Single-page POD for a distribution
I often find myself going back-and-forth between POD pages of a single distribution. (e.g. Dancer and Dancer::Cookbook.
Is there a way to get all the PODs of a distribution as a single HTML page?
Gábor Szabó - גאבור סבו
Random thoughts about programming in Perl and the people using Perl
I blog about Perl.
Free blog hosting for users of the Perl Programming Language
With multiple pages, you can open them in different browser tabs, or different terminals, and flick back and forth between them pretty easily. I'd actually expect the documentation to be harder to read if you were having to scroll up and down to alternate between reading two different sections.
A quick and dirty way to read all pod in a particular distribution as a single page is:
I'm sure you can adapt that to use your favourite Pod-to-HTML tool and browser.
If you wanted to get a bit more sophisticated, you could demote all heading levels (head3 to head4, head2 to head3, head1 to head2) and then insert additional head1 headings for each page, so that it's clear where one pod page starts and the other ends. Also, you might want to trim out repeated sections like AUTHORS, COPYRIGHT, etc.
Yeah, wouldn't a long page also make you go "back and forth" (albeit vertically)?
Yes, well I guess the advantage might be that it will be easier to search, but then maybe it would be better to have an index of all these pages with the "important" words index. Where I think "important" would be names of functions/methods/attributes.
We need someone to add a split-screen feature to $favourite_browser_here.
All versions of Opera prior to version 15 can do split screen.