OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] Show off what you've done with Docbook

I have a personal project using docbook as a central point for producing pdf and ebooks (epub and mobi (drm-less)). This is a free ruleset for wargaming with little figurines. See my website dedicated to this work in progress: http://bloodandblades.com/

Epub is relatively easy and works rather well, in a direct manner. Mobi, I got from epub with calibre, but the graphics are problematic (on my old Kindle 4 touchless). The pdf, I cannot produce directly, so one against I got it from epub, which is not the best way to get it in a perfect world.

The docbook handling is a free project of itself. It is there : https://github.com/psiloi/tiddlybook

The recipe for making file are all in the Makefile.

I would appreciate any help to improve my output methods. I also haven't been able to support entities in my docbook. I find the official documentation lacking example in this repect, more complete example. A simpl "hello world" docbook with one or two entities would greatly help me.

2015-09-15 8:44 GMT+02:00 Fekete, Róbert <robert.fekete@balabit.com>:
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.)



On Mon, Sep 14, 2015 at 6:48 PM, Stefan Hinz <stefan.hinz@oracle.com> wrote:

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:


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:


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. :-)



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: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]