個人的なさがしもののはなし #rubyhiroba

個人的なさがしもののはなし

小宮健 (Takeshi KOMIYA) @tk0miya

#rubyhiroba LT-thon!

Who am I ?

仕事( 株 ) タイムインターメディア所属

参加コミュニティSphinx-users.jpPython mini hack-a-thonPython の方から来ました

Twitter: @tk0miya

Who am I ?

blockdiag というツールを作ってますテキスト (DSL like .dot) から画像を生成します

{ トップページ -> ログイン -> マイページ ; トップページ -> 商品一覧 -> 商品詳細 ;}

Who am I ?

“ 昨日誕生日でした” .!.! # => true

https://www.flickr.com/photos/ayca13/9179835693

( イメージ画像です )

AD: SphinxCon のお知らせ

みなさん、ドキュメント書いてますか？10/26( 日 ) に SphinxCon JP 2014 を開催し

ます

テーマ『 Sphinx をはじめよう』ドキュメンテーションツールとの出会いをあたらしい使い方を知るきっかけに演題、参加者ともに募集中です「 SphinxCon JP 」で検索！

さがしてますその１

さがしてます

さがしてます： Ruby Friends

Ruby の知り合い ( 友達？ ) をさがしてます。以前は Rubyist だったのにすっかり Python の人作るものは Python のものばかりRubyKaigi には参加するけど、いつもぼっち






というわけで…地域 Ruby に飛び込みたい池袋、新宿、四ツ谷界隈の *.rb 教えてください！

さがしてますその２

さがしてます： DocTool Friends

ドキュメント仲間ドキュメントツールについて語り合いたいテキストマークアップのツールを作りたい、改善し

たい

たとえば？


ドキュメントツールの話題って？出力フォーマットの話 ( とその苦労話 )


ドキュメントツールの話題って？出力フォーマットの話 ( とその苦労話 )

HTMLPDF

ePub

ePub ( 縦書き )HTML + JS


ドキュメントツールの話題って？出力フォーマットの話 ( とその苦労話 )表現やメンテナンスについて ( とその苦労話 )


ドキュメントツールの話題って？出力フォーマットの話 ( とその苦労話 )表現やメンテナンスについて ( とその苦労話 )

画像の埋め込み数式

その他 ( 動画、 slideshare)

自動生成 / 抽出

シェアする方法

継続的メンテナンス

拡張方法Cacoo

テーブル

Visio

Astah


ドキュメントツールの話題って？出力フォーマットの話 ( とその苦労話 )表現やメンテナンスについて ( とその苦労話 )ドキュメントの用途 ( とその苦労話 )


ドキュメントツールの話題って？出力フォーマットの話 ( とその苦労話 )表現やメンテナンスについて ( とその苦労話 )ドキュメントの用途 ( とその苦労話 )

手順書マニュアル出版

仕様書

スライド

Web サイトブログリファレンス


ドキュメントツールの話題って？出力フォーマットの話 ( とその苦労話 )表現やメンテナンスについて ( とその苦労話 )ドキュメントの用途 ( とその苦労話 )マークアップ言語 ( とその苦労話 )


ドキュメントツールの話題って？出力フォーマットの話 ( とその苦労話 )表現やメンテナンスについて ( とその苦労話 )ドキュメントの用途 ( とその苦労話 )マークアップ言語 ( とその苦労話 )

markdown

Re:VIEW

reStructured TextTeX

RD/rdoc

YARD

textile

各種 Wiki 文法

org-modePOD はてな記法 AsciiDoc

DocBookroff

XML


たとえば markdown を例に取ってどんなツールを使ってますか？

Github? Jekyll? Octpress? Pandoc? md2inao? reveal.js?

どうやって編集してますか？Vim? Emacs? Kobito? Sublime? etc?

困ってること、工夫してることありますか？画像の作り方、環境の作り方、シェアの仕方、 etc.markdown で表現できないことはどうしてる？

標準化ってどうなってますか？


Markdown 2 (http://markdown2.github.io/site/)

作られたっきり更新されてない…

http://markdown2.github.io/site/

http://markdown2.github.io/site/


Internet Draft (The text/markdown Media Type)2014/7/4 に公開Content-Type: text/markdown; charset=UTF-8;

flavor=GitHubthe IANA Markdown Flavors Registry本気なの !?

2014/9/9 に更新されてたContent-Type: text/markdown; charset=UTF-8;

rules=GitHubflavor → rules に変更まだ続く模様


standardmarkdown.comA strongly specified, highly compatible

implementation of Markdown

John Gruber (markdown 作者 ) からツッコミが！リネームすることになったStandardmardown.com を閉じることになった謝罪することになった

＿人人人人人人人人人人人人人人人人人＿＞　突然の This domain was disabled 　＜￣ Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y ￣


commonmark.com元 standardmarkdown仕様も実装もあるThe current version of the CommonMark spec

is complete と言ってるそのうち 1.0 がでるらしい

これは standard になるのか ?新たな flavor の登場になるのか ?


markdown だけでもこれだけ話題があるマークアップ言語、ツールごとにに得意、不得意が

あるそんな話をする仲間がほしい !!

まとめ

SphinxCon やりますRuby 仲間にしてくださいドキュメントツール仲間をさが

しています@tk0miya まで！

Technology

個人的なさがしもののはなし #rubyhiroba