-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 13/01/11 14:10, Samuli Seppänen wrote: > >> >> It should be possible to write a little script which parses the wiki >> (page content) source text and makes man/html pages and example files >> based on this. This could be done before each release. >> >> The drawback is that the wiki markup might be too flexible (too many >> features) and the parsing script might get complicated. > I'm pretty sure we can get the Wiki contents out in HTML format. And > there should be plenty of "HTML -> something" converters out there. >
It will probably be just as easy as parsing the wiki markup as the HTML result. That parsing code already exists somewhere in Trac. The problem I was more thinking of is to have a style/layout which matches man pages, f.ex. There are certain elements which are required, and a certain order. And there are certain things which are not so easily accessible in man, like how to center text, bullet lists, misc indentation stuff. There are several and different "tags" in *roff which are rather limited, but they work flawlessly when used correctly, in the strict manner they was designed for. Wiki-markup/HTML is way more flexible. Or to say it another way, converting *roff -> HTML is easy as going downhill, HTML -> *roff is more like going uphill. However - nothing is impossible, it just takes a bit longer time :) kind regards, David Sommerseth -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (GNU/Linux) Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org/ iEYEARECAAYFAk0vF/gACgkQDC186MBRfrqO4QCdFzSN7NEbuMkL78TpOE8Ki/H0 zA8AoJe62qdFM25XUK4WjFvSfhhKqXlb =+NCV -----END PGP SIGNATURE-----
