RFC は読みづらい。いまどき横幅固定出しタイプライタみたいなフォントだし携帯で読むと字が小さすぎる。どう考えても理想的な表示では無いので原稿を入手して自分でフォーマットしたいと思った。
目標: https://tools.ietf.org/html/rfc6749 を携帯で読みやすく。
仮定: RFC の HTML フォーマットにはリンクも付いている事だし、なにかの原稿を元に作られているに違いない。整形前の原稿が手に入れば携帯で読めるよう好きにフォーマットし直せるのではないか?
この整形前の原稿を手に入れるためには、RFC がどのように書かれるのかを調べれば良い。Publication Process から辿ってゆくと次の事が分かった。
- 著者は RFC として公開する前にまず Internet-Draft を投稿する。
- 投稿は Internet-Draft submission のフォームを使う。
- 投稿フォーマットとして最低限 xml か txt を選ぶ。片方だけを投稿するともう片方はツールで生成される。
-
xml2rfc: xml -> txt 変換
- The "xml2rfc" Version 2 Vocabulary: XML フォーマット
- 例えば OAuth2.xml
- id2xml: txt -> xml 変換
- その他 Tools for Creating Internet-Drafts に色々なツールがある。
- kramdown-rfc2629 最近よく使われるらしい。
-
xml2rfc: xml -> txt 変換
ということで、RFC の xml ソースコードがあればもうちょっとましに整形出来る事が分かった。
実際、ietf のサイトでも読みやすく整形されたドラフト版の XML は見つかった。。https://tools.ietf.org/id/draft-ietf-oauth-v2-31.xml
不思議な事に RFC の xml は見当たらなかった。見つかったら続きを書きます。
参考
-
RFC/Internet-Draftの書き方
- 発表資料(藤原) が分かりやすい。