atom:entry 要素 (Atom 1.0)
[17] Atom 1.0 の atom:entry 要素は、
個々のエントリーを表します。この要素はエントリーに関連付けられているメタデータとデータの包含子の役割を果たします。
Atom 1.0 4.1.2.
[18]
- 局所名
entry
(「entry」 (「エントリー」) より)- 文脈
atom:feed の子要素として、
Atomエントリー文書の根要素として- 内容モデル
- 後述
- DOM界面
AtomEntryElement- 属性
仕様書
- [13] RFC 4287 - The Atom Syndication Format
- http://tools.ietf.org/html/rfc4287#section-4.1.1
- http://tools.ietf.org/html/rfc4287#section-4.1.2
- [8] RFC 5023 - The Atom Publishing Protocol ( 版) http://tools.ietf.org/html/rfc5023#section-10
文脈
[19] この要素は atom:feed 要素の子要素として用いることができます
Atom 1.0 4.1.2.。フィードに含まれるエントリーを表します。
[20] この要素は Atomエントリー文書の根要素として用いることができます
Atom 1.0 4.1.2.。
内容
[31] 次の要素を内容に含められます。
atom:author (0〜∞、条件付必須)atom:category (0〜∞)atom:contributor (0〜∞)atom:content (0〜1)app:control (0..1)app:edited (0..1)atom:id (1)- [9]
atom:link (0〜∞、追加制約あり) atom:published (0〜1)atom:rights (0〜1)atom:source (0〜1)atom:summary (0〜1、条件付必須)atom:title (1)atom:updated (1)thr:in-reply-to (0〜∞)thr:total (0〜1)- XML署名の要素 (Atom文書の項を参照)
必須の条件については、それぞれの項を参照。[16] RFC 4287 4.1.1.1. は、過去の経験から文章的な内容を含むフィードの方が含まないフィードよりも有用であり、応用によっては最低でもある程度の文章が含まれていないと動作が予測できなくなるものもあるとした上で、次のように助言しています。
- 空でない
atom:title を含めること - 空でない
atom:content を含めること (この要素を使う場合) - 空でない
atom:summary を含めること
(atom:content を含めない場合)
[11] 集成文書の atom:entry 要素は
app:edited 要素を含むべきです。
[27] alternate の項も参照してください。
[29] Atom Threading Extensions の2つの要素については、それぞれの項を参照してください。
[33] 次のものが使われることもあります。dc:subjectmedia:thumbnailgd:extendedPropertyactivity:verbactivity:objectre:rankhatena:formatted-contenthatena:syntaxsnf:relatedLinksnf:advertisementsnf:analyticsmastodon:scopecbl:*cblNtf:*cblGrp:*cblSch:*cblChat:*cblTsk:*sx:*hatenablog:custom-url
順序
[21] Atom 1.0 仕様書は atom:entry の子要素の順序に意味を与えていません
Atom 1.0 4.1.2.。
識別
[14] Atomフィード文書内に同じ atom:id の
atom:entry 要素が複数存在する場合、それらは同じエントリーを表します。
その場合、それらの atom:updated は異なっているべきです。
Atom 1.0 4.1.1.
レンダリング
[12] Thunderbird 2.0.0.18 は、 content 要素が含まれている場合、
「プレーンテキスト」、「シンプル HTML」、「オリジナル HTML」
のいずれでも content 要素をレンダリングするようです。
(表示の仕方はそれぞれで異なります。)
順序
[10] 集成フィードでは、エントリーは app:edited
によって、文書順で最近編集されたものが前に来るように整列するべきです。
AtomPub
同一エントリー
[15] 同じ atom:id の atom:entry
要素が Atomフィード文書中に複数含まれている場合には、
Atom処理器はそのすべてを表示しても構いませんし、
いくつかだけを表示しても構いません。典型的な動作の1つは、
atom:updated が最新のものだけを表示するというものです。
Atom 1.0 4.1.1.
[30] アーカイブされたフィードにおいては、論理フィードの構築においてどのように重複を処理 (除去)
するべきかが規定されています。 (アーカイブされたフィードの項を参照。)
歴史
[22] Atom 0.3 では Atomエントリー文書の概念がなく、
常に atom:feed の子要素として用いることが想定されていました。
関連
[23] atom:entry が根要素である文書は
Atomエントリー文書と呼ばれます。
[25] XML署名を使うことができます。また、Atomエントリー文書では
XML暗号化を使うことができます。詳しくは Atom文書の項をご覧ください。
[24] RSS の item 要素と似ています。
[28] HTML の article 要素は atom:entry
要素と似たような使われ方をされます。
atom:entry 要素 (Atom 0.3)
[1] Atom 0.3
の atom:entry 要素は、
フィードに含まれる個々のエントリーを表します Atom 0.3。
- 状態
- 廃止 → Atom 1.0
atom:entry - 局所名
entry- 文脈
atom:feed の子要素として- 内容モデル
- 属性
仕様書:
The Atom Syndication Format 0.3 (PRE-DRAFT) ( 版) http://www.mnot.net/drafts/draft-nottingham-atom-format-02.html#rfc.section.4.13
文脈
[2] この要素は atom:feed 要素の子要素として0個以上使うことができます
Atom 0.3。
[3] Atom 1.0 とは異なり、 Atom 0.3 には atom:entry
が他の要素の後に来なければならないという制約はありませんでした。
内容
[4] この要素は任意の名前空間に属する要素を含めることができます。
[5] Atom 0.3 の要素としては、次のものが定義されていました。atom:author (0..1)atom:content (0..1)atom:contributor (0..∞)atom:created (0..1)atom:id (0..1)atom:issued (1)atom:link (1..∞)atom:modified (1)atom:summary (0..1)atom:title (1)
[7] 要素の順序に意味があると考えてはなりません Atom 0.3。
[36] その他に使われるもの:
メモ
[6] Atom 0.3 には Atom 1.0 の Atomエントリー文書の概念はなく、
atom:entry を文書要素として使うことは規定されていませんでした。