Opened 8 years ago

Last modified 7 years ago

#5690 new enhancement

WikiProcessor for POD formatted text

Reported by: Salvador Fandino Owned by: anybody
Priority: normal Component: Request-a-Hack
Severity: normal Keywords: pod wikiprocessor
Cc: Trac Release: 0.11


POD (Plain Old Documentation) is the format commonly used to document Perl modules and scripts.

It would be nice to have a WikiProcessor allowing to use this format also in the Trac wiki.

The Perl module Pod::Simple::Wiki available from CPAN allows to convert between POD and the MoinMoin Wiki syntax (that AFAIK is the one used by Trac), so it will be just a matter of programming a wrapper to call this module from Trac.

Attachments (0)

Change History (3)

comment:1 Changed 8 years ago by Ryan J Ollos

Summary: POD WikiProcessorWikiProcessor for POD formatted text

comment:2 Changed 7 years ago by izzy

Did you see the PerlPodMacro?

comment:3 Changed 7 years ago by anonymous

sure, I did it ;-)

Though it is just a prove of concept. It converts the POD to HTML using pod2html and so the generates pages look very alien.

My initial plan was to use the Pod::Simple::Wiki modules from CPAN, but it didn't really work. The markup generated by the MoinMoin backend (probably the most close to Trac) did not render right and the document structure become broken in the translation.

My conclusion was that an specific backend able to translate Pod to Trac markup was required, but that exceeded the time I was able to allocate to the "hack" :-(

Modify Ticket

Change Properties
Set your email in Preferences
as new The owner will remain anybody.

Add Comment

E-mail address and name can be saved in the Preferences.

Note: See TracTickets for help on using tickets.