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

Gabor Kovesdan gabor at FreeBSD.org
Sun Jun 2 16:05:10 UTC 2013


Em 02-06-2013 17:03, Warren Block escreveu:
> That means "include elements marked with edition="print" and all 
> unprofiled elements"?
Yes. In other words: exclude elements, whose edition is not print.
>
> 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".
In the print branch it is possible to just mark online parts but if we 
want to work with single source we need both ways since there are some 
parts that are print-only. But I guess that the most of the Handbook may 
be unprofiled. Maybe we are late for going to a totally single source 
solution now but imho, we should do it the next time.
>
>> 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. 
If the reference is a sentence in a paragraph, you should use phrase. If 
it is a whole paragraph, you can add the markup para.

Gabor


More information about the freebsd-doc mailing list