Sphinxの使い方事例

Go Yamada
Go Yamadasphinx-users.jp
SphinxCon JP 2012




                    Sphinx-users.jp
                              山田剛
アジェンダ


1. 自己紹介
2. 事例その1 スマートなファイル管理をし
   たい
3. 事例その2 簡単にWebサイトを作りたい
4. まとめ
1. 自己紹介
2. 事例その1 スマートなファイル管理をし
たい
3. 事例その2 簡単にWebサイトを作りたい
4. まとめ
おまえ誰よ:山田 剛
                       Twitter: @usaturn
 仕事
   (株) ネットサポート所属
   アウトソーシング業を営むIT企業
 参加コミュニティ(勉強会)
   Python系
   Mercurial系
   Vim系
   アジャイル系
 その他
   sh、awk、vbs等は使えますが汎用言語の経験無し
   1年前にPythonを勉強し始めた
   “改善”、”効率化”が好き。というか楽したい
1. 自己紹介
2. 事例その1 スマートなファイル管理をし
たい
3. 事例その2 簡単にWebサイトを作りたい
4. まとめ
インフラの現場のファイルサーバと
は

どこのインフラの現場で
も、
 ファイルサーバの中身
  は似たりよったり。
example
容量の大きなファイルサーバに部署ごと、チーム毎のディレ
   クトリを作成し、明確なルール無しでの運用




    ディレクトリ作成の乱発、ファイルの散乱




          情報取得の阻害
巨大で乱雑なファイルサーバだと?

「着任早々すまないけど、説明する時間が無いので○○ディレ
クトリの配下で、それっぽいファイルを一通り見ておいてくれ
ないかな?」


「あの6000ファイルくらいある上に、似たりよったりのファ
         イルが大量にあるんですが」


「みんな同じ道を通ってきているんだ、悪いけどなんとかし
         て確認してくれ」


          「・・・・・・・」
ディレクトリ構成によるファイル管
 理




 そもそも、ディレクトリ構成やファイル名
だけに頼る、ファイル(ドキュメント)管理
に無理があるのでは?
ボクの考えた最強のファイル(ドキュメン
 ト)管理

TracやRedmine等


  プロジェクト管理
ツール

                  を
プロジェクト管理ツールによるファイル
 管理その1
 付属のWikiによるドキュメント作成
  バージョン管理ができる!
  もちろん履歴をさかのぼって誰が編集したか
 もわかる!
プロジェクト管理ツールによるファイル
  管理その2
 Mercurial等のバージョン管理ツールを使ったファイ
 ル管理
  Wiki上にリポジトリのファイルへのリンクを説明付で
  作る事により、ファイルを開かなくても目的のファイ
  ルを探す事が出来る!
しかし、以前の現場では



プロジェクト管理ツール導入
の
     厚い壁
         に心折れる
そこでSphinx

プロジェクト管理ツールの代
替品とはならないが、ドキュ
メントやファイルをまとめる
事が簡単にできる。
やってみた事
 自分中心の案件に関して、自分一人で編集する事前
  提でプロジェクトを作成。Sphinxでhtml化する。
 ファイルサーバに配置したhtmlをローカルで閲覧し
  てもらい、情報共有を実施。
 Excel、Word、PDFなどのバイナリファイル
  も:download:を使って説明付でファイルを配置する。
Sphinx化した結果
 チームメンバからは「見易い」という評価。
 しかしメンバにSphinxを利用してもらうには至らず。
 メンバが編集必要なドキュメントに関しては
make shinglehtml
で一本のhtmlを作成し、MS-WordでWord形式に変換
  噂ではMS-Wordに変換する拡張をどなたかが書いているとか
1. 自己紹介
2. 事例その1 スマートなファイル管理をし
たい
3. 事例その2 簡単にWebサイトを作りたい
4. まとめ
自社でSphinxを紹介しました

 社員向けのメールマガジンでSphinxを紹介
 ①   教育部の部長が「こんなツールを求めてい
     ました!」と絶賛
 ② 部長、すぐに社員向けの各種ページ(プロジェクト)
     を作成する

                    部長凄いよ!!
わが社にもSphinxの時代がやってき
 た!?

 この波にのって、社内にSphinx広めよ
う!!




 社内でSphinxハンズオンの開催!!
  ⇒ が、社員百数十人中、1人しか応募せず。
あきらめたら試合は(ry
 弊社は先に紹介したように
アウトソーシング(派遣)メインの業務。
  月末に派遣先との契約を終えて次の月から社内待機と
  なる人間が数人出ます。
社内待機の人々
① 朝9時半に出社し「おはようございます」と挨拶を
  する
② 自学自習
③ 18時に「おつかれさまでした」と挨拶をして帰る




                  以上
社内待機者については放置状態
 そこで私が提案したのが




待機者ハッカソ
   ン
提案した事
 提案書参照
決まった事
 議事録参照
日報の問題点
 メールで送っているので、過去の日報を確認するの
が大変なはず

 日報を出すほうとしては、見られているのかどうか
わからずモチベーションもあがらない
  レスポンスがなかったらモチベーションあがらないよ
  ね?


 情報へのアクセスのし易さが
       鍵
Sphinxを採用した理由

 日報用のWebアプリが良いのでは?
   開発者の方であればWebアプリを作る事は簡単だけ
    ど・・・

 社内SNSに書いてもらうのは?
   レスポンスを返しやすいという事では適している
   日報という括りで情報がまとまらない



ならば、Sphinxです!
  静的ページを簡単に作れる
  Indexディレクティブの利用(pair)で手軽に人単位、
  日単位で日報を確認しやすくなる
Sphinxの日報サイトを作る際に工夫した
  事
 Sphinxの使い方の説明ページの作成


 ファイルサーバの特定の場所に日報.rstを置くだけ
 で夜にWebサイトが更新する

 Indexディレクティブの利用(pair) ※前述
成果物
 現在、待機者の日報サイトを継続中

残念ながら社内向けサイトなので、お見せする事は
できませんが・・・・
                 もしかしたら?


 もしかしたらお見せできるか
      も?
1. 自己紹介
2. 事例その1 スマートなファイル管理をし
たい
3. 事例その2 簡単にWebサイトを作りたい
4. まとめ
まとめ
 Sphinx自体が万能ツールというわけではありません
が、その手軽さから、使い方次第では使用コストを
超える効果を生み出します

 Sphinxに限った事ではありませんが、新しいツール
や、新しい方法を導入しようとすると反発が必ずあ
ります
1 of 30

More Related Content

What's hot(20)

ひとりsphinxひとりsphinx
ひとりsphinx
(^-^) togakushi2.4K views
Sphinx GO!!Sphinx GO!!
Sphinx GO!!
Go Yamada909 views
How to spread reST and SphinxHow to spread reST and Sphinx
How to spread reST and Sphinx
Takanori Suzuki8.5K views
APIドキュメントの話 #sphinxjpAPIドキュメントの話 #sphinxjp
APIドキュメントの話 #sphinxjp
Takeshi Komiya10.5K views
Sphinxを使って本を書こう #pyconjp 2012Sphinxを使って本を書こう #pyconjp 2012
Sphinxを使って本を書こう #pyconjp 2012
Takayuki Shimizukawa9.1K views

Similar to Sphinxの使い方事例(20)

Sphinxでドキュメントを書こうSphinxでドキュメントを書こう
Sphinxでドキュメントを書こう
Kazufumi Ohkawa2.7K views
OSS開発勉強会-01BOSS開発勉強会-01B
OSS開発勉強会-01B
Kohei KaiGai523 views
Fuchsia概略その1Fuchsia概略その1
Fuchsia概略その1
l_b__6.2K views
Alfresco ce 4.2の新機能Alfresco ce 4.2の新機能
Alfresco ce 4.2の新機能
Jun Terashita2K views
Lync でできる? 仕事効率化Lync でできる? 仕事効率化
Lync でできる? 仕事効率化
Manato KAMEYA2.5K views
最近作ったもの最近作ったもの
最近作ったもの
onozaty1.4K views
Building document with the Sphinx public edtionBuilding document with the Sphinx public edtion
Building document with the Sphinx public edtion
Yukihiko SAWANOBORI1.9K views
達人出版会のご紹介(技術編)達人出版会のご紹介(技術編)
達人出版会のご紹介(技術編)
masayoshi takahashi1.3K views
Openshift 20191128Openshift 20191128
Openshift 20191128
Yasushi Osonoi304 views

More from Go Yamada(8)

Publishing of sphinx2018Publishing of sphinx2018
Publishing of sphinx2018
Go Yamada252 views
Introduce for sphinx-users-jpIntroduce for sphinx-users-jp
Introduce for sphinx-users-jp
Go Yamada1.5K views
Gentoo is painful_but_usefulGentoo is painful_but_useful
Gentoo is painful_but_useful
Go Yamada1.2K views
Don't need dockerDon't need docker
Don't need docker
Go Yamada804 views
Gentoo for PythonistaGentoo for Pythonista
Gentoo for Pythonista
Go Yamada737 views
I love ms word!?I love ms word!?
I love ms word!?
Go Yamada659 views
Common usage of SphinxCommon usage of Sphinx
Common usage of Sphinx
Go Yamada1.6K views

Sphinxの使い方事例