Sphinx documentation: define but hide heading/title text

1.5k Views Asked by At

I'm using Sphinx to document a Python package. The top of the title page / splash page holds a graphic with a logo and text for the project. This gives the visual appearance that I want, but because I have defined no top-level heading the page title metadata (which renders in the browser tab) is set to <no title> — my project name.

Is there a way I can do one of the following?

  1. Define a title text but not have it render as a heading on the page?
  2. Set the title page metadata some other way?
1

There are 1 best solutions below

1
On

You can customize the theme, overriding the part that contains the <title> tag. See Templating in the Sphinx documentation for complete information. If you have the "basic" theme, you would need to override line 130 in layout.html

    <title>{{ title|striptags|e }}{{ titlesuffix }}</title>

You can apply control structures in themes using Jinja2 templating language, in case you want to apply this feature for only one page and not others.