sphinx-contrib /

Filename Size Date modified Message
_template
aafig
actdiag
adadomain
ansi
autoprogram
autorun
blockdiag
cheeseshop
clearquest
cmakedomain
coffeedomain
context
domaintools
doxylink
email
erlangdomain
exceltable
feed
findanything
gnuplot
googleanalytics
googlechart
googlemaps
httpdomain
hyphenator
inlinesyntaxhighlight
lassodomain
lilypond
makedomain
matlabdomain
mockautodoc
mscgen
napoleon
nicovideo
nwdiag
omegat
osaka
phpdomain
plantuml
py_directive
rawfiles
requirements
restbuilder
rubydomain
sadisplay
sdedit
seqdiag
slide
swf
sword
tikz
traclinks
whooshindex
youtube
zopeext
381 B
ignore eclipse and pydev dot files
11.1 KB
Added tag httpdomain-1.2.1 for changeset d4fcfb31ac92
2.5 KB
WIP: autoprogram
1.4 KB
Add initial file infrastructure.
7.3 KB
Link sphinxcontrib-autoprogram docs
9.5 KB
Add initial file infrastructure.
1.0 KB
Fixes make-ext.py to use _template/README.rst instead of _template/README

README for sphinx-contrib

This repository contains a collection of Sphinx extensions maintained by their respective authors. It is not an official part of Sphinx.

Installing

Use setup.py in the subdirectory for the individual extension:

cd dir
python setup.py build
sudo python setup.py install

Contributing

If you want to add your own extension, please write an e-mail to georg@python.org and give your bitbucket user name; you will then get write access to the public repo at http://bitbucket.org/birkenfeld/sphinx-contrib.

Send wishes, comments, patches, etc. for individual extensions to their author as given in the module.

List of extensions

  • aafig: render embedded ASCII art as nice images using aafigure.
  • actdiag: embed activity diagrams by using actdiag
  • adadomain: an extension for Ada support (Sphinx 1.0 needed)
  • ansi: parse ANSI color sequences inside documents
  • autoprogram: documenting CLI programs
  • autorun: Execute code in a runblock directive.
  • blockdiag: embed block diagrams by using blockdiag
  • cheeseshop: easily link to PyPI packages
  • clearquest: create tables from ClearQuest queries.
  • cmakedomain: a domain for CMake
  • coffeedomain: a domain for (auto)documenting CoffeeScript source code.
  • context: a builder for ConTeXt.
  • doxylink: Link to external Doxygen-generated HTML documentation
  • domaintools: A tool for easy domain creation.
  • email: obfuscate email addresses
  • erlangdomain: an extension for Erlang support (Sphinx 1.0 needed)
  • exceltable: embed Excel spreadsheets into documents using exceltable
  • feed: an extension for creating syndication feeds and time-based overviews from your site content
  • findanything: an extension to add Sublime Text 2-like findanything panels to your documentation to find pages, sections and index entries while typing
  • gnuplot: produces images using gnuplot language.
  • googleanalytics: track web visitor statistics by using Google Analytics
  • googlechart: embed charts by using Google Chart
  • googlemaps: embed maps by using Google Maps
  • httpdomain: a domain for documenting RESTful HTTP APIs.
  • hyphenator: client-side hyphenation of HTML using hyphenator
  • inlinesyntaxhighlight: inline syntax highlighting
  • lassodomain: a domain for documenting Lasso source code
  • lilypond: an extension inserting music scripts from Lilypond in PNG format.
  • makedomain: a domain for GNU Make
  • matlabdomain: document MATLAB and GNU Octave code.
  • mockautodoc: mock imports.
  • mscgen: embed mscgen-formatted MSC (Message Sequence Chart)s.
  • napoleon: supports Google style and NumPy style docstrings.
  • nicoviceo: embed videos from nicovideo
  • nwdiag: embed network diagrams by using nwdiag
  • omegat: support tools to collaborate with OmegaT (Sphinx 1.1 needed)
  • osaka: convert standard Japanese doc to Osaka dialect (it is joke extension)
  • paverutils: an alternate integration of Sphinx with Paver.
  • phpdomain: an extension for PHP support
  • plantuml: embed UML diagram by using PlantUML
  • py_directive: Execute python code in a py directive and return a math node.
  • rawfiles: copy raw files, like a CNAME.
  • requirements: declare requirements wherever you need (e.g. in test docstrings), mark statuses and collect them in a single list
  • restbuilder: a builder for reST (reStructuredText) files.
  • rubydomain: an extension for Ruby support (Sphinx 1.0 needed)
  • sadisplay: display SqlAlchemy model sadisplay
  • sdedit: an extension inserting sequence diagram by using Quick Sequence Diagram Editor (sdedit)
  • seqdiag: embed sequence diagrams by using seqdiag
  • slide: embed presentation slides on slideshare and other sites.
  • swf: embed flash files
  • sword: an extension inserting Bible verses from Sword.
  • tikz: draw pictures with the TikZ/PGF LaTeX package.
  • traclinks: create TracLinks to a Trac instance from within Sphinx
  • whooshindex: whoosh indexer extension
  • youtube: embed videos from YouTube
  • zopeext: provide an autointerface directive for using Zope interfaces.

For contributors

When adding or updating your extension, please adhere to these guidelines:

  • Use make-ext.py to set up your extension subdirectory.
  • Each extension must be either a submodule or subpackage of the sphinxcontrib package. The sphinxcontrib/__init__.py file in your package must not be changed.
  • Each extension must be listed in this file under "List of extensions" above.
  • Each author should be listed in AUTHORS along with the extension name.
  • It would be good to have all extensions BSD licensed; otherwise make a note in an ext/LICENSE file.
  • Each extension can maintain a changelog and readme file; these files should be called ext/CHANGES and ext/README.rst, respectively.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.