Re: [lxml-dev] Generating PDF documentation
Hi, Marcin Kasperski wrote:
If there are no objection, I'll just add the generated PDF to the source release, that's not even 1MB more.
I'd suggest distributing PDF separately (and linking it from the website so it is easily available). PDFs aren't compressing too well.
The PDF gzips from 900KB down to 600KB, so that's not too much in addition. On the other hand, many people just use easy_install or a buildout to grab the tar.gz, so they won't benefit from the docs at all. We currently have a source distribution of a bit less than 2MB. Most of that is generated HTML documentation (gzipped 1.1MB, mainly the API docs). If we removed everything that easy_install doesn't use, maybe even the test suites, I guess we would be down to some 600KB, including the generated C source. We could still provide a complete tar.gz for download, maybe next to the plain source on PyPI, or just from the lxml homepage. It's harder to do, though, as I don't think distutils supports this without a little setup.py tweaking. Any opinions on this?
And - especially - some people who do not use source release may find use for PDF ;-)
Sure, I didn't say it wouldn't show up on the web page. Stefan
participants (4)
-
Marcin Kasperski
-
Martijn Faassen
-
Stefan Behnel
-
Tres Seaver