Skip to main content

Custom Fonts

Some areas of the theme use third-party CJK fonts for design. Because CJK font files are large, the theme extracts and packages only the glyphs actually used into a subset font.

Toggle via the zh_font config option.

zh_font:
  enable: true
  fontName: sourceHanSerif
  type: ttf
  style:
    - normal
    - bold

You can replace the font files under the _font/ directory with your own preferred fonts.

Font loading optimization​

The theme optimizes loading of custom subset fonts to reduce FOUT (flash of unstyled text) and speed up text rendering:

  • font-display: swap: system fonts render text first while the custom font loads, then seamlessly swap in — avoiding long blank periods.
  • <link rel="preload">: the first font file is preloaded at high priority, fetched in parallel with CSS to shorten the critical rendering path.
  • Font subsetting: only the glyphs actually used are packaged, dramatically reducing font size.

No configuration needed — applied automatically when zh_font.enable: true is set.