Opened 15 years ago
Closed 7 years ago
#5690 closed enhancement (wontfix)
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 |
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 (5)
comment:1 Changed 15 years ago by
Summary: | POD WikiProcessor → WikiProcessor for POD formatted text |
---|
comment:2 Changed 15 years ago by
comment:3 Changed 15 years ago by
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" :-(
comment:5 Changed 7 years ago by
Resolution: | → wontfix |
---|---|
Status: | new → closed |
Seems like it should be implemented by extending PerlPodMacro.
Did you see the PerlPodMacro?