kawasaki.rb #013 でSphinx導入事例の発表をしてきました と #011 #012 参加記録 #kwskrb #sphinxjp

あらすじ

kawasaki.rb に参加したものの記録を取っていなかったのでまとめて。

13回目ではSphinxを話をしたのでその備忘録。Ruby系の勉強会だけどRuby以外の発表でも大丈夫。

発表内容

以下のスライドを元にLTしました。

SIerでもSphinxを使いたい! 前編 from kk_Ataka

Sphinxを使用したドキュメント作成をする機会を探っていて、ようやくドンピシャで導入できるプロジェクトをこの手で手繰り寄せたのでそこで得た知見をまとめました。

大体の内容はこの辺から参照してます。

ねらい

  • 「なんとか設計書_日付_リビジョン(だれそれ更新分)(最新版).xls」 とかいう差分取りづらい伝説のファイルが共有サーバ上に量産されるの辛い…
  • 共有サーバに上記のようなファイルがちらかるのでどこに何があるかわかりにくい
  • ミリ単位のレイアウト調整に苦心するのやだ

という事で

  • プレーンテキストで文書を作成できる
  • 文書を体系立てて管理できる
  • デザインなどはアウトプット時におまかせ

できるSphinxを導入しようというもの。

なぜSphinxがいいのかというところを競合するツールと比較してみたところまでを発表しました。

次の発表で「導入する際、導入した後に気をつけた事」とか発表する予定です。

おまけ 11回目、12回目で起こったこと

  • ロゴができた
  • kawasaki.rbのGitHub Pagesができた(Powered by Jekyllだ!)
  • kawasaki.rbのリポジトリに対して参加者がPRしまくり

他、所見。

  • Jekyll の翻訳で得た知見あたりを発表したいなーとも考えている
  • 12回目の懇親会で食べた「じゃが麺」がよかった。中毒性あり。こわい

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

  1. 2014/08/28 [Sphinx] [Ruby] [イベント] kawasaki.rb #015 でSphinx導入事例の発表をしてきました #kwskrb #sphinxjp
  2. 2014/10/27 [イベント] [Sphinx] SphinxCon JP 2014 で発表してきました #sphinxjp
  3. 2014/04/01 [Ruby] [Jekyll] [イベント] kawasaki.rb #010 で発表してきました #kwskrb
  4. 2016/11/30 [Sphinx] [Python] [イベント] PyConJP 2016 in TokyoでSphinxハンズオンのTAをしてきた #pyconjp
  5. 2016/01/19 [Sphinx] [イベント] PyLadiesTokyo #8でSphinxハンズオンのTAをしてきた #sphinxjp
  6. 2015/12/01 [Sphinx] [イベント] SphinxCon JP 2015 で雑用してきた #sphinxjp
  7. 2015/11/01 [Sphinx] [イベント] Sphinxワークショップ@関西で事例紹介とハンズオンTAをしてきた #sphinxjp
  8. 2015/10/13 [Sphinx] [Python] [イベント] PyConJP 2015 in TokyoでSphinxハンズオンのTAをしてきた #pyconjp
  9. 2013/04/27 [Ruby] [Chef] [イベント] BPStudy#68に参加しました #bpstudy
  10. 2012/06/03 [TDD] [RSpec] [Ruby] [イベント] TDD Boot Camp 大阪 1.0( #tddbc ) に参加しました
  11. 2012/05/28 [Ruby] [イベント] [Jenkins] [Redmine] Jenkins,Redmine使いこなし勉強会に参加しました と、ちょっとプラグイン作ってみた #jen_red
  12. 2012/04/28 [Jenkins] [Sphinx] [イベント] BPStudy#57に参加しました #bpstudy
  13. 2014/05/28 [Sphinx] WindowsにSphinxのlatexpdfjaができる環境を整えるのに苦戦した話
  14. 2014/05/19 [Sphinx] 「Sphinxをはじめよう」を読んで導入したいと思ったので色々考えてみた2
  15. 2014/01/28 [Jekyll] [GitHub] [Ruby] Jekyllプロジェクトへpull requestを行う手順(したとは言っていない)