Opened 4 years ago

Closed 4 years ago

Last modified 4 years ago

#16863 closed Cleanup/optimization (fixed)

Multiple "invalid option block" errors when building docs

Reported by: carljm Owned by: nobody
Component: Documentation Version: master
Severity: Normal Keywords:
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no


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:`` file created by
    :djadmin:` 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.

Change History (1)

comment:1 Changed 4 years ago by carljm

  • Resolution set to fixed
  • Status changed from new to closed

In [16842]:

(The changeset message doesn't reference this ticket)

Note: See TracTickets for help on using tickets.
Back to Top