GnuCash Documentation 2.4.1 in .epub and .mobi format

Geert Janssens janssens-geert at telenet.be
Fri Jul 8 17:39:39 EDT 2011


On vrijdag 8 juli 2011, SASAKI Suguru wrote:
> Hi,
> 
> Thanks for reviewing.
> 
> 2011-07-08 Geert Janssens <janssens-geert at telenet.be>:
> > Ok, I have taken a closer look your your tweaks.
> > 
> > I have a few questions:
> > 1. I notice you use a ruby script to convert to epub. Why did you choose
> > that instead of the standard docbook xsl transformation ? The epub
> > stylesheet is not part of our repository because we never used it
> > before, but it can be added easily.
> 
> I know that we can convert DocBook to XHTML with standard XSLT,
> and then convert XHTML to EPUB with somthing like calbre.
> 
> This Ruby script came from DocBook project(, and packaged as dbtoepub
> in Debian (sid)).
> README about this script at
> <URL:http://docbook.sourceforge.net/release/xsl/current/epub/README> says,
> 
>   | These are XSL stylesheets for transforming DocBook XML document
>   | instances into .epub format.
>   | [...]
>   | An alpha-quality reference implementation (dbtoepub) for a DocBook to
>   | .epub converter (written in Ruby) is available under bin/.
> 
> They say these scripts and XSL stylesheets are alpha-quality,
> but I think this is somewhat specialized for EPUB generation
> and we can get better results with these
> than going through DocBook -> XHTML -> EPUB on our own.
> 
I didn't realize the ruby script came from the docbook project, but I've found 
it now as well on my system. I wonder if this script is required to generate 
the epub format, or if it's just a wrapper around a generic xslt 
transformation. I haven't experimented with this yet and I won't have much 
time for it in the next couple of weeks. So I'm very interested in the results 
of your experiments in this regard.

Geert


More information about the gnucash-devel mailing list