On 2012-08-24, at 3:25 AM, Chris Nighswonger wrote:
On Thu, Aug 23, 2012 at 11:17 AM, Robin Sheat <robin@catalyst.net.nz> wrote: Op 23-08-12 17:14, Chris Nighswonger schreef:
If we can agree to some sort of standardized formatting, I'll write a parser to generate the wiki pages from the INSTALL files.
Wiki formatting would make sense, wouldn't it?
I was hoping someone would suggest that... ;-)
It's reasonably readable too.
For the most part
We could to them in POD and then do something like pod2wiki: http://search.cpan.org/~jmcnamara/Pod-Simple-Wiki-0.14/bin/pod2wiki
Which would allow such as 'perldoc INSTALL.foo' and such.
yep, thats the idea Chris :) there looks to be some good conversion tools between asciidoc, pod, and wiki (and then html, docbook, pdf and latex too) some conversion tools are going to work better that others. and some probably won't work at all i'll attempt to do some 'conversion testing' to see what the best/worst formats are https://github.com/giftnuss/p5-pod-asciidoc http://stackoverflow.com/questions/7612374/how-to-convert-asciidoc-to-perl-p... http://search.cpan.org/~dagolden/Pod-WikiDoc/ https://github.com/agentzh/nginx-devel-utils/blob/master/wiki2pod.pl http://search.cpan.org/~jmcnamara/Pod-Simple-Wiki-0.14/bin/pod2wiki http://code.google.com/p/mastermind-strategy/source/browse/wiki/wiki2pod?spec=svn198&r=198