あらすじ
さる1/16に開催されたPyLadies TokyoにてSphinxのハンズオンが開催されたのでTAしてきました。
Sphinx hands-on in PyLadies Tokyo Meetup#8 !! #sphinxjp #PyLadiesTokyo pic.twitter.com/hfwwMZb6hA
— sphinx-users.jp (@sphinxjp) 2016, 1月 16振り返りKPT
Keep
- PyLadies Tokyo – Official Site は、現在別のCMSで構築されているがこれを機会にSphinxに乗り換える案が出ているようです！ナイスですね
Problem
- 特に大きな問題もなく、もしもの時のために小さい電源タップを持参すると助かる時があるかも？
Try
- ハンズオン質問あるあるみたいなものがまとめられるといいかも
- ハンズオン資料( sphinxjp / handson — Bitbucket )とかSphinx-Users.jpのサイトを見てくと書いてあったりするけど
ハンズオンあるある
エディタ編
- 半角スペース、全角スペース、タブを可視化できるエディタだとエラーに気づきやすい…かも！？
- 不意に混同するとハマっちゃう
アウトプット編(html)
- テーマ、適用されてない？
- (1.3以降の)デフォルトテーマである
alabasterはそういう見た目なのだ - ブラウザの横幅を変えるとメニューバーが目に見えて変化するのでわかりやすい
- (1.3以降の)デフォルトテーマである
defaultがあるのになんでデフォルトがこれじゃないの？(定番になりつつある質問)- Sphinx 1.3からデフォルトテーマは
alabasterになった - あわせてデフォルトテーマ
defaultはclassicに名称変更されたが、互換性維持のために残っている - Sphinx 1.3でテーマを
defaultに設定してmake htmlするとalabaster使いなよと警告が出る - Sphinxの更新履歴 — Sphinx 1.3.2 ドキュメントによると1.3b3でそうなった様子
- Sphinx 1.3からデフォルトテーマは
$ make html
(略)
WARNING: 'default' html theme has been renamed to 'classic'. Please change your html_theme setting either to the new 'alabaster' default theme, or to 'classic' to keep using the old default.
(略)