Skip site navigation (1)Skip section navigation (2)
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>