Refreshing this old thread - hope that's not taboo. Finally got a chance to read up on python and modify a recipe. Here's a simple one that grabs the Doctrine2 documentation
Now I'm wondering how to make calibre format this as a normal book and not a collection of 'articles'. While the article navigation makes sense for real periodicals/blogs/news feeds, I'd prefer a standard TOC for converted documentation.