SphinxでPDFを出力したときにヘッダー、フッターが表示されない

備忘録

環境

Sphinx 7.2.6
TeX Live 2023

問題

SphinxでPDFを出力すると
目次や章が始まったページでヘッダーやフッターが表示されなくなる。
見栄えがよろしくないので調査することに

解決

調べていくと日本語に設定した場合のみこの症状が発生することがわかった。
そこでjsbook.clsを調べていくと次のような記述があった。

jsbook.cls

\def\plainifnotempty{%
  \ifx \@oddhead \@empty
    \ifx \@oddfoot \@empty
    \else
      \thispagestyle{plainfoot}%
    \fi
  \else
    \thispagestyle{plainhead}%
  \fi}

ここでスタイルが設定されるため、ヘッダーやフッターが表示されなくなる。
よってlatex_elementsという設定オプションを使用して、コードを無効にする。

conf.py

latex_elements = {
    'preamble': r'''
        % plainifnotemptyを無効化
        \renewcommand{\plainifnotempty}{}
    ''',
}