##############################################################
sphinxのカスタマイズ (1) - conf.py - 
##############################################################

=========================================================
conf.py の役割
=========================================================

* conf.py は、Sphinxでドキュメントをビルドする際の :blue:`設定記述ファイル` ．
*  :blue:`外観、機能` を設定．
* ドキュメント情報を記述 (プロジェクト名、著者、バージョン、言語など)のメタ情報を定義．
* 出力形式ごとの調整 ( HTMLやLaTeX、EPUBなど出力形式ごとのカスタム設定 )
* パス指定 ( css などの静的ファイルやテンプレートディレクトリを登録 )
*  :blue:`ロールやディレクティブのカスタマイズ` 
* .pyファイルで、条件分岐やモジュール読み込みなどpythonで柔軟な制御が可能．

|