HTMLテーマに独自のCSS/JSファイルを読み込ませてデザイン調整等したい

  1. _static/custom.css を用意します(ファイル名は任意)。

  2. conf.py に以下の行を追加します

    def setup(app):
        app.add_stylesheet('custom.css')
    

これでcustom.cssもHTMLから読み込まれるようになります。

同様にapp_add_javascript('custom.js')を使えばJSファイルも追加できます。

Sphinx標準テーマであれば、add_stylesheetやadd_javascriptを使ってcssやjsを追加することが出来ます。

注釈

この仕組みはlayout.htmlに以下のような記述がある場合に動作します。Sphinx標準のテーマの例:

{%- for cssfile in css_files %}
<link rel="stylesheet" href="{{ pathto(cssfile, 1) }}" type="text/css" />
{%- endfor %}

https://bitbucket.org/birkenfeld/sphinx/src/348224ae1fd5/sphinx/themes/basic/layout.html#cl-105