Hacker News Reader

Comment by smiley325 | Hacker News Reader

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?

View 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.

http://pocoo.org

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.

My modification of the Flask theme is available here:

    https://github.com/kennethreitz/kr-sphinx-themes

The original is here:

    https://github.com/mitsuhiko/flask-sphinx-themes

I 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">`).

It's pulling in a copy of the css file the flask site uses.

Reply on news.ycombinator.com