Rss1.0-tag-syntax

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

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

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

<?xml version="1.0"?>
<rdf:RDF>

   <channel>
      <title>...</title>
      <link>...</link>
      <description>...</description>

      <image/>
      <items>...</items>
      <textInput/>

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

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

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

</rdf:RDF>

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

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

XMLバージョン識別子

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

構文

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

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

必須

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

rdf:RDFタグ

すべてのRSS 1.0準拠ドキュメントの最も外側のレベルは、RDF要素です。 開始RDFタグは、rdf:名前空間プレフィックスをRDF構文スキーマに関連付け、RSS 1.0スキーマをドキュメントのデフォルト名前空間として確立します。

構文

<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns="http://purl.org/rss/1.0/">

必須

常に正確。

チャンネルタグを開始

channel要素には、タイトル、簡単な説明、説明されたリソース(たとえば、チャネルプロバイダーのホームページ)へのURLリンクなど、チャネル自体を説明するメタデータが含まれます。

チャネル要素のrdf:about属性の\ {resource} URLは、RSSドキュメント内の他のrdf:about属性に対して一意である必要があり、チャネルを識別するURIです。 最も一般的には、これは説明されているホームページのURLまたはRSSファイルが見つかるURLのいずれかです。

構文

<channel rdf:about="{resource}">

必須

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

チャンネルのタイトル

リソースの識別文字列。 アイテムで使用される場合、これはアイテムのリンクの名前です。 画像で使用される場合、これは画像のAltテキストです。 チャンネルで使用する場合、これはチャンネルのタイトルです。 テキスト入力で使用される場合、これはテキスト入力のタイトルです。

構文

<title>finddevguides</title>

必須

必須。

最大長

1〜40文字。

チャンネルリンク(URL)

チャンネルタイトルのHTMLレンダリングがリンクするURL。通常、親サイトのホームページまたはニュースページ

構文

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

必須

必須。

最大長

1〜500文字。

チャンネルの説明

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

構文

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

必須

必須。

最大長

1〜500文字。

チャンネル画像タグ

オプションの画像要素とこの特定のRSSチャネルの間にRDFアソシエーションを確立します。 rdf:resourceの\ {image_uri}は、image要素のrdf:about \ {image_uri}と同じでなければなりません。

構文

<image rdf:resource="{image_uri}"/>

必須

ドキュメント要素に画像要素が存在する場合にのみ必須

チャンネルアイテムタグ

ドキュメントのアイテムをこの特定のRSSチャネルに関連付ける、RDFの目次。 各アイテムのrdf:resource \ {item_uri}は、関連するアイテム要素のrdf:about \ {item_uri}と同じでなければなりません。

RDF Seq(シーケンス)は、RDFバッグではなく、すべてのアイテムを含むために使用され、レンダリングと再構築のためのアイテムの順序を示します。

ドキュメントに表示されるが、チャネルレベルのアイテムシーケンスのメンバーとして表示されないアイテムは、RDFパーサーによって破棄される可能性が高いことに注意してください。

構文

<items><rdf:Seq><rdf:li resource="{item_uri}"/> ... </rdf:Seq></items>

必須

必須。

チャンネルtextInputタグ

オプションのtextinput要素とこの特定のRSSチャネルの間にRDFアソシエーションを確立します。 \ {textinput_uri} rdf:resourceは、textinput要素のrdf:about \ {textinput_uri}と同じでなければなりません。

構文

<textinput rdf:resource="{textinput_uri}"/>

必須

texinput要素が存在する場合にのみ必要です。

終了チャンネルタグ

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

構文

</channel>

必須

必須。

画像開始タグ:

チャネルのHTMLレンダリングに関連付けられる画像。 この画像は、ほとんどのWebブラウザでサポートされている形式である必要があります。 後の0.91仕様では幅1〜144、高さ1〜400が許可されていましたが、慣例(および0.9仕様)では88x31が規定されています。

構文

<image rdf:about="{image_uri}">.

必須:

オプション。存在する場合は、チャネル要素にも存在する必要があります。

画像タイトルタグ

HTMLとしてレンダリングされるときのチャネルの画像タグに関連付けられた代替テキスト(「alt」属性)。

構文

<title>{image_alt_text}</title>

必須

画像要素が存在する場合は必須です。

最大長

1〜40文字。

画像URLタグ

HTMLとしてレンダリングされるときにチャネルの画像タグの「src」属性で使用される画像のURL。

構文

<url>{image_url}</url>

必須

画像要素が存在する場合は必須です。

最大長

1〜500文字。

画像リンクタグ

チャンネル画像のHTMLレンダリングがリンクするURL。 これは、チャンネルのタイトルリンクと同様に、一般に親サイトのホームページまたはニュースページです。

構文

<link>{image_link}</link>

必須

画像要素が存在する場合は必須です。

最大長

1〜500文字。

画像終了タグ

画像タグの終了タグ。

構文

</image>

必須

必須;画像タグが存在する場合。

アイテム開始タグ

RSS 1.0のモジュール式の拡張性を備えた一般的なニュースの見出しですが、ディスカッション投稿、求人一覧、ソフトウェアパッチなど、URIを含むオブジェクトであれば何でもかまいません。 RSSドキュメントごとに少なくとも1つのアイテムがある場合があります。 RSS 1.0は上限を強制しませんが、RSS 0.9および0.91との後方互換性のために、最大15アイテムが推奨されます。

\ {item_uri}は、RSSドキュメント内の他のrdf:about属性に関して一意である必要があり、アイテムを識別するURIです。 \ {item_uri}は、可能であれば、<item>要素の<link>サブ要素の値と同一でなければなりません。

フィードごとの推奨アイテム数は1〜15です。

構文

<item rdf:about="{item_uri}">

必須

1つ以上必要です。

アイテムタイトルタグ

アイテムのタイトル。

構文

<title>{item_title}</title>

必須

必須;各アイテムタグ。

最大長

1〜100文字。

アイテムリンクタグ

アイテムのURL。

構文

<link>{item_link}</link>

必須

必須;各アイテムタグ。

最大長

1〜500文字。

アイテム説明タグ

アイテムの簡単な説明/要約。

構文

<description>{item_description}</description>

必須

オプション。アイテムタグ付き。

最大長

1〜500文字。

アイテム終了タグ

アイテムタグの終了タグ。

構文

</item>

必須

必須;各アイテムタグに対して。

テキスト入力タグを開始

ユーザーが発行元のサイトにクエリを送信できるようにするための入力フィールド。 この要素には、タイトル、(cgiまたは他のプロセッサへの)リンク、説明を含む説明、およびHTMLタグ<input type = text name = "[name]"で名前として使用される名前が必要です。 >

構文

<textinput rdf:about="{textinput_uri}">

必須

オプション。存在する場合、チャネル要素にも存在する必要があります。

テキスト入力タイトルタグ

テキスト入力フィールドの説明的なタイトル。 例:「購読」または「検索!」。

構文

<title>{textinput_title}</title>

必須

テキスト入力が存在する場合は必須です。

最大長

1〜40文字。

テキスト入力説明タグ

テキスト入力フィールドの目的の簡単な説明。 たとえば、「…のニュースレターを購読する」または「…のサイトのアーカイブを検索する」。

構文

<description>{textinput_description}</description>

必須

テキスト入力が存在する場合は必須です。

最大長

1〜100文字。

テキスト入力名タグ:

テキスト入力フィールドの(変数)名。

構文

<name>{textinput_varname}</name>

必須:

テキスト入力が存在する場合は必須です。

最大長

1〜500文字。

テキスト入力リンクタグ

テキスト入力の送信先のURL(GETを使用)。

構文

<link>{textinput_action_url}</link>

必須

テキスト入力が存在する場合は必須です。

最大長

1〜500文字。

テキスト入力終了タグ

textInputのCLosingタグ。

構文

</textInput>

必須

textinputで必要です。

rdf:RDF終了タグ

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

構文

</rdf:RDF>

必須

必須。

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

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

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

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

次に、バージョン1.0を使用してRSSフィードを作成する方法を示すフィードファイルの例を示します。

<?xml version="1.0"?>

<rdf:RDF
   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
   xmlns="http://purl.org/rss/1.0/">

   <channel rdf:about="http://www.finddevguides.com">
      <title>finddevguides</title>
      <link>http://finddevguides.com/rss</link>

      <description>
         Online Tutorials and Reference Manuals
      </description>

      <image rdf:resource= "http://finddevguides.com/images/tp-logo.gif"/>

      <items>
         <rdf:Seq>
         <rdf:li resource="http://finddevguides.com/rss/index"/>
         <rdf:li resource="http://finddevguides.com/php/index"/>
         </rdf:Seq>
      </items>

      <textinput rdf:resource= "http://www.finddevguides.com/tp-contact.php"/>

   </channel>

   <image rdf:about="http://finddevguides.com/images/tp-logo.gif">
      <title>finddevguides Logo</title>
      <link>http://finddevguides.com</link>
      <url>http://finddevguides.com/images/tp-logo.gif</url>
   </image>

   <item rdf:about="http://finddevguides.com/rss/index">
      <title>A simple RSS tutorial</title>
      <link>http://finddevguides.com/rss/index</link>

      <description>
         Learn RSS in simple and easy steps.
      </description>

   </item>

   <item rdf:about="http://finddevguides.com/php/index">
      <title>A complete guide for PHP Programmers</title>
      <link>http://finddevguides.com/php/index</link>

      <description>
         A free online guide for PHP. Learn PHP in very easy steps.
      </description>

   </item>

   <textinput rdf:about="http://www.finddevguides.com/tp-contact.php">
      <title>Contact finddevguides</title>

      <description>
         Contact finddevguides for more detail
      </description>

      <name>s</name>

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

   </textinput>
</rdf:RDF>

RSS 1.0ファイル拡張子

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

RSS 1.0モジュール

RSS 1.0モジュールは、http://purl.org/rss/1.0/modules/[RSS 1.0モジュール]からオンラインで入手できる個別のドキュメントで管理されています。