フィード

どのようなものか

フィードは、固定のアドレスに置かれ、サイトの最新の記事などを、ソフト
ウェアが読める形で並べたファイルです。各項目には、題名、日付、変わら
ない識別子、通常は本文もあります。プログラムが定期的に取得し、新しい
ものだけを人へ見せられます。ウェブフィードや配信用フィードとも呼び、
形式にかかわらず、すべてを「RSSフィード」と呼ぶ人も多くいます。

違いは、情報が動く向きです。ニュースレターは、発行者がアドレス一覧を
持ち、全員へ送る、プッシュ型です。フィードは、取得する側から動く、プ
ル型です。発行者がサーバーへ一つのファイルを置き、各購読者のフィード
リーダーが取得し、前回の複製と比べ、初めて見る項目を保持します。発行
者は誰が購読したかを知らず、購読者はメールアドレスを渡さず、やめるに
は、リーダーの一行を消すだけです。

ウェブ上のほぼすべてのフィードを、三形式が担います。RSS 2.0はXMLで、
項目の日付はRFC 822形式の`Sat, 07 Sep
2002 00:00:01 GMT`のように書き、仕様自体が、形式を凍結済みとします。
Atomは、IETFが2005年12月にRFC
4287として公開しました。こちらもXMLで、より厳密です。各フィードと項
目には、恒久的な`id`と、RFC
3339形式の`updated`のタイムスタンプがあり、どこかに著者の記載が必要
です。JSON
Feedは、2020年8月からバージョン1.1で、XMLを解析したくない開発者向け
に、同じことをJSONで表します。

ページは、head内の`<link
rel="alternate">`要素で、フィードの場所をソフトウェアへ知らせます。
各要素は、`application/rss+xml`、`application/atom+xml`、
`application/feed+json`のいずれかのメディアタイプを指定します。その
ため、リーダーは、サイトの通常のアドレスだけから、フィードを見つけら
れます。

なぜ重要なのか

最初の判断は、そもそも公開するかです。フィードは、ソーシャルネット
ワークより小さい読者層のために、テンプレートを作り、検証し、何年も安
定させる、追加の出力です。一方、プラットフォーム、アカウント、配信先
一覧のどれも不要な、唯一の購読経路です。投稿と、それを読みたいと求め
た人の間に、順位付けのアルゴリズムも入りません。

二つ目は、どの形式にするかです。RSSしか受け付けないリーダーも、Atom
しか受け付けないものもあり、購読者のリーダーがどちらを求めるかは、先
に分かりません。両方を出せば、二つ目のテンプレートを維持する負担で、
その隙間を埋められます。JSON
Feedは、JSONを扱いたい開発者のソフトウェア向けに、三つ目を加えます。
形式が増えるたびに、同じ項目、識別子、日付を保つファイルも増えます。

三つ目は、各項目に入れる本文の量です。全文フィードなら、リーダー内で
全部読めます。リーダーを使う理由の大きな部分ですが、発行者のページ閲
覧数は減ります。要約だけなら、項目ごとに全読者をサイトへ送ります。ど
ちらも誤りではなく、文章が届く範囲と、ページ自体への訪問回数の、どち
らを選ぶかです。

答えが何であっても、アドレスは約束になります。リーダーは、受け取った
URLを、それぞれが決める間隔で繰り返し取得し、何年も続けるものも多く
あります。RSSでは、`ttl`で分単位の間隔を提案できますが、リーダーは無
視してもかまいません。一度公開したフィードのアドレスは、残り続けま
す。

実際の活用例

このサイトは、ホームページから、`/index.xml`のRSS、`/atom.xml`の
Atom、`/feed.json`のJSON
Feedという三形式を公開します。クレジットのページが、形式と検証サービ
スを挙げます。すべて全文を含みます。XMLを二つ出すのは、どちらか片方
しか読まないリーダーがあり、確実にどちらか一つへ絞れないためです。
W3C
Feed ValidatorがAtomとRSSを調べ、JSON Feed
Validatorが三つ目を調べます。W3Cのサービスは、JSON
Feedより前からあるため、その形式を対象にしません。W3Cのサービスは、
多くの項目の更新日が同じと警告します。ページは警告を隠さず残します。
日付はgitの履歴から取り、多くのページを、同じ少数のコミットで書いた
ためです。

連絡先のページは、アカウントなしで会社の発信を追う方法として、フィー
ドを案内します。ソーシャルプロフィールと並べ、三形式とも、公開するも
のすべての全文を含むと、改めて説明します。

三形式のどれも、手書きやリクエスト時の生成ではありません。サイトを
作ったプロジェクトでは、実行時のバックエンドなしに、すべてをビルド時
に生成します。一つのコンテンツツリーから、各ページを複数の表現で公開
し、ホームページには、三つの配信フィードと、インストール可能なアプリ
のマニフェストも加えます。

問題が起きるところ

古い項目が、すべて新着として戻ります。
デザイン、ドメイン、テンプレートを変えた後、何か月も前に読んだ項目
が、何十件も現れます。リーダーが項目を見分けるのは、Atomの`id`、RSS
の`guid`、JSON
Feedの`id`という識別子です。文字列が変われば、新しい項目になります。
RFC
4287は、移動、移行、再公開の後も、項目の`id`を保たなければならないと
明記します。恒久リンクがよい識別子になるのは、移動後も古い文字列を保
つと約束している間だけです。RSSでは、`guid`が何かも示します。仕様は
`isPermaLink`の既定値を真としますが、このサイトは、それでも
`isPermaLink="true"`を書きます。逆に推測するリーダーが、すべてを重複
して取り込むためです。

ビルドのたびに、変更したと宣言します。
公開したものがなくても、再ビルドのたびにフィード全体の日付が進むと、
その日付を見て新着を検知するソフトウェアが、何もないのに反応します。
原因は、ビルド時の時計を使うテンプレートです。RSSは`lastBuildDate`を
「チャンネルの内容が最後に変わった時刻」と定義し、Atomのフィード全体
の`updated`も同じ意味です。代わりに、最新の項目から取るべきです。こ
のサイトのAtomテンプレートも、そのため、最新の項目を使います。

文字の表示を変えた後、解析できなくなります。
リーダーはフィードの破損を報告し、検証サービスは、スマートクオートを
含む最初の記事で、未定義の実体を指摘します。XMLが定義済みとする名前
付き実体は、`lt`、`gt`、`amp`、`apos`、`quot`の五つで、HTMLには、さ
らに何百もあります。引用符やダッシュをHTMLの名前付き実体で出す
Markdownレンダラーは、ページでは問題なくても、XML要素内では致命的な
マークアップを作ります。Atomの`type="html"`の内容が求めるように、入
れる前にHTMLをエスケープするか、RSS
Best Practices
Profileが`content:encoded`に認める、CDATAセクションで囲みます。この
サイトのAtomテンプレートは、内容をエスケープします。隣のコメントに
は、生のままでは、まったく解析できなかったと記録があります。

移動後に購読者が離れても、誰も知りません。
フィードには、購読解除ボタンも、人数が減る一覧もなく、分かるのは沈黙
だけです。アドレスを変えたりファイルを消したりすると、古いURLを取得
するすべてのリーダーが、エラーを受け取ります。元のアドレスで、フィー
ド自体か恒久リダイレクトを返し続けます。このサイトは、既存のリーダー
が取得する、使用中の生成ツールの既定パス、`/index.xml`にRSSを保ちま
す。告知していない言語でも、項目がゼロの、整形式のフィードを生成しま
す。リーダーは、404ではなく、有効な文書を受け取れます。

購読ダイアログで、二つのフィードが一つになります。
ページは二つを宣言しても、ブラウザー拡張やリーダーには、一つしか出ま
せん。同じメディアタイプ、同じ題名の代替リンクは、同じフィードに見え
るため、最後に見た方だけを載せます。それぞれに別の題名を付けます。こ
のサイトは、サイト名の後に「(RSS)」「(Atom)」「(JSON
Feed)」を付けます。

参考資料

  * RFC 4287：Atom配信形式 — 必須要素、恒久的な識別子、RFC 3339の日
付を定める、IETFの標準です。

  * RSS 2.0仕様 — RSS Advisory Boardによる、凍結済み形式の、要素ごと
の仕様です。

  * JSON Feedバージョン1.1 — 同じ考え方のJSONでの表現と、バージョン
1.0からの変更です。

  * HTML標準：リンク種別「alternate」 — ページが、フィードの場所をソ
フトウェアへ示す方法です。

  * W3Cフィード検証サービス — アドレスからRSSやAtomを検証し、各警告
を説明します。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/feed/	engineer.company	70
