0
0
mirror of https://github.com/django/django.git synced 2024-12-01 15:42:04 +01:00
django/docs
Aymeric Augustin 80d74097b4 Stopped populating the app registry as a side effect.
Since it triggers imports, it shouldn't be done lightly.

This commit adds a public API for doing it explicitly, django.setup(),
and does it automatically when using manage.py and wsgi.py.
2013-12-30 22:11:17 +01:00
..
_ext Fixed E127 pep8 warnings. 2013-12-14 11:59:15 -05:00
_theme/djangodocs Fixed #21558 -- Support building CHM files. 2013-12-04 16:46:56 +01:00
faq Updated a bunch of hyperlinks in documentation 2013-12-08 18:40:09 +01:00
howto Used app_label instead of appname. 2013-12-28 09:53:02 +01:00
internals Refactored the migration signals to use app configs. 2013-12-29 17:53:42 +01:00
intro Stopped populating the app registry as a side effect. 2013-12-30 22:11:17 +01:00
man Used app_label instead of appname. 2013-12-28 09:53:02 +01:00
misc Whitespace cleanup. 2013-10-10 16:49:20 -04:00
ref Stopped populating the app registry as a side effect. 2013-12-30 22:11:17 +01:00
releases Stopped populating the app registry as a side effect. 2013-12-30 22:11:17 +01:00
topics Updated advice on connecting signals at startup. 2013-12-30 22:11:17 +01:00
conf.py Pointed intersphinx links to Python's default version. 2013-12-30 19:09:45 +01:00
contents.txt
glossary.txt
index.txt Documented the Apps and AppConfig APIs. 2013-12-24 17:20:11 +01:00
make.bat
Makefile Allowed overriding variables in docs/Makefile. 2013-07-29 06:51:54 -04:00
README Whitespace cleanup. 2013-10-10 16:49:20 -04:00

The documentation in this tree is in plain text files and can be viewed using
any text file viewer.

It uses ReST (reStructuredText) [1], and the Sphinx documentation system [2].
This allows it to be built into other forms for easier viewing and browsing.

To create an HTML version of the docs:

* Install Sphinx (using ``sudo pip install Sphinx`` or some other method)

* In this docs/ directory, type ``make html`` (or ``make.bat html`` on
  Windows) at a shell prompt.

The documentation in _build/html/index.html can then be viewed in a web browser.

[1] http://docutils.sourceforge.net/rst.html
[2] http://sphinx-doc.org/