Beefy Boxes and Bandwidth Generously Provided by pair Networks
more useful options
 
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 (Monsignor) 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 chanting in the Monastery: (4)
As of 2015-07-06 03:00 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    The top three priorities of my open tasks are (in descending order of likelihood to be worked on) ...









    Results (69 votes), past polls