#16863: Multiple "invalid option block" errors when building docs
-------------------------------------+-------------------------------------
Reporter: carljm | Owner: nobody
Type: | Status: new
Cleanup/optimization | Component:
Milestone: | Documentation
Version: SVN | Severity: Normal
Keywords: | Triage Stage:
Has patch: 0 | Unreviewed
Needs tests: 0 | Needs documentation: 0
Easy pickings: 0 | Patch needs improvement: 0
| UI/UX: 0
-------------------------------------+-------------------------------------
Using Sphinx 1.07, I get 8 errors like this on a fresh docs build:
{{{
/home/carljm/projects/django/django/django-
git/docs/topics/i18n/localization.txt:262: (ERROR/3) Error in "note"
directive:
invalid option block.
.. note::
The default :file:`settings.py` file created by
:djadmin:`django-admin.py startproject <startproject>` includes
:setting:`USE_L10N = True <USE_L10N>` for convenience.
}}}
I think it's from lines beginning with a colon inside a directive (usually
`.. note` or `.. warning`), which Sphinx is trying to interpret as option
blocks for that directive.
If there's a way we could just turn that error off, that'd be nice.
Otherwise we should probably fix these cases manually and try to avoid
introducing new ones, it's a barrier to new docs contributors to have a
bunch of "known errors" in the docs build.
--
Ticket URL: <https://code.djangoproject.com/ticket/16863>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/django-updates?hl=en.
