RSS

どのようなものか

RSSは、フィードを公開するXML形式です。サイトを説明する一つの
`channel`要素の中に、リンク、日付、本文を持つ投稿を表す`item`要素の
一覧を収め、フィードリーダーが定期的に取得するアドレスで公開します。
仕様は名前をReally
Simple Syndicationと綴っていますが、形式に関係なくフィードを「RSS
フィード」と呼ぶ人も多くいます。RSS
1.0、すなわち「RDF Site Summary」は、現在使われる形式の古い版ではな
く、RDFに基づく別の形式です。

この形式はNetscapeで始まり、同社がRSS
0.90を1999年3月、0.91を同年7月に公開しました。UserLandは独自の0.91を
2000年6月に公開し、続いて0.92、2002年8月にはRSS
2.0を公開しました。Harvard Law SchoolのBerkman Klein Centerは、Dave
Winerが書いた2.0.1を2003年7月に公開し、それ以降、RSS Advisory Board
がCreative
Commonsライセンスの下で仕様文書を維持しています。ロードマップは、実
用上、形式を2.0.1で凍結したとしています。その後も委員会は文書を改訂
し、現行の版は2009年3月のものですが、新しい要件にはRSSの新版ではな
く、独自のXML名前空間を持つ拡張で対応します。

文書の構造は小さなものです。ルートは`rss`要素で、`version`属性は
`2.0`でなければならず、その中に一つの`channel`を置きます。チャンネル
には`title`、`link`、`description`が必要です。項目の各要素は任意です
が、表題か説明の少なくとも一方は必要です。それ以外は、`pubDate`や
`guid`から、チャンネルの`image`や`ttl`まで、発行者が必要なものを入れ
ます。

```xml
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
  <channel>
    <title>Example Notes</title>
    <link>https://example.com/</link>
    <description>Short notes on running servers.</description>
    <item>
      <title>Moving the database</title>
      <link>https://example.com/notes/db-move/</link>
      <guid isPermaLink="true">https://example.com/notes/db-move/</guid>
      <pubDate>Sat, 17 Oct 2026 09:00:00 GMT</pubDate>
      <description>Why the move took one evening.</description>
    </item>
  </channel>
</rss>
```

なぜ重要なのか

RSSの仕様は緩やかで、発行者はその緩やかさを理解する必要があります。
項目の`description`には、プレーンテキストも、要素内にエスケープして
入れたHTMLも格納でき、ファイルにはどちらかを示すものがないため、リー
ダーが判断します。`guid`は任意なので、なければ、項目が新しいかをリー
ダー自身が判断します。日付は、メール標準RFC
822（1982年）に従い、`Sat, 17 Oct 2026 09:00:00
GMT`のように、英語の曜日名と月名を含む文字列で書きます。仕様は、今で
も2桁の年を認めています。また、ベースURLを宣言する手段がないため、項
目内の相対リンクには、確実な解決の基準がありません。

これに対する委員会の回答が、2007年10月公開のRSS Best Practices
Profileです。幅広い読み取りソフトウェアで動く文書のための推奨事項を
まとめています。各項目への`guid`と、リンクおよび説明中の絶対URLを求
めています。また、試験したすべてのアグリゲーターが扱えた日付形式は、
末尾が`GMT`、`+0000`、`-0000`となる世界時だけだったと報告していま
す。フィード自身のアドレスを示す`atom:link`に`rel="self"`を付ける方
法も説明しています。このプロファイルに従ったフィードなら、リーダーが
推測する必要は大きく減ります。

現在のフィードで加えられる内容の大半は、二つの拡張が担います。
`atom:link`は、Atomからその要素を借ります。`content:encoded`は、もと
もとRSS
1.0向けに書かれたモジュールに由来し、項目のHTML全文を格納します。プ
ロファイルは、全文を`content:encoded`、短い要約を`description`に入れ
て併用する方法を説明しています。また、両方がある項目では、試験した8
種類のアグリゲーターのうち6種類が、`content:encoded`を表示して要約を
無視したと報告しています。`enclosure`要素は、三つの必須属性、`url`、
バイト単位の`length`、MIME形式を示す`type`で、項目にメディアファイル
を添付します。

凍結されていることは、強みでもあります。2003年以来変わらない形式な
ら、実装の対象が固定され、今日その形式で書いたフィードも、何年も前に
同じ仕様に基づいて書かれたソフトウェアで読めます。Atomは、上記の不足
の大半を仕様で解消しています。そのため、RSSも併せて公開する理由は、
厳密さよりも読者にあります。RSSしか読めないリーダーもあり、何年も前
に配ったRSSのアドレスも、今なお定期的に取得されています。

実際の活用例

このサイトは、AtomフィードとJSON Feedに加え、`/ja/index.xml`でRSS
2.0を公開しています。クレジットのページは、XMLフィードを二つ用意する
理由を説明しています。三つとも全文を収め、XMLを一つではなく二つにす
るのは、どちらか一方しか読めないリーダーがあり、常にどちらか一方を選
べばよいとは限らないためです。同ページは、Atomと並べてRSSフィードも
W3C
Feed Validatorへリンクし、誰でもこのサイトの説明を信じるだけでなく、
自分で検査できるようにしています。

ターミナルからこのサイトを読むページは、フィードをデータとして扱って
います。実績を三つの形式で配信し、各形式が抜粋ではなく、全項目の全文
を含むと説明し、RSSを`curl`だけで取得しています。

```sh
curl -s https://engineer.company/ja/index.xml
```

問題が起きるところ

チャンネルの画像が出ず、検証サービスにも指摘される。
フィード名の横に画像が表示されず、W3Cのサービスが画像形式を警告しま
す。RSSの`image`要素は、三つのフィード形式の中で、画像への制約が最も
厳しく、GIF、JPEG、PNGだけを認め、幅は最大144ピクセル、高さは最大400
ピクセルです。WebPの共有カード画像は適しません。このサイトのRSSテン
プレートは、代わりに144ピクセルのPNGアイコンを`image`に指定していま
す。隣のコメントには、変更後の再検証によって、WebPカードが
`ImageUrlFormat`の警告を招いていたと分かったことを記録しています。

項目の順序が違っても、何も報告されない。
リーダーが新しい項目を古い項目の下に並べたり、誤った日付を表示したり
します。RSSの日付は文字列なので、ISO
8601の日付、書式の誤記、別の言語の曜日名でも、XMLとしては正しく、気
付くのはリーダーの日付パーサーだけです。Hugoでは、日付の`Format`メ
ソッドは英語名を書き、`time.Format`関数は言語に合わせます。デンマー
ク語の`pubDate`は、RFC
822の日付ではありません。このサイトは、Atom用の書式とともに一つの部
分テンプレートに置いた書式を使い、メソッドで各`pubDate`を整形してい
ます。そこのコメントは、どちらかの誤記がビルドの失敗ではなく、誰かの
リーダーで誤って解析・整列されるフィードを生むと説明しています。

投稿のアイコンが出ず、検証サービスがエラーを並べる。
`content:encoded`の全文は元のページから離れるため、ページに依存する
ものは失われます。ページ内の別の場所に定義したスプライトを参照する
SVGアイコンは、リーダーでは何も描かず、W3Cのサービスは`svg`自体も指
摘します。そのため、このサイトのフィードでは、ブランドの歯車の区切り
を付けずに見出しを渡します。そのテンプレートのコメントには、検証サー
ビスが`Non-html
tag: svg`を12件、`role`属性に関する指摘を6件報告したと記録していま
す。

投稿内のリンクが、どこにもつながらない。
購読者が項目内のリンクをたどると、存在しないページに着いたり、何も開
かなかったりします。`/notes/`のようなルート相対リンクは、ブラウザー
がページのアドレスを知っているため、ウェブページ上では機能しますが、
RSS文書はベースURLを宣言できません。プロファイルは、説明に相対URLを
含めるべきではなく、アグリゲーターは、チャンネルの`link`を基準に解決
を試みてもよいとしています。試みないリーダーでは、壊れたリンクのまま
です。フィードのHTML内では、すべてのリンクを絶対URLにします。

同じ語を持つ二つのカテゴリーが、一つに見える。
二つの語彙でタグ付けした項目に、同じ用語が二度表示されたり、意味の異
なる二つの用語をリーダーが統合したりします。RSSの`category`要素に
は、用語が属する語彙を示す任意の`domain`属性があります。このサイトの
RSSテンプレートは、すべてのカテゴリーに付けています。コメントが説明
するように、domainがなければ、二つの語彙で重なる用語が重複して見える
ためです。

参考資料

  * RSS 2.0仕様 — RSS Advisory Boardによる、要素ごとの形式の説明と、
凍結を宣言するロードマップです。

  * RSS Best Practices Profile — 実際のアグリゲーターの試験結果を含
む、委員会の推奨事項です。

  * RSSの歴史 — Netscapeの0.90から現行文書まで、各版の日付と公開者を
記録しています。

  * RDF Site Summary（RSS）1.0 — 同じ名前を使う、RDFに基づく別の形式
です。

  * RFC 822 — RSSが今も日付と時刻の構文に使う、1982年のメール標準で
す。

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