Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 2 Jun 2013 09:03:37 -0600 (MDT)
From:      Warren Block <wblock@wonkity.com>
To:        Gabor Kovesdan <gabor@FreeBSD.org>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: print edition (was Re: removing 'changes' section from the online edition)
Message-ID:  <alpine.BSF.2.00.1306020853110.8625@wonkity.com>
In-Reply-To: <51AB59EB.4080400@FreeBSD.org>
References:  <CAF6rxgmionFt8Z7mrN0_JciThfyL4AMXcChRHWX1m%2BDE51FYLQ@mail.gmail.com> <51AA31C7.4010202@FreeBSD.org> <alpine.BSF.2.00.1306011250320.1365@wonkity.com> <51AA57E8.2030105@FreeBSD.org> <alpine.BSF.2.00.1306011612580.3184@wonkity.com> <51AAFF0A.2060009@FreeBSD.org> <alpine.BSF.2.00.1306020751010.8625@wonkity.com> <51AB59EB.4080400@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, 2 Jun 2013, Gabor Kovesdan wrote:

> Em 02-06-2013 15:56, Warren Block escreveu:
>>> There's an XSLT stylesheet provided by DocBook that preprocesses the 
>>> markup and only leaves in the corresponding content. This is not enabled 
>>> by default, only if you set it up with a knob in the Makefile of the 
>>> actual document.
>> 
>> I'd like to try an actual test on the Handbook.  Is that feasible with what 
>> we have currently?  What specific changes need to be made to the Makefiles? 
> You have to mark up something with edition="print", then set this either in 
> Makefile or at the command line when calling make all:
> PROFILING+= --param profile.attribute "'edition'" --param profile.value "'print'"

That means "include elements marked with edition="print" and all 
unprofiled elements"?

For a print version, it might be easier to just go the opposite way: 
leave everything unprofiled as defaulting to print, and marking 
online-only sections as "online".

> You have to watch out that the DocBook sources are valid both with and 
> without the profiled element. For example, you cannot have two titles for the 
> section with different edition values since only one title is allowed. In 
> this case, you have to use the phrase element in the title.

That will probably be necessary for some things, like a print chapter 
that links to online-only chapters.

> Further reading: http://www.sagehill.net/docbookxsl/Profiling.html

Thanks!



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.00.1306020853110.8625>