Gunther Birznieks wrote:
At 09:24 PM 7/13/2002, Stas Bekman wrote:
Gunther Birznieks wrote:
I agree! It is great work. It looks really slick.
:)
Unfortunately, the mod_perl guide documentation area has lost
functionality. I wanted to download the latest guide before my 23
hour flight to the USA (to read on the flight) and was dismayed to
find hours before my flight that it is impossible to get a full HTML
or full PDF download of the entire guide anymore...
You can get a PDF of single pages (of which I don't know the
reason?), but the guide itself is quite hard.
eh? what do you mean? it's all there, go to:
http://perl.apache.org/docs/1.0/guide/index.html
click on the pdf button in the right upper corner and you get this:
http://perl.apache.org/docs/1.0/guide/guide.pdf
Notice though, that parts non-specific to mod_perl 1.0 has now moved to
http://perl.apache.org/docs/general/index.html
Oh I see it does work. I suppose the PDF buttons on every page is what
confused me though. So if you go to the front-page of the docs section,
just the front-page gets generated in a PDF, if you go to a page within
the guide, then just that section gets generated.
The only PDF icon that actually generates a full guide (and it is
inconsistent with what the rest of the website PDF icons do) is the
actually guide.pdf.
A constructive suggestion would be that the icon for PDF on the main
guide page should explicitly say PDF of entire guide or something
other than the simple PDF icons on all the other pages of the website.
Or perhaps remove the PDF icons entirely off the rest of the website.
After all, who really wants to generate a PDF of a single HTML page they
already read?
Well, if you don't want to read the PDF of a single page, that doesn't
mean that others think the same. People like reading of the paper and
not the screen.
The new site is based on docsets stacking. Each root node includes
chapters and other docsets. Each root node builds the pdf of all its
immediate leaf nodes (chapters). Each leaf (chapter) builds a pdf of
itself. Notice that root nodes do *not* include chapters included in the
nested docsets, otherwise the very root pdf will be of 50MB in size.
I don't really follow your confusion. If you read the chapter 'help' and
you click on the pdf icon you get this chapter in pdf. if you are
reading the index page and click on the pdf you get the whole thing.
It's just more flexible now than it used to be.
I guess the only confusion might be with docsets that include no
chapters, but only other docsets, so if you click on the pdf icon at
/docs/1.0/ you get an almost empty pdf. But I guess people will learn
how things work and find the infrastructure useful.
__
Stas BekmanJAm_pH -- Just Another mod_perl Hacker
http://stason.org/ mod_perl Guide --- http://perl.apache.org
mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com
http://modperlbook.org http://apache.org http://ticketmaster.com
