On 4/23/05, John Taber <jtaber@...480...> wrote:
Okay, when I get this all figured out, if you want, I will make my first contribution on this as a guide for beginning volunteers like myself on how they can contribute documentation.
I understand the first part of creating the svg + html from docbook but as you mentioned, documentation is displayed in Inkscape as a svg file, right? So then doesn't the (svg+html) have to be converted back to a single svg file so that Inkscape can render it? Or then what is the purpose of creating the html? I was thinking the purpose was for the user to write docs in html but it sounds like all documentation would still be written in docbook. Can you help me understand?
Sure. This is called single-source. Your text in DocBook/XML is always the source. Both HTML and SVG versions of your guide are created from your DocBook/XML file. Every time you want to modify your guide, you edit your docbook/xml file, and then you run conversion script to produce HTML and SVG versions.
Alexandre