How to build FreeBSD doc web pages?

[Giorgos Keramidas]

On 2013-02-24 23:58, Craig Rodrigues <rodrigc at FreeBSD.org> wrote:
>On Sun, Feb 24, 2013 at 3:30 PM, Giorgos Keramidas <keramida at freebsd.org>wrote:
>> On 2013-02-24 13:35, Craig Rodrigues <rodrigc at 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.