sphinxのカスタマイズ (2) - _static/custom.css -¶
sphinxは、CSSのテンプレートに従って、HTMLを装飾する．
custom.css の準備¶
CSSテンプレート、 custom.css を "source/_static/" 以下に作成する．
ここにカスタムテンプレートを作成、追記していく．
conf.py に以下を追記して、読み込み設定する
html_static_path = ['_static']
html_css_files = [custom.css]
外観スタイルの変更¶
例えば、
1cite, code, tt {
2 font-family: "Ricty";
3}
4pre {
5 font-family: "Ricty";
6}
によって、リテラルブロック内のフォントを変更できる． 使用可能なフォント名については、:
$ fc-list | grep -i xxxx
などで調べられる．
ロールの追加¶
やりたいこと¶
独自のロール （文中で装飾をつける機能）が設定可能．
赤文字やフォント変更など、打ち消し線が作れる．
やること¶
"." (ドット) + "ロール名"で css クラスを定義 する(custom.css) ．
conf.py の中のroles（リスト）に、ロールの名前を追記する．( "." (ドット)以下の名前 )
記載例 (0) ( conf.py 内 )¶
roles = ['strike', 'red', 'blue', 'ricty']
記載例 (1) ricty フォントへの置き換えロール¶
1.ricty {
2 font-family: "Ricty", monospace;
3}
記載例 (2) 打ち消し線¶
1.strike {
2 text-decoration: line-through;
3}
記載例 (3) 色文字¶
1.red {
2 color: red;
3}
4.blue {
5 color: blue;
6}
