Edit

Page

Page title:

Page body:

[27] 本項では、 [[Web]] 技術を規定する[[仕様書]]の探し方をご紹介します。

* 特に必要がなければ、開発者向けドキュメントを読みましょう

[1] たまに[[仕様書]]を読めと意味もなく言っている人もいますが、[[仕様書]]は開発者向けドキュメントではありません。
一般開発者に理解しやすいことを目的に書かれたものではありません。
前提知識がなく間違った解釈をして、[[仕様書]]を読んだから正しいと勘違いしてしまうのは、
変な自信を持ってしまう分、厄介です。[[仕様書]]を読むのが偉いということはありません。

[4] ドキュメントとしては [[MDN]] (>>3) がおすすめです。 [[Mozilla]] の運営するサイトですが、
他の[[Webブラウザー]]の情報もあります。

[10] どの [[Webブラウザー]]がどの機能を実装しているかは、 [[caniuse]] (>>9) を見ましょう。
[[仕様書]]には書いていない有用な情報です。

[REFS[
- [3] [CITE@ja[Mozilla Developer Network]] ([TIME[2016-03-05 23:18:28 +09:00]] 版) <https://developer.mozilla.org/ja/>
- [9] [CITE@en-US[Can I use... Support tables for HTML5, CSS3, etc]] ([TIME[2016-03-05 15:46:30 +09:00]] 版) <http://caniuse.com/>
]REFS]

* 英語の原文を読みましょう

[2] [[Web]] の技術は日進月歩です。残念ながら、[[日本語]]で得られる正しい情報はほとんどありません。

[5] たまに[[仕様書]]を[[日本語]]に翻訳したものが公開されていることがありますが、
翻訳が正しいかどうかはっきりしないものばかりですし、
原文の更新に追従できていないものが多いです。

[6] [[日本語]]で読みたいなら、[[仕様書]]ではなく開発者向けドキュメントを読みましょう。
最新の生の情報が知りたいなら、がんばって[[英文]]を読んでください。
[[日本語]]訳された[[仕様書]]は、どちらの役にも立ちません (むしろ有害です)。

* 最新版を読みましょう

[23] [[Web]] の技術は日進月歩です。[[仕様書]]もかなり頻繁に更新されます。
分野によっては一日に何度も更新されています。

[24] そんなに変化が速いと追いつけないという人もいますが、
何もかもがランダムに変化するわけではありません。
華のある新機能もそこまで頻繁に追加されるわけではありません。
多くの変更はバグ修正や明確化や、失敗して使われていない機能の削除のような、
地味なものです。
ですから、最新版ほど厳密で、現実に近いものとなっているはずです。

[25] ページの最初の方に更新日が記載されているはずですから、
まずそこを確認しましょう。ごく最近に更新されたものか、
せめて数ヶ月以内に更新されたものでなければ、間違ったものを読んでいる可能性があります。

;; [26] 間違って古い版を見ているのかもしれませんし、
何かの理由で他の [[URL]] に[[仕様書]]が移動したのかもしれませんし、
捨てられた技術なのかもしれません。

* 主要な仕様書の一覧

[REFS[
- [7] [CITE[The Web Platform: Browser technologies]] ([TIME[2016-02-22 16:56:25 +09:00]] 版) <https://platform.html5.org/>
]REFS]

[8] 現在有効なほとんどの[[仕様書]]はここに掲載されています。

* 探し方

[12] [[Mozilla]] の新[[レンダリングエンジン]]プロジェクトの [[Servo]]
の [[Wiki]] に参照するべき[[仕様書]]の見つけ方をまとめられています。

[REFS[
- [11] [CITE@en[Relevant spec links · servo/servo Wiki]] ([TIME[2016-03-05 23:27:15 +09:00]] 版) <https://github.com/servo/servo/wiki/Relevant-spec-links>
]REFS]

[13] いくつかの[[仕様書]]は [[WHATWG]] 版と [[W3C]] 版があります。
[[WHATWG]] 版がよくメンテナンスされているので、そちらを見ましょう。

[22] [[HTML]] や [[DOM]] は [[WHATWG]] にあります。

[REFS[
- [16] [CITE[Web Hypertext Application Technology Working Group Specifications]] ([TIME[2016-02-14 14:02:41 +09:00]] 版) <https://spec.whatwg.org/>
]REFS]

[17] [[CSS]] 関係の[[仕様書]]は、 [[CSS WG]] の文書一覧 (>>18) からリンクされています。
複数あるときは、 Current Work と書かれているものを読むと良いでしょう。

[20] 単独の [[CSS]] [[仕様書]]が見つからない機能は [[CSS 2.2]] に含まれています。
(単独の [[CSS]] [[仕様書]]にあるのか [[CSS 2.2]] にあるのかは、 >>19
に表があります。)

;; >>18 の一覧では [[CSS 2.1]] と書かれているのが [[CSS 2.2]] です。

[REFS[
- [18] [CITE@en[CSS Working Group Editor Drafts]] ([TIME[2016-03-05 23:33:24 +09:00]] 版) <https://drafts.csswg.org/>
- [19] [CITE@en[Relevant spec links · servo/servo Wiki]] ([TIME[2016-03-05 23:34:55 +09:00]] 版) <https://github.com/servo/servo/wiki/Relevant-spec-links#user-content-css-2>
]REFS]

[14] その他 [[W3C]] の[[仕様書]]は、 [[Editor's Draft]] と書かれているものをみましょう。
[[Editor's Draft]] でないものを見ている場合は、
ページの最初の方に並んでいる[[リンク]]からたどれます。

;; [15] [[URL]] に [CODE[/TR/]] と入っているものや、
ページの最初の方に [[Recommendation]] と大書きされているものは、
古い版である可能性が高いです。最近のほとんどの [[W3C]]
の[[仕様書]]は [[GitHub Pages]] にあります。

[REFS[
- [21] [CITE@en[World Wide Web Consortium]] ([TIME[2016-03-05 23:38:06 +09:00]] 版) <https://github.com/w3c/>
]REFS]

* 仕様書の読み方

[29] [[仕様書]]を読む上での注意は色々ありますが、 [[HTML Standard]]
は次のような方法を提示しており [SRC[>>28]]、これは他の[[仕様書]]を読む時にも必要なことです。

[FIG(quote)[
[30] 
>
この[[仕様書]]は、他のあらゆる[[仕様書]]と同じように読む[SHOULD[べきです]]。
まず、最初から最後まで、何度も読む[SHOULD[べきです]]。
次に、少なくても1回は、逆向きに読む[SHOULD[べきです]]。
更に、[[目次]]から適当な[[章節]]を選んで読んで、
すべての[[相互参照]]をたどって読む[SHOULD[べきです]]。
]FIG]

[31] つまり、一度や二度読んだだけで満足しては駄目で、何度も隅から隅まで読み込む必要があります。

[REFS[
- [28] [CITE@en-GB-x-hixie[HTML Standard]] ([TIME[2016-03-04 19:12:53 +09:00]] 版) <https://html.spec.whatwg.org/#how-to-read-this-specification>
]REFS]

Historical Legal Sensitive Parent: [Help / License]

Edit

Page

Page name(s)