archive document

アーカイブ文書 (Atom)

[2] アーカイブ文書 (archive document) は、 アーカイブされたフィードの一部であって、購読文書より前のエントリーを含むフィード文書です。

仕様書

性質

[3] 特定の URL で出版されたアーカイブ文書に含まれるエントリーの集合は、 時を経て変化するべきではありません。同様に特定のアーカイブ文書URL は時を経て変化するべきではありません>>1

[19] アーカイブ文書は安定していて実質的に変更されないとクライアントは仮定して構わないことになっており、 従ってアーカイブ文書に含まれるエントリーが変更されても、クライアントはそれを再取得しないかもしれません。 ですからアーカイブ文書に加えて (またはその代わりに) 購読文書に変更されたエントリーを含めることを検討するべきです >>1

[20] アーカイブ文書は、そのすべてを公開し続けることが要求されているわけではありません >>1。 一定の配信期間を経過したら削除するような場合でも、過去のアーカイブ文書にアクセスできなくなりますが、 理論上は論理フィードの全体を提供しているとみなすようです。

リンク関係型

[4] アーカイブ文書ではリンク関係型として prev-archive, next-archive, current が使われます。

[5] prev-archive は、直前のアーカイブ文書URL を表します >>1。 このリンク関係型購読文書でも使われます。アーカイブ文書は、それ以上前のアーカイブが無い場合を除き、 prev-archive リンクを含まなければなりません >>1

[6] next-archive は、直後のアーカイブ文書URL を表します >>1アーカイブ文書は、それ以降のアーカイブが無い場合を除き、 next-archive リンクを含むべきです >>1

[7] current は、dereference すると論理フィード中の最新のエントリーを含んだフィード文書が得られる URL を表します >>1アーカイブ文書購読文書を参照する current リンクを含むべきです >>1

[8] なぜ current の定義が購読文書ではなく >>7 のような説明になっているのかは謎です。

[11] 購読文書アーカイブ文書でありません。定義上、アーカイブ文書購読文書となることは不可能とは断言できませんが、 一般的ではなさそうです。

fh:archive 要素 (Atom)

[10] fh:archive 要素フィードアーカイブ文書であることを表します。

文脈

[9] アーカイブ文書頭部fh:archive 要素を含めるべきです >>1

[14] すなわち、 Atom 1.0atom:feed 要素atom:entry 要素より前の部分や RSS 2.0channel 要素item 要素より前の部分で使うことができるようです。

[15] 明確には定義されていませんが、それ以外、例えば atom:entryatom:source の中では使えなそうです。

属性

[13] 属性はありません。

内容

[12] fh:archive 要素空要素です。 内容は定義されていません。 >>1

メモ

[16] fh:archive 要素はなぜか必須ではないようなので、 アーカイブ文書であるかどうかを確実に判別する方法はありません。 prev-archivenext-archive は参照先がアーカイブ文書とされているので、そこから推定することはできそうです。

歴史

[21] アーカイブ文書の3つのリンク関係型Atomリンク関係型の登録簿に >>1 で登録されています。このうち current は、 >>1 で定義を更新する形になっています。

[18] アーカイブ文書の3つのリンク関係型Web Linking の登録簿に >>17 で登録されています。なおこの登録簿は Atom の登録簿を置き換えるものです。