[Django]: reSTのdoctitle_xformを無効にする

Djangoのmarkup::reStructuredTextで「最上位レベルに位置するテキストが唯一かつ冒頭にある場合にinitial_header_levelの影響を受けない」のを無効にするには`settings.py`で、

RESTRUCTUREDTEXT_FILTER_SETTINGS = {
    'doctitle_xform': False,
}

と書く。詳細は、`django.contrib.markup.templatetags.markup.py`の50行目あたり。

def restructuredtext(value):
 try:
   from docutils.core import publish_parts
 except ImportError:
   if settings.DEBUG:
     raise template.TemplateSyntaxError, \
       "Error in {% restructuredtext %} filter: The Python docutils library isn't installed."
   return value
 else:
   docutils_settings = getattr(settings, "RESTRUCTUREDTEXT_FILTER_SETTINGS", {})
   parts = publish_parts(source=value, writer_name="html4css1", settings_overrides=docutils_settings)
   return parts["fragment"]

Ref

Downward::Spiral

django markup