develooper Front page | perl.perl5.porters | Postings from March 2008

Re: pod wiki?

Thread Previous | Thread Next
From:
Michael G Schwern
Date:
March 23, 2008 12:40
Subject:
Re: pod wiki?
Message ID:
47E6B210.506@pobox.com
Reini Urban wrote:
> To Schwern about http://www.perlfoundation.org/perl5/
> 
> It's nice to have a state-of-the-art wysiwyg wiki, but I'd vastly prefer 
> a pod wiki. Isn't this possible?

Yes.  Information about it is on the wiki. :P
http://www.perlfoundation.org/perl5/index.cgi?podwiki

But rather than convert the whole wiki into POD, which isn't necessary the 
greatest general-purpose wiki language...


> E.g. I try to create a F<perloptreeguts.pod> for core without the usual 
> patches submission and review, just online community interaction. We'll 
> see, just an attempt.
> 
> At first I had to convert it from pod to the social text wiki syntax 
> (Thanks Aristotle btw.), and now when I try to get to the real guts
> I have to convert it back from social text to pod. This drives me
> crazy.

One of the reasons I picked SocialText, aside from it being the easiest to 
install, [1] is that it's written in Perl, is (now) Open Source and can be 
customized.

We haven't taken advantage of that much yet.  Well, seems like this is a 
perfect opportunity.  It is possible to write a syntax plugin that formats POD 
into an HTML snippet.  Here's an example of how it's done.
http://www.socialtext.net/open/index.cgi?socialtext_wiki_syntax_plugin_howto

If someone would write one up we'll install it.  Syntax can be as simple as:

{pod:
...your pod here...
}

POD goes in, HTML comes out.


[1]  From my perspective anyway: "Kirsten, give me a wiki!"


-- 
7. Not allowed to add “In accordance with the prophesy” to the end of
    answers I give to a question an officer asks me.
     -- The 213 Things Skippy Is No Longer Allowed To Do In The U.S. Army
            http://skippyslist.com/list/

Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About