DocBook to ePub

Stephan Witt st.witt at
Sun Feb 7 15:28:18 UTC 2021

Am 30.01.2021 um 04:56 schrieb Thibaut Cuvelier <tcuvelier at>:
> On Sat, 30 Jan 2021 at 01:30, Stephan Witt <st.witt at> wrote:
> Am 29.01.2021 um 18:38 schrieb Thibaut Cuvelier <tcuvelier at>:
> > 
> > Dear list, 
> > 
> > As promised, I started working on ePub output, building upon the new DocBook output. 
> > 
> > Here is a script that performs the complete process of taking a DocBook file and generating the ePub. It has several dependencies: 
> > 
> > - an XSLT processor:
> >       • not xsltproc ( available for most Linux distributions, I guess it is available by default on macOS, must be bundled for Windows. I tried several versions for Windows, but an old bug that should have been fixed in 1.1.24 (roughly 2010) is still there: 
> >               • I/O error : No such file or directory
> >               • xsltDocumentElem: unable to save to C:/Users/Thibaut/AppData/Local/Temp/tmp6c2i6a7h/OEBPS/package.opf
> >       • Saxon 6 (available for most Linux distributions, must be bundled for Windows and macOS, requires Java). It's outdated software (circa 2005), but newer versions are not 100% backward compatible, so it is still very widely used. Other DocBook stylesheets would work on newer Saxon, but they are not as reliable as the old ones (like
> >       • not MSXML6 (Windows-only, mostly built-it, but not compatible with the DocBook stylesheets — it wrongly errors with chunking) or .Net XSLT engine (nxslt/nxslt2).
> > - the official DocBook XSLT stylesheets. Three parts are required: XHTML, XHTML5, and ePub. For now, I copied the needed parts in a patch. On some Linux distributions, this could be replaced by a version installed by the package manager (Ubuntu 20.04 has a near-up-to-date version, although the latest one has been released in 2016:; Fedora is up-to-date).
> > 
> > The integration into LyX should be complete, minus testing on Linux and others and packaging issues: the dependencies must be included for Windows and macOS, not for all Linux distros. 
> On macOS 10.14 (Mojave) I have:
> $ xsltproc -V
> Using libxml 20904, libxslt 10129 and libexslt 817
> xsltproc was compiled against libxml 20904, libxslt 10129 and libexslt 817
> libxslt 10129 was compiled against libxml 20904
> libexslt 817 was compiled against libxml 20904
> Why not?
> I was not able to make xsltproc work on Windows with these stylesheets, it gave many errors when creating new files. What if you try with the following script (it goes in lib/scripts)? 
> <>— 

Now I've tried the xsltproc based conversion (see attached patch) and AFAICS it works like a charm on Mac.

IMO this is a real option on Mac. The average user doesn't have java installed.

To prefer xsltproc on Mac something like the attached patch works for me.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: docbook2epub-xsltproc.patch
Type: application/octet-stream
Size: 1974 bytes
Desc: not available
URL: <>

More information about the lyx-devel mailing list