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.
Thanks :)
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?
Yes
So then doesn't the (svg+html) have to be converted back to a single svg file so that Inkscape can render it?
No, in Inkscape everything is in a single SVG file, both text and illustrations. In HTML rendition, text is in HTML and illustrations are in PNG. In the _source_, text is DocBook and illustrations are separate SVG files, one per illustration.
Or then what is the purpose of creating the html?
So it can be printed, read away from Inkscape, searched, indexed by Google, etc. etc.
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.
Yes. You write in DocBook (with SVG illustrations) and get HTML+PNG and single-file-SVG from that automatically.