-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Svetoslav Slavtchev wrote: >>On Friday 26 September 2003 06:09, Austin wrote: >> >>>markup? Also, the document is then not easily published >>>elsewhere. Is there an easy way to convert wiki markup to >>>pure HTML, or PDF, or some other publishing format? >> >>If you're using Twiki, they have a "publishing plugin" that >>converts an entire wiki to interlinked static HTML files. It >>looks better and needs a lot less work and server load than >>trying something with wget. I have it set up on the wiki for >>Gambas to generate once a day (since the Gambas wiki has kinda >>gotten a little complicated to do it on demand.) See the front >>page of http://www.binara.com/gambas-wiki/ for a link to the >>static version, and www.twiki.org (uh, somewhere within it... >>the whole thing's a wiki) for the plugin.
Speaking of gambas, why isn't it in contrib yet? (I had meant to try and work on this, but ran out of time ...). >> >>I haven't figured out a way to convert to PDF *usefully*, but the >>quick and dirty method would be to take the static files >>generated by the above method and oowriter --print them to a pdf >>file. I don't think that would look very good though. htmldoc may be better for this specific case. >> >>Despite this shortcoming, I think wikis are the way to go for >>community based documentation as long as someone sets up a >>document hierarchy when the wiki's put in place (in Gambas' >>case, I converted some documentation in a SXW file and wrote a >>program to pull class documentation out of the IDE, but people >>are free to add stuff outside those initial structures as well.) > > > i think i read smth about a wiki that supports docbook xml, > (but i can not find the mail right now, > and the [EMAIL PROTECTED] ml server gives error on searching :( ) There are two perl tools, wt2db and db2omf that could theoretically be useful, but they don't seem to generate anything useful from the twiki stuff I tried. http://tldp.org/wt2db/ http://tldp.org/db2omf/ BTW, the issue isn't only generating documentation, but also ensuring that it is easy to access (and I mean easier to access than the HTML HOWTOs etc). That's where db2omf would come in, and should allow searching and display with yelp and khelpcenter. > > & from docbook xml you can really easy create pdf, html, .... > for dynamic conversation apache + cocoon is a good solution i think > (at least for smaller documents, with my ~100page howto is a bit of pain) > see The other issue is maybe conglomerate is about ready for use for large-scale editing of docbook? It would just need use to have some versioning system (which the wiki currently provides). Regards, Buchan - -- |--------------Another happy Mandrake Club member--------------| Buchan Milne Mechanical Engineer, Network Manager Cellphone * Work +27 82 472 2231 * +27 21 8828820x202 Stellenbosch Automotive Engineering http://www.cae.co.za GPG Key http://ranger.dnsalias.com/bgmilne.asc 1024D/60D204A7 2919 E232 5610 A038 87B1 72D6 AC92 BA50 60D2 04A7 -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iD8DBQE/dFhRrJK6UGDSBKcRAn9RAJ9A07UyAE9CP9PBxU2cIUnkNWq51ACdFBvA eEL5hMEH8Y4qxarTAU27KuU= =ZhhN -----END PGP SIGNATURE----- ***************************************************************** Please click on http://www.cae.co.za/disclaimer.htm to read our e-mail disclaimer or send an e-mail to [EMAIL PROTECTED] for a copy. *****************************************************************
