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

[Bob Stayton <bobs@sagehill.net>]

Hi Jean-Pierre,

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

Here is an example of defining and using text entities:

  http://www.sagehill.net/docbookxsl/ModularEntities.html

Is that the kind of example you were looking for?

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

On 9/15/2015 2:06 AM, Jean-Pierre Rivière wrote:
> 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
> <mailto: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.)
>
>     Thanks!
>
>     Robert
>
>     On Mon, Sep 14, 2015 at 6:48 PM, Stefan Hinz <stefan.hinz@oracle.com
>     <mailto:stefan.hinz@oracle.com>> 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:
>         docbook-apps-unsubscribe@lists.oasis-open.org
>         <mailto:docbook-apps-unsubscribe@lists.oasis-open.org>
>         For additional commands, e-mail:
>         docbook-apps-help@lists.oasis-open.org
>         <mailto:docbook-apps-help@lists.oasis-open.org>
>
>
>
>
>
> --
> Jean-Pierre