Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

Yanick (3196)

Yanick
  (email not shown publicly)
http://babyl.dyndns.org/techblog

Journal of Yanick (3196)

Saturday July 14, 2007
08:27 PM

Pod::Manual

[ #33807 ]

A while ago, I hacked together a way to gather many pod files into a single pdf file. Well, finally I got around cleaning up the code and released it as Pod::Manual.

It's still very muchly alpha quality, but the basics seem to work. For example, the following works (at least on my machine)[*]:

use Pod::Manual;

my $manual = Pod::Manual->new({ title => 'Catalyst' });

$manual->add_chapter( $_ ) for qw/
    Catalyst::Manual::About
    Catalyst::Manual::Actions
    Catalyst::Manual::Cookbook
    Catalyst::Manual::DevelopmentProcess
    Catalyst::Manual::Internals
    Catalyst::Manual::Intro
    Catalyst::Manual::Plugins
    Catalyst::Manual::Tutorial
    Catalyst::Manual::Tutorial::Intro
    Catalyst::Manual::Tutorial::CatalystBasics
    Catalyst::Manual::Tutorial::BasicCRUD
    Catalyst::Manual::Tutorial::Authentication
    Catalyst::Manual::Tutorial::Authorization
    Catalyst::Manual::Tutorial::Debugging
    Catalyst::Manual::Tutorial::Testing
    Catalyst::Manual::Tutorial::AdvancedCRUD
    Catalyst::Manual::Tutorial::Appendices
    Catalyst::Manual::WritingPlugins
/;

$manual->save_as_pdf( 'catalyst_manual.pdf' );

At this stage of the game, bug reports and feature requests would be very welcome. As well as suggestions for other example manuals.

[*] caveat: for the moment you need TeTeX installed to generate pdf documents. One of the items on my todo list is to allow for other means to generate the pdf (jadetex, FOP, etc)

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • You can use groff for this sort of thing.

      % for pod in File::Basename File::Path
      > do
      >   perldoc -n groff $pod
      > done > pods.ps
    That gets you a postscript file, pods.ps, which you can convert to PDF simply using ps2pdf (or pstopdf on a mac).
    • Oh, but it's not the PDF conversion per se that is the problem. Rather, it's the PDF conversion with all sort of printed media goodiness (table of content, numbered pages, headers, index, etc).