Theme Appearance Options

The following options control the appearance of the theme. You don't need to pay attention to them in most cases, they are only provided for a small amount of users with needs.

Warning

These options are only valid when setting directly under the theme options, setting them in each language as no effect.

iconAssets Root only

• Type: FontIconAssets

  type Link =
    | `/${string}`
    | `//${string}`
    | `http://${string}`
    | `https://${string}`;
  
  type BuiltInFontIcon = "iconify" | "fontawesome" | "fontawesome-with-brands";
  
  type FontIconAssets = BuiltInFontIcon | Link | (BuiltInFontIcon | Link)[];

• Required: No

• Details: Interface → Icon

Link of font icon asset, 'iconify' 'fontawesome' and 'fontawesome-with-brands' keywords are supported.

darkmode Enabled by default Root only

• Type: "switch" | "toggle" | "auto" | "enable" | "disable"
• Default: "switch"
• Details: Interface → Darkmode

Dark mode support options:

• "switch": switch between dark, light and auto
• "toggle": toggle between lightmode and darkmode
• "auto": Automatically decide whether to apply dark mode based on user device's color-scheme or current time
• "enable": only dark mode
• "disable": disable dark mode

Note

If you don't need this feature, set darkmode: "disable" to disable it.

externalLinkIcon enabled by default

• Type: boolean
• Default: true

Controls whether an icon is displayed on external links.

fullscreen Root only

• Type: boolean
• Default: false
• Details: Interface → FullScreen

Whether show the "full screen" button.

pure Root only

• Type: boolean
• Default: false
• Details: Interface → Pure mode

Whether enable pure mode.

Tips

Enabling this will disable some of the fancy styles.

Useful when you want to provide "A pure document site".

print Root only

• Type: boolean
• Default: true

Whether display print icon in desktop mode.

iconPrefix Root only

• Type: string
• Default: Inferred from iconAssets
• Details: Interface → Icon

Prefix of icon FontClass, usually, it can be automatically set by the theme.