django/docs
Claude Paroz b4dd76c315 [5.1.x] Migrated setuptools configuration to pyproject.toml.
This branch migrates setuptools configuration from setup.py/setup.cfg to
pyproject.toml. In order to ensure that the generated binary files have
consistent casing (both the tarball and the wheel), setuptools version
is limited to ">=61.0.0,<69.3.0".

Configuration for flake8 was moved to a dedicated .flake8 file since
it cannot be configured via pyproject.toml.

Also, __pycache__ exclusion was removed from MANIFEST and the
extras/Makefile was replaced with a simpler build command.

Co-authored-by: Nick Pope <nick@nickpope.me.uk>

Backport of 4686541691 from main.
2024-06-24 22:31:17 -03:00
..
_ext Refs #29942 -- Fixed docs build on Python < 3.9 avoiding dict union operator. 2024-05-21 09:15:29 -03:00
_theme Fixed docs build with sphinxcontrib-spelling 7.5.0+. 2022-05-31 11:17:01 +02:00
faq [5.1.x] Replaced usage of "patch" with more precise terms in faq, howto, and intro docs. 2024-06-09 14:40:18 -03:00
howto [5.1.x] Replaced usage of "patch" with more precise terms in faq, howto, and intro docs. 2024-06-09 14:40:18 -03:00
internals [5.1.x] Migrated setuptools configuration to pyproject.toml. 2024-06-24 22:31:17 -03:00
intro [5.1.x] Fixed #35461 -- Updated misleading django-debug-toolbar instructions. 2024-06-21 13:20:41 +02:00
man Updated man page for Django 5.1 alpha. 2024-05-22 11:29:45 -03:00
misc Removed mention of designers in DTL design philosophy. 2024-02-01 09:20:11 +01:00
ref [5.1.x] Fixed #35306 -- Documented fallback localization formats in templates when localization is disabled. 2024-06-24 18:08:50 +02:00
releases [5.1.x] Fixed #35473 -- Fixed CVE number in security archive. 2024-06-14 14:00:31 +02:00
topics [5.1.x] Migrated setuptools configuration to pyproject.toml. 2024-06-24 22:31:17 -03:00
conf.py [5.1.x] Bumped django_next_version in docs config. 2024-05-22 11:34:04 -03:00
contents.txt
glossary.txt
index.txt [5.1.x] Replaced usage of "patch" with more precise terms in faq, howto, and intro docs. 2024-06-09 14:40:18 -03:00
make.bat Refs #34140 -- Added configurations to run blacken-docs linter and adjusted docs. 2023-03-01 13:02:57 +01:00
Makefile Refs #34140 -- Added configurations to run blacken-docs linter and adjusted docs. 2023-03-01 13:02:57 +01:00
README.rst
requirements.txt Refs #34140 -- Added configurations to run blacken-docs linter and adjusted docs. 2023-03-01 13:02:57 +01:00
spelling_wordlist Fixed #24018 -- Allowed setting pragma options on SQLite. 2024-02-16 12:59:19 +01:00

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

It uses `ReST`_ (reStructuredText), and the `Sphinx`_ documentation system.
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 ``python -m 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.

.. _ReST: https://docutils.sourceforge.io/rst.html
.. _Sphinx: https://www.sphinx-doc.org/