PyLadiesTokyo #8でSphinxハンズオンのTAをしてきた #sphinxjp

目次

• あらすじ
• 振り返りKPT
• Keep
• Problem
• Try
• ハンズオンあるある
• エディタ編
• アウトプット編(html)

あらすじ

さる1/16に開催されたPyLadies TokyoにてSphinxのハンズオンが開催されたのでTAしてきました。

• PyLadies Tokyo Meetup #8 - connpass

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 はそういう見た目なのだ
  • ブラウザの横幅を変えるとメニューバーが目に見えて変化するのでわかりやすい
• default があるのになんでデフォルトがこれじゃないの？(定番になりつつある質問)
  • Sphinx 1.3からデフォルトテーマは alabaster になった
  • あわせてデフォルトテーマ default は classic に名称変更されたが、互換性維持のために残っている
  • Sphinx 1.3でテーマを default に設定して make html すると alabaster 使いなよと警告が出る
  • Sphinxの更新履歴 — Sphinx 1.3.2 ドキュメントによると1.3b3でそうなった様子

$ 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.
(略)