Thomas Klausner wrote:
- now every document has a PDF version (before that there were only pdf's of the docsets), so now you can download a pdf of a single document or the whole set as one doc.
+1
I was allready wondering how to get a PDF of the whole guide...
As I replied to Thomas enquiry you need to run bin/build -df (-f added) to get the pdf rendered. pdfs rendering is a very slow operation, so by default we don't want it, and use it only for production.
Also notice that docset supports hidden documents. e.g. we have:
Great, so we can add a "How this site is done" page without it showing up in the main NavBar
yup :) and we can link to it from the tail widget.
Comments are welcome.
No Problems installing and building the new version. Only one thing: There are no tests ... At the last YAOC::Europe, Michael G. Schwern gave a rather amusing and convincing talk to actually /use/ them. But - as everybody knows, but denies to confess - writing tests sort of sucks.
I don't deny it, I write lots of tests where I can, e.g. see the work on mod_perl 2.0 and the huge guide on how to write tests :)
http://www.apache.org/~stas/modperl-site/docs/2.0/devel/testing/testing.html
And I've been to Schwern's talk at the last OSC.
But, for this kind of app (DocSet) it's very hard to write tests since it's not a set of functions but a whole engine that generates something in the end. If any of you are willing to help me with this it'd be fantastic. So far the only test I have is running the DocSet on the example directory in the DocSet distro.
I guess what you could do is to generate a sample and compare it against a known correctly rendered output. Similar to what template toolkit tests do, but on the big scale.
_____________________________________________________________________ Stas Bekman JAm_pH -- Just Another mod_perl Hacker http://stason.org/ mod_perl Guide http://perl.apache.org/guide mailto:[EMAIL PROTECTED] http://ticketmaster.com http://apacheweek.com http://singlesheaven.com http://perl.apache.org http://perlmonth.com/
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
