Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl: the Markov chain saw
 
PerlMonks  

Moose::Manual in a PDF printable file

by mascip (Pilgrim)
on Apr 02, 2012 at 15:34 UTC ( #963044=perlnews: print w/ replies, xml ) Need Help??

Hello all,
I made this for myself : a PDF printable version of the Moose::Manual. I will do it for the Moose::Cookbook too.

I thought others might want to use it. Help yourself :
PDF file
and if you want to change it, here is the original :
ODT file
All critics are more than welcome, and you can make changes yourselves now.

I think (it's just my very humble opinion) that ALL Perl documentation should be provided in such a printable format, so that people like me who are hurt by screens can easily print it all. It's also easier for me to learn when i can highlight things and take notes.

I didn't know where to share it, so i just put it here for now. If anybody has a better idea, please move it or tell me where to post / send it.

Comment on Moose::Manual in a PDF printable file
Re: Moose::Manual in a PDF printable file
by perlStuck (Sexton) on Apr 02, 2012 at 15:50 UTC

      Hmmmmm... at first i thought "it's not really a Meditation"; but it's definitely a tutorial draft, for review, and there is a "meditation" inside : "ALL Perl documentation should be provided in such a printable format".

      Thank you perlStuck :-)

      Errrr.... i don't find how to post a new message in Meditations. Help ?

        Go to 'Meditations' page.
        Go to 'Add your Meditation' section at bottom of page.
        Add your meditation by pasting text into 'Meditation' text box. (Add a title, too, in the 'Title' box.)

Re: Moose::Manual in a PDF printable file
by MidLifeXis (Prior) on Apr 02, 2012 at 18:16 UTC

    See also pod pdf. It looks like there are a couple of options out there.

    --MidLifeXis

      Very nice, thank you !

      For a documentation as long as Moose's, though, it would be nice to have a full PDF version somewhere for printing purpose. The whole Moose::Manual took approx 125 pages before i shrinked it to 73 pages.

      But Pod::Pdf might make it so much faster (for me) that i might just use this for the Cookbook, and i will use it for smaller PODs.
      Yep, thank a lot, you just saved me lots of time and effort :-)
      Especially because i do this with most PODs that i have to read, unless they are very small.

      I still like the idea that i can make it more lightweight in terms of pages, though. It took me 1 hour 30 to do this, which is too long for gaining 50 pages of weight and paper sheets. But when i think that other people will also benefit from it...

      Time will tell if i will ever take the time to do it again (^c^)

        I just tried Pod::Pdf on the Recipe 1 of the Cookbook.
        It created a 10 pages document out of this simple example, 5 of which are useless.

        In comparison, a re-factoring with OOffice gives me a document of approximately 2 pages and a half : it's twice as short.

        Conclusion : i will do this re-factoring and print it here, probably tomorrow.

Re: Moose::Manual in a PDF printable file
by mascip (Pilgrim) on Apr 02, 2012 at 19:33 UTC

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: perlnews [id://963044]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others making s'mores by the fire in the courtyard of the Monastery: (13)
As of 2014-09-19 12:29 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    How do you remember the number of days in each month?











    Results (137 votes), past polls