Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

schwern (1528)

schwern
  (email not shown publicly)
http://schwern.net/
AOL IM: MichaelSchwern (Add Buddy, Send Message)
Jabber: schwern@gmail.com
Schwern can destroy CPAN at his whim.

Journal of schwern (1528)

Wednesday September 17, 2008
09:59 PM

Google Wiki - POD converter

[ #37476 ]

Some of my pure POD documentation is wildly out of date. Test::Tutorial, Test::FAQ, ExtUtils::MakeMaker::Tutorial and ExtUtils::MakeMaker::FAQ. This sort of pure user level documentation is something that could be very easily done by a lot of people a little at a time. Perfect for a wiki!

And I've tried to wikify the before, but they seem to just get lost. I've used PodWiki in the past, but then I have to manually copy stuff into the repository and I forget. To do that. I toyed with the idea of making PodWiki automatically commit to an SVN repo (which wouldn't be too hard).

Test::More is now on Google Code. One of the interesting things they do is store the wiki in the SVN repo. Hmm.

What if I had a way to convert from Google Code wiki markup to POD? Then I could let people work on the documentation in the wiki and just convert that into POD for distribution! Soooo... who wants to write the converter?

UPDATE: fayland does! Pod::From::GoogleWiki.

(Alas, Google Code does not allow non-project members to edit a project's wiki, something I would like to see fixed).


List all Journal entries
The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.

Google Wiki - POD converter 5 Comments More | Login | Reply /

 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • I want to write one if u don't mind. :) what's the rules? what's the module name suggested? any sample wiki and related sample POD? Thanks.

    • Rules? First release wins!

      Suggested name? Pod::From::GoogleWiki? Google::Wiki::To::Pod?

      You might be able to simply abuse Pod::WikiDoc [cpan.org] by
      writing a new Pod::WikiDoc::Parser grammar for Google Code. Then I
      can just wrap the wiki page in "=begin/end wikidoc" around it and run
      it through Pod::Wikidoc to do the conversion.

      Alternatively, Convert::Wiki [cpan.org]
      might be adaptable.

      Or you can just do some quick hacky thing. I don't think it will take
      much work.

      The wiki in question is here [google.com]. The wiki
      syntax is here [google.com].
      Realistical

Stories, comments, journals, and other submissions on use Perl; are Copyright 1998-2006, their respective owners.