Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.
小宮健(Takeshi KOMIYA) @tk0miya 
#428rk01
Who am I ? 
 仕事 
 (株)タイムインターメディア所属 
 参加コミュニティ 
 Sphinx-users.jp 
 Python mini hack-a-thon 
 Python の方から来ました 
 senda...
Who am I ?
Who am I ? 
 blockdiag というツールを作ってます 
 テキスト(DSL like .dot)から画像を生成します 
{ 
トップページ-> ログイン-> マイペー 
ジ; 
トップページ-> 商品一覧-> 商品詳細; ...
ドキュメントの話、しませんか? 
 ドキュメント仲間 
 ドキュメントツールについて語り合いたい 
 テキストマークアップのツールを作りたい、改善し 
たい 
 たとえば?
ドキュメントの話、しませんか? 
 ドキュメントツールの話題って? 
 出力フォーマットの話(とその苦労話)
ドキュメントの話、しませんか? 
 ドキュメントツールの話題って? 
 出力フォーマットの話(とその苦労話)
ドキュメントの話、しませんか? 
 ドキュメントツールの話題って? 
 出力フォーマットの話(とその苦労話) 
 表現やメンテナンスについて(とその苦労話)
ドキュメントの話、しませんか? 
 ドキュメントツールの話題って? 
 出力フォーマットの話(とその苦労話) 
 表現やメンテナンスについて(とその苦労話)
さがしてます:DocTool Friends 
 ドキュメントツールの話題って? 
 出力フォーマットの話(とその苦労話) 
 表現やメンテナンスについて(とその苦労話) 
 ドキュメントの用途(とその苦労話)
ドキュメントの話、しませんか? 
 ドキュメントツールの話題って? 
 出力フォーマットの話(とその苦労話) 
 表現やメンテナンスについて(とその苦労話) 
 ドキュメントの用途(とその苦労話) 
出版
ドキュメントの話、しませんか? 
 ドキュメントツールの話題って? 
 出力フォーマットの話(とその苦労話) 
 表現やメンテナンスについて(とその苦労話) 
 ドキュメントの用途(とその苦労話) 
 マークアップ言語(とその苦労話)
ドキュメントの話、しませんか? 
 ドキュメントツールの話題って? 
 出力フォーマットの話(とその苦労話) 
 表現やメンテナンスについて(とその苦労話) 
 ドキュメントの用途(とその苦労話) 
 マークアップ言語(とその苦労話)
ドキュメントの話、しませんか? 
 たとえばmarkdown を例に取って 
 どんなツールを使ってますか? 
 Github? Jekyll? Octpress? Pandoc? md2inao? reveal.js? 
 どうやって...
ドキュメントの話、しませんか? 
 Markdown 2 (http://markdown2.github.io/site/) 
作られたっきり更新されてない…
ドキュメントの話、しませんか? 
 Internet Draft (The text/markdown Media Type) 
 2014/7/4 に公開 
 Content-Type: text/markdown; charset=U...
ドキュメントの話、しませんか? 
 standardmarkdown.com 
 A strongly specified, highly compatible 
implementation of Markdown 
_人人人人人人人人人...
ドキュメントの話、しませんか? 
 commonmark.com 
 元standardmarkdown 
 仕様も実装もある 
 The current version of the CommonMark spec is 
compl...
ドキュメントの話、しませんか? 
 他にも切り口はたくさんある 
 出版する際の注意点、ツール選び 
 翻訳に役立つツール 
 ドキュメントの翻訳で本家の更新を追いかける方法 
 同人誌を作るときのポイント 
 用語を統一する方法 ...
ドキュメントの話、しませんか? 
 話題はあるのに場がない(ような気がする) 
 ドキュメントコミュニティはバラバラに活動している 
 マークアップ言語ごと 
 プログラム言語ごと(Ruby 界隈、Python 界隈…) 
 活動(出...
ドキュメントの話、しませんか? 
 来月に版管理+自動組版というイベントがあります 
 まずは版管理や組版(出版方面)の話から
まとめ 
 ドキュメントの話、しませんか? 
 工夫してること、苦労してること、気になっ 
てること、シェアしませんか 
 やりかたはこれから考えていきます 
 詳しくは@tk0miya まで!
Upcoming SlideShare
Loading in …5
×

ドキュメントの話、しませんか? #428rk01

2,686 views

Published on

ドキュメントの話、しませんか? #428rk01

Published in: Technology
  • Be the first to comment

ドキュメントの話、しませんか? #428rk01

  1. 1. 小宮健(Takeshi KOMIYA) @tk0miya #428rk01
  2. 2. Who am I ?  仕事  (株)タイムインターメディア所属  参加コミュニティ  Sphinx-users.jp  Python mini hack-a-thon  Python の方から来ました  sendagaya.rb (先週初参加)  Tokyu RubyKaigi  元Rubyist です(1.4, 1.6の頃) Twitter: @tk0miya
  3. 3. Who am I ?
  4. 4. Who am I ?  blockdiag というツールを作ってます  テキスト(DSL like .dot)から画像を生成します { トップページ-> ログイン-> マイペー ジ; トップページ-> 商品一覧-> 商品詳細; }
  5. 5. ドキュメントの話、しませんか?  ドキュメント仲間  ドキュメントツールについて語り合いたい  テキストマークアップのツールを作りたい、改善し たい  たとえば?
  6. 6. ドキュメントの話、しませんか?  ドキュメントツールの話題って?  出力フォーマットの話(とその苦労話)
  7. 7. ドキュメントの話、しませんか?  ドキュメントツールの話題って?  出力フォーマットの話(とその苦労話)
  8. 8. ドキュメントの話、しませんか?  ドキュメントツールの話題って?  出力フォーマットの話(とその苦労話)  表現やメンテナンスについて(とその苦労話)
  9. 9. ドキュメントの話、しませんか?  ドキュメントツールの話題って?  出力フォーマットの話(とその苦労話)  表現やメンテナンスについて(とその苦労話)
  10. 10. さがしてます:DocTool Friends  ドキュメントツールの話題って?  出力フォーマットの話(とその苦労話)  表現やメンテナンスについて(とその苦労話)  ドキュメントの用途(とその苦労話)
  11. 11. ドキュメントの話、しませんか?  ドキュメントツールの話題って?  出力フォーマットの話(とその苦労話)  表現やメンテナンスについて(とその苦労話)  ドキュメントの用途(とその苦労話) 出版
  12. 12. ドキュメントの話、しませんか?  ドキュメントツールの話題って?  出力フォーマットの話(とその苦労話)  表現やメンテナンスについて(とその苦労話)  ドキュメントの用途(とその苦労話)  マークアップ言語(とその苦労話)
  13. 13. ドキュメントの話、しませんか?  ドキュメントツールの話題って?  出力フォーマットの話(とその苦労話)  表現やメンテナンスについて(とその苦労話)  ドキュメントの用途(とその苦労話)  マークアップ言語(とその苦労話)
  14. 14. ドキュメントの話、しませんか?  たとえばmarkdown を例に取って  どんなツールを使ってますか?  Github? Jekyll? Octpress? Pandoc? md2inao? reveal.js?  どうやって編集してますか?  Vim? Emacs? Kobito? Sublime? etc?  困ってること、工夫してることありますか?  画像の作り方、環境の作り方、シェアの仕方、etc.  markdown で表現できないことはどうしてる? 標準化ってどうなってますか?
  15. 15. ドキュメントの話、しませんか?  Markdown 2 (http://markdown2.github.io/site/) 作られたっきり更新されてない…
  16. 16. ドキュメントの話、しませんか?  Internet Draft (The text/markdown Media Type)  2014/7/4 に公開  Content-Type: text/markdown; charset=UTF-8; flavor=GitHub  the IANA Markdown Flavors Registry  本気なの!?  2014/9/9 に更新されてた  Content-Type: text/markdown; charset=UTF-8; rules=GitHub  flavor → rules に変更  まだ続く模様(9/22, 10/17 と更新されている…)
  17. 17. ドキュメントの話、しませんか?  standardmarkdown.com  A strongly specified, highly compatible implementation of Markdown _人人人人人人人人人人人人人人人人人_ > 突然のThis domain was disabled <  ̄Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y ̄  John Gruber (markdown 作者) からツッコミが!  リネームすることになった  Standardmardown.com を閉じることになった  謝罪することになった
  18. 18. ドキュメントの話、しませんか?  commonmark.com  元standardmarkdown  仕様も実装もある  The current version of the CommonMark spec is complete と言ってる  そのうち1.0 がでるらしい  これはstandard になるのか?  新たなflavor の登場になってしまうのか?  markdown だけでもこれだけ話題がある  詳しくは今月のWEB+DB の@takahashim の記事で!
  19. 19. ドキュメントの話、しませんか?  他にも切り口はたくさんある  出版する際の注意点、ツール選び  翻訳に役立つツール  ドキュメントの翻訳で本家の更新を追いかける方法  同人誌を作るときのポイント  用語を統一する方法  自動生成(API リファレンスなど)  その他もろもろ
  20. 20. ドキュメントの話、しませんか?  話題はあるのに場がない(ような気がする)  ドキュメントコミュニティはバラバラに活動している  マークアップ言語ごと  プログラム言語ごと(Ruby 界隈、Python 界隈…)  活動(出版、翻訳…)  知見が共有されづらい  ツールも共有されづらい  バラバラに同じ問題を解決し続けている  そんな話をする仲間がほしい!!  工夫してること、苦労してること、シェアしたい
  21. 21. ドキュメントの話、しませんか?  来月に版管理+自動組版というイベントがあります  まずは版管理や組版(出版方面)の話から
  22. 22. まとめ  ドキュメントの話、しませんか?  工夫してること、苦労してること、気になっ てること、シェアしませんか  やりかたはこれから考えていきます  詳しくは@tk0miya まで!

×