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 ]

jmcnamara (659)

jmcnamara
  (email not shown publicly)
http://search.cpan.org/author/jmcnamara/

'ere I am, J.M.! The ghost in the machine:

perl -MCPAN -e 'install jmcnamara & _ x ord $ ;' | tail -1

Journal of jmcnamara (659)

Saturday August 29, 2009
05:15 PM

Pod to Textile for Wikis on Github

[ #39555 ]
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.
--


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.

Pod to Textile for Wikis on Github 4 Comments More | Login | Reply /

 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • Something in the toolchain erroneously replaces -- with —.
    • Sorry, I don't understand the context. What is the problem exactly?

      John.
      --

        1. Open http://wiki.github.com/jmcnamara/pod-simple-wiki/pod2wiki [github.com] 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.)
        • 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 [thresholdstate.com]. 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.
          --

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