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