From owner-freebsd-doc@FreeBSD.ORG Mon Feb 25 15:23:41 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 BAB8E440; Mon, 25 Feb 2013 15:23:41 +0000 (UTC) (envelope-from gkeramidas@gmail.com) Received: from mail-we0-x236.google.com (we-in-x0236.1e100.net [IPv6:2a00:1450:400c:c03::236]) by mx1.freebsd.org (Postfix) with ESMTP id 0E7C8306; Mon, 25 Feb 2013 15:23:40 +0000 (UTC) Received: by mail-we0-f182.google.com with SMTP id t57so2570416wey.41 for ; Mon, 25 Feb 2013 07:23:40 -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=rSuliXb0Ct6ZmAl8298ya5DI957XAMEdF5HeulEydEE=; b=CGsUmY/8mYHjFVNF2g6IJvqif3Feq06Yfc4iZxSeD//bkeGaVuMnu3F1x7Ch1SEqOF 7Wf2OLq/oF7bXRu4/0zJlWTP5Q1Ke1kw6Y/TrveKipVWzd6ftaDhZ1latRMMyaIipD0T r1n/JV9UtyrjB1CBpQDxVmh9ITTkE3w3dQFhJ9u7wQx/TAWZH4Hc4dIk9gnMP/A5DXtr b0bRPT0STp2pz/4f7sa6NpAPxMdm5VgvA1U1MokQG9aAAz2T3kp0U+DD91mHohZ/bklN CflEnvOQsT59nX8ar9MbAC3/OsF9UIxhBNMtMKxWeLLtAz60KwDHTQhAhtuTUjo+FVAE egcg== X-Received: by 10.180.92.39 with SMTP id cj7mr12958981wib.19.1361805820217; Mon, 25 Feb 2013 07:23:40 -0800 (PST) Received: from saturn (217-162-217-29.dynamic.hispeed.ch. [217.162.217.29]) by mx.google.com with ESMTPS id ex15sm15533794wid.5.2013.02.25.07.23.38 (version=TLSv1.2 cipher=RC4-SHA bits=128/128); Mon, 25 Feb 2013 07:23:39 -0800 (PST) Sender: Giorgos Keramidas Date: Mon, 25 Feb 2013 16:23:32 +0100 From: Giorgos Keramidas To: Craig Rodrigues Subject: Re: How to build FreeBSD doc web pages? Message-ID: <20130225152311.GA7791@saturn> References: <20130224233011.GA32317@saturn> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 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: Mon, 25 Feb 2013 15:23:41 -0000 On 2013-02-24 23:58, Craig Rodrigues wrote: >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 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.