既存の html テーマを流用し、ユーザーの独自テーマを作成する¶

conf.py へのカスタムテーマの登録¶

conf.py の html_theme_path に _themes (適宜変更可能) を指定し、 html_theme に改編後の名前を指定する

以下 conf.py の抜粋

..

# The theme to use for HTML and HTML Help pages.  See the documentation for
# a list of builtin themes.
html_theme = 'alabaster_custom'

..

# Add any paths that contain custom themes here, relative to this directory.
html_theme_path = ['_themes']

..

カスタムテーマの配置¶

git clone git://github.com/bitprophet/alabaster.git などでソースコードをクローンし、ディレクトリ内の alabaster ディレクトリを _themes/ 内に複製する。

テーマの改変¶

とりあえず今回は一つ試みる。

{#- トップページは、ページのタイトルのみ表示 #}
{%- block htmltitle %}
{%- if pagename == 'index' %}
    <title>{{ title }}</title>
{%- else %}
    <title>{{ title|striptags|e }}{{ titlesuffix }}</title>
{%- endif %}
{%- endblock %}

終わりに¶

前回 と今回の記事で、利用者それぞれにあった Sphinx での GitHub Pages でのブログシステムを構築することができるようになるのではないか。 御活用ください。