Date: Mon, 25 Feb 2013 16:23:32 +0100 From: Giorgos Keramidas <keramida@FreeBSD.org> To: Craig Rodrigues <rodrigc@FreeBSD.org> Cc: freebsd-doc@freebsd.org Subject: Re: How to build FreeBSD doc web pages? Message-ID: <20130225152311.GA7791@saturn> In-Reply-To: <CAG=rPVefJvSzr5Bj8Us%2BXOmAB3ChBjjTLdsw--JEf%2B8=Qk_XLw@mail.gmail.com> References: <CAG=rPVcM1=mL8qUOTAD3n4mkx9qsgM91GmF11_LYRVPu%2BevPPg@mail.gmail.com> <20130224233011.GA32317@saturn> <CAG=rPVefJvSzr5Bj8Us%2BXOmAB3ChBjjTLdsw--JEf%2B8=Qk_XLw@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2013-02-24 23:58, Craig Rodrigues <rodrigc@FreeBSD.org> wrote: >On Sun, Feb 24, 2013 at 3:30 PM, Giorgos Keramidas <keramida@freebsd.org>wrote: >> On 2013-02-24 13:35, Craig Rodrigues <rodrigc@FreeBSD.org> wrote: >> >> The makefile glue for building the website assumes that DESTDIR is also >> set to something. Try installing with: >> >> cd ~rodrigc/public_html/doc2/doc >> cd en_US.ISO8859-1/htdocs >> >> env DESTDIR="$HOME/public_html/doc1" \ >> make install >> >> Setting DESTDIR during 'make install' for htdocs/ will automatically >> also set DOCDIR to $DESTDIR/data/doc so you don't have to specify it >> too. >> >> To speed up checks for the 'make install' run, it may also be useful >> to set ENLISH_ONLY=yes, so you skip all the translations at first. >> >> What you did ended up installing the Handbook's index.html over the >> doc/en_US.ISO8859-1/htdocs/index.xsl output. > > Ah OK, thanks for the tip. > Also looking at Glen Barber's script ~gjb/bin/docbuild.sh helped > me understand a lot. Would it be appropriate to add an > example to the fdp primer such as the one below? > > That would have improved my understanding of how to do this. > > It looks like this: > > http://people.freebsd.org/~rodrigc/doc2/doc/en_US.ISO8859-1/books/fdp-primer/the-website-install.html I just wrote a couple of small variants of Glen's original script, to explore a few things about our new svn layout: ~keramida/bin/docbuild.sh ~keramida/bin/wwwbuild.sh Once I have run a few tests and I am confident I can explain what to do, I will try to update the fdp-primer. It seems that most of the bits are already there in my docbuild.sh and wwwbuild.sh scripts.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20130225152311.GA7791>