Documentation markup experience

[Shaun McCance]

On Tue, 2010-07-06 at 10:39 -0500, Jim Campbell wrote:

> Also, keep in mind that Mallard doesn't currently support PDF output,
> but does support HTML output.  Mallard output can be displayed in
> Yelp, and Mallard converted to HTML could be displayed in the KDE help
> center (if they didn't want to view it in a browser for some
> reason . . . ).  
> 
> I kind of think PDF output would be very helpful for this, so I'm even
> open to doing this in Docbook v5.  Yelp 3.0 will support Docbook 5, so
> we would have HTML, PDF, and Yelp output options.

What would be the most useful intermediary format for creating
PDF files? Are people happy with the DocBook->PDF tools? Going
to DocBook (4 or 5) from a Mallard document like SWFK should
be straightforward. The hardest part is linearization. I do
have code for that, but how well its output suits your needs
will depend on your document. For something designed to be
linear, though, the results should be good.

--
Shaun