kawasaki.rb #015 でSphinx導入事例の発表をしてきました #kwskrb #sphinxjp

あらすじ

kawasaki.rb #015 で発表してきたので、まとめ。

あわせて読みたい

本当は14回で発表したかったのだけど、病欠してしまった…。

発表内容

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

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

結論

結論としては、

  • やはり納品物にするには(歴史的経緯などから)厳しい
    • 社内ドキュメントにする分には問題なし
    • SphinxからOutputを出すのはいいけど、顧客に巻き取られた後変更に耐えうる形式じゃないとつらい
  • チームで適用するには一人ではつらい(個人的なパワー不足)
    • 最低でも一人賛同者がほしい

こんな感じ。もっとパワフルな人ならうまくやれるかもしれないが、自分では厳しかった。

以下かいつまんで。

導入にあたり

  • 実際にSphinxを導入するための壁
    1. 自分とプロジェクトのメンバー
    2. reST記法覚えに注力してもらうために、雑用(お膳立て)は全部やる
    3. プロジェクトと顧客
    4. Officeで書かないよという宣言をする必要があると思う

納品にあたり

納品後、顧客に巻き取られる場合のいい案がない。

  • どうやって納品するの?
    • rstのまま(rst -> make)
    • 保守も自分たちでできるならそれでもいいかも
    • 顧客にmakeしてもらうの敷居高すぎ
    • Outputを提出
    • html, pdf 見た目はきれい、だけど修正が発生した場合どうすれば
    • word きれいに出すの難しい(個人的に) / あまり需要がない?

つまるところ「よし、いこう!いこうぜ、みんな!」状態を作るのがかなり難しい。

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

  1. 2014/07/13 [Sphinx] [Ruby] [イベント] kawasaki.rb #013 でSphinx導入事例の発表をしてきました と #011 #012 参加記録 #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を行う手順(したとは言っていない)