Sphinxデザインのカスタム

概要

sphinxデザインの手動調整の方法を記載。

sphinxデザインは、基本的に公式から提供されているテーマで事足りるとは思うが、
本document独自のカスタムとして、見出しカラーを見出しサイズごとに変えている。
(いちからCSS覚えるのもだるかったのでChatGPTに任せたりもした。生成AI便利だねぇ。)

カスタム内容

追加・修正するファイル

  • (追加)source/_static/custom.css

  • (修正)source/conf.py

    • 以下を追記(上記のCSSファイルを適用するための設定)

      html_css_files = ['custom.css']
    
  • custom.cssの中身

/* static/custom.css */

/* 全ての見出し (h1 ~ h6) に共通の設定 */

/* h1 見出し */
section h1 {
    background-color: rgb(103, 174, 219); /* 控えめな水色系 */
    padding: 3px 10px; /* 上下のパディングを小さく、左右は少し広め */
    border-radius: 5px;
    color: #003366; /* 文字色(濃い青系) */
}

/* h2 見出し */
section h2 {
    background: linear-gradient(to right, rgba(103, 219, 111, 0.6), rgba(103, 219, 111, 0.6) 80%, transparent 100%);
    padding: 3px 10px;
    border-radius: 5px;
    color: #003366;
}

/* h3 見出し */
section h3 {
    background: linear-gradient(to right, rgba(195, 218, 102, 0.4), rgba(195, 218, 102, 0.4) 60%, transparent 100%);
    padding: 3px 10px;
    border-radius: 5px;
    color: #003366;
}

/* h4 見出し */
section h4 {
    background: linear-gradient(to right, rgba(195, 218, 102, 0.3), rgba(195, 218, 102, 0.3) 50%, transparent 100%);
    padding: 3px 10px;
    border-radius: 5px;
    color: #003366;
}

/* h5 見出し */
section h5 {
    background: linear-gradient(to right, rgba(195, 218, 102, 0.2), rgba(195, 218, 102, 0.2) 40%, transparent 100%);
    padding: 3px 10px;
    border-radius: 5px;
    color: #003366;
}

/* h6 見出し */
section h6 {
    background: linear-gradient(to right, rgba(195, 218, 102, 0.1), rgba(195, 218, 102, 0.1) 30%, transparent 100%);
    padding: 3px 10px;
    border-radius: 5px;
    color: #003366;
}