django/docs
Ramiro Morales 47ddd6a408 Fixed #19552 -- Enhanced makemessages handling of ``{# #}``-style template comments.
They are simply ignored now. This allows for a more correct behavior when
they are placed before translatable constructs on the same line.

Previously, the latter were wrongly ignored because the former were
preserved when converting template code to the internal Python-syntax
form later fed to xgettext but Python has no ``/* ... */``-style
comments.

Also, special comments directed to translators are now only taken in
account when they are located at the end of a line. e.g.::

  {# Translators: ignored #}{% trans "Literal A" %}{# Translators: valid, associated with "Literal B" below #}
  {% trans "Literal B" %}

Behavior of ``{% comment %}...{% endcomment %}``tags remains unchanged.

Thanks juneih at redpill-linpro dot com for the report and Claude for
his work on the issue.
2013-01-29 19:13:23 -03:00
..
_ext
_theme/djangodocs
faq
howto Fixed #19633 - Discouraged use of gunicorn's Django integration. 2013-01-22 19:02:31 -05:00
internals Fixed typos in docs and comments 2013-01-29 10:55:55 -07:00
intro Fixed typos in docs and comments 2013-01-29 10:55:55 -07:00
man Revert "Patch by Claude for #16084." 2013-01-25 13:58:37 -03:00
misc Fixed typos in docs and comments 2013-01-29 10:55:55 -07:00
ref Fixed typos in docs and comments 2013-01-29 10:55:55 -07:00
releases Fixed #19552 -- Enhanced makemessages handling of ``{# #}``-style template comments. 2013-01-29 19:13:23 -03:00
topics Fixed #19552 -- Enhanced makemessages handling of ``{# #}``-style template comments. 2013-01-29 19:13:23 -03:00
Makefile
README Fixed #18928. Tightened language in docs/README. 2012-09-08 11:11:37 +05:30
conf.py
contents.txt
glossary.txt
index.txt Added more shortcuts to i18n docs in index page. 2013-01-25 13:50:37 -03:00
make.bat

README

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.pocoo.org/