From owner-freebsd-doc@FreeBSD.ORG Mon Feb 25 07:58:21 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 9DB23A2E; Mon, 25 Feb 2013 07:58:21 +0000 (UTC) (envelope-from crodr001@gmail.com) Received: from mail-lb0-f175.google.com (mail-lb0-f175.google.com [209.85.217.175]) by mx1.freebsd.org (Postfix) with ESMTP id F06592EE; Mon, 25 Feb 2013 07:58:20 +0000 (UTC) Received: by mail-lb0-f175.google.com with SMTP id n3so2006237lbo.20 for ; Sun, 24 Feb 2013 23:58:13 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:cc:content-type; bh=nEviNdL7qC8UgwpmsUjRq940O1YWtn8wpigUS54FmjM=; b=K5BGMLfHCGTwYyZeiB2buPVCm7UwZgTCyN/RS6YjXidLZNz4GnRz7DCuygcxAWfMf9 6xuJ2UwCEv+0UNPU0ZgoDKOv78G425kOVQ7+kOAuHOg4mahH210f6VDHPmoQgYUTMS4G xjcstqANIheJoTMsiWFsGbSo5jZFVx0L+cfeorNNbQ7mRUQFsHpwDPQ7qSwGfI8gKABG f/fLTDG1U83Ei23Jg/IicU8yee2esDQPZRJtrZT344FtBqoZCNjHAmjXkca0xzsGRSGk O14AS7HBkMXUN0V/tZ7xEUY7klaMgf5LUu5xfsUnM154Zup/HKJwLawgD3vRGw1hEah2 ktYg== MIME-Version: 1.0 X-Received: by 10.112.37.234 with SMTP id b10mr4047112lbk.118.1361779093719; Sun, 24 Feb 2013 23:58:13 -0800 (PST) Sender: crodr001@gmail.com Received: by 10.112.85.198 with HTTP; Sun, 24 Feb 2013 23:58:13 -0800 (PST) In-Reply-To: <20130224233011.GA32317@saturn> References: <20130224233011.GA32317@saturn> Date: Sun, 24 Feb 2013 23:58:13 -0800 X-Google-Sender-Auth: tWiKdQy2czIZeqvEsWXCfuPVVM8 Message-ID: Subject: Re: How to build FreeBSD doc web pages? From: Craig Rodrigues To: Giorgos Keramidas Content-Type: multipart/mixed; boundary=e0cb4efe2dbe24cbbb04d687e700 X-Content-Filtered-By: Mailman/MimeDel 2.1.14 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: Mon, 25 Feb 2013 07:58:21 -0000 --e0cb4efe2dbe24cbbb04d687e700 Content-Type: text/plain; charset=ISO-8859-1 On Sun, Feb 24, 2013 at 3:30 PM, Giorgos Keramidas wrote: > On 2013-02-24 13:35, Craig Rodrigues 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 -- Craig --e0cb4efe2dbe24cbbb04d687e700 Content-Type: text/plain; charset=US-ASCII; name="diff.txt" Content-Disposition: attachment; filename="diff.txt" Content-Transfer-Encoding: base64 X-Attachment-Id: f_hdlc29c51 SW5kZXg6IGRvYy9lbl9VUy5JU084ODU5LTEvYm9va3MvZmRwLXByaW1lci90aGUtd2Vic2l0ZS9j aGFwdGVyLnhtbAo9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09PT09Ci0tLSBkb2MvZW5fVVMuSVNPODg1OS0xL2Jvb2tzL2ZkcC1w cmltZXIvdGhlLXdlYnNpdGUvY2hhcHRlci54bWwJKHJldmlzaW9uIDQxMDM4KQorKysgZG9jL2Vu X1VTLklTTzg4NTktMS9ib29rcy9mZHAtcHJpbWVyL3RoZS13ZWJzaXRlL2NoYXB0ZXIueG1sCSh3 b3JraW5nIGNvcHkpCkBAIC0xNTEsNiArMTUxLDE5IEBACiAJICByb290LjwvcGFyYT4KIAogCTxz Y3JlZW4+JnByb21wdC5yb290OyA8dXNlcmlucHV0Pjxjb21tYW5kPmVudjwvY29tbWFuZD4gPG1h a2V2YXI+REVTVERJUjwvbWFrZXZhcj49PHJlcGxhY2VhYmxlPi91c3IvbG9jYWwvd3d3PC9yZXBs YWNlYWJsZT4gPGNvbW1hbmQ+bWFrZTwvY29tbWFuZD4gPG1ha2V0YXJnZXQ+aW5zdGFsbDwvbWFr ZXRhcmdldD48L3VzZXJpbnB1dD48L3NjcmVlbj4KKyAgICAgICAgPHRpcD4KKwkgIDxwYXJhPldo aWxlIG1vZGlmeWluZyBkb2N1bWVudGF0aW9uLCB5b3UgbWF5IHdpc2ggdG8gYnVpbGQKKyAgICAg ICAgICAgIGFuZCBpbnN0YWxsIG9ubHkgYSBzdWJzZXQgb2YgdGhlIGZ1bGwgZG9jdW1lbnRhdGlv biBpbgorICAgICAgICAgICAgb3JkZXIgdG8gdG8gcHJldmlldyB5b3VyIGNoYW5nZXMuICBGb3Ig ZXhhbXBsZSwgdGhlCisgICAgICAgICAgICBmb2xsb3dpbmcgY29tbWFuZCB3aWxsIGJ1aWxkIGFu ZCBpbnN0YWxsIG9ubHkgdGhlIEVuZ2xpc2gKKyAgICAgICAgICAgIGxhbmd1YWdlIHdlYiBwYWdl cy48L3BhcmE+CisJICA8c2NyZWVuPiZwcm9tcHQucm9vdDsgPHVzZXJpbnB1dD48Y29tbWFuZD5j ZDwvY29tbWFuZD4gPHJlcGxhY2VhYmxlPi91c3IvYnVpbGQvZW5fVVMuSVNPODg1OS0xL2h0ZG9j czwvcmVwbGFjZWFibGU+PC91c2VyaW5wdXQ+CismcHJvbXB0LnJvb3Q7IDxjb21tYW5kPmVudjwv Y29tbWFuZD4gPG1ha2V2YXI+R0VOX0lOREVYPC9tYWtldmFyPj08cmVwbGFjZWFibGU+eWVzPC9y ZXBsYWNlYWJsZT4gPG1ha2V2YXI+REVTVERJUjwvbWFrZXZhcj49PHJlcGxhY2VhYmxlPi91c3Iv bG9jYWwvd3d3PC9yZXBsYWNlYWJsZT4gXAorICAgIDxjb21tYW5kPm1ha2U8L2NvbW1hbmQ+IFwK KyAgICA8bWFrZXZhcj5FTkdMSVNIX09OTFk8L21ha2V2YXI+PTxyZXBsYWNlYWJsZT55ZXM8L3Jl cGxhY2VhYmxlPiBcCisgICAgPG1ha2V2YXI+V0VCX09OTFk8L21ha2V2YXI+PTxyZXBsYWNlYWJs ZT55ZXM8L3JlcGxhY2VhYmxlPiBcCisgICAgPG1ha2V0YXJnZXQ+YWxsPC9tYWtldGFyZ2V0PiA8 bWFrZXRhcmdldD5pbnN0YWxsPC9tYWtldGFyZ2V0PiA8L3NjcmVlbj4KKyAgICAgICAgPC90aXA+ CiAgICAgICA8L3N0ZXA+CiAKICAgICAgIDxzdGVwPgo= --e0cb4efe2dbe24cbbb04d687e700--