Description of problem:
Could we please have Markdown added as an output format for Publican? A module for HTML->Markdown already exists:
Added support for HTML::WikiConverter, any sub modules installed should just work.
Tested with HTML::WikiConverter::Markdown, added this as a Requires to the speck file.
This needs to be added to the PUG.
The format is case sensitive so:
$ publican build --formats Markdown
will work but:
$ publican build --formats markdown
Note the file names end .txt as the modules do not specify a file extension.
You can see a full list of extension at:
Should be easy to get RPMs using cpanspec.
$ cpanspec --build HTML::WikiConverter::Confluence
$ sudo yum install ./noarch/perl-HTML-WikiConverter-Confluence-0.01-1.fc20.noarch.rpm
$ cd $path_to_book
$ publican build --formats Confluence
$ gvim tmp/en-US/Confluence/*.txt
bfe4429..23f73b6 devel -> devel
Verified that Publican is able to output Markdown. Tried this with three different content specs:
There were several issues with the Markdown output, though:
* <itemizedlist>s and <orderedlist>s nested inside of <step>s and <orderedlist>s can reset list numbering.
* When <replaceable>bleh</replaceable> is nested inside <command> or <screen>, the Markdown output doesn't correctly mark bleh differently. However, I suspect that this is also greatly due to the limitation of Markdown support on our Drupal instance (I have yet to actually determine how we should render italics inside of block text, for instance).
These issues can be covered in a different BZ, though. For now, consider the ability to render Markdown as VERIFIED.
A fix for this shipped in Publican 4.2.0.