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 Bekman JAm_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
