* [CODE(XMLe)@en[atom:category]] 要素 (Atom)

[23] [DFN[[CODE(XMLe)@en[atom:category]]]] [[要素]]は[[エントリー]]や[[フィード]]と関連付けられた[RUBYB[[[分類]]]@en[category]]を表します
[SRC[[[RFC 4287]] 4.2.2.]]。

[13] 
:状態:[[IETF]] [[提案標準]]
:[[要素名]]:[CODE(XMLe)@en[[[category]]]]
(「[RUBYB[[[分類]]][category]]」より)
:文脈:
[CODE(XMLe)@en[[[atom:feed]]]] の[[子要素]]として、
[CODE(XMLe)@en[[[atom:entry]]]] の[[子要素]]として、
[CODE(XMLe)@en[app:[[categories]]]] の[[子要素]]として
:[[内容モデル]]:[[空]]
:[[属性]]:
[CODE(XMLa)@en[[[label]]]], [CODE(XMLa)@en[[[scheme]]]], [CODE(XMLa)@en[[[term]]]]

** 仕様書

-[21] [CITE@en[RFC 4287 - The Atom Syndication Format]]
--<http://tools.ietf.org/html/rfc4287#section-4.1.1>
--<http://tools.ietf.org/html/rfc4287#section-4.1.2>
--'''<http://tools.ietf.org/html/rfc4287#section-4.2.2>'''
-[11] [CITE@en[RFC 5023 - The Atom Publishing Protocol]] ([TIME[2008-11-20 18:52:14 +09:00]] 版) <http://tools.ietf.org/html/rfc5023#section-7.2.1>

** 文脈

[19] [CODE(XMLe)@en[[[atom:category]]]] [[要素]]は、
[CODE(XMLe)@en[[[atom:feed]]]] [[要素]]の[[子要素]]として任意個用いることができます
[SRC@en[[[Atom 1.0]] 4.1.1.]]。

[22] [CODE(XMLe)@en[[[atom:category]]]] [[要素]]は、
[CODE(XMLe)@en[[[atom:entry]]]] [[要素]]の[[子要素]]として任意個用いることができます
[SRC@en[[[Atom 1.0]] 4.1.2.]]。

[12] [CODE(XMLe)@en[atom:[[category]]]] [[要素]]は、
[[AtomPub]] [CODE(XMLe)@en[app:[[categories]]]] [[要素]]の[[子要素]]としても用いることができます。
[SRC@en[[[AtomPub]]]]

** 内容モデル

[24] [[RFC 4287]] はこの[[要素]]の[[内容]]があったとしてもその[[意味]]を規定しないと明記しています
[SRC[[[RFC 4287]] 4.2.2.]]。

[25] [[RELAX NG]] [[スキーマ]] ([[参考]]) 上の[[データ型]]は
[CODE(XML)@en[[[undefinedContent]]]] です [SRC[[[RFC 4287]] 4.2.2.]]。

** 歴史

[10] [[Atom 0.3]] にはまだ [CODE(XMLe)@en[atom:[[category]]]]
[[要素]]に相当するものはありませんでした。

** 例

[15] >>14 と同じサイトの [[Atom]] 版

[PRE(XML example code)[
        <category term="009掲示板" scheme="http://www.sixapart.com/ns/types#category" />
    
        <category term="012イベント&ニュース" scheme="http://www.sixapart.com/ns/types#category" />
    
    <category term="久米島ツアー" label="久米島ツアー" scheme="http://www.sixapart.com/ns/types#tag" />
]PRE]

;; [CITE[沖縄 ダイビング なんくるダイバーズ沖縄]] ([TIME[2008-11-23 23:53:25 +09:00]] 版) <http://www.nankurudivers.com/atom.xml>

[16] 
[PRE(XML example code)[
<category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event'/>
]PRE]

;; [[Google Calendar]]

[17] [CITE[GIGAZINE]] ([TIME[2008-12-14 16:19:16 +09:00]] 版) <http://www.pheedo.jp/f/gigazine_atom>

[PRE(XML example code)[
		<category term="メモ"
        scheme="http://gigazine.net/index.php?/news/C7/"
        label="メモ"/>
]PRE]

[18] [CITE@ja[ちょっとしたメモ - Atomのcategory要素とURI参照]] ([[Masahide Kanzaki]] 著, [TIME[2008-05-28 09:21:23 +09:00]] 版) <http://www.kanzaki.com/memo/2005/06/27-1>

[27] 
[PRE(XML example code)[
<category scheme='http://gdata.youtube.com/schemas/2007/categories.cat' term='Entertainment' label='エンターテイメント'/>
]PRE]

;; [[YouTube]] の [[API]]

** 関連

[20] [[RSS]] の [CODE(XMLe)@en[[[category]]]] [[要素]]や[[マイクロフォーマット]]の
[[rel-tag]] と似ています。

* [CODE(XMLe)@en[category]] 要素 (RSS)

[1] [[RSS]] の [DFN[[CODE(XMLe)@en[[[category]]]] [[要素]]]]は、
[[チャンネル]]や[[項目]]の属する[[分類]] ([[タグ]]) を表します。

:[[要素名]]:[CODE(XMLe)@en[[[category]]]] ([[category]] ([[分類]]) より)
:文脈:[[チャンネル要素]]が認められる文脈、[CODE(XMLe)@en[[[item]]]]
[[要素]]の[[子要素]]として
:[[内容モデル]]:[[テキスト]]
:[[属性]]:[CODE(XMLa)@en[[[domain]]]]

仕様書:
- [CITE@en[RSS 2.0 Specification (version 2.0.10)]]
-- <http://www.rssboard.org/rss-specification#optionalChannelElements>
-- <http://www.rssboard.org/rss-specification#hrelementsOfLtitemgt>
-- <http://www.rssboard.org/rss-specification#ltcategorygtSubelementOfLtitemgt>
-[CITE@en[RSS Best Practices Profile]]
--<http://www.rssboard.org/rss-profile#element-channel-category>
--<http://www.rssboard.org/rss-profile#element-channel-item-category>

** 文脈

[6] [CODE(XMLe)@en[[[category]]]] [[要素]]は [CODE(XMLe)@en[[[channnel]]]]
[[要素]]や [CODE(XMLe)@en[[[item]]]] [[要素]]の[[子要素]]として、
零個以上使って[['''構いません''']] [SRC@en[[[RSS 2.0]], [[RSS Best Practices Profile]]]]。

** 内容

[7] [[要素]]の[[内容]]は、[[スラッシュ]]分離の[[文字列]]で、[[分類]]の階層構造上の位置を表します
[SRC@en[[[RSS 2.0]]]]。と [[RSS 2.0]] では[[事実の文]]になっていますが、 [[RSS Best Practices Profile]]
では'''[[推奨]]'''になっています。

** 応用

[8] [[処理器]]は分類の解釈上の convention を確立して構いません [SRC@en[[[RSS 2.0]]]]。

;; どういう意味でしょう。

** 例

[2]
[PRE(XML example code)[
<category>Newspapers</category>
]PRE]

;; [[RSS 2.0]] 仕様書より

[4] 
[PRE(XML example code)[
<category>Grateful Dead</category>
]PRE]

;; [[RSS 2.0]] 仕様書より

[5] 
[PRE(XML example code)[
<category domain="http://www.fool.com/cusips">MSFT</category>
]PRE]

;; [[RSS 2.0]] 仕様書より

[9] 
[PRE(XML example code)[
<category>Media</category>
]PRE]

;; [[RSS Best Practices Profile]] より

[14] 
[PRE(XML example code)[
          <category domain="http://www.sixapart.com/ns/types#category">009掲示板</category>
        
          <category domain="http://www.sixapart.com/ns/types#category">012イベント&ニュース</category>
        
        
          <category domain="http://www.sixapart.com/ns/types#tag">久米島ツアー</category>
]PRE]

;;
[CITE[沖縄 ダイビング なんくるダイバーズ沖縄]] ([TIME[2008-11-23 23:50:59 +09:00]] 版) <http://www.nankurudivers.com/index.xml>

** 関連

[3] [[Atom]] では [CODE(XMLe)@en[[[category]]]] [[要素]]に相当します。

[26] [[RSS 1.0]] では[[カテゴリー]]や[[タグ]]には [CODE(XMLe)@en[[[dc:subject]]]]
[[要素]]がよく使われます。

* [CODE(XMLe)@en[category]] 要素 (SmartFormat)

[48] [[SmartNews]] の採用する [[SmartFormat]] は、 [[RSS 2.0]] や [[Atom 1.0]]
と似て非なる[[フィード形式]]です。 [CODE(XMLe)@en[category][atom:category]]
は、 [[RSS 2.0]] でも [[Atom 1.0]] でも、次のような構文を求めています。
(これは [[RSS 2.0]] とも [[Atom 1.0]] とも異なる独自形式です。)

[FIG(quote)[
[FIGCAPTION[
[47] [CITE@en[SmartFormat]]
( ([TIME[2016-09-20 05:41:23 +09:00]]))
<https://www.smartnews.com/smartformat/ja/#entry%3A6902e2c38bc28b4b0bcb4b2816703cab>
]FIGCAPTION]

>     <category>iphone,technology</category>

]FIG]

;; [CODE[,]] で複数の文字列を連結したリストです。

* メモ

[28] [CITE@en[draft-sneddon-atom-export-01 - Atom Export Format]]
( ([TIME[2014-02-28 06:35:44 +09:00]] 版))
<http://tools.ietf.org/html/draft-sneddon-atom-export-01>

[29] [CITE@en[Citation Style Language 1.0.1]]
( ([TIME[2014-10-01 11:57:04 +09:00]] 版))
<http://citationstyles.org/downloads/specification.html#info>

[FIG(quote)[
[FIGCAPTION[
[30] [CITE[OData Atom Format Version 4.0]]
([TIME[2013-08-15 01:00:00 +09:00]] 版)
<http://docs.oasis-open.org/odata/odata-atom-format/v4.0/cs01/odata-atom-format-v4.0-cs01.html#_Toc230433086>
]FIGCAPTION]

> <category rel="http://docs.oasis-open.org/odata/ns/scheme"
>           term="Model.VipCustomer"/>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[31] [CITE[API Documentation]]
([TIME[2015-07-28 21:53:57 +09:00]] 版)
<https://www.shutterfly.com/documentation/AtomConcepts.sfly>
]FIGCAPTION]

> 
>    <category term="addressbookentry" scheme="http://site.openfly.shutterfly.com/v1.0"/>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[32] [CITE[API Documentation]]
([TIME[2015-07-28 21:54:33 +09:00]] 版)
<https://www.shutterfly.com/documentation/AtomConcepts.sfly>
]FIGCAPTION]

> 
>    <category term="user" scheme="http://openfly.shutterfly.com/v1.0"/>
>    <entry>
>       <title>My New Folder</title>
>       <category term="folder" scheme="http://media.openfly.shutterfly.com/v1.0"/>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[33] [CITE[ORE User Guide - Resource Map Implementation in Atom]]
([TIME[2015-01-15 03:43:34 +09:00]] 版)
<https://www.openarchives.org/ore/1.0/atom>
]FIGCAPTION]

> 
>   <category term="2005-12-31T04:01:23Z" scheme="http://www.openarchives.org/ore/atom/created"/>
>   <category term="http://www.openarchives.org/ore/terms/Aggregation" label="Aggregation" 
>   scheme="http://www.openarchives.org/ore/terms/" />
>   <category term="2006-01-18T06:16:15Z" scheme="http://www.openarchives.org/ore/atom/modified"/>
>   <category term="http://purl.org/eprint/type/JournalArticle" 
>   scheme="http://purl.org/eprint/type/" label="Journal Article"/>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[34] ([TIME[2016-03-18 23:25:47 +09:00]] 版)
<http://staff.hatenablog.com/feed>
]FIGCAPTION]

> 
>         <category term="障害・メンテナンス" label="障害・メンテナンス" />

]FIG]


[FIG(quote)[
[FIGCAPTION[
[35] ([TIME[2016-03-18 01:55:19 +09:00]] 版)
<https://googleblog.blogspot.com/feeds/posts/default>
]FIGCAPTION]

> <category term="search"/>

]FIG]

[36] >>35 これは[[ブログ]]に存在する分類 (タグ?) がすべて [CODE(HXMLe)@en[feed]]
の [CODE(XMLe)@en[category]] として含まれているのでしょうかね。
確かに [CODE(XMLe)@en[category]] [[要素]]の意味を考えるとそれでもおかしくはなさそう。
そもそも [CODE(XMLe)@en[feed]] の [CODE(XMLe)@en[category]] は何のためにあるのだろう。。。

[FIG(quote)[
[FIGCAPTION[
[37] ([TIME[2016-03-15 11:13:59 +09:00]] 版)
<http://www.nhk.or.jp/lesson/common/rss/podcast/arabic.xml>
]FIGCAPTION]

> 
> <itunes:category text="Education">
> <itunes:category text="Language Courses"/>
> </itunes:category>
> <item>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[38] ([TIME[2016-03-15 11:13:59 +09:00]] 版)
<http://www.nhk.or.jp/lesson/common/rss/podcast/arabic.xml>
]FIGCAPTION]

> <itunes:category text="Education">
> <itunes:category text="Language Courses"/>
> </itunes:category>
> <pubDate>Tue, 15 Mar 2016 00:00:00 +0900</pubDate>
> </item>

;; [41] [CODE(XMLe)@en[item]] に [CODE(XMLe)@en[itunes:category]]
が指定されています。しかし [[Apple]] のドキュメントでは [CODE(XMLe)@en[channel]]
にしか指定できないことになっています。

]FIG]


[FIG(quote)[
[FIGCAPTION[
[39] [CITE@en[RSS feed sample - Podcasts Connect Help]]
([TIME[2016-03-19 12:27:24 +09:00]] 版)
<https://help.apple.com/itc/podcasts_connect/#/itcbaf351599>
]FIGCAPTION]

> <itunes:image href="http://example.com/podcasts/everything/AllAboutEverything.jpg" />
> <itunes:category text="Technology">
> <itunes:category text="Gadgets"/>
> </itunes:category>
> <itunes:category text="TV &amp; Film"/>
> <item>

;; [40] [CODE[<itunes:category>]] が欠落していて[[整形式]]になっていません。

]FIG]

[FIG(quote)[
[FIGCAPTION[
[42] ([TIME[2016-03-18 16:49:18 +09:00]] 版)
<http://www.joqr.co.jp/blog/golden-opening/index.xml>
]FIGCAPTION]

> 
> <category>Comedy</category>
> <itunes:category text="Comedy"/>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[43] ([TIME[2016-03-18 16:49:18 +09:00]] 版)
<http://www.joqr.co.jp/blog/golden-opening/index.xml>
]FIGCAPTION]

> 
> <category></category>
> <pubDate>Fri, 18 Mar 2016 17:00:00 +0900</pubDate>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[44] ([TIME[2016-03-14 12:53:04 +09:00]] 版)
<http://www.tbsradio.jp/tsutaya/index.xml>
]FIGCAPTION]

> <category>TV & Film</category>
> <itunes:category text="TV & Film"/>
> <itunes:category text="Comedy"/>

]FIG]


[FIG(quote)[
[FIGCAPTION[
[45] ([TIME[2016-03-21 10:33:46 +09:00]] 版)
<http://stackoverflow.com/feeds>
]FIGCAPTION]

>             <category scheme="http://stackoverflow.com/tags" term="python" />
>             <category scheme="http://stackoverflow.com/tags" term="xml" />

]FIG]


[FIG(quote)[
[FIGCAPTION[
[46] ( ([TIME[2016-01-16 16:49:14 +09:00]]))
<http://easier-links.com/atom.xml>
]FIGCAPTION]

>          <category term="550サーチエンジン" scheme="http://www.sixapart.com/ns/types#category" />

]FIG]

[49] [CITE@en[Atom Export Format]]
( ([TIME[2009-05-24 06:33:45 +09:00]] 版))
<http://stuff.gsnedders.com/atom-export.html>


[FIG(quote)[
[FIGCAPTION[
[50] ([TIME[2015-12-12 00:00:05 +09:00]] 版)
<http://blog.nicovideo.jp/index.xml>
]FIGCAPTION]

> 
[PRE(XML code)[
<category domain="http://www.sixapart.com/ns/types#category">お知らせ</category>
<category domain="http://www.sixapart.com/ns/types#category">ひとりごとシリーズ</category>
<category domain="http://www.sixapart.com/ns/types#category">ニコニコ動画について</category>
<category domain="http://www.sixapart.com/ns/types#category">日記</category>
]PRE]

]FIG]

[FIG(quote)[
[FIGCAPTION[
[51] ([TIME[2014-12-11 16:48:39 +09:00]] 版)
<http://xmlns.ezrss.it/0.1/index.xmlns>
]FIGCAPTION]

> 
[PRE(XML code)[
				<category domain="http://eztv.it/shows/40/californication/"><!'''['''CDATA'''['''TV Show / Californication''']'''''']'''></category>
]PRE]

]FIG]

[FIG(quote)[
[FIGCAPTION[
[52] [TIME[2016-03-19 18:25:35 +09:00]] 版)
<http://blog.suzaka.jp/xmlsrv/rss2.php?blog=79>
]FIGCAPTION]

> 
[PRE(XML code)[
<category domain="main">図書館だより</category>
]PRE]

]FIG]