Modify

Opened 5 years ago

Last modified 4 years ago

#5690 new enhancement

WikiProcessor for POD formatted text

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

Description

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 5 years ago by rjollos

  • Summary changed from POD WikiProcessor to WikiProcessor for POD formatted text

comment:2 Changed 4 years ago by izzy

Did you see the PerlPodMacro?

comment:3 Changed 4 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" :-(

Add Comment

Modify Ticket

Action
as new .
Author


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

 
Note: See TracTickets for help on using tickets.