Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 18 Aug 2011 08:50:59 +0200
From:      Johann Kois <jkois@FreeBSD.org>
To:        Jason Helfman <jhelfman@e-e.com>
Cc:        Mark Linimon <linimon@lonesome.com>, freebsd-doc@FreeBSD.org
Subject:   Re: Broken link to articles/problem-reports/pr-writing.html in porters-handbook
Message-ID:  <4E4CB653.5040700@FreeBSD.org>
In-Reply-To: <20110817164653.GC79663@eggman.experts-exchange.com>
References:  <20110816002225.7ebb265b@serene.no-ip.org> <4E4AD76C.6060508@FreeBSD.org> <20110816171311.1f845047@serene.no-ip.org> <4E4B8ED3.8040708@FreeBSD.org> <20110817125425.GA26287@lonesome.com> <20110817164653.GC79663@eggman.experts-exchange.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On 08/17/2011 18:46, Jason Helfman wrote:
> On Wed, Aug 17, 2011 at 07:54:25AM -0500, Mark Linimon thus spake:
>> On Wed, Aug 17, 2011 at 11:50:11AM +0200, Johann Kois wrote:
>>> For example if you build the local handbook you will get no
>>> book.html. If you build a local article you will get only
>>> article.html, but no "split-html".
>>
>> I usually test by e.g. 'make book.html' instead of just 'make'. I find
>> it easier to search for things on the single output. Either way works.
>>
>> mcl
>
> I build the entire site @work, and get both split and one page (book), and
> haven't had any issues yet with it.

Well, the "problem" is you should not get both versions.  ;-)

For example:

* Makefile for the fdp-primer:

FORMATS?= html html-split  (so you get both formats, both locally and on 
FreeBSD.org)

* Makefile for the handbook:

FORMATS?= html-split  (so no book.html when built locally, although it 
is there on www.FreeBSD.org).

* Makefile for all the articles:

FORMATS?= html (so only article.html when built locally, but also 
"html-split files" when built on FreeBSD.org).

This happens when you build the documentation from within the doc tree 
(so for example started from a checked out doc/en_US.ISO8859-1 dir).  So 
something is done differently when you create a full copy of FreeBSD 
www/doc.  At least that is how it looks to me.


jkois


-- 
  Johann Kois
  jkois(at)FreeBSD.org
  FreeBSD Documentation Project
  FreeBSD German Documentation Project - https://doc.bsdgroup.de



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4E4CB653.5040700>