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
