ドキュメントクラスオプションを設定する（latex_elements）

ドキュメントクラス（\documentclass）のオプションを設定する部分です。 プリアンブルの設定は、ここで書くと長くなって読みにくくなるため、 ここでは変数の定義だけして、中身はあとで書くことにします。

latex_elements = {
    "papersize" = "a4paper",
    "pointsize" = "12pt",
    "preamble": "",    # あとで追加するので定義だけしておく
    "figure_align": "htbp",
#   "fontpkg": "\\usepackage{times}",
    "polyglossia": "",
    "fncychap": r"\usepackage[Bjornstrup]{fncychap}",
}

LaTeX 文書の出力は以下のようになります。

\documentclass[a4paper, 12pt, dvipdfmx]{sphinxmanual}

パッケージを追加したい

LaTeXのパッケージはプリアンブルに追加しますが、その順序が重要なときがあります。 とくにhyperrefパッケージは最後に読み込むのがよいとされています。 Sphinxはこれに対応していて、hyperrefパッケージの前に読み込む場合はlatex_elements["extrapackages"]、後に読み込む場合はlatex_elements["preamble"]を使います。

latex_elementsのextrapackagesやpreambleに複数のパッケージを追加すると読みにくくなります。 なので、僕は次のようにlatex_elementsの中でキーだけ確保しておき、後からパッケージを追加するように書いています。 LaTeXの変数には\を使うものが多いため、raw文字列を使っています。

latex_elements = {
    ...,
    "extrapackages": "",
    "preamble": "",
}

latex_elements["extrapackages"] = r"""
\usepackage{physics}
"""

latex_elements["preamble"] = r"""
\hypersetup{bookmarksnumbered=true}
"""

LaTeX 文書の出力は以下のようになります。

\usepackage{physics}

% Include hyperref last.
\usepackage{hyperref}
% Fix anchor placement for figures with captions.
\usepackage{hypcap}% it must be loaded after hyperref.
% Set up styles of URL: it should be placed after hyperref.
\urlstyle{same}
\usepackage{sphinxmessages}
\setcounter{tocdepth}{0}

\hypersetup{bookmarksnumbered=true}

Polyglossiaパッケージを無効にしたい

latex_elements = {
    ...,
    "polyglossia": "",
    ...,
}

LaTeXエンジンにlualatexを指定すると、自動でPolyglossiaパッケージが読み込まれるようになっています。 このままビルドすると、多数のPackage polyglossia Warning: Asking to add empty feature to latin font(Script="CJK" to scripttag "")が表示されます。 多言語対応したドキュメントであれば、無効にしてしまいましょう。

fncychapパッケージのテーマを変更したい

latex_elements = {
    ...,
    "fncychap": r"\usepackage[Bjornstrup]{fncychap}",
    ...,
}

SphinxのデフォルトはBjarneですが、Bjornstrupに変更するとよいと思います。 選択できるテーマはfncychapパッケージを参照してください。