Re: First SVG graphic

I failed to generate the "single HTML file".

The default Makefile task, which creates multiple HTML files, works 
properly, because it confines itself to create links to SVG files. The 
SVG structure keeps hidden to the Docbook validation and processing - 
Docbook recognises only some additional links. What I have tried to 
generate a single HTML file is the use of xi:XInclude before validating 
and further processing. In this case the SVG structure is visible to 
Docbook.

In general it is possible to use SVG within Docbook 4.x, if you switch 
the doctype to

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook SVG Module V1.1CR1//EN"
                          "http://www.oasis-open.org/docbook/xml/svg/1.1CR1/dbsvg.dtd"  

This is an Docbook 4.x extension 
(https://docbook.org/specs/wd-docbook-svg-1.1cr1) for SVG-integration. 
But it's only a working draft from 2004, it never reached the status of 
an official OASIS standard. As far as I have seen, it works (with some 
limitations), if the SVG data is an integral part of the xml/sgml source 
file. I failed to combine it with xi:XInclude. In opposite to this the 
combination of xi:XInclude, SVG, and Docbook 5.1 works well. In my 
opinion this results from the fact, that the structure of Docbook 4.x is 
based on a DTD, whereas Docbook 5.x uses Relax-NG (and generates xsd 
files out of rng). DTDs natively are not namespace-aware, you must do 
some trickery to handle namespaces. Docbook 5.x is not only namespace 
aware, it natively includes definitions for SVG and other important 
standards like MathML.

My questions to the community are:

  * Does anyone has an idea how to generate single HTML file in the
    actual situation?
  * Shall we delay the SVG integration until we have switched to Docbook
    5.x? This task is a great step, but it must be done in any case,
    because Docbook 4.x is outdated since many years. Btw: Because of
    other problems (https://github.com/docbook/docbook/issues/74) it is
    likely that we cannot use 5.1 but have to wait for the upcoming
    release 5.2.

Kind regards

Jürgen Purtz