<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>Overview — Sphinx 1.1.3 documentation</title> <link rel="stylesheet" href="_static/sphinxdoc.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '', VERSION: '1.1.3', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true }; </script> <script type="text/javascript" src="_static/jquery.js"></script> <script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/doctools.js"></script> <link rel="search" type="application/opensearchdescription+xml" title="Search within Sphinx 1.1.3 documentation" href="_static/opensearch.xml"/> <link rel="top" title="Sphinx 1.1.3 documentation" href="#" /> <style type="text/css"> table.right { float: right; margin-left: 20px; } table.right td { border: 1px solid #ccc; } </style> </head> <body> <div style="background-color: white; text-align: left; padding: 10px 10px 15px 15px"> <img src="_static/sphinx.png" alt="Sphinx logo" /> </div> <div class="related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="genindex.html" title="General Index" accesskey="I">index</a></li> <li class="right" > <a href="py-modindex.html" title="Python Module Index" >modules</a> |</li> <li><a href="#">Sphinx home</a> | </li> <li><a href="contents.html">Documentation</a> »</li> </ul> </div> <div class="sphinxsidebar"> <div class="sphinxsidebarwrapper"><p class="logo"><a href="http://pocoo.org/"> <img src="_static/pocoo.png" /></a></p> <h3>Download</h3> <p>Current version: <b>1.1.3</b></p> <p>Get Sphinx from the <a href="http://pypi.python.org/pypi/Sphinx">Python Package Index</a>, or install it with:</p> <pre>easy_install -U Sphinx</pre> <p>Latest <a href="http://sphinx.pocoo.org/latest/">development version docs</a> are also available.</p> <h3>Questions? Suggestions?</h3> <p>Join the <a href="http://groups.google.com/group/sphinx-dev">Google group</a>:</p> <form action="http://groups.google.com/group/sphinx-dev/boxsubscribe" style="padding-left: 1em"> <input type="text" name="email" value="your@email"/> <input type="submit" name="sub" value="Subscribe" /> </form> <p>or come to the <tt>#pocoo</tt> channel on FreeNode.</p> <p>You can also open an issue at the <a href="http://www.bitbucket.org/birkenfeld/sphinx/issues/">tracker</a>.</p> <div id="searchbox" style="display: none"> <h3>Quick search</h3> <form class="search" action="search.html" method="get"> <input type="text" name="q" /> <input type="submit" value="Go" /> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> <p class="searchtip" style="font-size: 90%"> Enter search terms or a module, class or function name. </p> </div> <script type="text/javascript">$('#searchbox').show(0);</script> </div> </div> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body"> <h1>Welcome</h1> <div class="quotebar"> <p><em>What users say:</em></p> <p>“Cheers for a great tool that actually makes programmers <b>want</b> to write documentation!”</p> </div> <p> Sphinx is a tool that makes it easy to create intelligent and beautiful documentation, written by Georg Brandl and licensed under the BSD license.</p> <p>It was originally created for <a href="http://docs.python.org/">the new Python documentation</a>, and it has excellent facilities for the documentation of Python projects, but C/C++ is already supported as well, and it is planned to add special support for other languages as well. Of course, this site is also created from reStructuredText sources using Sphinx! </p> <p> Sphinx is under constant development. The following features are present, work fine and can be seen “in action” in the Python docs: </p> <ul> <li><b>Output formats:</b> HTML (including Windows HTML Help), LaTeX (for printable PDF versions), manual pages, plain text</li> <li><b>Extensive cross-references:</b> semantic markup and automatic links for functions, classes, citations, glossary terms and similar pieces of information</li> <li><b>Hierarchical structure:</b> easy definition of a document tree, with automatic links to siblings, parents and children</li> <li><b>Automatic indices:</b> general index as well as a module index</li> <li><b>Code handling:</b> automatic highlighting using the <a href="http://pygments.org">Pygments</a> highlighter</li> <li><b>Extensions:</b> automatic testing of code snippets, inclusion of docstrings from Python modules (API docs), and more</li> </ul> <p> Sphinx uses <a href="http://docutils.sf.net/rst.html">reStructuredText</a> as its markup language, and many of its strengths come from the power and straightforwardness of reStructuredText and its parsing and translating suite, the <a href="http://docutils.sf.net/">Docutils</a>. </p> <h2>Documentation</h2> <table class="contentstable" align="center" style="margin-left: 30px"><tr> <td width="50%"> <p class="biglink"><a class="biglink" href="tutorial.html">First steps with Sphinx</a><br/> <span class="linkdescr">overview of basic tasks</span></p> <p class="biglink"><a class="biglink" href="contents.html">Contents</a><br/> <span class="linkdescr">for a complete overview</span></p> </td><td width="50%"> <p class="biglink"><a class="biglink" href="search.html">Search page</a><br/> <span class="linkdescr">search the documentation</span></p> <p class="biglink"><a class="biglink" href="genindex.html">General Index</a><br/> <span class="linkdescr">all functions, classes, terms</span></p> </td></tr> </table> <p> You can also download PDF versions of the Sphinx documentation: a <a href="http://sphinx.pocoo.org/sphinx.pdf">version</a> generated from the LaTeX Sphinx produces, and a <a href="http://sphinx.pocoo.org/sphinx-rst2pdf.pdf">version</a> generated by rst2pdf. </p> <h2>Examples</h2> <p>Links to documentation generated with Sphinx can be found on the <a href="examples.html">Projects using Sphinx</a> page. </p> <p> For examples of how Sphinx source files look, use the “Show source” links on all pages of the documentation apart from this welcome page. </p> <p>You may also be interested in the very nice <a href="http://matplotlib.sourceforge.net/sampledoc/">tutorial</a> on how to create a customized documentation using Sphinx written by the matplotlib developers.</p> <p>There is a <a href="http://sphinx-users.jp/doc10/">Japanese translation</a> of this documentation, thanks to Yoshiki Shibukawa.</p> <h2>Get Sphinx</h2> <p> Sphinx is available as an <a href="http://peak.telecommunity.com/DevCenter/EasyInstall">easy-install</a>able package on the <a href="http://pypi.python.org/pypi/Sphinx">Python Package Index</a>. </p> <p>The code can be found in a Mercurial repository, at <tt>http://bitbucket.org/birkenfeld/sphinx/</tt>.</p> </div> </div> </div> <div class="clearer"></div> </div> <div class="related"> <h3>Navigation</h3> <ul> <li class="right" style="margin-right: 10px"> <a href="genindex.html" title="General Index" >index</a></li> <li class="right" > <a href="py-modindex.html" title="Python Module Index" >modules</a> |</li> <li><a href="#">Sphinx home</a> | </li> <li><a href="contents.html">Documentation</a> »</li> </ul> </div> <div class="footer"> © Copyright 2007-2011, Georg Brandl. Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3. </div> </body> </html>