* [CODE(XMLe)@en[item]] 要素 (RSS2)

[5] 
[[RSS 2.0]] [[文書]]の [DFN[[CODE(XMLe)@en[[[item]]]] [[要素]]]]は、
[[項目]]を表します。「[[項目]]」は[RUBYB[話]@en[story]]
([[新聞]]や[[雑誌]]の「[RUBYB[話]@en[story]]」と同様なもの) を表します [SRC@en[[[RSS 2.0]]]]。

:[[要素名]]:[CODE(XMLe)@en[[[item]]]] ([[item]] ([[項目]]) より)
:文脈:[CODE(XMLe)@en[[[channel]]]] [[要素]]の[[子要素]]として、零個以上
:[[内容モデル]]:>>6 参照
:[[属性]]:

仕様書:
-[CITE@en[RSS 2.0 Specification (version 2.0.10)]] ([TIME[2008-11-21 13:42:42 +09:00]] 版) <http://www.rssboard.org/rss-specification#hrelementsOfLtitemgt>
-[CITE@en[RSS Best Practices Profile]] ([TIME[2008-11-21 15:11:45 +09:00]] 版) <http://www.rssboard.org/rss-profile#element-channel-item>

** 意味

[8] [CODE(XMLe)@en[[[item]]]] [[要素]]によって表される「[[話]]」は、
その全体がその [CODE(XMLe)@en[[[item]]]] [[要素]]内で完結していても構いませんし、
外部にある完全な「[[話]]」の説明に留まっていても構いません。

;; 前者の場合 [CODE(XMLe)@en[[[description]]]] が[[話]]の本文を含むことになり、
[CODE(XMLe)@en[[[link]]]] と [CODE(XMLe)@en[[[title]]]] は省略できます。
後者の場合、 [CODE(XMLe)@en[[[description]]]] が[[話]]の説明になり、
[CODE(XMLe)@en[[[link]]]] は完全な話の [[URL]] となります。
[SRC@en[[[RSS 2.0]]]]

** 文脈

[13] 仕様上は [CODE(XMLe)@en[[[item]]]] [[要素]]は [CODE(XMLe)@en[[[channel]]]] [[要素]]の[[子要素]]でなければなりませんが、
現実には [CODE(XMLe)@en[[[rss]]]] [[要素]]の[[子要素]]になっていることもあります。

** 内容

[6] [[子要素]]として次の[[要素]]を使えます [SRC@en[[[RSS 2.0]], [[RSS Best Practices]]]]。
[FIG(short list)[
- [CODE(XMLe)@en[[[author]]]]
- [CODE(XMLe)@en[[[category]]]]
- [CODE(XMLe)@en[[[comments]]]]
- [CODE(XMLe)@en[[[description]]]]
- [CODE(XMLe)@en[[[enclosure]]]]
- [CODE(XMLe)@en[[[guid]]]]
- [CODE(XMLe)@en[[[link]]]]
- [CODE(XMLe)@en[[[pubDate]]]]
- [CODE(XMLe)@en[[[source]]]]
- [CODE(XMLe)@en[[[title]]]]
]FIG]

[7] [CODE(XMLe)@en[[[link]]]] と
[CODE(XMLe)@en[[[title]]]] のいずれかはなければ[['''なりません''']]
[SRC@en[[[RSS 2.0]], [[RSS Best Practices Profile]]]]。

[9] これらの[[要素]]は、 [CODE(XMLe)@en[[[category]]]] を除き、高々1つなければ[['''なりません''']]
[SRC@en[[[RSS Best Practices Profile]]]]。

[11] 他に使われることがある[[要素]]:
[FIG(short list)[
- [CODE(XMLe)@en[[[atom:link]]]]
- [CODE(XMLe)@en[atom:updated]]
- [CODE(XMLe)@en[[[dc:creator]]]]
- [CODE[dc:language]]
- [CODE(XMLe)@en[dc:modified]]
- [CODE(XMLe)@en[dcndl:[VAR[*]]]]
- [CODE(XMLe)@en[[[content:encoded]]]]
- [CODE(XMLe)@en[[[slash:comments]]]]
- [CODE(XMLe)@en[media:thumbnail]]
- [CODE(XMLe)@en[media:content]]
- [CODE[media:status]]
- [CODE(XMLe)@en[gd:extendedProperty]]
- [CODE(XMLe)@en[itunes:author]]
- [CODE(XMLe)@en[itunes:block]]
- [CODE(XMLe)@en[itunes:image]]
- [CODE(XMLe)@en[itunes:duration]]
- [CODE(XMLe)@en[itunes:explicit]]
- [CODE(XMLe)@en[itunes:isClosedCaptioned]]
- [CODE(XMLe)@en[itunes:order]]
- [CODE(XMLe)@en[itunes:subtitle]]
- [CODE(XMLe)@en[itunes:summary]]
- [CODE(XMLe)@en[files:[VAR[*]]]]
- [CODE(XMLe)@en[psc:chapters]]
- [CODE(XMLe)@en[torrent]] ([CODE(URI)@en[http://xmlns.ezrss.it/0.1/]])
- [CODE(XMLe)@en[nhkblog:[VAR[*]]]]
- [CODE(XMLe)@en[g:[VAR[*]]]]
- [CODE(XMLe)@en[yt:[VAR[*]]]]
- [CODE(XMLe)@en[hatena:[VAR[*]]]]
- [CODE(XMLe)@en[ror:[VAR[*]]]]
- [CODE(XMLe)@en[jwplayer:[VAR[*]]]]
- [CODE(XMLe)@en[p:[VAR[*]]]]
- [CODE(XMLe)@en[rdfs:seeAlso]]
- [CODE(XMLe)@en[snf:relatedLink]]
- [CODE(XMLe)@en[snf:advertisement]]
- [CODE(XMLe)@en[snf:analytics]]
- [CODE[snf:video]]
- [CODE(XMLe)@en[nicoch:*]]
- [CODE(XMLe)@en[nicoch:article_thumbnail]]
- [CODE(XMLe)@en[sx:*]]
- [CODE[carwings:*]]
]FIG]

[3] [[Apple]] のドキュメントは認めていませんが、
[CODE(XMLe)@en[itunes:category]] が使われることがあります。

** レンダリング

[12] [[Thunderbird]] 2.0.0.18 は、 [CODE(XMLe)@en[[[item]]]] [[要素]]内に
[CODE(XMLe)@en[[[description]]]] [[要素]]しか存在しない場合、
- 「プレーンテキスト」ではまっさら
- 「シンプル HTML」では [CODE(XMLe)@en[[[description]]]] [[要素]]の[[内容]]
- 「オリジナル HTML」では [CODE(XMLe)@en[[[link]]]] [[要素]]で指定された外部内容

を[[レンダリング]]するようです。

** 例

[10] 
[PRE(XML example code)[
<item>
  <title>Seventh Heaven! Ryan Hurls Another No Hitter</title>
  <link>http://dallas.example.com/1991/05/02/nolan.htm</link>
  <description>Texas Rangers pitcher Nolan Ryan hurled the seventh no-hitter of his legendary career on Arlington Appreciation Night, defeating the Toronto Blue Jays 3-0. The 44-year-old struck out 16 batters before a crowd of 33,439.</description>
</item>
]PRE]

;; [[RSS Best Practices Profile]] より

* [CODE(XMLe)@en[item]] 要素 (RSS1)

[14] [[RSS 1.0]] の [CODE(XMLe)@en[[[item]]]] [[要素]]は、[[RSS]]
によって記述される対象となる、一つの話題の単位を表します。

** 仕様書

[REFS[
- [27] [CITE[RDF Site Summary (RSS) 1.0]] ([TIME[2008-06-10 05:47:42 +09:00]]) <http://web.resource.org/rss/1.0/spec#s5>
-- [1] '''[CSECTION@en[5.5 <item>]] <http://web.resource.org/rss/1.0/spec#s5.5>'''
- [28] [CITE[RDF Site Summary 1.0 Modules: Content]] ([TIME[2002-10-14 07:00:04 +09:00]] 版) <http://web.resource.org/rss/1.0/modules/content/>
]REFS]

** 意味

[15] [[RSS 1.0]] 仕様書は次のように説明しています [SRC[>>1]]。
>
While commonly a news headline, with RSS 1.0's modular extensibility, this can be just about anything: discussion posting, job listing, software patch -- any object with a URI.

** 文脈

[16] [CODE(XMLe)@en[[[item]]]] [[要素]]は [CODE(XMLe)@en[[[rdf:RDF]]]] [[要素]]の[[子要素]]として
1つ以上必要です。個数に上限はありませんが、 [[RSS 0.9]] および [[RSS 0.91]]
との互換性のために15個以下とすることが[RUBYB[推奨]@en[recommended]]されています。
[SRC[>>1]]

** 属性

- [22] [CODE(XMLa)@en[[[rdf:about]]]] (必須 [SRC[>>1]])

** 内容

[17] この[[要素]]の[[内容]]は、次の[[子要素]]です。順序は任意です。
[FIG(short list)[
- [18] [CODE(XMLe)@en[[[title]]]] (丁度1個) [SRC[>>1]]
- [19] [CODE(XMLe)@en[[[link]]]] (丁度1個) [SRC[>>1]]
- [20] [CODE(XMLe)@en[[[description]]]] (高々1個) [SRC[>>1]]
- [26] [CODE(XMLe)@en[[[content:encoded]]]] (高々1個) [SRC[>>28]]
- [29] [CODE(XMLe)@en[[[dc:title]]]]
- [30] [CODE(XMLe)@en[[[dc:creator]]]]
- [31] [CODE(XMLe)@en[[[dc:subject]]]]
- [32] [CODE(XMLe)@en[[[dc:description]]]]
- [33] [CODE(XMLe)@en[[[dc:publisher]]]]
- [34] [CODE(XMLe)@en[[[dc:contributor]]]]
- [35] [CODE(XMLe)@en[[[dc:date]]]]
- [36] [CODE(XMLe)@en[[[dc:type]]]]
- [37] [CODE(XMLe)@en[[[dc:format]]]]
- [38] [CODE(XMLe)@en[[[dc:identifier]]]]
- [39] [CODE(XMLe)@en[[[dc:source]]]]
- [40] [CODE(XMLe)@en[[[dc:language]]]]
- [41] [CODE(XMLe)@en[[[dc:relation]]]]
- [42] [CODE(XMLe)@en[[[dc:coverage]]]]
- [43] [CODE(XMLe)@en[[[dc:rights]]]]
]FIG]

[2] その他に次の[[要素]]も使われます。
[FIG(short list)[
- [CODE(XMLe)@en[slash:[VAR[*]]]]
- [CODE(XMLe)@en[taxo:topics]]
- [CODE(XMLe)@en[dc:corp]]
- [CODE(XMLe)@en[date][date (RSS)]]
]FIG]

[45] 同じ名前の[[要素]]が複数あってはなりません [SRC[>>27]]。

** 関連

[24] [CODE(XMLe)@en[[[channel]]]] [[要素]]の[[子要素]]たる [CODE(XMLe)@en[[[items]]]]
[[要素]]の[[子要素]]であるところの [CODE(XMLe)@en[[[rdf:Seq]]]] [[要素]]に
[CODE(XMLe)@en[[[item]]]] [[要素]]に対応する [CODE(XMLe)@en[[[rdf:li]]]]
[[要素]]を入れることになっています。

** 例

[23] [SRC[>>1]]
[PRE(XML example code)[
  <item rdf:about="http://xml.com/pub/2000/08/09/xslt/xslt.html">
    <title>Processing Inclusions with XSLT</title>
    <link>http://xml.com/pub/2000/08/09/xslt/xslt.html</link>
    <description>
     Processing document inclusions with general XML tools can be 
     problematic. This article proposes a way of preserving inclusion 
     information through SAX-based processing.
    </description>
  </item>
]PRE]

** メモ

[25] [[RDF]] の慣習に従うなら [CODE(XMLe)@en[[[item]]]] は[[型]]なので[[大文字]]からはじまるべきなのでしょうが、
[[RSS 0.9]] との互換性のためか[[小文字]]からはじまっています。

[FIG(quote)[
[FIGCAPTION[
[4] [CITE@en[WebSub]]
([TIME[2018-01-23 01:01:39 +09:00]])
<https://w3c.github.io/websub/#content-distribution>
]FIGCAPTION]

> For Atom ('''['''RFC4287''']''') and RSS ('''['''RSS-2.0''']''') feeds, the hub MAY remove already-delivered atom:entry or rss:item elements from the feed.

]FIG]


[FIG(quote)[
[FIGCAPTION[
[21] ([TIME[2018-03-14 23:04:13 +09:00]])
<https://hojin-info.go.jp/hojin/common/data/HojinInfoRss.xml>
]FIGCAPTION]

> <item>
> <title>2018/03/14  機能の追加及び法人基本情報・法人活動情報のデータ構造の変更を実施しました。</title>
> </item>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[44] ([TIME[2018-04-28 16:21:49 +09:00]])
<https://www.mohw.gov.tw/rss-17-1.html>
]FIGCAPTION]

> <pubDate>Wed, 25 Apr 2018 05:35:00 GMT</pubDate><author></author><source url="text">https://www.mohw.gov.tw/cp-17-40877-1.html</source><NewsID>40877</NewsID><DeptName>食品藥物管理署</DeptName><FileList /><ImageList /></item><item>

]FIG]
