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
3,671 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%
1dbb40cb5c
Go to file
Kouhei Sutou 1dbb40cb5c Use term in description list as translation message 
Here is a .rst that reproduces the problem fixed by this changes:

  term-word
    description-paragraph

"description-paragraph" is extracted as translation message by
"sphinx-build -b gettext" but "term-word" isn't.

It's because nodes.term node doesn't have source information.
Source information should be added by Docutils instead of Sphinx.

A patch that fix this problem in Doctuils had been submitted:
https://sourceforge.net/tracker/?func=detail&aid=3548418&group_id=38414&atid=422032

This changes are workarond to work with docutils-0.9.1 or earlier.
2012-07-26 00:40:40 +09:00
custom_fixers Rename __unicode__ to __str__ 2010-05-09 14:57:18 +02:00
doc Doc change for d7ac5e46307d 2012-05-08 12:51:28 +02:00
sphinx Use term in description list as translation message 2012-07-26 00:40:40 +09:00
tests fix some testing. 2012-05-01 15:21:12 +09:00
utils merge with 1.0 2011-01-04 11:29:09 +01:00
.hgignore Ignore files generated when building the test docs 2010-11-02 13:15:18 +01:00
AUTHORS Add attribution for 9b4e41bba142. 2011-09-17 20:53:44 +02:00
babel.cfg Update POT file for new template locations. 2009-05-22 18:19:30 +02:00
CHANGES Changelog entry for d7ac5e46307d 2012-05-08 12:48:25 +02:00
distribute_setup.py update distribute_setup.py from http://python-distribute.org/distribute_setup.py 2010-06-15 23:16:33 +02:00
EXAMPLES Merge with 1.0 2011-09-23 22:03:34 +02:00
LICENSE Closes #724: Add license for Underscore.js. 2011-06-28 20:37:29 +02: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 edited and renamed the README so it's rendered properly on Bitbucket 2012-03-07 14:05:47 -08:00
setup.cfg Teach babel to extract l_() messages. 2009-07-03 13:37:38 +02:00
setup.py Pre-release updates. 2011-10-09 23:25:40 +02:00
sphinx-apidoc.py #98: Add autopackage script. (Undocumented for now.) 2011-01-04 19:20:22 +01:00
sphinx-autogen.py New year update. 2011-01-04 10:00:51 +01:00
sphinx-build.py New year update. 2011-01-04 10:00:51 +01:00
sphinx-quickstart.py New year update. 2011-01-04 10:00:51 +01:00
TODO Dummy change. 2009-10-26 09:30:43 +01:00
tox.ini fix some testing. 2012-05-01 15:21:12 +09: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.pocoo.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.