print edition (was Re: removing 'changes' section from the online edition)

Warren Block wblock at wonkity.com
Sun Jun 2 13:56:33 UTC 2013


On Sun, 2 Jun 2013, Gabor Kovesdan wrote:

> Em 02-06-2013 00:13, Warren Block escreveu:
>> On Sat, 1 Jun 2013, Gabor Kovesdan wrote:
>> 
>>> Em 01-06-2013 20:52, Warren Block escreveu:
>>>>> No objection from me, I just want to bring it up again that handling 
>>>>> these with a single-source solution would be nice, i.e. using DocBook 
>>>>> profiling. It would also facilitate merges. This basically consists of 
>>>>> adding edition="print" to the affected section of preface and then 
>>>>> setting up profiling. (I can do it, just ping me if there is consensus 
>>>>> on this).
>>>> 
>>>> Yes!  I was just talking about this elsewhere.  Could we do it so only 
>>>> the non-print sections need to be modified? 
>>> You only need to add edition="online" to non-print sections. And only need 
>>> to add edition="print" to non-online sections. The rest is shared and the 
>>> markup is kept minimal.
>> 
>> How do you control which is included when the document is built? 
> 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?

Thanks!


More information about the freebsd-doc mailing list