1. この夏の最新
Text::Hatena
をお届けします!!
2012/08/18
大西康裕 (id:onishi) はてな

2. 自己紹介
• id:onishi - 大西康裕
• 株式会社はてな (2001∼)
• チーフエンジニア
• はてなブログディレクター
• @yasuhiro_onishi
• PAUSE: ONISHI - Devel::KYTProf

3. Text::Hatena とは
はてな記法を
HTMLに変換
するモジュール

4. はてな記法とは
• はてなブログやはてなダイアリーやはてなグ
ループで使える書式
• かんたんな記述でHTML文書構造や自動リン
クが書ける
• hatenadiary.g.hatena.ne.jp/keyword/
はてな記法一覧

5. 入力支援（ブロック記法）

6. 自動リンク（インライン記法）

7. たくさんのText::Hatena
• Text::Hatena ∼0.16 (jkondo)
• https://metacpan.org/release/JKONDO/Text-Hatena-0.16
• Text::Hatena 0.20 (jkondo)
• https://metacpan.org/module/Text::Hatena
• Text::Xatena (cho45)
• https://metacpan.org/module/Text::Xatena
• Text::HatenaLite (wakabatan)
• https://github.com/wakaba/perl-text-hatenalite

8. Text::Hatena # ∼0.16
use Text::Hatena; # 0.16
my $parser = Text::Hatena->new;
$parser->parse($text);
my $html = $parser->html;

9. Text::Hatena # 0.20
use Text::Hatena; # 0.20
my $html = Text::Hatena->parse($text);

10. Text::Xatena
use Text::Xatena;
my $thx = Text::Xatena->new;
$thx->format($string);

11. Text::HatenaLite
use Text::HatenaLite::Parser;
my $html = Text::HatenaLite::Parser
->parse_string($string);

12. もっとたくさんの…
• Hatena::Diary::HTMLParserBody
• Hatena2::Group::HTMLParserBody
• Hatena::Bookmark::TextFormat
• Hatena::Haiku::Body

13. Hatena::Diary::HTMLParserBody
• 最初のはてな記法 Parser
• 2008年までテストなかった
• 1200行のメソッド
• まだ使われています…

14. H::D::HTMLParserBody#makelink

15. 記法展開の難しさ(1)
テキストをHTMLにするものだけど
HTML::Parserベース
• はてな記法はHTMLタグが使える
• コメント記法
• スーパーPRE記法

16. 記法展開の難しさ(1)
<script>
ここは記法展開しないよ
</script>
<!--
ここは消えるよ
-->
>||
記法展開しないでPREになるよ
||<

17. 記法展開の難しさ(1)
<script>
>||
ここはどうなる？
||<
</script>
>||
<!--
ここはどうなる？
-->
||<

18. 記法展開の難しさ(1)
記法とHTMLを
同時に解釈しな
ければいけない

19. 記法展開の難しさ(2)
3つのことを同時にやっている
• 記法の展開
• キーワードリンク
• XSS対策(ホワイトリストによるscript制限)

20. 記法展開の難しさ(2)
どうしてこうなった
• 記法とキーワードリンクが密結合している
• []キーワードリンクしない記法[]
• 記法展開すると意味を失う

21. 記法展開の難しさ(2)
記法展開とキーワー
ドリンクを同時に行
わなければならない

22. このため
記法展開とキーワードリンクが密結
合であるため、Text::Hatena な
どの記法展開だけのモジュールを
作っても、実際のプロダクト（はて
なダイアリー）で利用できなかった

23. どうしよう

24. メタデータによる疎結合化
記法展開時に
「これ以上リンクしない」という
カスタムデータ属性を付与
<span data-unlink>
ここはこれ以上リンクしない
</span>

25. メタデータによる疎結合化
}
• 記法パーサ
• data-unlink属性を付与 疎結合化
• キーワードリンカ
• data-unlink属性を見てリンクを判断

26. The new Text::Hatena
• Text::Xatena をベースに
(©cho45)
• カスタムデータ属性を使って記法展開とキー
ワードリンクを疎結合化
• 過去（や類似）のインターフェース互換
• 多くのはてな記法に対応
• 実際にはてなブログで利用している

27. インターフェース後方互換
use Text::Hatena;
my $parser = Text::Hatena->new;
my $html = $parser->parse($string);
# Text::Hatena 0.16 style
my $html = $parser->html;
# Text::Hatena 0.20 style
my $html = Text::Hatena->parse($string);
# Text::Xatena style
my $html = $parser->format($string);

28. 単体でも使える便利モジュール
•Text::Hatena::Keyword
• キーワードリンカ
•Text::Hatena::Embed
• URL埋め込み支援([http:embed]記法)

29. Text::Hatena::Keyword
data-unlink 属性を考慮してキーワードリンク
my $parser = Text::Hatena::Keyword->new(
rules => [
qr/hoge|fuga/ => sub { sprintf '/keyword/%s', uri_escape($_) },
[qw/foo bar/] => sub { sprintf '/other/%s', uri_escape($_) },
],
);
my $words = $parser->extract($html); # 抽出
my $formatted_html = $parser->format($html); # リンク

30. Text::Hatena::Embed
URLを渡すといい感じにembed
my $embed = Text::Hatena::Embed->new;
my $html = $embed->render($url);
www.slideshare.net/onishi/oembed-texthatena

31. github.com/onishi/Text-Hatena
本日公開しました!!
どうぞご利用ください!!
pull request ください!!

32. はてなブログ
27週連続新機能リリース中
日本一開発がホットなブログ
hatenablog.com

33. 人材募集
• 株式会社はてなではエンジニアその他
全職種を募集しています
• 一緒にブログを作りましょう！
www.hatena.ne.jp/company/staff

34. ご清聴ありがとうございました