CSSしたい(html_css_files

1# config.py
2html_static_path = ["_static"]
3html_css_files = [
4    # "ファイル名",
5    "custom.css",
6]

カスタム用のCSSファイルをdocs/_static/custom.cssに配置します。 conf.pyhtml_static_pathには_staticを、html_css_filesにCSSファイル名を記述します。

ヒント

CSSファイルは複数指定できます。 用途別にファイルを分割してもよいと思います。

1html_css_files = [
2    "css/heading.css", # 見出し用
3    "css/font.css",    # フォント用
4]

メディアクエリしたい

1html_css_files = [
2    # ("ファイル名", {"media": "メディアクエリの種類"}),
3    ("print.css", {"media": "print"}),
4]

tuple形式でメディアクエリーを指定できます。 メディアクエリの種類はall(すべて)、print(印刷)、screen(画面)、speech(音声合成)から選択します。

参考

出力されるlinkタグ(外部ソースへのリンク要素)は次のようになります。

<link href="print.css" rel="stylesheet" media="print">