GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Furo

This view

  • Original page
  • New address

GeezerVison is showing pradyunsg.me — Customisation - Furo

Customisation¶

Furo supports customisation of the theme’s overall look and feel (through theme options) as well as a few per-page tweaks.

This section serves to guide the user with customising Furo-based documentation. This page lists all the theme-specific customisations, as provided by this theme. Other pages in this section provide guidance for making specific customisations when using Sphinx with Furo.

Theme options¶

html_theme_options in conf.py is used for customisations that affect the entire documentation. This is for stuff like fonts and colors. While this theme inherits some options from the built-in basic Sphinx theme, only the ones documented here are supported.

light_css_variables / dark_css_variables¶

Added in version 2020.08.14.beta5.

Changed in version 2020.11.01.beta14: Support for dark mode involved replacing css_variables with light_css_variables / dark_css_variables.

Furo makes extensive use of CSS variables. These can be overridden by the user and are used for stylizing nearly all elements of the documentation. Changing colors contains important details of how these variables are used.

Setting *_css_variables is the recommended mechanism to override Furo’s default values for these variables.

html_theme_options = {
    "light_css_variables": {
        "color-brand-primary": "red",
        "color-brand-content": "#CC3333",
        "color-admonition-background": "orange",
    },
}

Caution

Typos in the *_css_variables dictionary are silently ignored, and do not raise any errors or warnings. Double check that your spellings and values are correct and valid.

sidebar_hide_name¶

Added in version 2020.08.14.beta5.

Controls whether you see the project’s name in the sidebar of the documentation. This is useful when you only want to show your documentation’s logo in the sidebar. The default is False.

html_theme_options = {
    "sidebar_hide_name": True,
}

navigation_with_keys¶

Added in version 2020.11.01.beta14.

Controls whether the user can navigate the documentation using the keyboard’s left and right arrows. The default is False.

html_theme_options = {
    "navigation_with_keys": True,
}

top_of_page_button¶

Added in version 2022.06.04.

Deprecated since version 2024.05.06: This will be removed after 2024-11-01. Use top_of_page_buttons instead.

Controls which button is shown on the top of the page. The only supported values are "edit" (the default) and None.

html_theme_options = {
    "top_of_page_button": "edit",
}

top_of_page_buttons¶

Added in version 2024.05.06.

Controls which buttons are shown on the top of the page. This is a list which can be empty or contain one-or-more of the following values:

  • "edit"

  • "view"

html_theme_options = {
    "top_of_page_buttons": ["view", "edit"],
}

announcement¶

Added in version 2020.12.28.beta22.

Add a site-wide announcement, to the top of every page when set. See Adding an announcement banner for the details.

footer_icons¶

Added in version 2022.02.14.

Changes the icons presented in the site footer. See Changing footer icons for the details.

is_rtl¶

Enables right-to-left layout for languages such as Arabic, Persian, and Hebrew. The default is False. Set this option independently of Sphinx’s language setting.

html_theme_options = {
    "is_rtl": True,
}

See Changing text and layout to right-to-left for configuration and details of how content is displayed.

Page specific tweaks¶

File-Wide metadata is used for per-page customisation, primarily for controlling which UI elements are presented.

hide-toc¶

Added in version 2020.08.14.beta5.

The “Contents” sidebar is automatically hidden for any pages that don’t have any inner headings. It is possible to hide it even when a page has inner headings, by setting hide-toc at the page level. See Hiding Contents sidebar for an example.

Custom CSS files¶

If you want more control than what is provided by the above theme options, see Injecting code.

You are visitor 01402639 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.