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? John
On Saturday 23 April 2005 11:43, bulia byak wrote:
On 4/23/05, John Taber <jtaber@...480...> wrote:
This sounds really great. Is this the process? docbook =>(via XSLT)=> svg + html
Yes
=> (modify docs) => convert to svg output helpfile => render helpfile in Inkscape?
In this part, when you need to modify anything, you modify the docbook and regenerate SVG and HTML from it.
Other formats can be added if needed; one possibility is PDF (via XSL-FO). Another is paginated SVG (when Inkscape supports multipage).
Then I guess one could also simply load the output svg file into a gtk image and place it into a frame with scrollbars? Obviously static, but great for output display.
Probably, though HTML is likely easier for static display.
Is there something like a wiki on this to read?
Not yet
Sidenote: what editor is being used for docbook writing?
I use my XEmacs for everything :)