Sphinxワークショップ@関西で事例紹介とハンズオンTAをしてきた #sphinxjp

あらすじ

さる10/31に開催された Sphinxワークショップ@関西 にて事例紹介とハンズオンTAをしてきた。

ので振り返りメモ。PyConJPのkptは活かされたのか。

スライド

JUS関西 Sphinxワークショップ@関西 Sphinx事例紹介 from kk_Ataka

振り返りKPT

Keep

  1. 会場には遅刻せず余裕を持って到着できた
  2. 質問への対応、割とスムーズだった(と思う/アツい自画自賛)
    • PyConJPの経験が活きたな!
  3. Sphinx Tシャツ持っていった

Problem

  1. MacのDisplayPort忘れた
    • 持ち物チェックリストに追加しよう
  2. 移動時間をちゃんと見積もるべし
    • 帰り際のドタバタ。危うく帰れなくなる所だった(一応、みんな無事に帰れた)

Try

  • 歴史的経緯も気にしてみよう
    • 質問であったのが、「Sphinxのhtmlテーマのデフォルトはなんで default じゃないの?( alabaster なの?)」というもの
      • Sphinx 1.3からデフォルトテーマは alabaster になった
      • あわせてデフォルトテーマ defaultclassic に名称変更されたが、互換性維持のために残っている
      • 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.
(略)

その他の感想

  • 今回のワークショップ参加者の方は「Officeつらくてなんとか改善したい」派が多かった印象
  • 「ポーギーに話す」の正式名称および出典がわかった

その中にMITでは学生が教官を患わせる前に一度テディベアに説明しなければならないという話が載っている。

大学も熊もあってた。ただ、熊は熊でもテディベアだった。

ちなみに、今までググってたキーワード群を「熊」->「テディベア」に変えると(「大学 熊 話す」を「大学 テディベア 話す」)、上記のサイトが1ページ目に上がってきたのでもう半歩足りなかったみたい。

ググるにも発想力とアドリブが求められる。ハマると全然引っかからない

関連記事(この記事の初版より古い記事はリンクがグレーで表示されます)

  1. 2015/12/01 [Sphinx] [イベント] SphinxCon JP 2015 で雑用してきた #sphinxjp
  2. 2015/10/13 [Sphinx] [Python] [イベント] PyConJP 2015 in TokyoでSphinxハンズオンのTAをしてきた #pyconjp
  3. 2016/11/30 [Sphinx] [Python] [イベント] PyConJP 2016 in TokyoでSphinxハンズオンのTAをしてきた #pyconjp
  4. 2016/01/19 [Sphinx] [イベント] PyLadiesTokyo #8でSphinxハンズオンのTAをしてきた #sphinxjp
  5. 2014/10/27 [イベント] [Sphinx] SphinxCon JP 2014 で発表してきました #sphinxjp
  6. 2014/08/28 [Sphinx] [Ruby] [イベント] kawasaki.rb #015 でSphinx導入事例の発表をしてきました #kwskrb #sphinxjp
  7. 2014/07/13 [Sphinx] [Ruby] [イベント] kawasaki.rb #013 でSphinx導入事例の発表をしてきました と #011 #012 参加記録 #kwskrb #sphinxjp
  8. 2012/04/28 [Jenkins] [Sphinx] [イベント] BPStudy#57に参加しました #bpstudy
  9. 2015/09/24 [Ansible] [イベント] Ansible Meetup in Tokyo 2015.09でLTしてきました #ansiblejp
  10. 2016/10/31 [Sphinx] Software Design 2016年11月号にSphinxの記事を執筆しました #sphinxjp
  11. 2014/05/28 [Sphinx] WindowsにSphinxのlatexpdfjaができる環境を整えるのに苦戦した話
  12. 2014/05/19 [Sphinx] 「Sphinxをはじめよう」を読んで導入したいと思ったので色々考えてみた2
  13. 2014/04/01 [Ruby] [Jekyll] [イベント] kawasaki.rb #010 で発表してきました #kwskrb
  14. 2013/10/25 [Sphinx] 「Sphinxをはじめよう」を読んで導入したいと思ったので色々考えてみた
  15. 2013/10/02 [Sphinx] Sphinxのプラグインの作り方を学ぶ