Re:Requests: HTTP for Humans
by smiley325 on Saturday August 13, 2011 @11:02PM
(#2882658)
I've noticed that the layout of the site is uncannily similar to flask's documentation (http://flask.pocoo.org/docs/), down to the "Fork me on Github" in the top right corner. Is there some sort of software producing this kind of documentation?
[ Parent
| on HN ]
Yes. They're both created using Sphinx: http://sphinx.pocoo.org/
Requests is hosted on a site called Read the Docs, which does documentation hosting for Sphinx projects: http://readthedocs.org/
Sphinx has become the defacto documentation tool for Python projects, and a lot of other projets as well. Notably a number of PHP projects, and Varnish the web cache use it also.
It should also be noted that Sphinx was developed by Pocoo, the same group that develops Flask, Jinja, Werkzeug.
Re:Requests: HTTP for Humans
by lightcatcher on Sunday August 14, 2011 @04:43PM
(#2884403)
And also Pygments (probably the most popular syntax highlighting libraries) and they run http://paste.pocoo.org/ , an excellent pastebin.
http://www.pocoo.org/projects/#project-hub shows all of their projects. Pocoo significantly improves the lives of all Python developers. Thanks pocoo team!
The "Fork me on Github" is pretty common on a lot of sites (Github made those graphics), but that aside I agree -- I was thinking it was another Pocoo project until I saw the author.
Looks like he just co-opted the theme (Pocoo might have it available somewhere, but I couldn't find it). Nothing wrong with that, it's a great theme.
Re:Requests: HTTP for Humans
by kenneth_reitz on Sunday August 14, 2011 @11:02AM
(#2883779)
My modification of the Flask theme is available here:
https://github.com/kennethreitz/kr-sphinx-themes
https://github.com/mitsuhiko/flask-sphinx-themesI don't have much more info than this, but it looks like they're both generated with Sphinx (http://sphinx.pocoo.org/), going by the footer from flask, and the common source (both have `<div class="sphinxsidebar">`).