jmcnamara/pod-simple-wiki — pull request #1 by pragmatic (2012-10-04 03:25:06+00:00)
Title: Options support and MediaWiki output beautifying

Add some rudimentary option support to allow enhanced MediaWiki output.

Current options are:

- tags

Allow the passing of custom tags, as I wished to enable syntax highlighting
of \

.. \

sections in my personal wiki using the http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi extension. Now I can transform those section
into \ ... \ and have the synopsis
section be nice and colourful.

- sentence_case

If set, modifies all =head1 titles to "Sentence case", which is just
an upper-case first letter and the rest of the letters lower-cased.

- cpanify_links

If set, all links without extra qualifier text are prefixed with a
cpan URL which means that links to Perl modules will be correctly
resolved in an internal wiki.

- munge_name

If set, modify the resultant output to remove the NAME section, but
first parse out the embedded abstract text and place that at the top
of the wiki page, as a sort of introduction.

Additionally, the item list output has been modified to better support
the Pod::Elemental::Transformer::List style of lists (as used by
many Dist::Zilla based distros via Pod::Weaver). The output of the
following list definition:

```pod
=for :list
* Point one
This is pointy
* Point two
That hurts
```
will be..

```wiki
* Point one

This is pointy

* Point two

That hurts

```

This allows for bulleted list headings with correctly aligned paragraph
blocks beneath.

The wiki modules have also been changed to be MixedCase, so Mediawiki becomes MediaWiki and Usemod becomes UseMod etc., this is to respect the correct case of the various wiki project names, and is purely an aesthetic choice.

Kind regards,
Peter Hallam