Pod to Textile for Wikis on Github

jmcnamara on 2009-08-29T22:15:40

As a mentioned recently I added Pod to Textile support to Pod::Simple::Wiki. It is now up on CPAN.

This lets you to convert a Pod document to Textile markup as follows:

pod2wiki --style=textile Some::Module.pm > some_module.wiki 
Which makes it easy to add a github wiki page like this.

John.
--


Conversion error

daxim on 2009-09-01T08:49:31

Something in the toolchain erroneously replaces -- with —.

Re:Conversion error

jmcnamara on 2009-09-01T22:08:31

Sorry, I don't understand the context. What is the problem exactly?

John.
--

Re:Conversion error

daxim on 2009-09-07T20:41:47

  1. Open http://wiki.github.com/jmcnamara/pod-simple-wiki/pod2wiki in your web browser.
  2. Copy the parameter style into the clipboard. (Out of the three occurences on that page, the two which are not set in monospace exhibit the problem.)
  3. Paste into shell. See the program choke on the unexpected long dash character. (GNU style options start with two ASCII dashes instead.)

Re:Conversion error

jmcnamara on 2009-09-07T22:40:33

The Pod and the generated wiki output both have a double dash but it is being rendered by Github as a Html "em dash" (code 8212). This is in accordance with the Textile spec. It does the same with quotes and other punctuation.

It isn't a feature that I particularly like but it is the way Textile is intended to behave.

John.
--