Rss-feed
RSS-フィード要素
フィードID:
普遍的に一意で永続的なURIを使用してフィードを識別します。 インターネットドメイン名に長期間の更新可能なリースがある場合は、ウェブサイトのアドレスを自由に使用できます。
構文
必須
必須。
フィードのタイトル
フィードの人間が読めるタイトルが含まれています。 多くの場合、関連するWebサイトのタイトルと同じです。 この値は空白にしないでください。
構文
必須
必須。
フィード更新日
フィードが重要な方法で最後に変更された時刻を示します。 AtomのすべてのタイムスタンプはRFC 3339に準拠する必要があります。
構文
必須
必須。
フィード作成者
フィードの作成者を1人指定します。 フィードには複数の作成者要素が含まれる場合があります。 すべてのエントリ要素に少なくとも1つの作成者要素が含まれていない限り、フィードには少なくとも1つの作成者要素が含まれている必要があります。
author要素には、<name>、<email>、および<uri>タグを含めることができます。
構文
必須
オプションですが、推奨されます。
フィードリンク
これにより、関連するWebページが識別されます。 関係のタイプは、_rel_属性によって定義されます。 フィードは、タイプと_hreflang_ごとに1つの代替に制限されています。 フィードには、フィード自体へのリンクが含まれている必要があります。
構文
必須
オプションですが、推奨されます。
フィードカテゴリ
これは、フィードが属するカテゴリを指定します。 フィードには複数のカテゴリ要素が含まれる場合があります。
構文
必須
オプションです。
フィード投稿者
これにより、フィードへの1人の貢献者が指定されます。 フィードには複数の貢献者要素を含めることができます。
構文
必須
オプションです。
フィードジェネレーター
これは、デバッグおよびその他の目的で、フィードの生成に使用されるソフトウェアを識別します。 uri属性とversion属性はどちらもオプションです。
構文
必須
オプションです。
アイコンタグ
これにより、小さな画像が識別され、フィードを視覚的に識別できます。 アイコンは正方形である必要があります。
構文
必須
オプションです。
ロゴタグ
これにより、フィードの視覚的な識別を提供する大きな画像が識別されます。 画像の幅は、高さの2倍にする必要があります。
構文
必須
オプションです。
権利タグ
これは、権利に関する情報を伝えます。 フィード内およびフィード上に保持されている著作権。
構文
必須
オプションです。
字幕タグ
これには、フィードの人間が読める説明またはサブタイトルが含まれています。
構文
<entry>要素
Atomフィードには、1つ以上のエントリ要素を含めることができます。 必須およびオプションのFeed要素のリストを以下に示します。
エントリーID
これは、普遍的に一意で永続的なURIを使用してエントリを識別します。 フィード内の2つのエントリは、異なる時点で同じエントリを表す場合、_id_に同じ値を持つことができます。
構文
必須
必須。
エントリータイトル
これには、人間が読めるエントリのタイトルが含まれています。 この値は空白にしないでください。
構文
必須
必須。
エントリー更新日
これは、エントリが重要な方法で最後に変更された時間を示します。 この値は、タイプミスを修正した後に変更する必要はなく、大幅な変更を行った後にのみ変更できます。 通常、フィード内のエントリごとに更新されるタイムスタンプが異なります。
構文
必須
必須。
エントリー著者
これにより、エントリの作成者が1人になります。 エントリには複数の著者がいる場合があります。 エントリには、囲んでいるFeedにauthor要素があるか、囲まれているsource要素にauthor要素がある場合を除き、少なくとも1つのauthor要素が含まれている必要があります。
構文
必須
オプションですが、推奨されます。
エントリー内容
これには、エントリの完全なコンテンツが含まれているか、リンクされています。 代替リンクがない場合はコンテンツを提供する必要があり、要約がない場合はコンテンツを提供する必要があります。
構文
<content>完全なストーリーはこちら</content>
必須
オプションですが、推奨されます。
エントリーリンク
これにより、関連するWebページが識別されます。 関係のタイプは、_rel_属性によって定義されます。 エントリは、タイプと_hreflang_ごとに1つの代替に制限されます。 コンテンツ要素がない場合、エントリには代替リンクが含まれている必要があります。
構文
必須
オプションですが、推奨されます。
エントリー概要
これは、エントリの短い要約、要約、または抜粋を伝えます。 エントリにコンテンツが提供されていないか、そのコンテンツがインラインでない場合は、概要を提供する必要があります。
構文
必須
オプションですが、推奨されます。
エントリーカテゴリー
これは、エントリが属するカテゴリを指定します。 エントリには複数のカテゴリ要素が含まれる場合があります。
構文
必須
オプションです。
エントリー提供者
これにより、エントリに1人の貢献者が指定されます。 エントリには複数の貢献者要素が含まれる場合があります。
構文
必須
オプションです。
公開されたタグ
これには、エントリが最初に作成された時刻またはエントリが最初に利用可能になった時刻が含まれます。
構文
必須
オプションです。
エントリーソース
あるフィードから別のフィードにエントリをコピーする場合、ソースフィードに子要素の作成者、寄稿者、権利、またはカテゴリが含まれている場合、ソースフィードのメタデータ(エントリ要素以外のフィードのすべての子要素)を保持する必要がありますこれらの子要素はソースエントリに存在しません。
構文
必須
オプションです。
エントリー権
これは、権利に関する情報を伝えます。 エントリ内およびその上に保持されている著作権。
構文
必須
オプションです。
共通の構成体
カテゴリー
_ <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をエスケープしたエンティティのないプレーンテキストが含まれます。
_type = "html" _の場合、この要素にはエンティティエスケープされたhtmlが含まれます。
_type = "xhtml" _の場合、この要素にはdiv要素にラップされたインラインxhtmlが含まれます。
Atom 1.0のサンプルフィード
この例は、Atom 1.0を使用してフィードを作成する方法を示しています。
Atom1.0ファイル拡張子:
Atom 1.0ドキュメントの特定のファイル拡張子は必要ありません。 ただし、.xmlをお勧めします。