Webサイトを作ろう(オリジナルテーマの作成)

Sphinxはテーマという形で、ドキュメントの見た目を変更することができます。ドキュメントのレイアウト、デザインは自由に編集することができるのでドキュメントだけではなくWebサイトを作ることもできます。ここでは、テーマを作成してかんたんなWebサイトを作っていきます。

注釈

Sphinxには標準テーマとして多数のテーマが同梱されています。オリジナルのテーマを変更する前にテーマの変更を参照してください。

また、既存のテーマを多少変更したい場合は、HTMLテーマのサポートhtml_theme_optionsHTMLテーマに独自のCSS/JSファイルを読み込ませてデザイン調整等したいを参照して下さい。

オリジナルのレイアウトを作成する

必要な準備が整ったら、実際にオリジナルのテーマを作成します。Sphinxのテーマは、JinjaHTMLテンプレート、CSS、必要に応じてJavaScriptを使用して作成することができます。