How to build FreeBSD doc web pages?

[Giorgos Keramidas]

On 2013-02-24 13:35, Craig Rodrigues <rodrigc at FreeBSD.org> wrote:
> Hi,
> 
> I am trying to fix some text in the FreeBSD docs,
> and am trying to build the FreeBSD docs and web pages
> so I can view the output HTML as I am fixing things.
> 
> What is the correct procedure to do this?
> 
> I am trying to follow these instructions:
> 
> http://www.freebsd.org/doc/en/books/fdp-primer/the-website-build.html
> 
> but those instructions didn't quite do what I wanted, i.e.
> they did not build all the books (such as handbook) and articles.
> 
> On Freefall, I did this:
> 
> mkdir -p ~rodrigc/public_html/doc2
> mkdir -p ~rodrigc/public_html/doc1
> cd ~rodrigc/public_html/doc2
> svn co svn://svn.freebsd.org/doc/head doc
> cd ~rodrigc/public_html/doc2/doc/en_US.ISO8859-1
> make install DOCDIR=$HOME/public_html/doc1/doc

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.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20130225/064d2e02/attachment.sig>