From owner-freebsd-doc@FreeBSD.ORG Sun Feb 24 23:30:20 2013 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id E58ED813; Sun, 24 Feb 2013 23:30:20 +0000 (UTC) (envelope-from gkeramidas@gmail.com) Received: from mail-we0-x233.google.com (mail-we0-x233.google.com [IPv6:2a00:1450:400c:c03::233]) by mx1.freebsd.org (Postfix) with ESMTP id 45308DAE; Sun, 24 Feb 2013 23:30:20 +0000 (UTC) Received: by mail-we0-f179.google.com with SMTP id p43so2039439wea.10 for ; Sun, 24 Feb 2013 15:30:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:sender:date:from:to:cc:subject:message-id:references :mime-version:content-type:content-disposition:in-reply-to; bh=9HSZWkd3MxkADxzUBSDLv2FcpXIO6FwWNMIYPdXF9Wo=; b=EvKDmZlOLjcKW618AbI6AoaEESmn2uvlWce9t8hqy93oUqq9g4tIWOyf84jboROAja WwYJvneK4VBcLTDe4mV6pN0KpcBuF2gK9+G+vY4XAIiM9ByRaKxMG9HVi3+nEVfUPzzA wxwVg1x6WMd20ha1F+PfiqyRcBR9RxKji7BfvFoOnEagVS/0vh3DWHbMceHs1WnnubfJ tBUk4uMa+YT2HJA8xSbrBFpQ+hFueeLa1zIKKcJL2Ef6NCBb4nAOVScG5dLlaLeVAq60 GgxKd3vhS/k1nqtuylhug8hPMa/fkFhXgs5HTP5UVXB3fmHwzKezJj+DyRvlLDB26xY4 dPsg== X-Received: by 10.181.11.164 with SMTP id ej4mr8723584wid.29.1361748619355; Sun, 24 Feb 2013 15:30:19 -0800 (PST) Received: from saturn (217-162-217-29.dynamic.hispeed.ch. [217.162.217.29]) by mx.google.com with ESMTPS id j4sm11765010wiz.10.2013.02.24.15.30.17 (version=TLSv1.2 cipher=RC4-SHA bits=128/128); Sun, 24 Feb 2013 15:30:18 -0800 (PST) Sender: Giorgos Keramidas Date: Mon, 25 Feb 2013 00:30:13 +0100 From: Giorgos Keramidas To: Craig Rodrigues Subject: Re: How to build FreeBSD doc web pages? Message-ID: <20130224233011.GA32317@saturn> References: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="CE+1k2dSO48ffgeK" Content-Disposition: inline In-Reply-To: Cc: freebsd-doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 24 Feb 2013 23:30:21 -0000 --CE+1k2dSO48ffgeK Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2013-02-24 13:35, Craig Rodrigues wrote: > Hi, >=20 > 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. >=20 > What is the correct procedure to do this? >=20 > I am trying to follow these instructions: >=20 > http://www.freebsd.org/doc/en/books/fdp-primer/the-website-build.html >=20 > but those instructions didn't quite do what I wanted, i.e. > they did not build all the books (such as handbook) and articles. >=20 > On Freefall, I did this: >=20 > 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=3D$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=3D"$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=3Dyes, 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. --CE+1k2dSO48ffgeK Content-Type: application/pgp-signature; name="signature.asc" Content-Description: Digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (GNU/Linux) iEYEARECAAYFAlEqooMACgkQ1g+UGjGGA7b73wCgtJXazNbT1PKmSWjBqdyPKF8j WegAn3zBYZqTloGF0VcRnx3Yw/T8eZc5 =ra+5 -----END PGP SIGNATURE----- --CE+1k2dSO48ffgeK--