Hello Róbert,
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.)
The sidebar is part of the overall website layout which is maintained by
our web team. For the online readable formats, we sync over the HTML
output from DocBook to which we add a specially crafted PHP "header"
that makes the HTML integrate smoothly we the site layout. The solutions
works but is kind of hack-ish, so we hope to replace soon it with a
simpler solution that requires us to sync over plain old XHTML.
Cheers,
Stefan
Thanks!
Robert
On Mon, Sep 14, 2015 at 6:48 PM, Stefan Hinz <[email protected]
<mailto:[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 <tel:%2B49-30-82702940>
---------------------------------------------------------------------
To unsubscribe, e-mail:
[email protected]
<mailto:[email protected]>
For additional commands, e-mail:
[email protected]
<mailto:[email protected]>
--
Oracle <http://www.oracle.com>
Stefan Hinz, MySQL Documentation Manager
Oracle MySQL <http://dev.mysql.com/doc>
Berlin, Germany, +49-30-82702940
