Pod-Pandoc 0.4.0

process Plain Old Documentation format with Pandoc

Homepage: https://github.com/nichtich/Pod-Pandoc

Platform: CPAN

Language: Perl

License: GPL-2.0

View on registry: https://metacpan.org/release/Pod-Pandoc


NAME

Pod::Pandoc - process Plain Old Documentation format with Pandoc

STATUS

Build Status Coverage Status Kwalitee Score Code Climate Issue Count Documentation Status

DESCRIPTION

The Plain Old Documentation format (Pod) is a markup language used to document Perl code (see perlpod for reference). Several Perl modules exist to process and convert Pod into other formats.

Pod::Pandoc is an attempt to unify and extend Pod converting based on the Pandoc document converter. Pandoc supports more document formats in a more detailled and uniform way than any set of Perl modules will ever do. For this reason Pod::Pandoc provides methods to convert Pod to the Pandoc document model for further processing with Pandoc.

OUTLINE

REQUIREMENTS

Installation of this module does not require Pandoc but it is needed to make actual use of it. See http://pandoc.org/installing.html for installation.

EXAMPLES

GitHub wiki and Sphinx documentation are automatically build on each commit to the master branch (see script deploy.sh).

GitHub wiki

The GitHub wiki of this project is automatically populated with its module documentation. Wiki pages are created with pod2pandoc as following (see script update-wiki.sh):

pod2pandoc lib/ script/ wiki/ --ext md --index Home --wiki -t markdown_github

Sphinx and Read The Docs

The Sphinx documentation generator recommends documents in reStructureText format. It further requires a configuration file conf.py and some links need to be adjusted because Pandoc does not support wikilinks in rst output format (see script update-docs.sh:

pod2pandoc lib/ script/ docs/ --ext rst --wiki -t rst --standalone
perl -pi -e 's!`([^`]+) <([^>]+)>`__!-e "docs/$2.rst" ? ":doc:`$1 <$2>`" : "`$1 <$2>`__"!e' docs/*.rst
make -C docs html

The result is published automatically at http://pod-pandoc.rtfd.io/en/latest/Pod-Pandoc.html.

SEE ALSO

This module is basde on the wrapper module Pandoc to execute pandoc from Perl and on the module Pandoc::Elements for pandoc document processing.

This module makes obsolete several specialized Pod::Simple::... modules such as Pod::Simple::HTML, Pod::Simple::XHTML, Pod::Simple::LaTeX, Pod::Simple::RTF Pod::Simple::Text, Pod::Simple::Wiki, Pod::WordML, Pod::Perldoc::ToToc etc. It also covers batch conversion such as Pod::Simple::HTMLBatch, Pod::ProjectDocs, Pod::POM::Web, and Pod::HtmlTree.

AUTHOR

Jakob Voß [email protected]

COPYRIGHT AND LICENSE

Copyright 2017- Jakob Voß

GNU General Public License, Version 2


Develop Dependencies Requirements Latest Stable Latest Release Licenses
Dist-Milla v1.0.15 v1.0.17 v1.0.17 Artistic-1.0-Perl
Test-Pod 1.41 1.51 Artistic-1.0-Perl
Explore the resolved develop dependency tree for Pod-Pandoc 0.4.0
Dependencies Requirements Latest Stable Latest Release Licenses
IPC-Run3 0 0.048 Other
Pandoc v0.6.0 0.6.0 0.6.0 GPL-2.0
Pandoc-Elements 0.29 0.33 GPL-2.0
perl 5.014 5.8.15 5.025011 Artistic-1.0-Perl
Pod-Simple 3.08 3.35 Artistic-1.0-Perl
Pod-Usage 0 1.69 Artistic-1.0-Perl
Explore the resolved dependency tree for Pod-Pandoc 0.4.0
Configure Dependencies Requirements Latest Stable Latest Release Licenses
Module-Build-Tiny 0.039 0.039 Artistic-1.0-Perl
Explore the resolved configure dependency tree for Pod-Pandoc 0.4.0
Test Dependencies Requirements Latest Stable Latest Release Licenses
Test-Exception 0 0.43 Artistic-1.0-Perl
Test-More 0.96
Test-Output 0 1.031 Artistic-1.0-Perl
Explore the resolved test dependency tree for Pod-Pandoc 0.4.0

Releases

0.4.0 February 06, 2017
0.3.2 February 03, 2017
0.3.1 February 01, 2017
0.3.0 February 01, 2017

Project Statistics

SourceRank 0
Dependencies 6
Dependent projects 0
Dependent repositories 0
Total releases 4
Latest release
First release
Stars 1
Forks 0
Watchers 1
Contributors 1
Repo Size: 83 KB

Top Contributors See all

vzg-deploy

Something wrong with this page? Make a suggestion

Export .ABOUT file for this library

Last synced: 2017-02-08 01:01:52 UTC

Login to resync this project