Rss-entry
RSS-エントリー要素
Atomフィードには、1つ以上のエントリ要素を含めることができます。 必須およびオプションのFeed要素のリストを以下に示します。
エントリーID
これは、普遍的に一意で永続的なURIを使用してエントリを識別します。 フィードの2つのエントリは、異なる時点で同じエントリを表す場合、idに同じ値を持つことができます。
構文
<id>http://example.com/blog/1234</id>
必須
必須。
エントリータイトル
これには、人間が読めるエントリのタイトルが含まれています。 この値は空白にしないでください。
構文
<title>Atom 1.0 Tutorial</title>
必須
必須。
エントリー更新日
これは、エントリが重要な方法で最後に変更された時間を示します。 この値は、タイプミスを修正した後に変更する必要はなく、大幅な変更を行った後にのみ変更できます。 通常、フィード内のエントリごとに更新されるタイムスタンプが異なります。
構文
<updated>2007-07-13T18:30:02-05:00</updated>
必須
必須。
エントリー著者
これにより、エントリの作成者が1人になります。 エントリには複数の著者がいる場合があります。 エントリには、囲んでいるFeedにauthor要素があるか、囲まれているsource要素にauthor要素がある場合を除き、少なくとも1つのauthor要素が含まれている必要があります。
構文
<author>
<name>Mohtashim</name>
</author>
必須
オプションですが、推奨されます。
エントリー内容
これには、エントリの完全なコンテンツが含まれているか、リンクされています。 代替リンクがない場合はコンテンツを提供する必要があり、要約がない場合はコンテンツを提供する必要があります。
構文
<content>complete story here</content>
必須
オプションですが、推奨されます。
エントリーリンク
これにより、関連するWebページが識別されます。 関係のタイプは、_rel_属性によって定義されます。 エントリは、タイプと_hreflang_ごとに1つの代替に制限されます。 コンテンツ要素がない場合、エントリには代替リンクが含まれている必要があります。
構文
<link rel="alternate" href="/blog/1234"/>
必須
オプションですが、推奨されます。
エントリー概要
これは、エントリの短い要約、要約、または抜粋を伝えます。 エントリにコンテンツが提供されていないか、そのコンテンツがインラインでない場合は、概要を提供する必要があります。
構文
<summary>Some text.</summary>
必須
オプションですが、推奨されます。
エントリーカテゴリー
これは、エントリが属するカテゴリを指定します。 エントリには複数のカテゴリ要素が含まれる場合があります。
構文
<category term="education"/>
必須
オプションです。
エントリー提供者
これにより、エントリに1人の貢献者が指定されます。 エントリには複数の貢献者要素が含まれる場合があります。
構文
<contributor>
<name>Mohtashim</name>
</contributor>
必須
オプションです。
公開されたタグ
これには、エントリが最初に作成された時刻またはエントリが最初に利用可能になった時刻が含まれます。
構文
<published>2007-07-13T09:17:51-08:00</published>
必須
オプションです。
エントリーソース
あるフィードから別のフィードにエントリをコピーする場合、ソースフィードに子要素の作成者、寄稿者、権利、またはカテゴリのいずれかが含まれている場合、ソースフィードのメタデータ(エントリ要素以外のフィードのすべての子要素)を保持する必要がありますこれらの子要素はソースエントリに存在しません。
構文:
<source>
<id>http://moretutorials.org/</id>
<title>Tutorials and Reference Manuals</title>
<updated>2007-07-13T18:30:02Z</updated>
<rights>© 2007 More Tutorials.</rights>
</source>
必須
オプションです。
エントリー権
これは、権利に関する情報を伝えます。 エントリ内およびその上に保持されている著作権。
構文
<rights type="html">© 2007 finddevguides.com</rights>
必須
オプションです。
共通の構成体
カテゴリー
_ <category> _には、1つの必須属性_term_と、2つのオプション属性_scheme_および_label_があります。
_term_はカテゴリを識別します。
_scheme_は、URIを介して分類スキームを識別します。
_label_は、人間が読める形式の表示ラベルを提供します。
コンテンツ
_ <content> _には、エントリの完全なコンテンツが含まれるか、またはリンクされます。
最も一般的なケースでは、type_属性は_text _、 html 、 xhtml_のいずれかです。この場合、コンテンツ要素は他のテキスト構造と同じように定義されます。
それ以外の場合、_src_属性が存在する場合、コンテンツが見つかるURIを表します。 _type_属性は、存在する場合、コンテンツのメディアタイプです。
それ以外の場合、type_属性が + xml_または_/xml_で終わる場合、このタイプのxmlドキュメントはインラインに含まれます。
それ以外の場合、_type_属性が_text_で始まる場合、このタイプのエスケープされたドキュメントはインラインに含まれます。
それ以外の場合は、指定されたメディアタイプのhttp://www.faqs.org/rfcs/rfc3548l[base64]でエンコードされたドキュメントがインラインで含まれます。
Link
_ <link> は、htmlのhttp://www.w3.org/TR/1999/REC-html401-19991224/struct/linksl#h-12.3[link]要素に倣ってパターン化されています。 1つの必須属性_href_と、5つのオプション属性_rel _、 type 、 hreflang 、 title_、および_length_があります。
_href_は、参照されるリソース(通常はWebページ)のURIです。
_rel_には、単一のリンク関係タイプが含まれます。 完全なURIまたは次の事前定義値(default = alternate)のいずれかです。
- alternate:エントリまたはフィードの代替表現。たとえば、エントリのhtmlバージョンへのパーマリンク、またはウェブログのフロントページ。
- enclosure:関連リソース。サイズが潜在的に大きく、オーディオやビデオの録画などの特別な処理が必要になる場合があります。
- related:エントリまたはフィードに関連するドキュメント。
- self:フィード自体。
- via:エントリで提供される情報のソース。
_type_は、リソースのメディアタイプを示します。
_hreflang_は、参照されるリソースの言語を示します。
_title_は、通常は表示目的で、リンクに関する人間が読み取れる情報を示します。
_length_は、リソースの長さをバイト単位で示します。
人
_ <author> および <contributor> は、個人、企業、または同様のエンティティを表します。 1つの必須要素_name_と2つのオプション要素_uri _、 email_があります。
_ <name> _は、人間が判読できる人物の名前を伝えます。
_ <uri> _には、個人のホームページが含まれています。
_ <email> _には、個人の電子メールアドレスが含まれます。
Text
_ <title> 、 <summary> 、 <content> 、および <rights> _には、人間が読めるテキストが含まれていますが、通常は少量です。 _type_属性は、この情報のエンコード方法を決定します(default = "text")。
_type = "text" _の場合、この要素にはHTMLをエスケープしたエンティティのないプレーンテキストが含まれます。
<title type="text">AT&T bought by SBC!</title>
_type = "html" _の場合、この要素にはエンティティエスケープされたhtmlが含まれます。
<title type="html">
AT&amp;T bought <b>by SBC</b>!
</title>
_type = "xhtml" _の場合、この要素にはdiv要素にラップされたインラインxhtmlが含まれます。
<title type="xhtml">
<div xmlns="http://www.w3.org/1999/xhtml">
AT&T bought <b>by SBC</b>!
</div>
</title>
Atom 1.0のサンプルフィード
この例は、Atom 1.0を使用してフィードを作成する方法を示しています。
<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
<title>Example Feed</title>
<subtitle>Insert witty or insightful remark here</subtitle>
<link href="http://example.org/"/>
<updated>2003-12-13T18:30:02Z</updated>
<author>
<name>Mohtashim</name>
<email>[email protected]</email>
</author>
<id>urn:uuid:60a76c80-d399-11d9-b93C-0003939e0af6</id>
<entry>
<title>Tutorial on Atom</title>
<link href="http://example.org/2003/12/13/atom03"/>
<id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id>
<updated>2003-12-13T18:30:02Z</updated>
<summary>Some text.</summary>
</entry>
</feed>
Atom1.0ファイル拡張子
Atom 1.0ドキュメントの特定のファイル拡張子は必要ありません。 ただし、.xmlをお勧めします。