Make HTML title fully configurable in basic/layout.html

[shimizukawa]

The current basic HTML templates don't allow full control over the title of the document. You get "title -- docstitle" whether you want it or not:

    {%- if not embedded %}
      {%- set titlesuffix = " — "|safe + docstitle|e %}
    {%- else %}
      {%- set titlesuffix = "" %}
    {%- endif %}
    <title>{{ title|striptags }}{{ titlesuffix }}</title>

For single documents with one title, you get your title repeated twice and can't really do anything. It would be nice if the <title> element was in a block so you could override it:

    {% block htmltitle %}
        {%- if not embedded %}
          {%- set titlesuffix = " — "|safe + docstitle|e %}
        {%- else %}
          {%- set titlesuffix = "" %}
        {%- endif %}
        <title>{{ title|striptags }}{{ titlesuffix }}</title>
    {&#37; block htmltitle &#37;}

---

• Bitbucket: https://bitbucket.org/birkenfeld/sphinx/issue/260
• Originally reported by: Anonymous
• Originally created at: 2009-09-24T00:49:16.394

[shimizukawa]

From Anonymous on 2009-09-23 22:51:20+00:00

Err, that should be {% endblock %} at the end there. :)

[shimizukawa]

From Georg Brandl on 2009-11-08 18:04:37+00:00

I added the "htmltitle" block in <<cset 51a1698>>.

[shimizukawa]

From Georg Brandl on 2013-03-31 13:57:31+00:00

Removing version: 0.6.3 (automated comment)