Your SlideShare is downloading. ×
第2回 IT系勉強会in神戸 0908
Upcoming SlideShare
Loading in...5
×

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×

Introducing the official SlideShare app

Stunning, full-screen experience for iPhone and Android

Text the download link to your phone

Standard text messaging rates apply

第2回 IT系勉強会in神戸 0908

632
views

Published on

Published in: Self Improvement

0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
632
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
1
Comments
0
Likes
0
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
No notes for slide

Transcript

  • 1. Sphinx 何それおい しいの ( 仮 ) 2012.9.8 IT 系勉強会 in 神戸
  • 2. どうも、  です。● Twitter: @lab1092● 普段は業務パッケージの技術サポートやってま す。● 灘区 のほうからやってきました● OSC とかたまに出没
  • 3. 9 月 15 日13:30-14:15 433 教室
  • 4. きょうは…
  • 5. Sphinxについて
  • 6. 今日やること● Sphinx とは ?● Sphinx が使われている場面 – Pythonista でなくても使えるんだ !● Sphinx + – ずっと前から放置してるやつ – こんどはじんりきぼっと作ろうかな(?)
  • 7. 今日やること● Sphinx とは ?● Sphinx が使われている場面 – Pythonista でなくても使えるんだ !● Sphinx + – ずっと前から放置してるやつ – こんどはじんりきぼっと作ろうかな(?)
  • 8. みなさんドキュメント書いてますか ?
  • 9. ドキュメントを書くのが 楽しくなってしまう 魔法のドキュメンテーション ツール、 Sphinx 。
  • 10. でも世間的には「中級」…Sphinx を活用し、適切に構成されたドキュメントを容易に作成する
  • 11. reST + Sphinx 拡張 reST reSTructured Text インデックス 目次やグローサリー テキストマークアップコードハイライト 相互参照pygments によるコードハイライト プロジェクト内のファイル間 やプロジェクト間の相互参照
  • 12. 今日やること● Sphinx とは ?● Sphinx が使われている場面 – Pythonista でなくても使えるんだ !● Sphinx + – ずっと前から放置してるやつ – こんどはじんりきぼっと作ろうかな(?)
  • 13. (PHP)Symfony2 http://docs.symfony.gr.jp/symfony2/
  • 14. http://book.cakephp.org/ja/
  • 15. プログラミング言語 Go ドキュメント http://go.shibu.jp/
  • 16. Google Test ドキュメント日本語訳
  • 17. 「ドキュメントを書くツール」なので Python あんま関係ない
  • 18. Show Source!!
  • 19. ところで、、、
  • 20. そういえばさ、 Word で、 フォントサイズだけ 変えて スタイル使わない 人いません ?
  • 21. 文書構造に強くなる ?● reSTructuredText 書くと、どうしても字下げと かそういうものを意識せざるを得なくなるの で、自然とそういうものが身に着くのかも● 文字に対する無駄な装飾が出来ないため、本来 の内容について記述をすることに専念できる● 英文メールの書き方みたいになる
  • 22. 本来のドキュメントに専念できる● デザインだなんだといっても、やはり「わかっ てもらうドキュメント」をかいてナンボなの で。● reStrecturedText で書いた経験 ( 文書構造を意識 するということ ) を他で実践出来る – テンプレートの考え方等についても – 「お作法」を踏まえて。。。
  • 23. 今日やること● Sphinx とは ?● Sphinx が使われている場面 – Pythonista でなくても使えるんだ !● Sphinx + – ずっと前から放置してるやつ – こんどはじんりきぼっと作ろうかな(?)
  • 24. ~別のスライドへ~
  • 25. 今日やること● Sphinx とは ?● Sphinx が使われている場面 – Pythonista でなくても使えるんだ !● Sphinx + – ずっと前から放置してるやつ – こんどはじんりきぼっと作ろうかな(?)
  • 26. ~ Demo? ~というほどでもない
  • 27. 今日やること…は終わったかな ?● Sphinx とは ?● Sphinx が使われている場面 – Pythonista でなくても使えるんだ !● Sphinx + – ずっと前から放置してるやつ – こんどはじんりきぼっと作ろうかな(?)
  • 28. 何も持って帰らないというのもアレなので
  • 29. おまけ
  • 30. 「 wkhtmltopdf 」 使って楽ちん (?) PDF 出力
  • 31. wkhtmltopdf?● Web ページの表示を PDF に出力する – http://code.google.com/p/wkhtmltopdf/● sphinx では、“ make singlehtml” ターゲット で文書を 1 つの HTML に生成、簡易に PDF に するケースで使用。● "make pdf” ようわからん● Latex 経由よりも準備が少なくていい
  • 32. WK?WK = Webkit
  • 33. 以下の呪文を。make singlehtml
  • 34. するとあら不思議● 1 つのファイルの HTML が生成されてる。● これを wkhtmltopdf で処理するとおk ↓ 何か違うことやってるけどね rem singlehtml to PDF rem ################# sphinx-build -b singlehtml -c _ext -d _build/doctree . _build/singlehtml rem make PDF file to dropbox directory "C:Program Fileswkhtmltopdfwkhtmltopdf.exe" _build/singlehtml/index.html index.pdf copy index.pdf "%USERPROFILE%DocumentsMy DropboxPublicindex.pdf"
  • 35. これだけ~あと、 pandoc とかいうのも 調べとくといいかも
  • 36. kobe-it-fes.org ≪10/5,6
  • 37. Thanks for Watching