Hi Stefan, I have a question about how your HTML docs work: For example, at http://dev.mysql.com/doc/refman/5.6/en/tutorial.html there is a list of multiple books and a search bar on the left. Is this part external to docbook, or do you use some webhelp tweak to do it? (I've been trying to use webhelp with <set> to achieve similar results, but couldn't sort out all the bugs so far.)
Thanks! Robert On Mon, Sep 14, 2015 at 6:48 PM, Stefan Hinz <[email protected]> wrote: > Hi, > > Have any of you PDF + HTML output with Docbook? If anyone has such a >> project and will be willing to show it off, send some URLs! >> > > The MySQL documentation is created and maintained in DocBook XML. The > entry point to the docs is here: > > http://dev.mysql.com/doc/ > > As you can see, we build a lot of formats from DocBook, including Unix man > pages which are created from the same source as the rest of the formats > (most documentation teams maintain man pages separately). > > Last time we cared to do a detailed analysis of our stuff was in 2009; > here's a summary: > > http://dev.mysql.com/doc/index-about.html > > It's only become more in every respect, more products to cover, more > books, more pages, more complexity. We get the "why don't you use X > instead, it's so much better" question every once in a while, but DocBook > has been working remarkably well for us for more than a decade, and it > scales, so we have no plans to move away from it anytime soon. > > Reasons to consider DocBook in the first place included Norm's ( > http://docbook.org/tdg/en/html/docbook.html) and Bob's ( > http://www.sagehill.net/docbookxsl/) great books, by the way. :-) > > Cheers, > > Stefan > > -- > Oracle <http://www.oracle.com> > Stefan Hinz, MySQL Documentation Manager > Oracle MySQL <http://dev.mysql.com/doc> > Berlin, Germany, +49-30-82702940 > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > >
