IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity
The Sphinx documentation generator
4,150 Commits 2 Branches 219 Tags 163 MiB
Python 79.5%
JavaScript 11.5%
TeX 5.6%
Jinja 2.5%
HTML 0.6%
Other 0.2%
d1d1d9a73d
Go to file
masklinn d1d1d9a73d Add +0000 to POT-Creation-Date 
%z sets an empty string when datetimes are "naive" (no timezone
specified), but some packages expect a timezone specifier on the
POT-Creation-Date header and will error out if it is missing
(e.g. babel's pofile.read_po).

Lifted the stdlib's UTC timezone recipe and set this explicitly, it's
not the correct timezone but at least it's a timezone.

The LocalTimezone recipe might be a better one.
2013-05-28 11:30:57 +00:00
custom_fixers Rename __unicode__ to __str__ 2010-05-09 14:57:18 +02:00
doc integrate 'translationguide.rst' into 'intl.rst' 2013-04-13 18:16:48 +09:00
sphinx Add +0000 to POT-Creation-Date 2013-05-28 11:30:57 +00:00
tests Fix: Citation target missing cause AssertionError. Closes #1160 2013-05-02 10:37:12 +09:00
utils Copyright header update. 2013-04-01 11:41:48 +02:00
.hgignore Ignore files generated when building the test docs 2010-11-02 13:15:18 +01:00
.travis.yml Configure Travis CI. 2012-11-03 10:50:50 +01:00
AUTHORS Add Hernan. 2013-01-03 10:11:18 +01:00
babel.cfg Added improvements about i18n for themes "basic", "haiku" and "scrolls" that Sphinx built-in. Closes #1120 2013-03-04 10:35:30 -05:30
CHANGES Fix: Citation target missing cause AssertionError. Closes #1160 2013-05-02 10:37:12 +09:00
CHANGES.old changelog: split off older changes (pre-1.0) to a CHANGES.old file 2013-03-29 13:05:49 +01:00
distribute_setup.py Update distribute_setup.py to version 0.6.30 (http://python-distribute.org/distribute_setup.py) 2012-11-03 07:35:20 -05:00
EXAMPLES add OpenCV for EXAMPLES 2013-04-30 23:41:31 +09:00
LICENSE Copyright update. 2013-01-01 22:13:15 +01:00
Makefile Ignore japanese search: it has long lines but breaking them would be ugly. 2011-01-15 16:01:14 +01:00
MANIFEST.in Closes #809: Include custom fixers in the source distribution. 2011-11-01 21:40:52 +01:00
README.rst Update Sphinx URL to new sphinx-doc.org domain. 2012-11-04 11:28:12 +01:00
setup.cfg Add setup.py "upload" alias for automatic package signing. 2013-02-05 09:19:52 +01:00
setup.py Avoid unknown option warnings for use_2to3 in setup.py under Python 2. 2012-11-11 01:33:52 -06:00
sphinx-apidoc.py Copyright update. 2013-01-01 22:13:15 +01:00
sphinx-autogen.py Copyright update. 2013-01-01 22:13:15 +01:00
sphinx-build.py Copyright update. 2013-01-01 22:13:15 +01:00
sphinx-quickstart.py Copyright update. 2013-01-01 22:13:15 +01:00
TODO Dummy change. 2009-10-26 09:30:43 +01:00
tox.ini tox: allow insecure (no SSL) pip operation on Python 2.5 2013-03-29 19:06:24 +01:00

README.rst 

=================
README for Sphinx
=================

Installing
==========

Use ``setup.py``::

   python setup.py build
   sudo python setup.py install


Reading the docs
================

After installing::

   cd doc
   sphinx-build . _build/html

Then, direct your browser to ``_build/html/index.html``.

Or read them online at <http://sphinx-doc.org/>.


Testing
=======

To run the tests with the interpreter available as ``python``, use::

    make test

If you want to use a different interpreter, e.g. ``python3``, use::

    PYTHON=python3 make test


Contributing
============

Send wishes, comments, patches, etc. to sphinx-dev@googlegroups.com.