Webサイトを作ろう(オリジナルテーマの作成)¶
Sphinxはテーマという形で、ドキュメントの見た目を変更することができます。ドキュメントのレイアウト、デザインは自由に編集することができるのでドキュメントだけではなくWebサイトを作ることもできます。ここでは、テーマを作成してかんたんなWebサイトを作っていきます。
注釈
Sphinxには標準テーマとして多数のテーマが同梱されています。オリジナルのテーマを変更する前にテーマの変更を参照してください。
また、既存のテーマを多少変更したい場合は、
HTMLテーマのサポート の html_theme_options
や
HTMLテーマに独自のCSS/JSファイルを読み込ませてデザイン調整等したいを参照して下さい。
準備¶
オリジナルのテーマを作成するにあたって、必要な準備をします。
オリジナルのレイアウトを作成する¶
必要な準備が整ったら、実際にオリジナルのテーマを作成します。Sphinxのテーマは、Jinja HTMLテンプレート、CSS、必要に応じてJavaScriptを使用して作成することができます。
作成したテーマを配置する¶
オリジナルテーマが完成したら、自分のプロジェクトに配置して使ってみましょう。