Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Some good Sphinx customization examples? [closed]

I've created a Sphinx document using sphinx-quickstart.

  1. Are there any good examples/tutorials about customizing the look? Specifically to modify the header and add a logo.

  2. Are there some projects with downloadable Sphinx docs? I would like to see how they've customized their look.

update: Adding a logo is supported in the default setup, just not particularly well documented. Look in conf.py for the *_logo settings.`

like image 417
Mark Harrison Avatar asked Jan 16 '10 00:01

Mark Harrison


People also ask

Who uses Sphinx?

Google Drive, Dropbox, Zapier, Google Chrome, and DevDocs are some of the popular tools that integrate with Sphinx. Here's a list of all 5 tools that integrate with Sphinx.


2 Answers

Have a look at some of these themes. As the projects are open source you should be able to examine them closely.

like image 164
Vinay Sajip Avatar answered Nov 05 '22 22:11

Vinay Sajip


Time to start collecting links.

  • https://github.com/coordt/ADCtheme - Apple-like
  • https://github.com/mitsuhiko/flask-sphinx-themes - Flask
  • http://loose-bits.com/2012/11/19/sphinx-bootstrap-theme-updates.html - Twitter Bootstrap
  • https://github.com/snide/sphinx_rtd_theme - Theme of Read the Docs
  • https://github.com/bitprophet/alabaster - Based on the Flask
  • https://gitlab.com/documatt/sphinx-themes - themes collection for tech writing
like image 41
3 revs, 3 users 77% Avatar answered Nov 05 '22 22:11

3 revs, 3 users 77%