One of the things I would like from the documentation is that it can be provide in other formats. I haven been playing with asciidoc and a utility called pandoc. A converter from many things to many things. HTML to asciidoc is one of the possibilities.

I converted 3 embedded documentation files tech_overview.wiki, delta_encoder_algorithm.wiki en delta_format.wiki and created a docbook "manifest" which looks like:

= Several documents combined
Joe Bloggs
v1.0, 12-Aug-03
:numbered:
:doctype: book

include::tech_overview.txt[]

include::delta_format.txt[]

include::delta_encoder_algorithm.txt[]



and a reasonable document was generated. Reasonable because
    1) obvious the conversion wasn't 100 %
    2) these documents were not made with an eye for book integration
3) Links were difficult to reproduce. I had to make them absolute referencing

I have been playing with lyx and docbook but those solutions are using extern generated docs and allow you to show them in fossil. This could work from the embedded html documentation. Although one document had mixed html with wiki syntax and that caused some grief in the conversion. :-)

A goal for me is to have an updated lyx fossil manual in fossil and be able to use that to produce a pdf. I'll ponder a bit more about that.

--
Rene
_______________________________________________
fossil-users mailing list
fossil-users@lists.fossil-scm.org
http://lists.fossil-scm.org:8080/cgi-bin/mailman/listinfo/fossil-users

Reply via email to