Rss2.0-tag-syntax

提供:Dev Guides
移動先:案内検索

RSS-バージョン2.0のタグと構文

RSS 2.0ドキュメントの構造は次のとおりです。

<?xml version="1.0"?>
<rss version="2.0">
   <channel>
      <title>...</title>
      <link>...</link>
      <description>...</description>

      <language>...</language>
      <rating>...</rating>
      <copyright>...</copyright>

      <pubDate>...</pubDate>
      <lastBuildDate>...</lastBuildDate>
      <generator>....</generator>

      <docs>...</docs>
      <cloud>...</cloud>
      <ttl>...</ttl>

      <managingEditor>...</managingEditor>
      <webMaster>...</webMaster>

      <skipHours>
         <hour>...</hour>
      </skipHours>

      <skipDays>
         <day>...</day>
      </skipDays>

      <image>
         <title>...</title>
         <url>...</url>
         <link>...</link>

         <width>...</width>
         <height>...</height>
         <description>...</description>
      </image>

      <item>
         <title>...</title>
         <link>...</link>
         <description>...</description>

         <author>....</author>
         <category>....</category>
         <comments>....</comments>

         <enclosure ..../>
         <guid>....</guid>
         <pubDate>....</pubDate>

         <source>....</source>
      </item>

      ......More item tags.....
      <textInput>
         <title>...</title>
         <description>...</description>
         <name>...</name>

         <link>...</link>
      </textInput>
   </channel>
</rss>

以下に、RSS 2.0に関連するすべてのオプションおよび必須タグの詳細を示します。 Webサイト用のRSS v2.0フィードを準備するには、所定の例を確認してください。

  • 注:*すべてのタグは大文字と小文字が区別されるため、慎重に使用する必要があります。

XMLバージョン識別子

XMLアプリケーションとして、RSS文書はXML宣言で始まる必要はありません。 XMLバージョンIDタグで始まる必要があります。

構文

  • <?xml version = "1.0"?>または
  • <?xml version = "1.0" encoding = "[エンコードコードはこちら]"?>

リンクのリストは次のとおりです:/rss/rss-v2.0-encodings [RSS v2.0サポートされているエンコーディング]

必須

常に正確。 オプションのエンコード属性(デフォルトはUTF-8)。

RSSバージョン識別子

構文

<rss version="2.0">

必須

常に正確。

チャンネルタグを開始

各RSS2.0ファイルには1つのチャネル開始タグが必要です。

構文

<channel>

必須

必須。 RSSファイルごとに最大1つ。

チャンネルのタイトル

チャンネルの名前。 それは人々があなたのサービスを参照する方法です。 RSSファイルと同じ情報を含むHTML Webサイトがある場合、チャンネルのタイトルはWebサイトのタイトルと同じである必要があります。

構文

<title>finddevguides</title>

必須

必須。

チャンネルの説明

以下に説明するように、チャネルには説明タグがあります。

構文

<description>Your source for tutorials, references and manuals!</description>

必須

必須。

チャンネルタイトルリンク(URL)

これはホームページへのリンクであり、チャンネルに必要です。

構文

<link>http://www.finddevguides.com</link>

必須

必須。

チャンネル言語

これは、チャンネル(ウェブサイト)の言語を指定します。

構文

<language>[ language code here ]</language>

リンクのリストは次のとおりです:/rss/rss-v2.0-languages [RSS v2.0サポートされている言語。]

必須

オプションです。

チャンネル評価

チャンネルレーティングの使用方法の詳細については、上記のリンク:/rss/pics-rating [PICSレーティングの使用]をご覧ください。

構文

<rating>[ PICS rating here ]</rating>

必須

オプションです。

著作権識別子

このタグはRSS 2.0ファイルで許可されています。

構文

<copyright>Copyright 2007, finddevguides</copyright>

必須

オプションです。

発行日

このタグはRSS 2.0ファイルで許可されています。 チャンネル内のコンテンツの発行日。

構文

<pubDate>Thu, 19 Jul 2007 07:00:00 GMT</pubDate>

必須

オプションです。

最終ビルド日

このタグはRSS 2.0ファイルで許可されています。 チャンネルのコンテンツが最後に変更された時刻。

構文

<lastBuildDate>Thu, 19 Jul 2007 16:20:26 GMT </lastBuildDate>

必須

オプションです。

チャンネルカテゴリ

チャネルが属する1つ以上のカテゴリを指定します。

構文

<category>Newspapers </category>

必須

オプションです。

チャンネルドキュメント

RSSファイルで使用される形式のドキュメントを指すURL。 おそらくこのページへのポインタです。

構文

<docs>http://finddevguides.com/rss </docs>

必須

オプションです。

チャンネルクラウド

プロセスをクラウドに登録してチャネルの更新を通知できるようにし、RSSフィード用の軽量なパブリッシュ/サブスクライブプロトコルを実装します。

構文

<cloud>
   domain="rpc.sys.com" port="80" path="/RPC2" registerProcedure="myCloud.rssPleaseNotify" protocol="xml-rpc"
</cloud>

この例では、表示されるチャネルで通知を要求するには、ポート80でrpc.sys.comに/RPC2のパスでXML-RPCメッセージを送信します。 呼び出す手順はmyCloud.rssPleaseNotifyです。

必須

オプションです。

チャンネルttl

ttlは time to live を表します。 ソースから更新する前にチャネルをキャッシュできる時間を示す分数です。

構文

<ttl>60</ttl>

必須

オプションです。

編集長

編集コンテンツの責任者のメールアドレス。

構文

<managingEditor>[email protected]</managingEditor>

必須

オプション

ウェブマスター

チャネルに関連する技術的な問題の責任者のメールアドレス。

構文

<webMaster>[email protected]</webMaster>

必須

オプションです。

スキップ時間の開始タグ

チャンネルが更新される可能性が低い日、GMTの時間を示す<時間>のリスト。 このサブアイテムを省略すると、チャネルは1時間ごとに更新されると想定されます。

構文

<skipHours>

必須

オプションです。

Hour

skipHoursタグを使用している場合は、このタグも使用する必要があります。

構文

<hour>7</hour>

必須

<skipHours>の場合は必須。 <skipHours>要素ごとに最大24。

最大長

数値:0-23。

スキップ時間の終了

skipHoursタグを使用している場合は、このタグも使用する必要があります。

構文

</skipHours>

必須

<skipHours>の場合は必須。

スキップ日タグを開始

チャンネルが更新されない曜日を示す、英語の<day> sの週のリスト。 activeHoursと同様に、たとえば土曜日または日曜日にチャンネルが更新されないことがわかっている場合。

構文

<skipDays>

必須

オプションです。

Day

skipDaysタグを使用している場合、このタグも使用する必要があります。

構文

<day>Monday</day>

必須

<skipDays>の場合は必須。 <skipDays>ごとに最大7。 素子。

最大長

1〜10文字。

スキップ日を終了

skipDaysタグを使用している場合、このタグも使用する必要があります。

構文

</skipDays>

必須

<skipDays>の場合は必須。

画像タグを開始

チャンネル内に1つの画像開始タグを含めることができます。 構文は次のとおりです。

構文

<image>

必須

オプションです。

画像ALTテキスト

画像タグを使用している場合、このタグも使用する必要があります。

構文

<title>finddevguides Logo</title>

必須

<image>タグが利用可能な場合は必須。

画像の場所(URL)

リソースをロードする場所。 これは、リソースが選択された場合にユーザーをリダイレクトする場所を指定するlinkタグとはわずかに異なることに注意してください。

構文

<url>http://www.finddevguides.com/images/to-logo.gif</url>

必須

<image>タグが利用可能な場合は必須。

画像リンク(URL)

画像タグを使用している場合、このタグも使用する必要があります。

構文

<link>http://www.finddevguides.com/</link>

必須

<image>タグが使用可能な場合のオプション。

画像の幅

画像タグを使用している場合、このタグも使用することはオプションです。

構文

<width>[ numeric value here ]</width>

必須

<image>タグが使用可能な場合のオプション。

最大長

数値:1-144(デフォルトは88)。

画像の高さ

画像タグを使用している場合、このタグも使用することはオプションです。

構文

<height>[ numeric value here ]</height>

必須

<image>タグが使用可能な場合のオプション。

最大長

数値:1〜400(デフォルトは31)。

画像の説明

画像タグを使用している場合、このタグも使用することはオプションです。

構文

<description>Articles, discussions, builds, and more...</description>

必須

<image>タグが使用可能な場合のオプション。

終了画像タグ

画像タグを使用している場合、このタグも使用する必要があります。

構文

</image>

必須

<image>タグが利用可能な場合は必須。

開始アイテムタグ

これはオプションのタグであり、チャンネルタグ内に任意の数のアイテムタグを含めることができます。

構文

<item>

必須

オプションです。

アイテムタイトル

アイテムのタイトル。 このタグの使用はオプションです。

構文

<title>Learning RSS</title>

必須

オプションですが、<title>タグが使用可能な場合に使用することをお勧めします。

アイテムリンク(URL)

アイテムのURL。 このタグの使用はオプションです。

構文

<link>http://www.finddevguides.com/rss/index</link>

必須

オプションですが、<title>タグが使用可能な場合に使用することをお勧めします。

アイテム説明

アイテムの概要。 このタグの使用はオプションです。

構文

<description>RSS Tutorials Online. Read more about it in this discussion...</description>

必須

オプションですが、<title>タグが使用可能な場合に使用することをお勧めします。

アイテム作成者

アイテムの作成者のメールアドレスです。 titleタグを使用している場合、このタグを使用することはオプションです。

構文

<author>[email protected]</author>

必須

オプションですが、<title>タグが使用可能な場合に使用することをお勧めします。

品目カテゴリ

アイテムを1つ以上のカテゴリに含めます。 これは、itemのオプションのサブ要素です。

これには、1つのオプション属性、ドメイン、および分類分類法を識別する文字列があります。

構文

<category>Grateful Dead</category>
<category domain="http://www.fool.com/cusips">Grateful Dead</category>

必須

オプションで、必要な数のカテゴリ要素を含めることができます。これは、異なるドメインに対して、同じドメインの異なる部分でアイテムを相互参照するために必要です。

アイテムのコメント

これは、itemのオプションのサブ要素です。 存在する場合は、アイテムのコメントページのURLです。

構文

<comments>http://example.com/rss/comments</comments>

必須

オプションです。

アイテムエンクロージャー

<enclosure>は、itemのオプションのサブ要素です。 3つの必須属性があります。 urlはエンクロージャの場所を表し、lengthはバイト単位の大きさを表し、typeはそのタイプが標準のMIMEタイプであることを表します。

構文

<enclosure url="http://www.finddevguides.com/mp3s/tutorial.mp3" length="12216320" type="audio/mpeg"/>

必須

オプションです。

アイテムガイド

<guid>は、itemのオプションのサブ要素です。 guidは、グローバルに一意の識別子を表します。 アイテムを一意に識別する文字列です。 存在する場合、アグリゲーターはこの文字列を使用して、アイテムが新しいかどうかを判断することを選択できます。

構文

<guid>http://some.server.com/weblogItem3207</pubDate>

guidの構文に関する規則はありません。 アグリゲーターはそれらを文字列として表示する必要があります。 文字列の一意性を確立するのは、フィードのソース次第です。

必須

オプションです。

アイテム発行日

<pubDate>は、itemのオプションのサブ要素です。 その値は日付であり、アイテムが公開された日付を示します。 将来の日付の場合、アグリゲーターはその日付までアイテムを表示しないことを選択できます。

構文

<pubDate>Sun, 22 July 2007 15:21:36 GMT</pubDate>

必須

オプションです。

アイテムソース

<source>は、itemのオプションのサブ要素です。 その値は、<title>から派生した、アイテムが由来するRSSチャネルの名前です。 それは1つの必須属性urlを持ち、それはソースのXML化にリンクします。

この要素の目的は、リンクの信用を広め、ニュース項目のソースを公表することです。 アグリゲーターのPostコマンドで使用できます。 アイテムをアグリゲーターからウェブログ作成ツールに転送するときに自動的に生成されるはずです。

構文

<source url="http://www.tomalak.org/links2.xml">Tomalak's Realm</source>

必須

オプションです。

終了項目タグ

titleタグを使用している場合、このタグも使用する必要があります。

構文

</item>

テキスト入力タグを開始

チャネルには、オプションで4つの必須サブ要素を含む<textInput>サブ要素を含めることができます。

<textInput>要素の目的は謎です。 これを使用して、検索エンジンボックスを指定できます。 または、読者がフィードバックを提供できるようにします。 ほとんどのアグリゲーターはそれを無視します。

構文

<textInput>

必須

オプションです。 チャネルごとに最大1。

テキスト入力タイトル(送信ボタンのラベル)

textInputタグを使用している場合、このタグも使用する必要があります。

構文

<title>Send</title>

必須

<textInput>タグが使用可能な場合は必須。

テキスト入力の説明

textInputタグを使用している場合、このタグも使用する必要があります。

構文

<description>Comments about finddevguides?</description>

必須

<textInput>タグが使用可能な場合は必須。

テキスト入力名

textInputタグを使用している場合、このタグも使用する必要があります。

構文

<name>[ value of name= attribute of input tag here ]</name>

必須

<textInput>タグが使用可能な場合は必須。

テキスト入力リンク

これは、渡されたデータを処理するスクリプトへのリンクです。 textInputタグを使用している場合、このタグも使用する必要があります。

構文

<link>http://www.finddevguides.com/cgi-bin/sampleonly.cgi</link>

必須

<textInput>タグが使用可能な場合は必須。

テキスト入力タグの終了

textInputタグを使用している場合、このタグも使用する必要があります。

構文

<textInput>

必須

<textInput>タグが使用可能な場合は必須。

終了チャンネルタグ

チャネル開始タグには1つの終了チャネルが必要です。

構文

</channel>

必須

必須。

RSSタグの終了

これは、RSS0.91ドキュメントの終了タグです。

構文

</rss>

必須

必須。

特殊文字とHTMLエンティティの使用

RSS 2.0ファイルはXMLドキュメントですが、RSS 2.0はHTMLエンティティの完全なセットをサポートすることによりXMLを拡張します。 <url>または<link>タグでアンパサンド(&)などの特殊文字を使用する場合は、それらの文字を適切な10進数またはHTMLエンティティに置き換える必要があります。

HTMLチュートリアルでlink:/html/html_entities [HTMLエンティティ]の完全なセットを確認してください。

RSSバージョン2.0のサンプルフィード

次の例は、バージョン2.0を使用してRSSフィードを作成する方法を示しています。

<?xml version="1.0"?>
<rss version="2.0">
   <channel>
      <title>finddevguides</title>
      <link>http://www.finddevguides.com</link>
      <description>Tutorials and Reference Manuals</description>

      <language>en-us</language>
      <pubDate>Fri, 30 May 2003 11:06:42 GMT</pubDate>
      <lastBuildDate>Fri, 30 May 2003 11:06:42 GMT</lastBuildDate>

      <docs>http://www.finddevguides.com/rss</docs>
      <generator>Weblog Editor 2.0</generator>
      <managingEditor>[email protected]</managingEditor>

      <webMaster>[email protected]</webMaster>

      <item>
         <title>RSS Tutorial</title>
         <link>http://www.finddevguides.com/rss</link>
         <description>Learn RSS in simple steps</description>

         <pubDate>Fri, 30 May 2003 11:06:42 GMT</pubDate>

         <guid>
            http://www.finddevguides.com/rss/rss-feed-formats#v0.91
         </guid>

      </item>

      <item>
         <description>RSS Feed Formats</description>
         <pubDate>Fri, 30 May 2003 11:06:42 GMT</pubDate>

         <guid>
            http://www.finddevguides.com/rss/rss-feed-formats#v2.0
         </guid>

      </item>
    </channel>
</rss>

RSS 2.0ファイル拡張子

RSS 2.0ドキュメントの特定のファイル拡張子は必要ありません。 .rdfまたは.xmlのいずれかをお勧めしますが、前者をお勧めします。