On 2012-08-24, at 3:25 AM, Chris Nighswonger wrote: > On Thu, Aug 23, 2012 at 11:17 AM, Robin Sheat <[email protected]> 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-pod 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 _______________________________________________ Koha-devel mailing list [email protected] http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel website : http://www.koha-community.org/ git : http://git.koha-community.org/ bugs : http://bugs.koha-community.org/
