mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2026-09-03 20:52:55 -05:00
New doc design "sphinx13".
This commit is contained in:
Vendored
+7
-19
@@ -17,25 +17,23 @@
|
||||
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:
|
||||
Sphinx! The following features should be highlighted:
|
||||
</p>
|
||||
<ul>
|
||||
<li><b>Output formats:</b> HTML (including Windows HTML Help), LaTeX (for
|
||||
printable PDF versions), manual pages, plain text</li>
|
||||
printable PDF versions), Texinfo, 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>Automatic indices:</b> general index as well as a language-specific
|
||||
module indices</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>
|
||||
docstrings from Python modules (API docs), and
|
||||
<a href="{{ pathto('ext') }}">more</a></li>
|
||||
</ul>
|
||||
<p>
|
||||
Sphinx uses <a href="http://docutils.sf.net/rst.html">reStructuredText</a>
|
||||
@@ -44,7 +42,7 @@
|
||||
suite, the <a href="http://docutils.sf.net/">Docutils</a>.
|
||||
</p>
|
||||
|
||||
<h2>Documentation</h2>
|
||||
<h2 style="margin-bottom: 0">Documentation</h2>
|
||||
|
||||
<table class="contentstable" align="center" style="margin-left: 30px"><tr>
|
||||
<td width="50%">
|
||||
@@ -86,14 +84,4 @@
|
||||
<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>
|
||||
|
||||
{% endblock %}
|
||||
|
||||
Vendored
+8
-7
@@ -1,5 +1,5 @@
|
||||
<p class="logo"><a href="http://pocoo.org/">
|
||||
<img src="{{ pathto("_static/pocoo.png", 1) }}" /></a></p>
|
||||
<p class="logo">A <a href="http://pocoo.org/">
|
||||
<img src="{{ pathto("_static/pocoo.png", 1) }}" /></a> project</a></p>
|
||||
|
||||
<h3>Download</h3>
|
||||
{% if version.endswith('(hg)') %}
|
||||
@@ -20,11 +20,12 @@ 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" />
|
||||
<p>Join the <a href="http://groups.google.com/group/sphinx-users">Google group</a>:</p>
|
||||
<form action="http://groups.google.com/group/sphinx-users/boxsubscribe"
|
||||
style="padding-left: 0.5em">
|
||||
<input type="text" name="email" value="your@email" style="font-size: 90%; width: 120px"
|
||||
onfocus="$(this).val('');"/>
|
||||
<input type="submit" name="sub" value="Subscribe" style="font-size: 90%; width: 70px"/>
|
||||
</form>
|
||||
<p>or come to the <tt>#pocoo</tt> channel on FreeNode.</p>
|
||||
<p>You can also open an issue at the
|
||||
|
||||
Vendored
-23
@@ -1,23 +0,0 @@
|
||||
{% extends "!layout.html" %}
|
||||
|
||||
{% block extrahead %}
|
||||
{{ super() }}
|
||||
{%- if not embedded %}
|
||||
<style type="text/css">
|
||||
table.right { float: right; margin-left: 20px; }
|
||||
table.right td { border: 1px solid #ccc; }
|
||||
</style>
|
||||
{%- endif %}
|
||||
{% endblock %}
|
||||
|
||||
{% block rootrellink %}
|
||||
<li><a href="{{ pathto('index') }}">Sphinx home</a> | </li>
|
||||
<li><a href="{{ pathto('contents') }}">Documentation</a>
|
||||
»</li>
|
||||
{% endblock %}
|
||||
|
||||
{% block header %}
|
||||
<div style="background-color: white; text-align: left; padding: 10px 10px 15px 15px">
|
||||
<img src="{{ pathto("_static/sphinx.png", 1) }}" alt="Sphinx logo" />
|
||||
</div>
|
||||
{% endblock %}
|
||||
Reference in New Issue
Block a user