Re: pod-latex-pdf

Why I ask here is simply because I can imagine quite a few number of knowledgable people did something similar to create a nice PDF from POD.
While I haven't actually tried these myself (yet), I found these two on CPAN for someone a while back, and seem to recall getting some positive reviews on one or the other: Pod::HtmlPsPdf and Pod::Pdf.

Yeah, I know, i should try them to see if they are any good before recommending them, and to know which to recommend if any. :)

You may have reasons for wanting to go via LaTeX though, which eludes me since I don't know LaTeX. Apologies if those are of no interest. :)

You have moved into a dark place.
It is pitch black. You are likely to be eaten by a grue.

Comment on Re: pod-latex-pdf

Replies are listed 'Best First'.
Re: Re: pod-latex-pdf by perrin (Chancellor) on Jun 20, 2002 at 22:56 UTC
You can see Pod::HtmlPsPdf in action on http://perl.apache.org/guide/ the mod_perl site. It generates this section from POD.	[reply]
Re: Re: pod-latex-pdf by axelrose (Scribe) on Jun 21, 2002 at 10:41 UTC
The reasoning behind using LaTeX is to have full control over the layout, fonts, etc. pdflatex can produce very professional output, see e.g. http://www.pragma-ade.nl for samples. Another important point is using POD for diffent type of documentation. I think the whole Perl Cookbook was written with enriched POD.	[reply]
Re(3): pod-latex-pdf by Dog and Pony (Priest) on Jun 21, 2002 at 13:57 UTC
Ah, I rather thought it might be something like that, but decided to provide what I could anyways. :) And perrin provided an excellent example on how good the result good be above (I downloaded those PDF's and it was very nice IMO). As for using POD for documentation, I wholeheartedly agree. I am trying to write more and more stuff in POD for this reason, including company docs that can be transfered to other formats. I'm not there yet, but I am trying. As for books, I don't know about the Cookbook, as I don't own it, but the Camel book says it was written entirely in POD. It is mentioned in the POD chapter among other places. So it is definetely good enough. :) As the authors say themselves: We don't claim that pod is sufficient for writing a book, although it was sufficient for writing this one. Personally, I think one of the absolute best things with POD is that it is also easy to read unprocessed. There are no other formats I know about, that is as easy. Note that I said "that I know about", though. And plain text doesn't really count either, because it doesn't contain any processing instructions. :) You have moved into a dark place. It is pitch black. You are likely to be eaten by a grue.	[reply]