Microformats Wiki - User contributions [en]

hcard-ja

2008-06-08T12:33:33Z

Vantguarde: /* adr tel email types */

<h1>hCard</h1>
{{TOC-right}}
hCard は、vCard ([[rfc-2426|RFC2426]]) のプロパティと値を利用して、[[semantic-xhtml|HTML]] で人や会社、組織や場所を表現する [[microformats-ja|microformat]] です。hCard は HTML や XHTML はもちろんのこと、Atom、RSS、その他の XML に埋め込むことができます。

hCard を利用するには、いくつかの方法があります。
*[http://blog.livedoor.jp/forestk/misc/microformats/hCard/creator-ja/ hCard creator] hCard を利用し、作成したコードをページにはりつける。
*[[hcard-authoring|hCard authoring tips]] を読んで、hCard のマークアップを行う。

== hCard 仕様書 ==

<div class="vcard">
; <span class="role">編集者</span>
: <span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, and before at [http://technorati.com Technorati, Inc.], and at [http://microsoft.com/ Microsoft Corporation])
</div>
; 作者: [http://tantek.com/ Tantek Çelik] (affiliations above)
: <span class="vcard"><span class="fn">[[User:Brian|Brian Suda]]</span> (<span class="url">http://suda.co.uk/</span>)</span>

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめ、さまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは自分の名前を出し、友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーはその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーは hCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎となります。

hCard は、vCard のオブジェクト/プロパティ名を小文字にして、class 属性の値に使用します。vCard オブジェクトの入れ子関係は、そのまま HTML での入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次のリストにあるプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* <span id="property-list-n">'''n'''<sup style="font-size:smaller">[[#note1|1]]</sup> (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)

任意プロパティ
* nickname, sort-string
* url, email (type, value), <span id="property-list-n">tel<sup style="font-size:smaller">[[#note2|2]]</sup> (type, value)</span>
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<span id="note1">[[#property-list-n|1. ^]]</span>: 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<span id="note2">[[#property-list-tel|2. ^]]</span>: tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。文字の入った電話番号 (例: +1-555-FORMATS) は、数字で表記しなければなりません ({{must}})。<code>abbr</code> を利用して、ソフトウェアには数字から成る電話番号の方を伝えることもできます (<code><nowiki><abbr title="+15553676287">+1-555-FORMATS</abbr></nowiki></code>)。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視するべきです ({{should}})。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-name のイニシャル
* family-name (スペース) given-name のイニシャル (任意のピリオド)

<div style="border: thin dashed #600; width: 95%; padding: .5em 1em; background-color:#fee;">
注: 日本語で名前を記述するときには、この推測処理を利用することはできません。必ず given-name、family-name プロパティを利用し、明示的に名前を記述しなければなりません。

<pre><nowiki>
<div class="vcard">
<span class="fn n">
<span class="family-name">マイクロ</span>
<span class="given-name">太郎</span>
</span>
</div>
</nowiki></pre>
</div>

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

==== type with unspecified value ====
When the type of a property is specified, and there is no explicit value specified, then everything in the property except for the type is considered the value of the property. E.g.

<pre><nowiki>
<span class="tel"><span class="type">Home</span> +1.415.555.1212</span>
</nowiki></pre>

is equivalent to:

<pre><nowiki>
<span class="tel"><span class="type">Home</span><span class="value"> +1.415.555.1212</span></span>
</nowiki></pre>

And thus the type is "home" and the value is "+1.415.555.1212".

==== adr tel email types ====
次のリストは ''参考情報'' です。

規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください (ここでは利便性の為にコピーしています)。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

<div style="border: thin dashed #600; width: 95%; padding: .5em 1em; background-color:#fee;">
注: 日本語などの言語では、これらサブプロパティの多くを利用することができません。サブタイプはマークアップの制限上、その内容を訳すことができないからです。
</div>

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは [http://www.commerce.net/ Commercenet] のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''CommerceNet'''</div>
<div class="url">'''<nowiki>http://www.commerce.net/</nowiki>'''</div>
<div class="adr">'''<span class="type">Work</span>:'''
<div class="street-address">'''169 University Avenue'''</div>
<span class="locality">'''Palo Alto'''</span>, <span class="region">'''CA'''</span>  <span class="postal-code">'''94301'''</span>
<div class="country-name">'''USA'''</div>
</div>
<div class="tel">'''<span class="type">Work</span> +1-650-289-4040'''</div>
<div class="tel">'''<span class="type">Fax</span> +1-650-289-4041'''</div>
<div>'''Email <span class="email"><nowiki>info@commerce.net</nowiki></span>'''</div>
</div>

The mark-up, emboldening omitted for clarity, with the following semantic improvements:
* <code>abbr</code> to expand abbreviations
* hyperlinking the org name with the url

<pre><nowiki>
<div class="vcard">
<a class="fn org url" href="http://www.commerce.net/">CommerceNet</a>
<div class="adr">
<span class="type">Work</span>:
<div class="street-address">169 University Avenue</div>
<span class="locality">Palo Alto</span>,
<abbr class="region" title="California">CA</abbr>  
<span class="postal-code">94301</span>
<div class="country-name">USA</div>
</div>
<div class="tel">
<span class="type">Work</span> +1-650-289-4040
</div>
<div class="tel">
<span class="type">Fax</span> +1-650-289-4041
</div>
<div>Email:
<span class="email">info@commerce.net</span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== vCard における由来 ==
このセクションは ''参考情報'' です。

<div id="Semantic_XHTML_Design_Principles">[[hcard-design-methodology]] をご覧ください。</div>

=== 意味的に同等なもの ===
いくつかのプロパティにおいて、その意味を上手く表現できる HTML 要素が存在します。次に挙げるプロパティは、その例に書かれている (X)HTML で表現すべきです ({{should}})。

* vCard の <code>URL</code> は hCard にて <code><a class="url" href="...">...</a></code> と表します。このプロパティは、<code>class="vcard"</code> をつけた要素の中に書かれます。
* 同様に vCard の <code>EMAIL</code> は <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code> となります。
* vCard の <code>PHOTO</code> は <code><img class="photo" src="..." alt="Photo of ..." /></code>、または <code><object class="photo" data="..." type="...">Photo of ...</object></code> となります。
* vCard の <code>UID</code> hCard において、特定の URL (または EMAIL) といった、別の意味に置き換えられます。

=== 出現回数が一回のプロパティ ===
[[hcard-ja#.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3.E3.81.AE.E5.87.BA.E7.8F.BE.E5.9B.9E.E6.95.B0|プロパティの出現回数]]は、vCard RFC2426 で定義されるプロパティを一つずつ調べ、そのセマンティクスから一つのみでなければならない ({{must}}) を導き出したものです。[[hcard-singular-properties]] に解説があるので、そちらをご覧ください。

==== 単数化されたプロパティ ====
いくつかの複数系のプロパティ名が単数名化されています。このため、もし元となる複数形のプロパティが、複数のコンポーネントからなるひとつの値を取るものであっても、それらのコンポーネントは、単数名化されたプロパティを複数持つものとなります。

== その他の読み物 ==
* Garrett Dimon による [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] は hCard の良い解説です。
* Drew McLellan による [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard]
* Chris Silver Smith による [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats]
* [http://thedredge.org/ Andrew D. Hume] は [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] という、hCard に関する記事を書いています。
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] による[http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO] という素晴らしい記事があります。彼の hCard を例に取って解説しています。
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] 24 Ways の記事です。John Allsopp が CSS を用い、hCard をスタイリングしています。
* [http://www.technorati.com/cosmos/referer.html このページについて書かれた blog] と [http://technorati.com/tags/hcard hCard タグ] もご覧ください。
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - インスタントメッセージングの拡張]

== 関連ページ ==
{{hcard-related-pages}}

hcard-ja

2008-06-08T12:15:10Z

Vantguarde: /* プロパティリスト */

<h1>hCard</h1>
{{TOC-right}}
hCard は、vCard ([[rfc-2426|RFC2426]]) のプロパティと値を利用して、[[semantic-xhtml|HTML]] で人や会社、組織や場所を表現する [[microformats-ja|microformat]] です。hCard は HTML や XHTML はもちろんのこと、Atom、RSS、その他の XML に埋め込むことができます。

hCard を利用するには、いくつかの方法があります。
*[http://blog.livedoor.jp/forestk/misc/microformats/hCard/creator-ja/ hCard creator] hCard を利用し、作成したコードをページにはりつける。
*[[hcard-authoring|hCard authoring tips]] を読んで、hCard のマークアップを行う。

== hCard 仕様書 ==

<div class="vcard">
; <span class="role">編集者</span>
: <span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, and before at [http://technorati.com Technorati, Inc.], and at [http://microsoft.com/ Microsoft Corporation])
</div>
; 作者: [http://tantek.com/ Tantek Çelik] (affiliations above)
: <span class="vcard"><span class="fn">[[User:Brian|Brian Suda]]</span> (<span class="url">http://suda.co.uk/</span>)</span>

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめ、さまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは自分の名前を出し、友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーはその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーは hCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎となります。

hCard は、vCard のオブジェクト/プロパティ名を小文字にして、class 属性の値に使用します。vCard オブジェクトの入れ子関係は、そのまま HTML での入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次のリストにあるプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* <span id="property-list-n">'''n'''<sup style="font-size:smaller">[[#note1|1]]</sup> (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)

任意プロパティ
* nickname, sort-string
* url, email (type, value), <span id="property-list-n">tel<sup style="font-size:smaller">[[#note2|2]]</sup> (type, value)</span>
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<span id="note1">[[#property-list-n|1. ^]]</span>: 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<span id="note2">[[#property-list-tel|2. ^]]</span>: tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。文字の入った電話番号 (例: +1-555-FORMATS) は、数字で表記しなければなりません ({{must}})。<code>abbr</code> を利用して、ソフトウェアには数字から成る電話番号の方を伝えることもできます (<code><nowiki><abbr title="+15553676287">+1-555-FORMATS</abbr></nowiki></code>)。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視するべきです ({{should}})。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-name のイニシャル
* family-name (スペース) given-name のイニシャル (任意のピリオド)

<div style="border: thin dashed #600; width: 95%; padding: .5em 1em; background-color:#fee;">
注: 日本語で名前を記述するときには、この推測処理を利用することはできません。必ず given-name、family-name プロパティを利用し、明示的に名前を記述しなければなりません。

<pre><nowiki>
<div class="vcard">
<span class="fn n">
<span class="family-name">マイクロ</span>
<span class="given-name">太郎</span>
</span>
</div>
</nowiki></pre>
</div>

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

==== type with unspecified value ====
When the type of a property is specified, and there is no explicit value specified, then everything in the property except for the type is considered the value of the property. E.g.

<pre><nowiki>
<span class="tel"><span class="type">Home</span> +1.415.555.1212</span>
</nowiki></pre>

is equivalent to:

<pre><nowiki>
<span class="tel"><span class="type">Home</span><span class="value"> +1.415.555.1212</span></span>
</nowiki></pre>

And thus the type is "home" and the value is "+1.415.555.1212".

==== adr tel email types ====
次のリストは ''参考情報'' です。

規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください (ここでは利便性の為にコピーしています)。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

<div style="border: thin dashed #600; width: 95%; padding: .5em 1em; background-color:#fee;">
注: 日本語などの言語では、これらサブプロパティの多くを利用することができません。サブタイプは <nowiki><code>< span class="type">タイプ名</span></code></nowiki> と書く必要があり、その内容を訳すことは認められていないからです。
</div>

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは [http://www.commerce.net/ Commercenet] のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''CommerceNet'''</div>
<div class="url">'''<nowiki>http://www.commerce.net/</nowiki>'''</div>
<div class="adr">'''<span class="type">Work</span>:'''
<div class="street-address">'''169 University Avenue'''</div>
<span class="locality">'''Palo Alto'''</span>, <span class="region">'''CA'''</span>  <span class="postal-code">'''94301'''</span>
<div class="country-name">'''USA'''</div>
</div>
<div class="tel">'''<span class="type">Work</span> +1-650-289-4040'''</div>
<div class="tel">'''<span class="type">Fax</span> +1-650-289-4041'''</div>
<div>'''Email <span class="email"><nowiki>info@commerce.net</nowiki></span>'''</div>
</div>

The mark-up, emboldening omitted for clarity, with the following semantic improvements:
* <code>abbr</code> to expand abbreviations
* hyperlinking the org name with the url

<pre><nowiki>
<div class="vcard">
<a class="fn org url" href="http://www.commerce.net/">CommerceNet</a>
<div class="adr">
<span class="type">Work</span>:
<div class="street-address">169 University Avenue</div>
<span class="locality">Palo Alto</span>,
<abbr class="region" title="California">CA</abbr>  
<span class="postal-code">94301</span>
<div class="country-name">USA</div>
</div>
<div class="tel">
<span class="type">Work</span> +1-650-289-4040
</div>
<div class="tel">
<span class="type">Fax</span> +1-650-289-4041
</div>
<div>Email:
<span class="email">info@commerce.net</span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== vCard における由来 ==
このセクションは ''参考情報'' です。

<div id="Semantic_XHTML_Design_Principles">[[hcard-design-methodology]] をご覧ください。</div>

=== 意味的に同等なもの ===
いくつかのプロパティにおいて、その意味を上手く表現できる HTML 要素が存在します。次に挙げるプロパティは、その例に書かれている (X)HTML で表現すべきです ({{should}})。

* vCard の <code>URL</code> は hCard にて <code><a class="url" href="...">...</a></code> と表します。このプロパティは、<code>class="vcard"</code> をつけた要素の中に書かれます。
* 同様に vCard の <code>EMAIL</code> は <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code> となります。
* vCard の <code>PHOTO</code> は <code><img class="photo" src="..." alt="Photo of ..." /></code>、または <code><object class="photo" data="..." type="...">Photo of ...</object></code> となります。
* vCard の <code>UID</code> hCard において、特定の URL (または EMAIL) といった、別の意味に置き換えられます。

=== 出現回数が一回のプロパティ ===
[[hcard-ja#.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3.E3.81.AE.E5.87.BA.E7.8F.BE.E5.9B.9E.E6.95.B0|プロパティの出現回数]]は、vCard RFC2426 で定義されるプロパティを一つずつ調べ、そのセマンティクスから一つのみでなければならない ({{must}}) を導き出したものです。[[hcard-singular-properties]] に解説があるので、そちらをご覧ください。

==== 単数化されたプロパティ ====
いくつかの複数系のプロパティ名が単数名化されています。このため、もし元となる複数形のプロパティが、複数のコンポーネントからなるひとつの値を取るものであっても、それらのコンポーネントは、単数名化されたプロパティを複数持つものとなります。

== その他の読み物 ==
* Garrett Dimon による [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] は hCard の良い解説です。
* Drew McLellan による [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard]
* Chris Silver Smith による [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats]
* [http://thedredge.org/ Andrew D. Hume] は [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] という、hCard に関する記事を書いています。
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] による[http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO] という素晴らしい記事があります。彼の hCard を例に取って解説しています。
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] 24 Ways の記事です。John Allsopp が CSS を用い、hCard をスタイリングしています。
* [http://www.technorati.com/cosmos/referer.html このページについて書かれた blog] と [http://technorati.com/tags/hcard hCard タグ] もご覧ください。
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - インスタントメッセージングの拡張]

== 関連ページ ==
{{hcard-related-pages}}

hcard-ja

2008-06-08T12:14:45Z

Vantguarde: /* プロパティリスト */

<h1>hCard</h1>
{{TOC-right}}
hCard は、vCard ([[rfc-2426|RFC2426]]) のプロパティと値を利用して、[[semantic-xhtml|HTML]] で人や会社、組織や場所を表現する [[microformats-ja|microformat]] です。hCard は HTML や XHTML はもちろんのこと、Atom、RSS、その他の XML に埋め込むことができます。

hCard を利用するには、いくつかの方法があります。
*[http://blog.livedoor.jp/forestk/misc/microformats/hCard/creator-ja/ hCard creator] hCard を利用し、作成したコードをページにはりつける。
*[[hcard-authoring|hCard authoring tips]] を読んで、hCard のマークアップを行う。

== hCard 仕様書 ==

<div class="vcard">
; <span class="role">編集者</span>
: <span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, and before at [http://technorati.com Technorati, Inc.], and at [http://microsoft.com/ Microsoft Corporation])
</div>
; 作者: [http://tantek.com/ Tantek Çelik] (affiliations above)
: <span class="vcard"><span class="fn">[[User:Brian|Brian Suda]]</span> (<span class="url">http://suda.co.uk/</span>)</span>

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめ、さまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは自分の名前を出し、友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーはその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーは hCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎となります。

hCard は、vCard のオブジェクト/プロパティ名を小文字にして、class 属性の値に使用します。vCard オブジェクトの入れ子関係は、そのまま HTML での入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次のリストにあるプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''<span id="property-list-n">'''n'''<sup style="font-size:smaller">[[#note1|1]]</sup> (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)

任意プロパティ
* nickname, sort-string
* url, email (type, value), <span id="property-list-n">tel<sup style="font-size:smaller">[[#note2|2]]</sup> (type, value)</span>
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<span id="note1">[[#property-list-n|1. ^]]</span>: 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<span id="note2">[[#property-list-tel|2. ^]]</span>: tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。文字の入った電話番号 (例: +1-555-FORMATS) は、数字で表記しなければなりません ({{must}})。<code>abbr</code> を利用して、ソフトウェアには数字から成る電話番号の方を伝えることもできます (<code><nowiki><abbr title="+15553676287">+1-555-FORMATS</abbr></nowiki></code>)。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視するべきです ({{should}})。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-name のイニシャル
* family-name (スペース) given-name のイニシャル (任意のピリオド)

<div style="border: thin dashed #600; width: 95%; padding: .5em 1em; background-color:#fee;">
注: 日本語で名前を記述するときには、この推測処理を利用することはできません。必ず given-name、family-name プロパティを利用し、明示的に名前を記述しなければなりません。

<pre><nowiki>
<div class="vcard">
<span class="fn n">
<span class="family-name">マイクロ</span>
<span class="given-name">太郎</span>
</span>
</div>
</nowiki></pre>
</div>

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

==== type with unspecified value ====
When the type of a property is specified, and there is no explicit value specified, then everything in the property except for the type is considered the value of the property. E.g.

<pre><nowiki>
<span class="tel"><span class="type">Home</span> +1.415.555.1212</span>
</nowiki></pre>

is equivalent to:

<pre><nowiki>
<span class="tel"><span class="type">Home</span><span class="value"> +1.415.555.1212</span></span>
</nowiki></pre>

And thus the type is "home" and the value is "+1.415.555.1212".

==== adr tel email types ====
次のリストは ''参考情報'' です。

規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください (ここでは利便性の為にコピーしています)。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

<div style="border: thin dashed #600; width: 95%; padding: .5em 1em; background-color:#fee;">
注: 日本語などの言語では、これらサブプロパティの多くを利用することができません。サブタイプは <nowiki><code>< span class="type">タイプ名</span></code></nowiki> と書く必要があり、その内容を訳すことは認められていないからです。
</div>

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは [http://www.commerce.net/ Commercenet] のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''CommerceNet'''</div>
<div class="url">'''<nowiki>http://www.commerce.net/</nowiki>'''</div>
<div class="adr">'''<span class="type">Work</span>:'''
<div class="street-address">'''169 University Avenue'''</div>
<span class="locality">'''Palo Alto'''</span>, <span class="region">'''CA'''</span>  <span class="postal-code">'''94301'''</span>
<div class="country-name">'''USA'''</div>
</div>
<div class="tel">'''<span class="type">Work</span> +1-650-289-4040'''</div>
<div class="tel">'''<span class="type">Fax</span> +1-650-289-4041'''</div>
<div>'''Email <span class="email"><nowiki>info@commerce.net</nowiki></span>'''</div>
</div>

The mark-up, emboldening omitted for clarity, with the following semantic improvements:
* <code>abbr</code> to expand abbreviations
* hyperlinking the org name with the url

<pre><nowiki>
<div class="vcard">
<a class="fn org url" href="http://www.commerce.net/">CommerceNet</a>
<div class="adr">
<span class="type">Work</span>:
<div class="street-address">169 University Avenue</div>
<span class="locality">Palo Alto</span>,
<abbr class="region" title="California">CA</abbr>  
<span class="postal-code">94301</span>
<div class="country-name">USA</div>
</div>
<div class="tel">
<span class="type">Work</span> +1-650-289-4040
</div>
<div class="tel">
<span class="type">Fax</span> +1-650-289-4041
</div>
<div>Email:
<span class="email">info@commerce.net</span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== vCard における由来 ==
このセクションは ''参考情報'' です。

<div id="Semantic_XHTML_Design_Principles">[[hcard-design-methodology]] をご覧ください。</div>

=== 意味的に同等なもの ===
いくつかのプロパティにおいて、その意味を上手く表現できる HTML 要素が存在します。次に挙げるプロパティは、その例に書かれている (X)HTML で表現すべきです ({{should}})。

* vCard の <code>URL</code> は hCard にて <code><a class="url" href="...">...</a></code> と表します。このプロパティは、<code>class="vcard"</code> をつけた要素の中に書かれます。
* 同様に vCard の <code>EMAIL</code> は <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code> となります。
* vCard の <code>PHOTO</code> は <code><img class="photo" src="..." alt="Photo of ..." /></code>、または <code><object class="photo" data="..." type="...">Photo of ...</object></code> となります。
* vCard の <code>UID</code> hCard において、特定の URL (または EMAIL) といった、別の意味に置き換えられます。

=== 出現回数が一回のプロパティ ===
[[hcard-ja#.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3.E3.81.AE.E5.87.BA.E7.8F.BE.E5.9B.9E.E6.95.B0|プロパティの出現回数]]は、vCard RFC2426 で定義されるプロパティを一つずつ調べ、そのセマンティクスから一つのみでなければならない ({{must}}) を導き出したものです。[[hcard-singular-properties]] に解説があるので、そちらをご覧ください。

==== 単数化されたプロパティ ====
いくつかの複数系のプロパティ名が単数名化されています。このため、もし元となる複数形のプロパティが、複数のコンポーネントからなるひとつの値を取るものであっても、それらのコンポーネントは、単数名化されたプロパティを複数持つものとなります。

== その他の読み物 ==
* Garrett Dimon による [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] は hCard の良い解説です。
* Drew McLellan による [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard]
* Chris Silver Smith による [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats]
* [http://thedredge.org/ Andrew D. Hume] は [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] という、hCard に関する記事を書いています。
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] による[http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO] という素晴らしい記事があります。彼の hCard を例に取って解説しています。
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] 24 Ways の記事です。John Allsopp が CSS を用い、hCard をスタイリングしています。
* [http://www.technorati.com/cosmos/referer.html このページについて書かれた blog] と [http://technorati.com/tags/hcard hCard タグ] もご覧ください。
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - インスタントメッセージングの拡張]

== 関連ページ ==
{{hcard-related-pages}}

hcard-ja

2008-06-08T12:14:18Z

Vantguarde: /* "n" の推測処理 */

<h1>hCard</h1>
{{TOC-right}}
hCard は、vCard ([[rfc-2426|RFC2426]]) のプロパティと値を利用して、[[semantic-xhtml|HTML]] で人や会社、組織や場所を表現する [[microformats-ja|microformat]] です。hCard は HTML や XHTML はもちろんのこと、Atom、RSS、その他の XML に埋め込むことができます。

hCard を利用するには、いくつかの方法があります。
*[http://blog.livedoor.jp/forestk/misc/microformats/hCard/creator-ja/ hCard creator] hCard を利用し、作成したコードをページにはりつける。
*[[hcard-authoring|hCard authoring tips]] を読んで、hCard のマークアップを行う。

== hCard 仕様書 ==

<div class="vcard">
; <span class="role">編集者</span>
: <span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, and before at [http://technorati.com Technorati, Inc.], and at [http://microsoft.com/ Microsoft Corporation])
</div>
; 作者: [http://tantek.com/ Tantek Çelik] (affiliations above)
: <span class="vcard"><span class="fn">[[User:Brian|Brian Suda]]</span> (<span class="url">http://suda.co.uk/</span>)</span>

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめ、さまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは自分の名前を出し、友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーはその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーは hCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎となります。

hCard は、vCard のオブジェクト/プロパティ名を小文字にして、class 属性の値に使用します。vCard オブジェクトの入れ子関係は、そのまま HTML での入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次のリストにあるプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* <span id="property-list-n">'''n'''<sup style="font-size:smaller">[[#note1|1]]</sup>
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), <span id="property-list-n">tel<sup style="font-size:smaller">[[#note2|2]]</sup> (type, value)</span>
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<span id="note1">[[#property-list-n|1. ^]]</span>: 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<span id="note2">[[#property-list-tel|2. ^]]</span>: tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。文字の入った電話番号 (例: +1-555-FORMATS) は、数字で表記しなければなりません ({{must}})。<code>abbr</code> を利用して、ソフトウェアには数字から成る電話番号の方を伝えることもできます (<code><nowiki><abbr title="+15553676287">+1-555-FORMATS</abbr></nowiki></code>)。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視するべきです ({{should}})。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-name のイニシャル
* family-name (スペース) given-name のイニシャル (任意のピリオド)

<div style="border: thin dashed #600; width: 95%; padding: .5em 1em; background-color:#fee;">
注: 日本語で名前を記述するときには、この推測処理を利用することはできません。必ず given-name、family-name プロパティを利用し、明示的に名前を記述しなければなりません。

<pre><nowiki>
<div class="vcard">
<span class="fn n">
<span class="family-name">マイクロ</span>
<span class="given-name">太郎</span>
</span>
</div>
</nowiki></pre>
</div>

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

==== type with unspecified value ====
When the type of a property is specified, and there is no explicit value specified, then everything in the property except for the type is considered the value of the property. E.g.

<pre><nowiki>
<span class="tel"><span class="type">Home</span> +1.415.555.1212</span>
</nowiki></pre>

is equivalent to:

<pre><nowiki>
<span class="tel"><span class="type">Home</span><span class="value"> +1.415.555.1212</span></span>
</nowiki></pre>

And thus the type is "home" and the value is "+1.415.555.1212".

==== adr tel email types ====
次のリストは ''参考情報'' です。

規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください (ここでは利便性の為にコピーしています)。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

<div style="border: thin dashed #600; width: 95%; padding: .5em 1em; background-color:#fee;">
注: 日本語などの言語では、これらサブプロパティの多くを利用することができません。サブタイプは <nowiki><code>< span class="type">タイプ名</span></code></nowiki> と書く必要があり、その内容を訳すことは認められていないからです。
</div>

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは [http://www.commerce.net/ Commercenet] のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''CommerceNet'''</div>
<div class="url">'''<nowiki>http://www.commerce.net/</nowiki>'''</div>
<div class="adr">'''<span class="type">Work</span>:'''
<div class="street-address">'''169 University Avenue'''</div>
<span class="locality">'''Palo Alto'''</span>, <span class="region">'''CA'''</span>  <span class="postal-code">'''94301'''</span>
<div class="country-name">'''USA'''</div>
</div>
<div class="tel">'''<span class="type">Work</span> +1-650-289-4040'''</div>
<div class="tel">'''<span class="type">Fax</span> +1-650-289-4041'''</div>
<div>'''Email <span class="email"><nowiki>info@commerce.net</nowiki></span>'''</div>
</div>

The mark-up, emboldening omitted for clarity, with the following semantic improvements:
* <code>abbr</code> to expand abbreviations
* hyperlinking the org name with the url

<pre><nowiki>
<div class="vcard">
<a class="fn org url" href="http://www.commerce.net/">CommerceNet</a>
<div class="adr">
<span class="type">Work</span>:
<div class="street-address">169 University Avenue</div>
<span class="locality">Palo Alto</span>,
<abbr class="region" title="California">CA</abbr>  
<span class="postal-code">94301</span>
<div class="country-name">USA</div>
</div>
<div class="tel">
<span class="type">Work</span> +1-650-289-4040
</div>
<div class="tel">
<span class="type">Fax</span> +1-650-289-4041
</div>
<div>Email:
<span class="email">info@commerce.net</span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== vCard における由来 ==
このセクションは ''参考情報'' です。

<div id="Semantic_XHTML_Design_Principles">[[hcard-design-methodology]] をご覧ください。</div>

=== 意味的に同等なもの ===
いくつかのプロパティにおいて、その意味を上手く表現できる HTML 要素が存在します。次に挙げるプロパティは、その例に書かれている (X)HTML で表現すべきです ({{should}})。

* vCard の <code>URL</code> は hCard にて <code><a class="url" href="...">...</a></code> と表します。このプロパティは、<code>class="vcard"</code> をつけた要素の中に書かれます。
* 同様に vCard の <code>EMAIL</code> は <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code> となります。
* vCard の <code>PHOTO</code> は <code><img class="photo" src="..." alt="Photo of ..." /></code>、または <code><object class="photo" data="..." type="...">Photo of ...</object></code> となります。
* vCard の <code>UID</code> hCard において、特定の URL (または EMAIL) といった、別の意味に置き換えられます。

=== 出現回数が一回のプロパティ ===
[[hcard-ja#.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3.E3.81.AE.E5.87.BA.E7.8F.BE.E5.9B.9E.E6.95.B0|プロパティの出現回数]]は、vCard RFC2426 で定義されるプロパティを一つずつ調べ、そのセマンティクスから一つのみでなければならない ({{must}}) を導き出したものです。[[hcard-singular-properties]] に解説があるので、そちらをご覧ください。

==== 単数化されたプロパティ ====
いくつかの複数系のプロパティ名が単数名化されています。このため、もし元となる複数形のプロパティが、複数のコンポーネントからなるひとつの値を取るものであっても、それらのコンポーネントは、単数名化されたプロパティを複数持つものとなります。

== その他の読み物 ==
* Garrett Dimon による [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] は hCard の良い解説です。
* Drew McLellan による [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard]
* Chris Silver Smith による [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats]
* [http://thedredge.org/ Andrew D. Hume] は [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] という、hCard に関する記事を書いています。
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] による[http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO] という素晴らしい記事があります。彼の hCard を例に取って解説しています。
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] 24 Ways の記事です。John Allsopp が CSS を用い、hCard をスタイリングしています。
* [http://www.technorati.com/cosmos/referer.html このページについて書かれた blog] と [http://technorati.com/tags/hcard hCard タグ] もご覧ください。
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - インスタントメッセージングの拡張]

== 関連ページ ==
{{hcard-related-pages}}

hcard-ja

2008-06-08T12:02:36Z

Vantguarde: /* "n" の推測処理 */ added a note that this opitimization doesn't work for Japanese names and authors need to explicitly markup their names with given-name and family-name.

<h1>hCard</h1>
{{TOC-right}}
hCard は、vCard ([[rfc-2426|RFC2426]]) のプロパティと値を利用して、[[semantic-xhtml|HTML]] で人や会社、組織や場所を表現する [[microformats-ja|microformat]] です。hCard は HTML や XHTML はもちろんのこと、Atom、RSS、その他の XML に埋め込むことができます。

hCard を利用するには、いくつかの方法があります。
*[http://blog.livedoor.jp/forestk/misc/microformats/hCard/creator-ja/ hCard creator] hCard を利用し、作成したコードをページにはりつける。
*[[hcard-authoring|hCard authoring tips]] を読んで、hCard のマークアップを行う。

== hCard 仕様書 ==

<div class="vcard">
; <span class="role">編集者</span>
: <span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, and before at [http://technorati.com Technorati, Inc.], and at [http://microsoft.com/ Microsoft Corporation])
</div>
; 作者: [http://tantek.com/ Tantek Çelik] (affiliations above)
: <span class="vcard"><span class="fn">[[User:Brian|Brian Suda]]</span> (<span class="url">http://suda.co.uk/</span>)</span>

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめ、さまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは自分の名前を出し、友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーはその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーは hCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎となります。

hCard は、vCard のオブジェクト/プロパティ名を小文字にして、class 属性の値に使用します。vCard オブジェクトの入れ子関係は、そのまま HTML での入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次のリストにあるプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* <span id="property-list-n">'''n'''<sup style="font-size:smaller">[[#note1|1]]</sup>
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), <span id="property-list-n">tel<sup style="font-size:smaller">[[#note2|2]]</sup> (type, value)</span>
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<span id="note1">[[#property-list-n|1. ^]]</span>: 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<span id="note2">[[#property-list-tel|2. ^]]</span>: tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。文字の入った電話番号 (例: +1-555-FORMATS) は、数字で表記しなければなりません ({{must}})。<code>abbr</code> を利用して、ソフトウェアには数字から成る電話番号の方を伝えることもできます (<code><nowiki><abbr title="+15553676287">+1-555-FORMATS</abbr></nowiki></code>)。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視するべきです ({{should}})。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-name のイニシャル
* family-name (スペース) given-name のイニシャル (任意のピリオド)

<div style="border: thin dashed #600; width: 95%; padding: .5em 1em; background-color:#fee;">
注: 日本語で名前を記述するときには、この推測処理を利用することはできません。必ず given-name、family-name プロパティを利用し、明示的に名前を記述しなければなりません。
</div>

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

==== type with unspecified value ====
When the type of a property is specified, and there is no explicit value specified, then everything in the property except for the type is considered the value of the property. E.g.

<pre><nowiki>
<span class="tel"><span class="type">Home</span> +1.415.555.1212</span>
</nowiki></pre>

is equivalent to:

<pre><nowiki>
<span class="tel"><span class="type">Home</span><span class="value"> +1.415.555.1212</span></span>
</nowiki></pre>

And thus the type is "home" and the value is "+1.415.555.1212".

==== adr tel email types ====
次のリストは ''参考情報'' です。

規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください (ここでは利便性の為にコピーしています)。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

<div style="border: thin dashed #600; width: 95%; padding: .5em 1em; background-color:#fee;">
注: 日本語などの言語では、これらサブプロパティの多くを利用することができません。サブタイプは <nowiki><code>< span class="type">タイプ名</span></code></nowiki> と書く必要があり、その内容を訳すことは認められていないからです。
</div>

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは [http://www.commerce.net/ Commercenet] のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''CommerceNet'''</div>
<div class="url">'''<nowiki>http://www.commerce.net/</nowiki>'''</div>
<div class="adr">'''<span class="type">Work</span>:'''
<div class="street-address">'''169 University Avenue'''</div>
<span class="locality">'''Palo Alto'''</span>, <span class="region">'''CA'''</span>  <span class="postal-code">'''94301'''</span>
<div class="country-name">'''USA'''</div>
</div>
<div class="tel">'''<span class="type">Work</span> +1-650-289-4040'''</div>
<div class="tel">'''<span class="type">Fax</span> +1-650-289-4041'''</div>
<div>'''Email <span class="email"><nowiki>info@commerce.net</nowiki></span>'''</div>
</div>

The mark-up, emboldening omitted for clarity, with the following semantic improvements:
* <code>abbr</code> to expand abbreviations
* hyperlinking the org name with the url

<pre><nowiki>
<div class="vcard">
<a class="fn org url" href="http://www.commerce.net/">CommerceNet</a>
<div class="adr">
<span class="type">Work</span>:
<div class="street-address">169 University Avenue</div>
<span class="locality">Palo Alto</span>,
<abbr class="region" title="California">CA</abbr>  
<span class="postal-code">94301</span>
<div class="country-name">USA</div>
</div>
<div class="tel">
<span class="type">Work</span> +1-650-289-4040
</div>
<div class="tel">
<span class="type">Fax</span> +1-650-289-4041
</div>
<div>Email:
<span class="email">info@commerce.net</span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== vCard における由来 ==
このセクションは ''参考情報'' です。

<div id="Semantic_XHTML_Design_Principles">[[hcard-design-methodology]] をご覧ください。</div>

=== 意味的に同等なもの ===
いくつかのプロパティにおいて、その意味を上手く表現できる HTML 要素が存在します。次に挙げるプロパティは、その例に書かれている (X)HTML で表現すべきです ({{should}})。

* vCard の <code>URL</code> は hCard にて <code><a class="url" href="...">...</a></code> と表します。このプロパティは、<code>class="vcard"</code> をつけた要素の中に書かれます。
* 同様に vCard の <code>EMAIL</code> は <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code> となります。
* vCard の <code>PHOTO</code> は <code><img class="photo" src="..." alt="Photo of ..." /></code>、または <code><object class="photo" data="..." type="...">Photo of ...</object></code> となります。
* vCard の <code>UID</code> hCard において、特定の URL (または EMAIL) といった、別の意味に置き換えられます。

=== 出現回数が一回のプロパティ ===
[[hcard-ja#.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3.E3.81.AE.E5.87.BA.E7.8F.BE.E5.9B.9E.E6.95.B0|プロパティの出現回数]]は、vCard RFC2426 で定義されるプロパティを一つずつ調べ、そのセマンティクスから一つのみでなければならない ({{must}}) を導き出したものです。[[hcard-singular-properties]] に解説があるので、そちらをご覧ください。

==== 単数化されたプロパティ ====
いくつかの複数系のプロパティ名が単数名化されています。このため、もし元となる複数形のプロパティが、複数のコンポーネントからなるひとつの値を取るものであっても、それらのコンポーネントは、単数名化されたプロパティを複数持つものとなります。

== その他の読み物 ==
* Garrett Dimon による [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] は hCard の良い解説です。
* Drew McLellan による [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard]
* Chris Silver Smith による [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats]
* [http://thedredge.org/ Andrew D. Hume] は [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] という、hCard に関する記事を書いています。
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] による[http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO] という素晴らしい記事があります。彼の hCard を例に取って解説しています。
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] 24 Ways の記事です。John Allsopp が CSS を用い、hCard をスタイリングしています。
* [http://www.technorati.com/cosmos/referer.html このページについて書かれた blog] と [http://technorati.com/tags/hcard hCard タグ] もご覧ください。
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - インスタントメッセージングの拡張]

== 関連ページ ==
{{hcard-related-pages}}

hcard-ja

2008-06-08T11:57:07Z

Vantguarde: /* adr tel email types */ added a note that many subtypes are not be able to use in Japanese due to the "human readable" principle. that really sucks...

<h1>hCard</h1>
{{TOC-right}}
hCard は、vCard ([[rfc-2426|RFC2426]]) のプロパティと値を利用して、[[semantic-xhtml|HTML]] で人や会社、組織や場所を表現する [[microformats-ja|microformat]] です。hCard は HTML や XHTML はもちろんのこと、Atom、RSS、その他の XML に埋め込むことができます。

hCard を利用するには、いくつかの方法があります。
*[http://blog.livedoor.jp/forestk/misc/microformats/hCard/creator-ja/ hCard creator] hCard を利用し、作成したコードをページにはりつける。
*[[hcard-authoring|hCard authoring tips]] を読んで、hCard のマークアップを行う。

== hCard 仕様書 ==

<div class="vcard">
; <span class="role">編集者</span>
: <span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, and before at [http://technorati.com Technorati, Inc.], and at [http://microsoft.com/ Microsoft Corporation])
</div>
; 作者: [http://tantek.com/ Tantek Çelik] (affiliations above)
: <span class="vcard"><span class="fn">[[User:Brian|Brian Suda]]</span> (<span class="url">http://suda.co.uk/</span>)</span>

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめ、さまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは自分の名前を出し、友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーはその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーは hCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎となります。

hCard は、vCard のオブジェクト/プロパティ名を小文字にして、class 属性の値に使用します。vCard オブジェクトの入れ子関係は、そのまま HTML での入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次のリストにあるプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* <span id="property-list-n">'''n'''<sup style="font-size:smaller">[[#note1|1]]</sup>
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), <span id="property-list-n">tel<sup style="font-size:smaller">[[#note2|2]]</sup> (type, value)</span>
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<span id="note1">[[#property-list-n|1. ^]]</span>: 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<span id="note2">[[#property-list-tel|2. ^]]</span>: tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。文字の入った電話番号 (例: +1-555-FORMATS) は、数字で表記しなければなりません ({{must}})。<code>abbr</code> を利用して、ソフトウェアには数字から成る電話番号の方を伝えることもできます (<code><nowiki><abbr title="+15553676287">+1-555-FORMATS</abbr></nowiki></code>)。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視するべきです ({{should}})。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

==== type with unspecified value ====
When the type of a property is specified, and there is no explicit value specified, then everything in the property except for the type is considered the value of the property. E.g.

<pre><nowiki>
<span class="tel"><span class="type">Home</span> +1.415.555.1212</span>
</nowiki></pre>

is equivalent to:

<pre><nowiki>
<span class="tel"><span class="type">Home</span><span class="value"> +1.415.555.1212</span></span>
</nowiki></pre>

And thus the type is "home" and the value is "+1.415.555.1212".

==== adr tel email types ====
次のリストは ''参考情報'' です。

規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください (ここでは利便性の為にコピーしています)。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

<div style="border: thin dashed #600; width: 95%; padding: .5em 1em; background-color:#fee;">
注: 日本語などの言語では、これらサブプロパティの多くを利用することができません。サブタイプは <nowiki><code>< span class="type">タイプ名</span></code></nowiki> と書く必要があり、その内容を訳すことは認められていないからです。
</div>

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは [http://www.commerce.net/ Commercenet] のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''CommerceNet'''</div>
<div class="url">'''<nowiki>http://www.commerce.net/</nowiki>'''</div>
<div class="adr">'''<span class="type">Work</span>:'''
<div class="street-address">'''169 University Avenue'''</div>
<span class="locality">'''Palo Alto'''</span>, <span class="region">'''CA'''</span>  <span class="postal-code">'''94301'''</span>
<div class="country-name">'''USA'''</div>
</div>
<div class="tel">'''<span class="type">Work</span> +1-650-289-4040'''</div>
<div class="tel">'''<span class="type">Fax</span> +1-650-289-4041'''</div>
<div>'''Email <span class="email"><nowiki>info@commerce.net</nowiki></span>'''</div>
</div>

The mark-up, emboldening omitted for clarity, with the following semantic improvements:
* <code>abbr</code> to expand abbreviations
* hyperlinking the org name with the url

<pre><nowiki>
<div class="vcard">
<a class="fn org url" href="http://www.commerce.net/">CommerceNet</a>
<div class="adr">
<span class="type">Work</span>:
<div class="street-address">169 University Avenue</div>
<span class="locality">Palo Alto</span>,
<abbr class="region" title="California">CA</abbr>  
<span class="postal-code">94301</span>
<div class="country-name">USA</div>
</div>
<div class="tel">
<span class="type">Work</span> +1-650-289-4040
</div>
<div class="tel">
<span class="type">Fax</span> +1-650-289-4041
</div>
<div>Email:
<span class="email">info@commerce.net</span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== vCard における由来 ==
このセクションは ''参考情報'' です。

<div id="Semantic_XHTML_Design_Principles">[[hcard-design-methodology]] をご覧ください。</div>

=== 意味的に同等なもの ===
いくつかのプロパティにおいて、その意味を上手く表現できる HTML 要素が存在します。次に挙げるプロパティは、その例に書かれている (X)HTML で表現すべきです ({{should}})。

* vCard の <code>URL</code> は hCard にて <code><a class="url" href="...">...</a></code> と表します。このプロパティは、<code>class="vcard"</code> をつけた要素の中に書かれます。
* 同様に vCard の <code>EMAIL</code> は <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code> となります。
* vCard の <code>PHOTO</code> は <code><img class="photo" src="..." alt="Photo of ..." /></code>、または <code><object class="photo" data="..." type="...">Photo of ...</object></code> となります。
* vCard の <code>UID</code> hCard において、特定の URL (または EMAIL) といった、別の意味に置き換えられます。

=== 出現回数が一回のプロパティ ===
[[hcard-ja#.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3.E3.81.AE.E5.87.BA.E7.8F.BE.E5.9B.9E.E6.95.B0|プロパティの出現回数]]は、vCard RFC2426 で定義されるプロパティを一つずつ調べ、そのセマンティクスから一つのみでなければならない ({{must}}) を導き出したものです。[[hcard-singular-properties]] に解説があるので、そちらをご覧ください。

==== 単数化されたプロパティ ====
いくつかの複数系のプロパティ名が単数名化されています。このため、もし元となる複数形のプロパティが、複数のコンポーネントからなるひとつの値を取るものであっても、それらのコンポーネントは、単数名化されたプロパティを複数持つものとなります。

== その他の読み物 ==
* Garrett Dimon による [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] は hCard の良い解説です。
* Drew McLellan による [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard]
* Chris Silver Smith による [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats]
* [http://thedredge.org/ Andrew D. Hume] は [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] という、hCard に関する記事を書いています。
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] による[http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO] という素晴らしい記事があります。彼の hCard を例に取って解説しています。
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] 24 Ways の記事です。John Allsopp が CSS を用い、hCard をスタイリングしています。
* [http://www.technorati.com/cosmos/referer.html このページについて書かれた blog] と [http://technorati.com/tags/hcard hCard タグ] もご覧ください。
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - インスタントメッセージングの拡張]

== 関連ページ ==
{{hcard-related-pages}}

hcard-ja

2008-06-08T11:50:24Z

Vantguarde: /* adr tel email types */

<h1>hCard</h1>
{{TOC-right}}
hCard は、vCard ([[rfc-2426|RFC2426]]) のプロパティと値を利用して、[[semantic-xhtml|HTML]] で人や会社、組織や場所を表現する [[microformats-ja|microformat]] です。hCard は HTML や XHTML はもちろんのこと、Atom、RSS、その他の XML に埋め込むことができます。

hCard を利用するには、いくつかの方法があります。
*[http://blog.livedoor.jp/forestk/misc/microformats/hCard/creator-ja/ hCard creator] hCard を利用し、作成したコードをページにはりつける。
*[[hcard-authoring|hCard authoring tips]] を読んで、hCard のマークアップを行う。

== hCard 仕様書 ==

<div class="vcard">
; <span class="role">編集者</span>
: <span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, and before at [http://technorati.com Technorati, Inc.], and at [http://microsoft.com/ Microsoft Corporation])
</div>
; 作者: [http://tantek.com/ Tantek Çelik] (affiliations above)
: <span class="vcard"><span class="fn">[[User:Brian|Brian Suda]]</span> (<span class="url">http://suda.co.uk/</span>)</span>

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめ、さまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは自分の名前を出し、友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーはその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーは hCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎となります。

hCard は、vCard のオブジェクト/プロパティ名を小文字にして、class 属性の値に使用します。vCard オブジェクトの入れ子関係は、そのまま HTML での入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次のリストにあるプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* <span id="property-list-n">'''n'''<sup style="font-size:smaller">[[#note1|1]]</sup>
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), <span id="property-list-n">tel<sup style="font-size:smaller">[[#note2|2]]</sup> (type, value)</span>
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<span id="note1">[[#property-list-n|1. ^]]</span>: 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<span id="note2">[[#property-list-tel|2. ^]]</span>: tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。文字の入った電話番号 (例: +1-555-FORMATS) は、数字で表記しなければなりません ({{must}})。<code>abbr</code> を利用して、ソフトウェアには数字から成る電話番号の方を伝えることもできます (<code><nowiki><abbr title="+15553676287">+1-555-FORMATS</abbr></nowiki></code>)。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視するべきです ({{should}})。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

==== type with unspecified value ====
When the type of a property is specified, and there is no explicit value specified, then everything in the property except for the type is considered the value of the property. E.g.

<pre><nowiki>
<span class="tel"><span class="type">Home</span> +1.415.555.1212</span>
</nowiki></pre>

is equivalent to:

<pre><nowiki>
<span class="tel"><span class="type">Home</span><span class="value"> +1.415.555.1212</span></span>
</nowiki></pre>

And thus the type is "home" and the value is "+1.415.555.1212".

==== adr tel email types ====
次のリストは ''参考情報'' です。

規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください (ここでは利便性の為にコピーしています)。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは [http://www.commerce.net/ Commercenet] のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''CommerceNet'''</div>
<div class="url">'''<nowiki>http://www.commerce.net/</nowiki>'''</div>
<div class="adr">'''<span class="type">Work</span>:'''
<div class="street-address">'''169 University Avenue'''</div>
<span class="locality">'''Palo Alto'''</span>, <span class="region">'''CA'''</span>  <span class="postal-code">'''94301'''</span>
<div class="country-name">'''USA'''</div>
</div>
<div class="tel">'''<span class="type">Work</span> +1-650-289-4040'''</div>
<div class="tel">'''<span class="type">Fax</span> +1-650-289-4041'''</div>
<div>'''Email <span class="email"><nowiki>info@commerce.net</nowiki></span>'''</div>
</div>

The mark-up, emboldening omitted for clarity, with the following semantic improvements:
* <code>abbr</code> to expand abbreviations
* hyperlinking the org name with the url

<pre><nowiki>
<div class="vcard">
<a class="fn org url" href="http://www.commerce.net/">CommerceNet</a>
<div class="adr">
<span class="type">Work</span>:
<div class="street-address">169 University Avenue</div>
<span class="locality">Palo Alto</span>,
<abbr class="region" title="California">CA</abbr>  
<span class="postal-code">94301</span>
<div class="country-name">USA</div>
</div>
<div class="tel">
<span class="type">Work</span> +1-650-289-4040
</div>
<div class="tel">
<span class="type">Fax</span> +1-650-289-4041
</div>
<div>Email:
<span class="email">info@commerce.net</span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== vCard における由来 ==
このセクションは ''参考情報'' です。

<div id="Semantic_XHTML_Design_Principles">[[hcard-design-methodology]] をご覧ください。</div>

=== 意味的に同等なもの ===
いくつかのプロパティにおいて、その意味を上手く表現できる HTML 要素が存在します。次に挙げるプロパティは、その例に書かれている (X)HTML で表現すべきです ({{should}})。

* vCard の <code>URL</code> は hCard にて <code><a class="url" href="...">...</a></code> と表します。このプロパティは、<code>class="vcard"</code> をつけた要素の中に書かれます。
* 同様に vCard の <code>EMAIL</code> は <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code> となります。
* vCard の <code>PHOTO</code> は <code><img class="photo" src="..." alt="Photo of ..." /></code>、または <code><object class="photo" data="..." type="...">Photo of ...</object></code> となります。
* vCard の <code>UID</code> hCard において、特定の URL (または EMAIL) といった、別の意味に置き換えられます。

=== 出現回数が一回のプロパティ ===
[[hcard-ja#.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3.E3.81.AE.E5.87.BA.E7.8F.BE.E5.9B.9E.E6.95.B0|プロパティの出現回数]]は、vCard RFC2426 で定義されるプロパティを一つずつ調べ、そのセマンティクスから一つのみでなければならない ({{must}}) を導き出したものです。[[hcard-singular-properties]] に解説があるので、そちらをご覧ください。

==== 単数化されたプロパティ ====
いくつかの複数系のプロパティ名が単数名化されています。このため、もし元となる複数形のプロパティが、複数のコンポーネントからなるひとつの値を取るものであっても、それらのコンポーネントは、単数名化されたプロパティを複数持つものとなります。

== その他の読み物 ==
* Garrett Dimon による [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] は hCard の良い解説です。
* Drew McLellan による [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard]
* Chris Silver Smith による [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats]
* [http://thedredge.org/ Andrew D. Hume] は [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] という、hCard に関する記事を書いています。
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] による[http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO] という素晴らしい記事があります。彼の hCard を例に取って解説しています。
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] 24 Ways の記事です。John Allsopp が CSS を用い、hCard をスタイリングしています。
* [http://www.technorati.com/cosmos/referer.html このページについて書かれた blog] と [http://technorati.com/tags/hcard hCard タグ] もご覧ください。
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - インスタントメッセージングの拡張]

== 関連ページ ==
{{hcard-related-pages}}

hcard-ja

2008-06-08T11:44:45Z

Vantguarde:

<h1>hCard</h1>
{{TOC-right}}
hCard は、vCard ([[rfc-2426|RFC2426]]) のプロパティと値を利用して、[[semantic-xhtml|HTML]] で人や会社、組織や場所を表現する [[microformats-ja|microformat]] です。hCard は HTML や XHTML はもちろんのこと、Atom、RSS、その他の XML に埋め込むことができます。

hCard を利用するには、いくつかの方法があります。
*[http://blog.livedoor.jp/forestk/misc/microformats/hCard/creator-ja/ hCard creator] hCard を利用し、作成したコードをページにはりつける。
*[[hcard-authoring|hCard authoring tips]] を読んで、hCard のマークアップを行う。

== hCard 仕様書 ==

<div class="vcard">
; <span class="role">編集者</span>
: <span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, and before at [http://technorati.com Technorati, Inc.], and at [http://microsoft.com/ Microsoft Corporation])
</div>
; 作者: [http://tantek.com/ Tantek Çelik] (affiliations above)
: <span class="vcard"><span class="fn">[[User:Brian|Brian Suda]]</span> (<span class="url">http://suda.co.uk/</span>)</span>

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめ、さまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは自分の名前を出し、友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーはその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーは hCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎となります。

hCard は、vCard のオブジェクト/プロパティ名を小文字にして、class 属性の値に使用します。vCard オブジェクトの入れ子関係は、そのまま HTML での入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次のリストにあるプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* <span id="property-list-n">'''n'''<sup style="font-size:smaller">[[#note1|1]]</sup>
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), <span id="property-list-n">tel<sup style="font-size:smaller">[[#note2|2]]</sup> (type, value)</span>
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<span id="note1">[[#property-list-n|1. ^]]</span>: 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<span id="note2">[[#property-list-tel|2. ^]]</span>: tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。文字の入った電話番号 (例: +1-555-FORMATS) は、数字で表記しなければなりません ({{must}})。<code>abbr</code> を利用して、ソフトウェアには数字から成る電話番号の方を伝えることもできます (<code><nowiki><abbr title="+15553676287">+1-555-FORMATS</abbr></nowiki></code>)。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視するべきです ({{should}})。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

==== type with unspecified value ====
When the type of a property is specified, and there is no explicit value specified, then everything in the property except for the type is considered the value of the property. E.g.

<pre><nowiki>
<span class="tel"><span class="type">Home</span> +1.415.555.1212</span>
</nowiki></pre>

is equivalent to:

<pre><nowiki>
<span class="tel"><span class="type">Home</span><span class="value"> +1.415.555.1212</span></span>
</nowiki></pre>

And thus the type is "home" and the value is "+1.415.555.1212".

==== adr tel email types ====
次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは [http://www.commerce.net/ Commercenet] のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''CommerceNet'''</div>
<div class="url">'''<nowiki>http://www.commerce.net/</nowiki>'''</div>
<div class="adr">'''<span class="type">Work</span>:'''
<div class="street-address">'''169 University Avenue'''</div>
<span class="locality">'''Palo Alto'''</span>, <span class="region">'''CA'''</span>  <span class="postal-code">'''94301'''</span>
<div class="country-name">'''USA'''</div>
</div>
<div class="tel">'''<span class="type">Work</span> +1-650-289-4040'''</div>
<div class="tel">'''<span class="type">Fax</span> +1-650-289-4041'''</div>
<div>'''Email <span class="email"><nowiki>info@commerce.net</nowiki></span>'''</div>
</div>

The mark-up, emboldening omitted for clarity, with the following semantic improvements:
* <code>abbr</code> to expand abbreviations
* hyperlinking the org name with the url

<pre><nowiki>
<div class="vcard">
<a class="fn org url" href="http://www.commerce.net/">CommerceNet</a>
<div class="adr">
<span class="type">Work</span>:
<div class="street-address">169 University Avenue</div>
<span class="locality">Palo Alto</span>,
<abbr class="region" title="California">CA</abbr>  
<span class="postal-code">94301</span>
<div class="country-name">USA</div>
</div>
<div class="tel">
<span class="type">Work</span> +1-650-289-4040
</div>
<div class="tel">
<span class="type">Fax</span> +1-650-289-4041
</div>
<div>Email:
<span class="email">info@commerce.net</span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== vCard における由来 ==
このセクションは ''参考情報'' です。

<div id="Semantic_XHTML_Design_Principles">[[hcard-design-methodology]] をご覧ください。</div>

=== 意味的に同等なもの ===
いくつかのプロパティにおいて、その意味を上手く表現できる HTML 要素が存在します。次に挙げるプロパティは、その例に書かれている (X)HTML で表現すべきです ({{should}})。

* vCard の <code>URL</code> は hCard にて <code><a class="url" href="...">...</a></code> と表します。このプロパティは、<code>class="vcard"</code> をつけた要素の中に書かれます。
* 同様に vCard の <code>EMAIL</code> は <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code> となります。
* vCard の <code>PHOTO</code> は <code><img class="photo" src="..." alt="Photo of ..." /></code>、または <code><object class="photo" data="..." type="...">Photo of ...</object></code> となります。
* vCard の <code>UID</code> hCard において、特定の URL (または EMAIL) といった、別の意味に置き換えられます。

=== 出現回数が一回のプロパティ ===
[[hcard-ja#.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3.E3.81.AE.E5.87.BA.E7.8F.BE.E5.9B.9E.E6.95.B0|プロパティの出現回数]]は、vCard RFC2426 で定義されるプロパティを一つずつ調べ、そのセマンティクスから一つのみでなければならない ({{must}}) を導き出したものです。[[hcard-singular-properties]] に解説があるので、そちらをご覧ください。

==== 単数化されたプロパティ ====
いくつかの複数系のプロパティ名が単数名化されています。このため、もし元となる複数形のプロパティが、複数のコンポーネントからなるひとつの値を取るものであっても、それらのコンポーネントは、単数名化されたプロパティを複数持つものとなります。

== その他の読み物 ==
* Garrett Dimon による [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] は hCard の良い解説です。
* Drew McLellan による [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard]
* Chris Silver Smith による [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats]
* [http://thedredge.org/ Andrew D. Hume] は [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] という、hCard に関する記事を書いています。
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] による[http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO] という素晴らしい記事があります。彼の hCard を例に取って解説しています。
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] 24 Ways の記事です。John Allsopp が CSS を用い、hCard をスタイリングしています。
* [http://www.technorati.com/cosmos/referer.html このページについて書かれた blog] と [http://technorati.com/tags/hcard hCard タグ] もご覧ください。
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - インスタントメッセージングの拡張]

== 関連ページ ==
{{hcard-related-pages}}

hcard-ja

2008-06-08T11:32:07Z

Vantguarde: Sync: 09:02, 2 May 2008

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな HTML または XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、HTML や XHTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

<div class="vcard">
; <span class="role">編集者</span>
: <span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, and before at [http://technorati.com Technorati, Inc.], and at [http://microsoft.com/ Microsoft Corporation])
</div>
; 作者: [http://tantek.com/ Tantek Çelik] (affiliations above)
: <span class="vcard"><span class="fn">[[User:Brian|Brian Suda]]</span> (<span class="url">http://suda.co.uk/</span>)</span>

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* <span id="property-list-n">'''n'''<sup style="font-size:smaller">[[#note1|1]]</sup>
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), <span id="property-list-n">tel<sup style="font-size:smaller">[[#note2|2]]</sup> (type, value)</span>
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<span id="note1">[[#property-list-n|1. ^]]</span>: 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<span id="note2">[[#property-list-tel|2. ^]]</span>: tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。Letter values (e.g. +1-555-FORMATS) {{must}} be converted to numbers. Use an <code>abbr</code> to display letters and provide a numerical value simultaneously, e.g. <code><nowiki><abbr title="+15553676287">+1-555-FORMATS</abbr></nowiki></code>.

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

==== type with unspecified value ====
When the type of a property is specified, and there is no explicit value specified, then everything in the property except for the type is considered the value of the property. E.g.

<pre><nowiki>
<span class="tel"><span class="type">Home</span> +1.415.555.1212</span>
</nowiki></pre>

is equivalent to:

<pre><nowiki>
<span class="tel"><span class="type">Home</span><span class="value"> +1.415.555.1212</span></span>
</nowiki></pre>

And thus the type is "home" and the value is "+1.415.555.1212".

==== adr tel email types ====
次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは [http://www.commerce.net/ Commercenet] のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''CommerceNet'''</div>
<div class="url">'''<nowiki>http://www.commerce.net/</nowiki>'''</div>
<div class="adr">'''<span class="type">Work</span>:'''
<div class="street-address">'''169 University Avenue'''</div>
<span class="locality">'''Palo Alto'''</span>, <span class="region">'''CA'''</span>  <span class="postal-code">'''94301'''</span>
<div class="country-name">'''USA'''</div>
</div>
<div class="tel">'''<span class="type">Work</span> +1-650-289-4040'''</div>
<div class="tel">'''<span class="type">Fax</span> +1-650-289-4041'''</div>
<div>'''Email <span class="email"><nowiki>info@commerce.net</nowiki></span>'''</div>
</div>

The mark-up, emboldening omitted for clarity, with the following semantic improvements:
* <code>abbr</code> to expand abbreviations
* hyperlinking the org name with the url

<pre><nowiki>
<div class="vcard">
<a class="fn org url" href="http://www.commerce.net/">CommerceNet</a>
<div class="adr">
<span class="type">Work</span>:
<div class="street-address">169 University Avenue</div>
<span class="locality">Palo Alto</span>,
<abbr class="region" title="California">CA</abbr>  
<span class="postal-code">94301</span>
<div class="country-name">USA</div>
</div>
<div class="tel">
<span class="type">Work</span> +1-650-289-4040
</div>
<div class="tel">
<span class="type">Fax</span> +1-650-289-4041
</div>
<div>Email:
<span class="email">info@commerce.net</span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== vCard における由来 ==
このセクションは ''参考情報'' です。

<div id="Semantic_XHTML_Design_Principles">[[hcard-design-methodology]] をご覧ください。</div>

=== 意味的に同等なもの ===
いくつかのプロパティにおいて、その意味を上手く表現できる HTML 要素が存在します。次に挙げるプロパティは、その例に書かれている (X)HTML で表現すべきです ({{should}})。

* vCard の <code>URL</code> は hCard にて <code><a class="url" href="...">...</a></code> と表します。このプロパティは、<code>class="vcard"</code> をつけた要素の中に書かれます。
* 同様に vCard の <code>EMAIL</code> は <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code> となります。
* vCard の <code>PHOTO</code> は <code><img class="photo" src="..." alt="Photo of ..." /></code>、または <code><object class="photo" data="..." type="...">Photo of ...</object></code> となります。
* vCard の <code>UID</code> hCard において、特定の URL (または EMAIL) といった、別の意味に置き換えられます。

=== 出現回数が一回のプロパティ ===
[[hcard-ja#.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3.E3.81.AE.E5.87.BA.E7.8F.BE.E5.9B.9E.E6.95.B0|プロパティの出現回数]]は、vCard RFC2426 で定義されるプロパティを一つずつ調べ、そのセマンティクスから一つのみでなければならない ({{must}}) を導き出したものです。[[hcard-singular-properties]] に解説があるので、そちらをご覧ください。

==== 単数化されたプロパティ ====
いくつかの複数系のプロパティ名が単数名化されています。このため、もし元となる複数形のプロパティが、複数のコンポーネントからなるひとつの値を取るものであっても、それらのコンポーネントは、単数名化されたプロパティを複数持つものとなります。

== その他の読み物 ==
* Garrett Dimon による [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] は hCard の良い解説です。
* Drew McLellan による [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard]
* Chris Silver Smith による [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats]
* [http://thedredge.org/ Andrew D. Hume] は [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] という、hCard に関する記事を書いています。
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] による[http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO] という素晴らしい記事があります。彼の hCard を例に取って解説しています。
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] 24 Ways の記事です。John Allsopp が CSS を用い、hCard をスタイリングしています。
* [http://www.technorati.com/cosmos/referer.html このページについて書かれた blog] と [http://technorati.com/tags/hcard hCard タグ] もご覧ください。
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - インスタントメッセージングの拡張]

== 関連ページ ==
{{hcard-related-pages}}

books

2007-11-01T16:11:57Z

Vantguarde:

<h1> Books </h1>

This page lists books which provide description and documentation of microformats. Most recent first, grouped by year.

== Errata ==
For errata in any of the following, if any, see '''<nowiki>http://en.wikibooks.org/wiki/Errata/[ISBN]</nowiki>''', where [ISBN] is the ISBN with no hyphens or spaces. (Perhaps this could be added to [[Special:Booksources]]?)

== 2008 ==
* Japanese translation of Allsopp's ''Microformats: Empowering Your Markup for Web 2.0''; translated by Noriyo Asano, under the editorship of Kazuhito Kidachi
** Mainichi Communications Inc., early 2008?
** [http://iaspectrum.net/about.html Noriyo] has translated "Ambient Findability" and "Designing Interfaces"; [http://kidachi.kazuhi.to/ Kazuhito] is one of the well-known advocates of Web Standards and microformats in Japan.
** Read their posts about the translation: [http://blog.iaspectrum.net/2007/09/microformats_d0f7.html#more Noriyo's] and [http://kidachi.kazuhi.to/blog/archives/002367.html Kazuhito's] (both in Japanese).

== 2007 ==

* ''[http://www.friendsofed.com/book.html?isbn=1590598148 Microformats: Empowering Your Markup for Web 2.0]'' by John Allsopp
** Friends of Ed, ISBN 9781590598146, March 2007
** Read [http://www.friendsofed.com/extras/1590598148/Appendices.pdf Allsopp's Appendix (PDF)].

== 2006 ==

* ''[http://www.oreilly.com/catalog/neogeography/ Introduction to Neogeography]'' by Andrew Turner
**O'Reilly, ISBN 9780596529956, December 2006
** This is a PDF book, part of the O'Reilly Short Cuts series. Covers the ADR and GEO microformats.

* ''[http://www.oreilly.com/catalog/microformats/ Using Microformats]'' by Brian Suda
**O'Reilly, ISBN 9780596528218, 2006
** This is a PDF book, part of the O'Reilly Short Cuts series. It is a solid introduction to all the established microformats, the history, philosophy and a look at where microformats are headed.

* ''[http://www.amazon.com/gp/product/0596009879 Web Design In A Nutshell, Third Edition]'' by Jennifer Niederst Robbins. '''IMPORTANT: This applies to the THIRD EDITION only!'''
** O'Reilly Media, ISBN 9780596009878, 2006
** Provides an excellent modern standards based foundation for web design that is ideal for understanding microformats, and a whole introductory chapter on microformats as well.
** See also [http://www.oreilly.com/catalog/wdnut3/ Web Design in a Nutshell, Third Edition] (on oreilly.com).

*''[http://www.friendsofed.com/book.html?isbn=1590597656 HTML Mastery]'' by Paul Haine
**Friends of Ed, ISBN 9781590597651, 2006
**Chapter 5, <abbr title="pages">pp.</abbr> 117-154: ''Purpose Built Semantics: Microformats and Other Stories.''

== 2005 ==

* ''[http://www.amazon.com/gp/product/0764597582 Hacking RSS and Atom]'' by Leslie M. Orchard
** Wiley, ISBN 9780764597589, 2005
** The last chapter has a nice section on both publishing and consuming [[hcalendar|hCalendar]] events in either a feed or as part of a page. Les has implemented various microformats (hCalendar entry form as a greasemonkey script, [[xoxo|XOXO]] dynamic editing).
** You can find source code for the [[hcalendar|hCalendar]] scripts from my book [http://decafbad.com/trac/wiki/HackingRssAndAtom at my site]. Look for the files starting with <code>ch18</code>. Buy the book if you like it! [[User:LesOrchard|LesOrchard]] 20:11, 25 Mar 2006 (PST)

Main Page-ja

2007-11-01T13:35:28Z

Vantguarde: /* 仕様 */ done!

<div style="float:right;margin-left:1em">__TOC__</div>

'''Microformats Wikiにようこそ！'''

初めての方は、[[introduction-ja|microformatsの手引き]]からどうぞ。編集を始める前に、[[how-to-play-ja]]を読んでください。

== はじめに ==
* [[posh-ja|<abbr title="Plain Old Semantic HTML">POSH</abbr>]] とは何なのかを理解しましょう。
* 「[http://microformats.org/about/ microformatsについて]」のページ、[http://microformats.org/ 最新ニュース]、[[press|メディア紹介例]]や [[presentations-ja|プレゼンテーション]]、microformatsに関する[[books|書籍]]、[[podcasts|ポッドキャスト]]、[[screencasts|スクリーンキャスト]]などについて読んでみてください。
* 質問がある場合は、[[faq|よく聞かれる質問]]や[[glossary|用語集]]をご覧ください。
* 誰かから直接話を聞きたければ、[[events|microformatsのイベント]]に参加してみてください。

== 定義 ==
Microformatsとは、Webサイトで人やイベント、タグを記述する際に用いるマークアップ方法です。

Microformatsは、あなたのWebサイトからフィードやAPIを早く簡単に提供するための手段です。また、Microformatsによって、さらに詳しい情報をWebで発信することができるようになります。[[what-are-microformats-ja|マイクロフォーマットとは何か]]、また[[what-can-you-do-with-microformats|マイクロフォーマットを使うと何ができるか]]にある、より詳しい説明もご覧ください。

== 協力するには ==
Microformatsをさらに高めるためには、みなさんの協力が必要です。

* あなたのWebサイトやサービス、製品で[[get-started|microformatsを利用]]する。
* マイクロフォーマットをもっと使ってもらえるよう、[[advocacy|周りにすすめる]]。
* [[testimonial|Microformatsをおすすめするエントリ]]を書く。
* [[to-do|TO DOリスト]]にあるタスクをこなす。
* [[irc-ja|IRCチャンネル]]や[[mail|メーリングリスト]]で学んだり、質問に答える (メールを送る前に、[[mailing-lists#General_guidelines|一般的なガイドライン]]を読んでください)。
* さまざまな言葉で読めるように、microformats wikiの翻訳を手伝う ([[Main_Page-ja#.E4.BB.96.E8.A8.80.E8.AA.9E.E3.81.A7.E3.81.AEmicroformats_wiki|他言語でのmicroformats wiki]])。
* 新しいmicroformatsを提案する前に、あなたのWebサイトが[[POSH]]であり、[[get-started|すでにあるmicroformatsを利用]]している事を確認する。そのあと、[[process|新しいフォーマットを提案する際のプロセス]]について良く読む。

== 仕様 ==
以下はオープンスタンダードとなった[[microformats-ja|microformats]]の仕様です。

* [[hcalendar-ja|hCalendar]] (翻訳中!) - [http://microformats.org/code/hcalendar/creator hCalendar creator]
* [[hcard-ja|hCard]] - [http://microformats.org/code/hcard/creator hCard creator]
* [[rel-license-ja|rel-license]]
* [[rel-nofollow-ja|rel-nofollow]]
* [[rel-tag-ja|rel-tag]]
* [[vote-links-ja|Vote Links]]
* [[XFN-ja|XFN]] - [http://gmpg.org/xfn/creator XFN creator]
* [[XMDP-ja|XMDP]]
* [[xoxo-ja|XOXO]] (翻訳中!)

== ドラフト ==
* [[adr|adr]] - 住所のマークアップ
* [[geo|geo]] - [http://en.wikipedia.org/wiki/WGS84 世界測地系]による、緯度と経度のマークアップ
* [[hatom|hAtom]] - 更新情報を配信する (例: Weblogのエントリ)
* [[hresume-ja|hResume]] (翻訳中!) - 履歴書の公開
* [[hreview-ja|hReview]] - [http://microformats.org/code/hreview/creator hReview creator]
* [[rel-directory]]- to indicate that the destination of a hyperlink is a directory listing containing an entry for the current page
* [[rel-enclosure]] - for indicating attachments (e.g. files) to download and cache
* [[rel-home]] - indicate a hyperlink to the homepage of the site
* [[relpayment-research|rel-payment]] - indicate a payment mechanism
* [[robots-exclusion|robots exclusion]]
* [[xfolk|xFolk]]

== デザインパターン ==
{{design_patterns-ja}} 
* [[elemental-microformat-ja|単純microformats]]
* [[compound-microformat-ja|複合microformats]]

== Exploratory Discussions ==
See: [[exploratory-discussions]] for details of research and analysis of real-world [[examples]], existing formats, and brainstorming of possible new microformats, per the microformats [[process]]. Such work is categorised as being:

*[[exploratory-discussions#Active|Actively being progressed]]
*[[exploratory-discussions#Current|Current, but less active]]
*[[exploratory-discussions#Moribund|Moribund]]
*[[exploratory-discussions#Abandoned|Formally abandoned]] or
*[[exploratory-discussions#Archive|Archived]]

== 例 ==
* [[examples-in-the-wild-ja|実際の利用例]]
* [[implementations|ツールの実装]]
* [[zen-garden|Zen Garden]]

== resources ==
See [[resources]].

== user centric development ==
*[[user-interface]]
*[[data-portability]]
*[[social-network-portability]]

== shared work areas ==
* [[to-do|TODOリスト]]
* [[templates]]
* [http://microformats.org/wiki/delete pages for deletion] 

== ツール、テストケース、リサーチ ==
The first place to look for examples, code, and test cases is in the pages for each individual microformat. There are only a few cross-cutting [[tools|tools and services]] that need to process more than one microformat. That section is intended for editors, parsers, validators, test cases, and other information relevant across multiple microformats.

== 他言語でのmicroformats wiki ==
<span id="microformats_wiki_translations_in_other_languages">microformatsの記事を、さまざまな言語で読んだり、編集したりできます。</span>

* 100以上の記事のある言語
** [[Main_Page|<span lang="en">English</span> (本家の英語)]]
** [[Main_Page-fr|<span lang="fr">Français</span> (フランス語)]] <span lang="fr">{{UpdateMarker-fr}}</span>
* 10以上の記事のある言語
** [[Main_Page-pt-br|<span lang="pt-br">Português</span> (ブラジル系ポルトガル語)]]
** [[Main_Page-ja|日本語]]
* 2以上の記事のある言語
** [[Main_Page-cs|<span lang="cs">Česky</span> (チェコ語)]] {{NewMarker}}
** [[Main_Page-de|<span lang="de">Deutsch</span> (ドイツ語)]]
** [[Main_Page-es|<span lang="es">Español</span> (スペイン語)]]
** [[Main_Page-gl|<span lang="gl">Galego</span> (ガリーシア語)]] {{NewMarker}}
** [[Main_Page-pl|<span lang="pl">Polski</span> (ポーランド語)]]
** [[Main_Page-ro|<span lang="ro">Română</span> (ルーマニア語)]]
* 翻訳が始まったばかりの言語
** [[Main_Page-ar|<span lang="ar">العربية</span> (アラビア語)]]
* その他
**[http://ja.wikipedia.org/wiki/Microformat Wikipediaのmicroformatsページ]は、多くの言語版ができています。

[[other-languages]]や[[how-to-start-new-translation|how-to-start-a-new-translation]]もご覧ください。

hcard-ja

2007-11-01T13:23:29Z

Vantguarde:

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、(X)HTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは WikiMedia Foundation のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

このマークアップは次のようになっています (見やすいように加工しています)。

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== vCard における由来 ==
このセクションは ''参考情報'' です。

<div id="Semantic_XHTML_Design_Principles">[[hcard-design-methodology]] をご覧ください。</div>

=== 意味的に同等なもの ===
いくつかのプロパティにおいて、その意味を上手く表現できる HTML 要素が存在します。次に挙げるプロパティは、その例に書かれている (X)HTML で表現すべきです ({{should}})。

* vCard の <code>URL</code> は hCard にて <code><a class="url" href="...">...</a></code> と表します。このプロパティは、<code>class="vcard"</code> をつけた要素の中に書かれます。
* 同様に vCard の <code>EMAIL</code> は <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code> となります。
* vCard の <code>PHOTO</code> は <code><img class="photo" src="..." alt="Photo of ..." /></code>、または <code><object class="photo" data="..." type="...">Photo of ...</object></code> となります。
* vCard の <code>UID</code> hCard において、特定の URL (または EMAIL) といった、別の意味に置き換えられます。

=== 出現回数が一回のプロパティ ===
[[hcard-ja#.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3.E3.81.AE.E5.87.BA.E7.8F.BE.E5.9B.9E.E6.95.B0|プロパティの出現回数]]は、vCard RFC2426 で定義されるプロパティを一つずつ調べ、そのセマンティクスから一つのみでなければならない ({{must}}) を導き出したものです。[[hcard-singular-properties]] に解説があるので、そちらをご覧ください。

==== 単数化されたプロパティ ====
いくつかの複数系のプロパティ名が単数名化されています。このため、もし元となる複数形のプロパティが、複数のコンポーネントからなるひとつの値を取るものであっても、それらのコンポーネントは、単数名化されたプロパティを複数持つものとなります。

== その他の読み物 ==
* Garrett Dimon による [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] は hCard の良い解説です。
* Drew McLellan による [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard]
* Chris Silver Smith による [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats]
* [http://thedredge.org/ Andrew D. Hume] は [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] という、hCard に関する記事を書いています。
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] による[http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO] という素晴らしい記事があります。彼の hCard を例に取って解説しています。
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] 24 Ways の記事です。John Allsopp が CSS を用い、hCard をスタイリングしています。
* [http://www.technorati.com/cosmos/referer.html このページについて書かれた blog] と [http://technorati.com/tags/hcard hCard タグ] もご覧ください。
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - インスタントメッセージングの拡張]

== 関連ページ ==
{{hcard-related-pages}}

hcard-ja

2007-11-01T13:22:54Z

Vantguarde: /* Further Reading */ hmm did i really need to translate this section...?

hcard-ja

2007-11-01T13:13:05Z

Vantguarde: /* 単数化されたプロパティ */ damn this plural properties singularized sentence should be run-offed...

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、(X)HTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは WikiMedia Foundation のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

このマークアップは次のようになっています (見やすいように加工しています)。

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== vCard における由来 ==
このセクションは ''参考情報'' です。

<div id="Semantic_XHTML_Design_Principles">[[hcard-design-methodology]] をご覧ください。</div>

=== 意味的に同等なもの ===
いくつかのプロパティにおいて、その意味を上手く表現できる HTML 要素が存在します。次に挙げるプロパティは、その例に書かれている (X)HTML で表現すべきです ({{should}})。

* vCard の <code>URL</code> は hCard にて <code><a class="url" href="...">...</a></code> と表します。このプロパティは、<code>class="vcard"</code> をつけた要素の中に書かれます。
* 同様に vCard の <code>EMAIL</code> は <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code> となります。
* vCard の <code>PHOTO</code> は <code><img class="photo" src="..." alt="Photo of ..." /></code>、または <code><object class="photo" data="..." type="...">Photo of ...</object></code> となります。
* vCard の <code>UID</code> hCard において、特定の URL (または EMAIL) といった、別の意味に置き換えられます。

=== 出現回数が一回のプロパティ ===
[[hcard-ja#.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3.E3.81.AE.E5.87.BA.E7.8F.BE.E5.9B.9E.E6.95.B0|プロパティの出現回数]]は、vCard RFC2426 で定義されるプロパティを一つずつ調べ、そのセマンティクスから一つのみでなければならない ({{must}}) を導き出したものです。[[hcard-singular-properties]] に解説があるので、そちらをご覧ください。

==== 単数化されたプロパティ ====
いくつかの複数系のプロパティ名が単数名化されています。このため、もし元となる複数形のプロパティが、複数のコンポーネントからなるひとつの値を取るものであっても、それらのコンポーネントは、単数名化されたプロパティを複数持つものとなります。

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-11-01T13:07:40Z

Vantguarde: /* Notes on derivation from vCard */

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、(X)HTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは WikiMedia Foundation のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

このマークアップは次のようになっています (見やすいように加工しています)。

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== vCard における由来 ==
このセクションは ''参考情報'' です。

<div id="Semantic_XHTML_Design_Principles">[[hcard-design-methodology]] をご覧ください。</div>

=== 意味的に同等なもの ===
いくつかのプロパティにおいて、その意味を上手く表現できる HTML 要素が存在します。次に挙げるプロパティは、その例に書かれている (X)HTML で表現すべきです ({{should}})。

* vCard の <code>URL</code> は hCard にて <code><a class="url" href="...">...</a></code> と表します。このプロパティは、<code>class="vcard"</code> をつけた要素の中に書かれます。
* 同様に vCard の <code>EMAIL</code> は <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code> となります。
* vCard の <code>PHOTO</code> は <code><img class="photo" src="..." alt="Photo of ..." /></code>、または <code><object class="photo" data="..." type="...">Photo of ...</object></code> となります。
* vCard の <code>UID</code> hCard において、特定の URL (または EMAIL) といった、別の意味に置き換えられます。

=== 出現回数が一回のプロパティ ===
[[hcard-ja#.E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3.E3.81.AE.E5.87.BA.E7.8F.BE.E5.9B.9E.E6.95.B0|プロパティの出現回数]]は、vCard RFC2426 で定義されるプロパティを一つずつ調べ、そのセマンティクスから一つのみでなければならない ({{must}}) を導き出したものです。[[hcard-singular-properties]] に解説があるので、そちらをご覧ください。

==== 単数化されたプロパティ ====
複数系のプロパティ名が単数名化されています。このため、もし元となる複数形のプロパティが、複数のコンポーネントからなるひとつの値を取るものであっても、それらのコンポーネントは、単数名化されたプロパティを複数持つものとなります。これにより、プロパティは複数の値を持つものとなり、複数の値をとるプロパティの影響を受けるようになります。

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-11-01T12:00:10Z

Vantguarde: /* ひとつのみ/複数持てるプロパティ */

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、(X)HTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== プロパティの出現回数 ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは WikiMedia Foundation のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

このマークアップは次のようになっています (見やすいように加工しています)。

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-11-01T11:59:04Z

Vantguarde: /* 単数・複数のプロパティ */

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、(X)HTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== ひとつのみ/複数持てるプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは WikiMedia Foundation のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

このマークアップは次のようになっています (見やすいように加工しています)。

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-11-01T11:54:49Z

Vantguarde: /* 複数のプロパティ */

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、(X)HTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 単数・複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは WikiMedia Foundation のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

このマークアップは次のようになっています (見やすいように加工しています)。

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-11-01T11:40:31Z

Vantguarde: /* 原案及び謝辞 */

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、(X)HTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは WikiMedia Foundation のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

このマークアップは次のようになっています (見やすいように加工しています)。

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
vCard を "何年も前に" 教えてくれた私の良き友人 [http://vadim.com/ Vadim] に感謝しています。ただ、もしあのときから vCard を気にかけていたら、もっと多くの車輪の再発明を防げたかもしれませんが。

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-30T14:19:53Z

Vantguarde:

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、(X)HTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは WikiMedia Foundation のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

このマークアップは次のようになっています (見やすいように加工しています)。

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== 実装 ==
このセクションは'''参考情報'''です。前のセクションと同じく、hCard の実装についても別のページを用意しています。

[[hcard-implementations|hCard Implementations]] で、hCard の実装についてご覧ください。

== 著作権 ==
仕様の作成者である [[User:Tantek|Tantek Çelik]] および [[User:Brian|Brian Suda]] が、自分のページでパブリックドメインの声明を行っています。よって、この仕様はパブリックドメインです。

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU 勧告 E.123] 電話番号フォーマット (有料)
* [[rfc-2119|RFC 2119]]

=== その他の参考文献 ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== hCard を利用する仕様 ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== hCard に似通っているもの ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== 原案及び謝辞 ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-30T14:08:15Z

Vantguarde:

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、(X)HTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===
次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは WikiMedia Foundation のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

このマークアップは次のようになっています (見やすいように加工しています)。

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

== hCard ボタン ==
hCard を使ったあなたのページに、次にあるボタンを貼り付けましょう。[[buttons#hCard]] には、最近追加されたボタンもあります。

* http://www.crowley.nl/images/hcard.png (ミラー: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS でボタン風にデザインすることもできます。[http://re-run.com/about/microformat-badges microformat badges @ re-run] をご覧ください。

== 実世界での例 ==
このセクションは'''参考情報'''です。すでに世界には多くの hCard が存在しています。以前はこの仕様書で紹介していましたが、数が増えすぎてしまったため、別のページを用意しました。

[[hcard-examples-in-wild|hCard Examples in the wild]] で、実際に使われている hCard をご覧ください。

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-30T13:06:01Z

Vantguarde: /* XMDP プロファイル */

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、(X)HTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティの全てが、[[rfc-2426|RFC2426]] のセクション番号付きでリスト化されています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===

次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは WikiMedia Foundation のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

このマークアップは次のようになっています (見やすいように加工しています)。

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

==Buttons==
You can use these buttons on pages with hCards. See [[buttons#hCard]] for any recent additions.

* http://www.crowley.nl/images/hcard.png (mirror: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS-powered button, as evidenced at [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-29T14:46:47Z

Vantguarde: /* Examples */

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、(X)HTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティ全てのリストがあり、また [[rfc-2426|RFC2426]] のセクション番号も付随しています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== hCard の例 ==
このセクションは参考情報です。

=== vCard のサンプル ===

次にあるのは vCard のサンプルです。
<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

この vCard を hCard で表現すると次のようになります。なお、推測処理ができるプロパティについては省略してあります。他の例は [[hcard-example1-steps| hCard Example 1]] をご覧ください。

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

この hCard は次のように表示されるでしょう。
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: hCard のマークアップにはバージョン情報が必要ありません。なぜならバージョンは <head> 要素の 'profile' 属性に記述されたプロファイルで定義されているからです。

=== hCard の実例 ===
次にあるのは WikiMedia Foundation のコンタクト情報です。この情報は hCard を用いて記述されているので、microformats をパース処理するツールにより見つけることができます。

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

このマークアップは次のようになっています (見やすいように加工しています)。

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== その他の例 ===
[[hcard-examples|hCard examples]] には vCard 仕様書 [[rfc-2426|RFC2426]] の例をすべて hCard にしたものをはじめ、もっとたくさんの例があります。

==Buttons==
You can use these buttons on pages with hCards. See [[buttons#hCard]] for any recent additions.

* http://www.crowley.nl/images/hcard.png (mirror: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS-powered button, as evidenced at [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-29T14:31:58Z

Vantguarde: 50% done :)

<h1>hCard</h1>
{{TOC-right}}
hCard は vCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックな XHTML]] で人や会社、組織や場所を表現するシンプルなフォーマットです。hCard は [[microformats-ja|microformats]] のひとつであり、(X)HTML や Atom、RSS やその他の XML に埋め込むことができます。

hCard を利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator] を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]] を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard 仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Apple のアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCard へ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これは vCard のプロパティや値を、XTHML でそのまま表現しようとするものです。ブロガーはhCard を Web ページに埋め込み、CSS で思うようにデザインすることができます。また、hCard はアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator] を使い、出てきた HTML コードを blog や Web サイトに貼り付け、コンタクト情報を公開してみてください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCard の基礎を構成します。

hCard は、vCard のオブジェクト/プロパティ名を小文字にしたものを class 属性の値として使用します。vCard オブジェクトの入れ子関係は、そのまま XHTML 要素の入れ子関係に置き換えられます。

=== ルート class 名 ===
hCard のルート class 名は "vcard" です。"vcard" という class 名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCard のプロパティは、hCard 内の要素によって表されます。次にリストするプロパティを class 属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCard のプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつの hCard は、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他に URL を取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合は特別な class 名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップする hCard を例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この hCard は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCard には、Web ページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCard の '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは [[rfc-2426|RFC2426]] のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9 で定義されていますが、hCard ではこれらのプロパティを使ってはいけません ({{must-not}})。hCard を利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCard から vCard へ変換するコンバーターは、これらのプロパティの代わりに hCard が埋め込まれている Web ページの情報を用いて、これらのプロパティを埋めることになります。まず、NAME プロパティは文書のタイトル ((X)HTML 文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILE の値には、[[rfc-2426|RFC2426]] より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCE プロパティには、ページの URL を用いることが推奨されます ({{should}})。hCard を vCard に変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODID プロパティは、実際に vCard を出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]] のセクション 3.6.9 に倣い、VERSION プロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、その hCard は会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCard では "N" プロパティの記述が必須となっています。ところが vCard 仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者の vCard に "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCard では次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Web においてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCard は "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCard の作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCard は推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== カテゴリーとしてのタグ ===
hCard のカテゴリーは [[rel-tag]] を用い、タグとして表現することも可能です ({{may}})。"category" プロパティが rel-tag である場合、そのタグはカテゴリーとして扱われます。

=== 'type' サブプロパティの値 ===
'type' サブプロパティがとる値は、その親プロパティによって異なります。これらの 'type' サブプロパティの値は大文字小文字を区別しません (case-INSENSITIVE)。よって "Home" は "home" と同じであり、その他の値と組み合わせた場合についても同様です。たとえば、家の電話番号で、かつ優先番号であるものは次のようになります。

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

この例は次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

次のリストは ''参考情報'' です。規範的な type の値は [[rfc-2426|RFC2426]] のセクション 3.2.1 ADR、3.3.1 TEL、3.3.2 EMAIL を参照してください。ここでは利便性の為にコピーしています。type サブプロパティのデフォルト値はリストの最初に並んでおり、また大文字で記述されています。また、これらの type は複数指定することができます。

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "IANA に登録された他のアドレスタイプ"

=== XMDP プロファイル ===
hCard の [http://gmpg.org/xmdp XMDP] プロファイルは [[hcard-profile]] をご覧ください。hcard-profile には上で説明したプロパティ全てのリストがあり、また [[rfc-2426|RFC2426]] のセクション番号も付随しています。

=== パース処理 ===
[[hcard-parsing|hCard parsing]] をご覧ください。

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

===Live example===

Here are the WikiMedia Foundation's contact details, as a live hCard which will be detected, on this page, by microformat parsing tools:

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

The mark-up (wrapped, and emboldening omitted, for clarity) used is:

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard [[rfc-2426|RFC2426]] converted into hCard.

==Buttons==
You can use these buttons on pages with hCards. See [[buttons#hCard]] for any recent additions.

* http://www.crowley.nl/images/hcard.png (mirror: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS-powered button, as evidenced at [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-29T14:01:03Z

Vantguarde: /* Implied "organization-name" Optimization */

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Appleのアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCardの基礎を構成します。

hCardは、vCardのオブジェクト/プロパティ名を小文字にしたものをclass属性の値として使用します。vCardオブジェクトの入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== ルートclass名 ===
hCardのルートclass名は "vcard" です。"vcard" というclass名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCardのプロパティは、hCard内の要素によって表されます。次にリストするプロパティをclass属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCardのプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつのhCardは、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合、特別なclass名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップするhCardを例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardは次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCardには、Webページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCardの '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは[[rfc-2426|RFC2426]]のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9で定義されていますが、hCardではこれらのプロパティを使ってはいけません ({{must-not}})。hCardを利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCardからvCardへ変換するコンバーターは、これらのプロパティの代わりにhCardが埋め込まれているWebページの情報を用いて、これらのプロパティを埋めることになります。まず、NAMEプロパティは文書のタイトル ((X)HTML文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILEの値には、[[rfc-2426|RFC2426]]より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCEプロパティには、ページのURLを用いることが推奨されます ({{should}})。hCardをvCardに変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODIDプロパティは、実際にvCardを出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]]のセクション3.6.9.に倣い、VERSIONプロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、そのhCardは会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCardでは "N" プロパティの記述が必須となっています。ところがvCard仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者のvCardに "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCardでは次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Webにおいてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCardは "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCardの作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCardは推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== "organization-name" の推測処理 ===
"ORG" プロパティは organization-name と organization-unit という二つのサブプロパティを持っています。しかしほとんどの場合、作成者は organization-name のみを記述します。よって、もし "ORG" プロパティが "organization-name" プロパティを内側に持たない場合、"ORG" プロパティの内容は必ず "organization-name" とみなされます ({{must}})。

=== Tags as Categories ===
Categories in hCard {{may}} be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== type subproperty values ===
The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See [[rfc-2426|RFC2426]] sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their [[rfc-2426|RFC2426]] definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

===Live example===

Here are the WikiMedia Foundation's contact details, as a live hCard which will be detected, on this page, by microformat parsing tools:

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

The mark-up (wrapped, and emboldening omitted, for clarity) used is:

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard [[rfc-2426|RFC2426]] converted into hCard.

==Buttons==
You can use these buttons on pages with hCards. See [[buttons#hCard]] for any recent additions.

* http://www.crowley.nl/images/hcard.png (mirror: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS-powered button, as evidenced at [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-29T13:57:38Z

Vantguarde:

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Appleのアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCardの基礎を構成します。

hCardは、vCardのオブジェクト/プロパティ名を小文字にしたものをclass属性の値として使用します。vCardオブジェクトの入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== ルートclass名 ===
hCardのルートclass名は "vcard" です。"vcard" というclass名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCardのプロパティは、hCard内の要素によって表されます。次にリストするプロパティをclass属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCardのプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつのhCardは、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合、特別なclass名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップするhCardを例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardは次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCardには、Webページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCardの '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは[[rfc-2426|RFC2426]]のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9で定義されていますが、hCardではこれらのプロパティを使ってはいけません ({{must-not}})。hCardを利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCardからvCardへ変換するコンバーターは、これらのプロパティの代わりにhCardが埋め込まれているWebページの情報を用いて、これらのプロパティを埋めることになります。まず、NAMEプロパティは文書のタイトル ((X)HTML文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILEの値には、[[rfc-2426|RFC2426]]より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCEプロパティには、ページのURLを用いることが推奨されます ({{should}})。hCardをvCardに変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODIDプロパティは、実際にvCardを出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]]のセクション3.6.9.に倣い、VERSIONプロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、そのhCardは会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCardでは "N" プロパティの記述が必須となっています。ところがvCard仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者のvCardに "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCardでは次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[[hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1|組織のコンタクト情報]]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Webにおいてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCardは "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は [[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCardの作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCardは推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== Implied "organization-name" Optimization ===
The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents {{must}} be treated as the "organization-name".

=== Tags as Categories ===
Categories in hCard {{may}} be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== type subproperty values ===
The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See [[rfc-2426|RFC2426]] sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their [[rfc-2426|RFC2426]] definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

===Live example===

Here are the WikiMedia Foundation's contact details, as a live hCard which will be detected, on this page, by microformat parsing tools:

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

The mark-up (wrapped, and emboldening omitted, for clarity) used is:

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard [[rfc-2426|RFC2426]] converted into hCard.

==Buttons==
You can use these buttons on pages with hCards. See [[buttons#hCard]] for any recent additions.

* http://www.crowley.nl/images/hcard.png (mirror: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS-powered button, as evidenced at [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-29T13:56:07Z

Vantguarde: /* プロパティについて */

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Appleのアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCardの基礎を構成します。

hCardは、vCardのオブジェクト/プロパティ名を小文字にしたものをclass属性の値として使用します。vCardオブジェクトの入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== ルートclass名 ===
hCardのルートclass名は "vcard" です。"vcard" というclass名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCardのプロパティは、hCard内の要素によって表されます。次にリストするプロパティをclass属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCardのプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard-ja#.22n.22_.E3.81.AE.E6.8E.A8.E6.B8.AC.E5.87.A6.E7.90.86|"n" の推測処理]]にあるルールに当てはまる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつのhCardは、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合、特別なclass名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップするhCardを例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardは次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCardには、Webページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCardの '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは[[rfc-2426|RFC2426]]のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9で定義されていますが、hCardではこれらのプロパティを使ってはいけません ({{must-not}})。hCardを利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCardからvCardへ変換するコンバーターは、これらのプロパティの代わりにhCardが埋め込まれているWebページの情報を用いて、これらのプロパティを埋めることになります。まず、NAMEプロパティは文書のタイトル ((X)HTML文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILEの値には、[[rfc-2426|RFC2426]]より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCEプロパティには、ページのURLを用いることが推奨されます ({{should}})。hCardをvCardに変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODIDプロパティは、実際にvCardを出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]]のセクション3.6.9.に倣い、VERSIONプロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、そのhCardは会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCardでは "N" プロパティの記述が必須となっています。ところがvCard仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者のvCardに "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCardでは次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[http://microformats.org/wiki/hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1 組織のコンタクト情報]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Webにおいてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCardは "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は "n" の推測処理と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCardの作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCardは推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== Implied "organization-name" Optimization ===
The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents {{must}} be treated as the "organization-name".

=== Tags as Categories ===
Categories in hCard {{may}} be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== type subproperty values ===
The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See [[rfc-2426|RFC2426]] sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their [[rfc-2426|RFC2426]] definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

===Live example===

Here are the WikiMedia Foundation's contact details, as a live hCard which will be detected, on this page, by microformat parsing tools:

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

The mark-up (wrapped, and emboldening omitted, for clarity) used is:

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard [[rfc-2426|RFC2426]] converted into hCard.

==Buttons==
You can use these buttons on pages with hCards. See [[buttons#hCard]] for any recent additions.

* http://www.crowley.nl/images/hcard.png (mirror: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS-powered button, as evidenced at [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-29T13:54:41Z

Vantguarde: /* Implied "n" Optimization */ forgot about translating the title

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Appleのアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCardの基礎を構成します。

hCardは、vCardのオブジェクト/プロパティ名を小文字にしたものをclass属性の値として使用します。vCardオブジェクトの入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== ルートclass名 ===
hCardのルートclass名は "vcard" です。"vcard" というclass名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCardのプロパティは、hCard内の要素によって表されます。次にリストするプロパティをclass属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCardのプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard#Implied_.22n.22_Optimization|'n' の省略ルール]]が適用できる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつのhCardは、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合、特別なclass名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップするhCardを例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardは次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCardには、Webページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCardの '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは[[rfc-2426|RFC2426]]のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9で定義されていますが、hCardではこれらのプロパティを使ってはいけません ({{must-not}})。hCardを利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCardからvCardへ変換するコンバーターは、これらのプロパティの代わりにhCardが埋め込まれているWebページの情報を用いて、これらのプロパティを埋めることになります。まず、NAMEプロパティは文書のタイトル ((X)HTML文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILEの値には、[[rfc-2426|RFC2426]]より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCEプロパティには、ページのURLを用いることが推奨されます ({{should}})。hCardをvCardに変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODIDプロパティは、実際にvCardを出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]]のセクション3.6.9.に倣い、VERSIONプロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、そのhCardは会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== "n" の推測処理 ===
vCardでは "N" プロパティの記述が必須となっています。ところがvCard仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者のvCardに "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCardでは次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[http://microformats.org/wiki/hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1 組織のコンタクト情報]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Webにおいてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCardは "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は "n" の推測処理と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCardの作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCardは推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== Implied "organization-name" Optimization ===
The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents {{must}} be treated as the "organization-name".

=== Tags as Categories ===
Categories in hCard {{may}} be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== type subproperty values ===
The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See [[rfc-2426|RFC2426]] sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their [[rfc-2426|RFC2426]] definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

===Live example===

Here are the WikiMedia Foundation's contact details, as a live hCard which will be detected, on this page, by microformat parsing tools:

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

The mark-up (wrapped, and emboldening omitted, for clarity) used is:

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard [[rfc-2426|RFC2426]] converted into hCard.

==Buttons==
You can use these buttons on pages with hCards. See [[buttons#hCard]] for any recent additions.

* http://www.crowley.nl/images/hcard.png (mirror: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS-powered button, as evidenced at [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-29T13:48:12Z

Vantguarde: /* Implied "nickname" Optimization */

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Appleのアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCardの基礎を構成します。

hCardは、vCardのオブジェクト/プロパティ名を小文字にしたものをclass属性の値として使用します。vCardオブジェクトの入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== ルートclass名 ===
hCardのルートclass名は "vcard" です。"vcard" というclass名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCardのプロパティは、hCard内の要素によって表されます。次にリストするプロパティをclass属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCardのプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard#Implied_.22n.22_Optimization|'n' の省略ルール]]が適用できる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつのhCardは、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合、特別なclass名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップするhCardを例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardは次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCardには、Webページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCardの '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは[[rfc-2426|RFC2426]]のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9で定義されていますが、hCardではこれらのプロパティを使ってはいけません ({{must-not}})。hCardを利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCardからvCardへ変換するコンバーターは、これらのプロパティの代わりにhCardが埋め込まれているWebページの情報を用いて、これらのプロパティを埋めることになります。まず、NAMEプロパティは文書のタイトル ((X)HTML文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILEの値には、[[rfc-2426|RFC2426]]より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCEプロパティには、ページのURLを用いることが推奨されます ({{should}})。hCardをvCardに変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODIDプロパティは、実際にvCardを出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]]のセクション3.6.9.に倣い、VERSIONプロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、そのhCardは会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== Implied "n" Optimization ===
vCardでは "N" プロパティの記述が必須となっています。ところがvCard仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者のvCardに "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCardでは次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[http://microformats.org/wiki/hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1 組織のコンタクト情報]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== "nickname" の推測処理 ===
[[hReview|ユーザーレビュー]]の作者など、Webにおいてニックネームやハンドル、そしてユーザーネームは広く普及しています。そこで、hCardは "nickname" を推測する処理方法を規定しました。

"nickname" の推測機構は "n" の推測処理と似ています。もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値が単語一つで構成され、さらに "N" プロパティが存在しない場合、次のような処理がなされます。

# "FN" プロパティの内容は "nickname" プロパティの値として解釈される必要があります ({{must}})。
# パーサは存在しない "N" プロパティについて、"N" のサブプロパティに空の値を与えたと仮定し、処理することが推奨されます ({{should}})。

パーサはニックネームの推測処理に従う必要がありますが ({{must}})、hCardの作成者は "nickname" プロパティを明示することが推奨されます ({{should}})。次のような場合においてもです。

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

また、hCardは推測されたニックネームに加え、明示的に記述された "nickname" プロパティを持つことができます ({{may}})。

=== Implied "organization-name" Optimization ===
The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents {{must}} be treated as the "organization-name".

=== Tags as Categories ===
Categories in hCard {{may}} be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== type subproperty values ===
The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See [[rfc-2426|RFC2426]] sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their [[rfc-2426|RFC2426]] definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

===Live example===

Here are the WikiMedia Foundation's contact details, as a live hCard which will be detected, on this page, by microformat parsing tools:

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

The mark-up (wrapped, and emboldening omitted, for clarity) used is:

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard [[rfc-2426|RFC2426]] converted into hCard.

==Buttons==
You can use these buttons on pages with hCards. See [[buttons#hCard]] for any recent additions.

* http://www.crowley.nl/images/hcard.png (mirror: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS-powered button, as evidenced at [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-29T13:23:33Z

Vantguarde: /* Implied "n" Optimization */

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Appleのアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCardの基礎を構成します。

hCardは、vCardのオブジェクト/プロパティ名を小文字にしたものをclass属性の値として使用します。vCardオブジェクトの入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== ルートclass名 ===
hCardのルートclass名は "vcard" です。"vcard" というclass名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCardのプロパティは、hCard内の要素によって表されます。次にリストするプロパティをclass属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCardのプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard#Implied_.22n.22_Optimization|'n' の省略ルール]]が適用できる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつのhCardは、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合、特別なclass名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップするhCardを例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardは次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCardには、Webページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCardの '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは[[rfc-2426|RFC2426]]のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9で定義されていますが、hCardではこれらのプロパティを使ってはいけません ({{must-not}})。hCardを利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCardからvCardへ変換するコンバーターは、これらのプロパティの代わりにhCardが埋め込まれているWebページの情報を用いて、これらのプロパティを埋めることになります。まず、NAMEプロパティは文書のタイトル ((X)HTML文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILEの値には、[[rfc-2426|RFC2426]]より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCEプロパティには、ページのURLを用いることが推奨されます ({{should}})。hCardをvCardに変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODIDプロパティは、実際にvCardを出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]]のセクション3.6.9.に倣い、VERSIONプロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、そのhCardは会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== Implied "n" Optimization ===
vCardでは "N" プロパティの記述が必須となっています。ところがvCard仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者のvCardに "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCardでは次のように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[http://microformats.org/wiki/hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1 組織のコンタクト情報]で書かれているルールが適用されます。

# "FN" の内容は、ホワイトスペースで区切られた二つの "単語" に分解されます。
# "FN" の ''最初の'' 単語は、"N" プロパティの "given-name" として扱われます。
# "FN" の ''次の/最後の'' 単語は、"N" プロパティの "family-name" として扱われます。
# 例外: もし最初の単語がコンマ "," で終わる、または二つ目の単語が一文字 (または一文字とピリオド ".")であった場合、コンマを抜いた最初の単語が "family-name" となり、二つ目の単語が "given-name" となります。

これらのルールにより、次の表記であれば簡単に名前を "FN" に記述することができます。
* given-name (スペース) family-name
* family-name (コンマ) given-name
* family-name (コンマ) given-nameのイニシャル
* family-name (スペース) given-nameのイニシャル (任意のピリオド)

=== Implied "nickname" Optimization ===
Due to the prevalence of the use of nicknames/handles/usernames in actual content published on the Web (e.g. authors of [[hReview|reviews]]), hCard also has an implied "nickname" optimization to handle this.

Similar to the implied "n" optimization, if "FN" and "ORG" are not the same, and the value of the "FN" property is exactly one word, and there is no explicit "N" property, then:

# The content of the "FN" {{must}} be treated as a "nickname" property value.
# Parsers {{should}} handle the missing "N" property by implying empty values for all the "N" sub-properties.

Though parsers {{must}} follow the implied nickname optimization, publishers {{should}} explicitly indicate the "nickname" even in this case, e.g.:

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

The hCard {{may}} have additional explicit "nickname" property values in addition to the implied nickname.

=== Implied "organization-name" Optimization ===
The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents {{must}} be treated as the "organization-name".

=== Tags as Categories ===
Categories in hCard {{may}} be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== type subproperty values ===
The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See [[rfc-2426|RFC2426]] sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their [[rfc-2426|RFC2426]] definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

===Live example===

Here are the WikiMedia Foundation's contact details, as a live hCard which will be detected, on this page, by microformat parsing tools:

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

The mark-up (wrapped, and emboldening omitted, for clarity) used is:

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard [[rfc-2426|RFC2426]] converted into hCard.

==Buttons==
You can use these buttons on pages with hCards. See [[buttons#hCard]] for any recent additions.

* http://www.crowley.nl/images/hcard.png (mirror: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS-powered button, as evidenced at [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-29T13:13:13Z

Vantguarde: /* Implied "n" Optimization */

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Appleのアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCardの基礎を構成します。

hCardは、vCardのオブジェクト/プロパティ名を小文字にしたものをclass属性の値として使用します。vCardオブジェクトの入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== ルートclass名 ===
hCardのルートclass名は "vcard" です。"vcard" というclass名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCardのプロパティは、hCard内の要素によって表されます。次にリストするプロパティをclass属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCardのプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard#Implied_.22n.22_Optimization|'n' の省略ルール]]が適用できる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつのhCardは、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合、特別なclass名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップするhCardを例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardは次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCardには、Webページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCardの '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは[[rfc-2426|RFC2426]]のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9で定義されていますが、hCardではこれらのプロパティを使ってはいけません ({{must-not}})。hCardを利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCardからvCardへ変換するコンバーターは、これらのプロパティの代わりにhCardが埋め込まれているWebページの情報を用いて、これらのプロパティを埋めることになります。まず、NAMEプロパティは文書のタイトル ((X)HTML文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILEの値には、[[rfc-2426|RFC2426]]より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCEプロパティには、ページのURLを用いることが推奨されます ({{should}})。hCardをvCardに変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODIDプロパティは、実際にvCardを出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]]のセクション3.6.9.に倣い、VERSIONプロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、そのhCardは会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== Implied "n" Optimization ===
vCardでは "N" プロパティの記述が必須となっています。ところが、vCard仕様書 ([[rfc-2426|RFC2426]]) では、最後の方 (p.38) にある作者のvCardに "N" プロパティが含まれていません。この明らかな矛盾は、"FN" プロパティがこの仕様書のように、多くの場合において "N" プロパティの内容を暗示していると解釈すれば問題なくなります。というわけで、hCardではそのように規定します。

もし "FN" と "ORG" プロパティが同じではなく、また "FN" の値がホワイトスペースで区切られた二つの単語のみで構成されており、さらに "N" プロパティが存在しない場合、"N" は "FN" プロパティの値から推測されます。もし "FN" が単語一つの場合は次の段落を、もし "FN" が三つ以上の単語である場合、作成者は "N" プロパティを明示的にマークアップする必要があります ({{must}})。しかし、組織名の場合はこのルールに当てはまりません。この場合は[http://microformats.org/wiki/hcard-ja#.E7.B5.84.E7.B9.94.E3.81.AE.E3.82.B3.E3.83.B3.E3.82.BF.E3.82.AF.E3.83.88.E6.83.85.E5.A0.B1 組織のコンタクト情報]で書かれているルールが適用されます。

# The content of "FN" is broken into two "words" separated by whitespace.
# The ''first'' word of the "FN" is interpreted as the "given-name" for the "N" property.
# The ''second/last'' word of the "FN" is interpreted as the "family-name" for the "N" property.
# Exception: If the first word ends in a "," comma OR if the second word is a single character (optionally followed by a period "."), then the first word (minus the comma at the end if any) is interpreted as the "family-name" and the second word is interpreted as the "given-name".

This allows simplification in the typical case of people stating:
* given-name (space) family-name
* family-name (comma) given-name
* family-name (comma) given-name-first-initial
* family-name (space) given-name-first-initial (optional period)

=== Implied "nickname" Optimization ===
Due to the prevalence of the use of nicknames/handles/usernames in actual content published on the Web (e.g. authors of [[hReview|reviews]]), hCard also has an implied "nickname" optimization to handle this.

Similar to the implied "n" optimization, if "FN" and "ORG" are not the same, and the value of the "FN" property is exactly one word, and there is no explicit "N" property, then:

# The content of the "FN" {{must}} be treated as a "nickname" property value.
# Parsers {{should}} handle the missing "N" property by implying empty values for all the "N" sub-properties.

Though parsers {{must}} follow the implied nickname optimization, publishers {{should}} explicitly indicate the "nickname" even in this case, e.g.:

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

The hCard {{may}} have additional explicit "nickname" property values in addition to the implied nickname.

=== Implied "organization-name" Optimization ===
The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents {{must}} be treated as the "organization-name".

=== Tags as Categories ===
Categories in hCard {{may}} be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== type subproperty values ===
The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See [[rfc-2426|RFC2426]] sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their [[rfc-2426|RFC2426]] definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

===Live example===

Here are the WikiMedia Foundation's contact details, as a live hCard which will be detected, on this page, by microformat parsing tools:

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

The mark-up (wrapped, and emboldening omitted, for clarity) used is:

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard [[rfc-2426|RFC2426]] converted into hCard.

==Buttons==
You can use these buttons on pages with hCards. See [[buttons#hCard]] for any recent additions.

* http://www.crowley.nl/images/hcard.png (mirror: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS-powered button, as evidenced at [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-29T12:49:00Z

Vantguarde: /* 組織のコンタクト情報 */

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Appleのアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCardの基礎を構成します。

hCardは、vCardのオブジェクト/プロパティ名を小文字にしたものをclass属性の値として使用します。vCardオブジェクトの入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== ルートclass名 ===
hCardのルートclass名は "vcard" です。"vcard" というclass名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCardのプロパティは、hCard内の要素によって表されます。次にリストするプロパティをclass属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCardのプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard#Implied_.22n.22_Optimization|'n' の省略ルール]]が適用できる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつのhCardは、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合、特別なclass名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップするhCardを例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardは次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCardには、Webページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCardの '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは[[rfc-2426|RFC2426]]のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9で定義されていますが、hCardではこれらのプロパティを使ってはいけません ({{must-not}})。hCardを利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCardからvCardへ変換するコンバーターは、これらのプロパティの代わりにhCardが埋め込まれているWebページの情報を用いて、これらのプロパティを埋めることになります。まず、NAMEプロパティは文書のタイトル ((X)HTML文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILEの値には、[[rfc-2426|RFC2426]]より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCEプロパティには、ページのURLを用いることが推奨されます ({{should}})。hCardをvCardに変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODIDプロパティは、実際にvCardを出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]]のセクション3.6.9.に倣い、VERSIONプロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、そのhCardは会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略をふまえた対応が推奨されます ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== Implied "n" Optimization ===
Although vCard requires that the "N" property be present, the authors of the vCard specification ([[rfc-2426|RFC2426]]) themselves do not include "N" properties in their vCards near the end of the spec (p.38). This apparent contradiction can be resolved by simply allowing the "FN" property to imply "N" property values in typical cases provided in the spec. We do so explicitly in hCard.

If "FN" and "ORG" are not the same (see previous section), and the value of the "FN" property is exactly two words (separated by whitespace), and there is no explicit "N" property, then the "N" property is inferred from the "FN" property. For "FN"s with either one word see below, and for three or more, the author {{must}} explicitly markup the "N", except for the organization contact info case, [http://microformats.org/wiki/hcard#Organization_Contact_Info see above] for that.

# The content of "FN" is broken into two "words" separated by whitespace.
# The ''first'' word of the "FN" is interpreted as the "given-name" for the "N" property.
# The ''second/last'' word of the "FN" is interpreted as the "family-name" for the "N" property.
# Exception: If the first word ends in a "," comma OR if the second word is a single character (optionally followed by a period "."), then the first word (minus the comma at the end if any) is interpreted as the "family-name" and the second word is interpreted as the "given-name".

This allows simplification in the typical case of people stating:
* given-name (space) family-name
* family-name (comma) given-name
* family-name (comma) given-name-first-initial
* family-name (space) given-name-first-initial (optional period)

=== Implied "nickname" Optimization ===
Due to the prevalence of the use of nicknames/handles/usernames in actual content published on the Web (e.g. authors of [[hReview|reviews]]), hCard also has an implied "nickname" optimization to handle this.

Similar to the implied "n" optimization, if "FN" and "ORG" are not the same, and the value of the "FN" property is exactly one word, and there is no explicit "N" property, then:

# The content of the "FN" {{must}} be treated as a "nickname" property value.
# Parsers {{should}} handle the missing "N" property by implying empty values for all the "N" sub-properties.

Though parsers {{must}} follow the implied nickname optimization, publishers {{should}} explicitly indicate the "nickname" even in this case, e.g.:

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

The hCard {{may}} have additional explicit "nickname" property values in addition to the implied nickname.

=== Implied "organization-name" Optimization ===
The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents {{must}} be treated as the "organization-name".

=== Tags as Categories ===
Categories in hCard {{may}} be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== type subproperty values ===
The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See [[rfc-2426|RFC2426]] sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their [[rfc-2426|RFC2426]] definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

===Live example===

Here are the WikiMedia Foundation's contact details, as a live hCard which will be detected, on this page, by microformat parsing tools:

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

The mark-up (wrapped, and emboldening omitted, for clarity) used is:

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard [[rfc-2426|RFC2426]] converted into hCard.

==Buttons==
You can use these buttons on pages with hCards. See [[buttons#hCard]] for any recent additions.

* http://www.crowley.nl/images/hcard.png (mirror: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS-powered button, as evidenced at [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-28T09:57:09Z

Vantguarde: Sync'd

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Appleのアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCardの基礎を構成します。

hCardは、vCardのオブジェクト/プロパティ名を小文字にしたものをclass属性の値として使用します。vCardオブジェクトの入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== ルートclass名 ===
hCardのルートclass名は "vcard" です。"vcard" というclass名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCardのプロパティは、hCard内の要素によって表されます。次にリストするプロパティをclass属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCardのプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard#Implied_.22n.22_Optimization|'n' の省略ルール]]が適用できる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつのhCardは、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合、特別なclass名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップするhCardを例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardは次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCardには、Webページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCardの '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは[[rfc-2426|RFC2426]]のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9で定義されていますが、hCardではこれらのプロパティを使ってはいけません ({{must-not}})。hCardを利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCardからvCardへ変換するコンバーターは、これらのプロパティの代わりにhCardが埋め込まれているWebページの情報を用いて、これらのプロパティを埋めることになります。まず、NAMEプロパティは文書のタイトル ((X)HTML文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILEの値には、[[rfc-2426|RFC2426]]より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCEプロパティには、ページのURLを用いることが推奨されます ({{should}})。hCardをvCardに変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODIDプロパティは、実際にvCardを出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]]のセクション3.6.9.に倣い、VERSIONプロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、そのhCardは会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略を処理するべきです ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== Implied "n" Optimization ===
Although vCard requires that the "N" property be present, the authors of the vCard specification ([[rfc-2426|RFC2426]]) themselves do not include "N" properties in their vCards near the end of the spec (p.38). This apparent contradiction can be resolved by simply allowing the "FN" property to imply "N" property values in typical cases provided in the spec. We do so explicitly in hCard.

If "FN" and "ORG" are not the same (see previous section), and the value of the "FN" property is exactly two words (separated by whitespace), and there is no explicit "N" property, then the "N" property is inferred from the "FN" property. For "FN"s with either one word see below, and for three or more, the author {{must}} explicitly markup the "N", except for the organization contact info case, [http://microformats.org/wiki/hcard#Organization_Contact_Info see above] for that.

# The content of "FN" is broken into two "words" separated by whitespace.
# The ''first'' word of the "FN" is interpreted as the "given-name" for the "N" property.
# The ''second/last'' word of the "FN" is interpreted as the "family-name" for the "N" property.
# Exception: If the first word ends in a "," comma OR if the second word is a single character (optionally followed by a period "."), then the first word (minus the comma at the end if any) is interpreted as the "family-name" and the second word is interpreted as the "given-name".

This allows simplification in the typical case of people stating:
* given-name (space) family-name
* family-name (comma) given-name
* family-name (comma) given-name-first-initial
* family-name (space) given-name-first-initial (optional period)

=== Implied "nickname" Optimization ===
Due to the prevalence of the use of nicknames/handles/usernames in actual content published on the Web (e.g. authors of [[hReview|reviews]]), hCard also has an implied "nickname" optimization to handle this.

Similar to the implied "n" optimization, if "FN" and "ORG" are not the same, and the value of the "FN" property is exactly one word, and there is no explicit "N" property, then:

# The content of the "FN" {{must}} be treated as a "nickname" property value.
# Parsers {{should}} handle the missing "N" property by implying empty values for all the "N" sub-properties.

Though parsers {{must}} follow the implied nickname optimization, publishers {{should}} explicitly indicate the "nickname" even in this case, e.g.:

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

The hCard {{may}} have additional explicit "nickname" property values in addition to the implied nickname.

=== Implied "organization-name" Optimization ===
The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents {{must}} be treated as the "organization-name".

=== Tags as Categories ===
Categories in hCard {{may}} be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== type subproperty values ===
The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See [[rfc-2426|RFC2426]] sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their [[rfc-2426|RFC2426]] definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

===Live example===

Here are the WikiMedia Foundation's contact details, as a live hCard which will be detected, on this page, by microformat parsing tools:

<div class="vcard">
<div class="fn org">'''Wikimedia Foundation Inc.'''</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">'''200 2nd Ave. South #358'''</div>
<div> <span class="locality">'''St. Petersburg'''</span> <span class="region">'''FL'''</span>  <span class="postal-code">'''33701-4313'''</span></div>
<div class="country-name">'''USA'''</div>
</div>
<div>'''Phone:''' <span class="tel"><span class="type">work</span>'''+1-727-231-0101'''</span></div>
<div>'''Email:''' <span class="email">'''info@wikimedia.org'''</span></div>
<div><span class="tel"><span class="type">'''Fax'''</span>''':''' <span class="value">'''+1-727-258-0207'''</span></span></div>
</div>

The mark-up (wrapped, and emboldening omitted, for clarity) used is:

<pre><nowiki>
<div class="vcard">
<div class="fn org">Wikimedia Foundation Inc.</div>
<div class="adr">
<span class="type">work</span>
<div class="street-address">200 2nd Ave. South #358</div>
<div>
<span class="locality">St. Petersburg</span>
<abbr class="region" title="Florida">FL</abbr>  <span class="postal-code">33701-4313</span>
</div>
<div class="country-name">USA</div>
</div>
<div>Phone: <span class="tel"><span class="type">work</span>+1-727-231-0101</span></div>
<div>Email: <span class="email">info@wikimedia.org</span></div>
<div>
<span class="tel"><span class="type">Fax</span>:
<span class="value">+1-727-258-0207</span></span>
</div>
</div>
</nowiki></pre>

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard [[rfc-2426|RFC2426]] converted into hCard.

==Buttons==
You can use these buttons on pages with hCards. See [[buttons#hCard]] for any recent additions.

* http://www.crowley.nl/images/hcard.png (mirror: http://www.davidjanes.com/images/mf_hcard.png)
* http://rbach.priv.at/2006/buttons/hcard.png
* http://www.boogdesign.com/images/buttons/microformat_hcard.png
* CSS-powered button, as evidenced at [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== Copyright ==
Per the public domain release on the authors' user pages ([[User:Tantek|Tantek Çelik]], [[User:Brian|Brian Suda]]) this specification is released into the public domain.

{{MicroFormatPublicDomainContributionStatement}}

== Patents ==
{{MicroFormatPatentStatement}}

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)
* [[rfc-2119|RFC 2119]]

=== Informative References ===
* [[hcard-history|hCard history]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 2004-09-30]
** Contributed from http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 in Postscript] ([http://72.14.253.104/search?q=cache:FjqzsFu4h20J:www.dante.net/np/ds/osi/9594-6-X.520.A4.ps HTMLization courtesy of Google Cache]) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Inspiration and Acknowledgments ==
Thanks to: my good friend [http://vadim.com/ Vadim] who introduced me to vCard ''many'' years ago, and if I'd only paid more attention then, perhaps I could have helped a lot of people avoid wasting a lot of time reinventing various standards wheels.

== Notes on derivation from vCard ==
This section is ''informative''.

<div id="Semantic_XHTML_Design_Principles">See: [[hcard-design-methodology]].</div>

=== More Semantic Equivalents ===
For some properties there are HTML elements which better match and convey their semantics. The following properties SHOULD be encoded with the following (X)HTML:
* <code>URL</code> in vCard becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vcard"</code> in hCard.
* Similarly, <code>EMAIL</code> in vCard becomes <code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>
* <code>PHOTO</code> in vCard becomes <code><img class="photo" src="..." alt="Photo of ..." /></code> or <code><object class="photo" data="..." type="...">Photo of ...</object></code>
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.

=== Singular and Plural derivations ===
The [[hcard#Singular_vs._Plural_Properties|lists of singular and plural properties]] have been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====
Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}

hcard-ja

2007-10-27T18:00:37Z

Vantguarde:

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Appleのアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCardの基礎を構成します。

hCardは、vCardのオブジェクト/プロパティ名を小文字にしたものをclass属性の値として使用します。vCardオブジェクトの入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== ルートclass名 ===
hCardのルートclass名は "vcard" です。"vcard" というclass名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCardのプロパティは、hCard内の要素によって表されます。次にリストするプロパティをclass属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCardのプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard#Implied_.22n.22_Optimization|'n' の省略ルール]]が適用できる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつのhCardは、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か "Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合、特別なclass名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップするhCardを例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardは次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCardには、Webページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCardの '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは[[rfc-2426|RFC2426]]のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9で定義されていますが、hCardではこれらのプロパティを使ってはいけません ({{must-not}})。hCardを利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCardからvCardへ変換するコンバーターは、これらのプロパティの代わりにhCardが埋め込まれているWebページの情報を用いて、これらのプロパティを埋めることになります。まず、NAMEプロパティは文書のタイトル ((X)HTML文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILEの値には、[[rfc-2426|RFC2426]]より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCEプロパティには、ページのURLを用いることが推奨されます ({{should}})。hCardをvCardに変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODIDプロパティは、実際にvCardを出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]]のセクション3.6.9.に倣い、VERSIONプロパティに "3.0" という値をつけるべきです ({{should}})。

=== 組織のコンタクト情報 ===
もし、"FN" と "ORG" プロパティが同じ値を持っている場合 (多くの場合、これらは class="fn org" と同じ要素に記述されています)、そのhCardは会社や組織、場所のコンタクト情報を表すものとみなされます ({{should}})。このとき、作成者は "N" プロパティを記述することはできない ({{must-not}})、もしくは、"" と、空文字列を記述する必要があります。このため、パーサは "N" プロパティの省略を処理するべきです ({{should}})。この場合は、全ての "N" サブプロパティに空文字列があるものとみなします。

=== Implied "n" Optimization ===
Although vCard requires that the "N" property be present, the authors of the vCard specification ([[rfc-2426|RFC2426]]) themselves do not include "N" properties in their vCards near the end of the spec (p.38). This apparent contradiction can be resolved by simply allowing the "FN" property to imply "N" property values in typical cases provided in the spec. We do so explicitly in hCard.

If "FN" and "ORG" are not the same (see previous section), and the value of the "FN" property is exactly two words (separated by whitespace), and there is no explicit "N" property, then the "N" property is inferred from the "FN" property. For "FN"s with either one word see below, and for three or more, the author {{must}} explicitly markup the "N", except for the organization contact info case, [http://microformats.org/wiki/hcard#Organization_Contact_Info see above] for that.

# The content of "FN" is broken into two "words" separated by whitespace.
# The ''first'' word of the "FN" is interpreted as the "given-name" for the "N" property.
# The ''second/last'' word of the "FN" is interpreted as the "family-name" for the "N" property.
# Exception: If the first word ends in a "," comma OR if the second word is a single character (optionally followed by a period "."), then the first word (minus the comma at the end if any) is interpreted as the "family-name" and the second word is interpreted as the "given-name".

This allows simplification in the typical case of people stating:
* given-name (space) family-name
* family-name (comma) given-name
* family-name (comma) given-name-first-initial
* family-name (space) given-name-first-initial (optional period)

=== Implied "nickname" Optimization ===
Due to the prevalence of the use of nicknames/handles/usernames in actual content published on the Web (e.g. authors of [[hReview|reviews]]), hCard also has an implied "nickname" optimization to handle this.

Similar to the implied "n" optimization, if "FN" and "ORG" are not the same, and the value of the "FN" property is exactly one word, and there is no explicit "N" property, then:

# The content of the "FN" {{must}} be treated as a "nickname" property value.
# Parsers {{should}} handle the missing "N" property by implying empty values for all the "N" sub-properties.

Though parsers {{must}} follow the implied nickname optimization, publishers {{should}} explicitly indicate the "nickname" even in this case, e.g.:

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

The hCard {{may}} have additional explicit "nickname" property values in addition to the implied nickname.

=== Implied "organization-name" Optimization ===
The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents {{must}} be treated as the "organization-name".

=== Tags as Categories ===
Categories in hCard {{may}} be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== type subproperty values ===
The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See [[rfc-2426|RFC2426]] sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their [[rfc-2426|RFC2426]] definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard RFC 2426 converted into hCard.

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)

=== Informative References ===
* Contributed from http://developers.technorati.com/wiki/hCard.
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 20040930]
* [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 20040910]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}
<nowiki>Insert non-formatted text here</nowiki>

hcard-ja

2007-10-27T17:14:04Z

Vantguarde:

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== はじめに ==
vCard ([[rfc-2426|RFC2426]]) は、Appleのアドレスブック機能をはじめさまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard''' というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]) のプロパティ名や値が、hCardの基礎を構成します。

hCardは、vCardのオブジェクト/プロパティ名を小文字にしたものをclass属性の値として使用します。vCardオブジェクトの入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== ルートclass名 ===
hCardのルートclass名は "vcard" です。"vcard" というclass名が指定された要素を、''hCard'' と呼びます。

=== プロパティとサブプロパティ ===
hCardのプロパティは、hCard内の要素によって表されます。次にリストするプロパティをclass属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCardのプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard#Implied_.22n.22_Optimization|'n' の省略ルール]]が適用できる場合は、任意 ({{optional}}) プロパティとなります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することができます ({{may}})。

=== 複数のプロパティ ===
ひとつのhCardは、一つ以上の 'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても構いません ({{may}})。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== "Human readable" か Machine readable" か ===
要素の内容のうち、人間に見えるテキスト情報が、そのプロパティの値を表します。しかし、いくつか例外が存在します。

もし <code><abbr></code> 要素がプロパティに用いられている場合、要素の内容ではなく <code><abbr></code> 要素の '<code>title</code>' 属性値がプロパティの値となります。要素の内容は、より人間にとって読みやすい値の表現となります。

もし <code><a></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>href="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

もし <code><img></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>src="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、<code><img></code> 要素の '<code>alt</code>' 属性の値がプロパティの値となります。

もし <code><object></code> 要素が一つ以上のプロパティに用いられている場合、次のように処理される必要があります ({{must}})。
# 'photo' プロパティと、他にURLを取るすべてのプロパティでは、<code>data="..."</code> 属性の値がプロパティの値となります。
# その他のプロパティでは、要素の内容がプロパティの値となります。

=== 値の抜粋 ===
要素の一部だけがプロパティの値として当てはまるという場合があります。例えば、'tel' のように、サブタイプを持つようなプロパティです。このような場合、特別なclass名である "<code>value</code>" を用い、プロパティの値として適切なものをマークアップします。家の電話番号をマークアップするhCardを例に取り説明しましょう。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardは次のように表示されるでしょう。

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>



=== プロパティの例外 ===
vCardには、Webページの内容としてあまり意味をなさない、もしくは何らかのかたちですでに存在しているプロパティが存在しています。このセクションでは、そのようなプロパティに対し、何を行い、何を行わないかを説明します。

# vCardの '''NAME'''、'''PROFILE'''、'''SOURCE'''、'''PRODID'''、'''VERSION''' プロパティは[[rfc-2426|RFC2426]]のセクション2.1.2、2.1.3、2.1.4、3.6.3、3.6.9で定義されていますが、hCardではこれらのプロパティを使ってはいけません ({{must-not}})。hCardを利用するものは、もしこれらのプロパティが使われていた場合、それらを無視する必要があります ({{must}})。hCardからvCardへ変換するコンバーターは、これらのプロパティの代わりにhCardが埋め込まれているWebページの情報を用いて、これらのプロパティを埋めることになります。まず、NAMEプロパティは文書のタイトル ((X)HTML文書の場合、<code><title></code> 要素) を用いることが推奨されます ({{should}})。PROFILEの値には、[[rfc-2426|RFC2426]]より "<code>VCARD</code>" の値を使うことができます ({{may}})。SOURCEプロパティには、ページのURLを用いることが推奨されます ({{should}})。hCardをvCardに変換するサービスならば、そのパラメーターとしても用いることができるでしょう。PRODIDプロパティは、実際にvCardを出力するサービスやアプリケーションのみが記述するべきです ({{should}})。同様に、そのようなアプリケーションのみが、[[rfc-2426|RFC2426]]のセクション3.6.9.に倣い、VERSIONプロパティに "3.0" という値をつけるべきです ({{should}})。

=== Organization Contact Info ===
If the "FN" and "ORG" properties have the exact same value (typically because they are set on the same element, e.g. class="fn org"), then the hCard represents contact information for a company, organization or place and {{should}} be treated as such. In this case the author also {{must-not}} set the "N" property, or set it (and any sub-properties) explicitly to the empty string "". Thus parsers {{should}} handle the missing "N" property, in this case by implying empty values for all the "N" sub-properties.

=== Implied "n" Optimization ===
Although vCard requires that the "N" property be present, the authors of the vCard specification ([[rfc-2426|RFC2426]]) themselves do not include "N" properties in their vCards near the end of the spec (p.38). This apparent contradiction can be resolved by simply allowing the "FN" property to imply "N" property values in typical cases provided in the spec. We do so explicitly in hCard.

If "FN" and "ORG" are not the same (see previous section), and the value of the "FN" property is exactly two words (separated by whitespace), and there is no explicit "N" property, then the "N" property is inferred from the "FN" property. For "FN"s with either one word see below, and for three or more, the author {{must}} explicitly markup the "N", except for the organization contact info case, [http://microformats.org/wiki/hcard#Organization_Contact_Info see above] for that.

# The content of "FN" is broken into two "words" separated by whitespace.
# The ''first'' word of the "FN" is interpreted as the "given-name" for the "N" property.
# The ''second/last'' word of the "FN" is interpreted as the "family-name" for the "N" property.
# Exception: If the first word ends in a "," comma OR if the second word is a single character (optionally followed by a period "."), then the first word (minus the comma at the end if any) is interpreted as the "family-name" and the second word is interpreted as the "given-name".

This allows simplification in the typical case of people stating:
* given-name (space) family-name
* family-name (comma) given-name
* family-name (comma) given-name-first-initial
* family-name (space) given-name-first-initial (optional period)

=== Implied "nickname" Optimization ===
Due to the prevalence of the use of nicknames/handles/usernames in actual content published on the Web (e.g. authors of [[hReview|reviews]]), hCard also has an implied "nickname" optimization to handle this.

Similar to the implied "n" optimization, if "FN" and "ORG" are not the same, and the value of the "FN" property is exactly one word, and there is no explicit "N" property, then:

# The content of the "FN" {{must}} be treated as a "nickname" property value.
# Parsers {{should}} handle the missing "N" property by implying empty values for all the "N" sub-properties.

Though parsers {{must}} follow the implied nickname optimization, publishers {{should}} explicitly indicate the "nickname" even in this case, e.g.:

<pre><nowiki>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</nowiki></pre>

The hCard {{may}} have additional explicit "nickname" property values in addition to the implied nickname.

=== Implied "organization-name" Optimization ===
The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents {{must}} be treated as the "organization-name".

=== Tags as Categories ===
Categories in hCard {{may}} be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== type subproperty values ===
The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See [[rfc-2426|RFC2426]] sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their [[rfc-2426|RFC2426]] definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard RFC 2426 converted into hCard.

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)

=== Informative References ===
* Contributed from http://developers.technorati.com/wiki/hCard.
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 20040930]
* [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 20040910]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}
<nowiki>Insert non-formatted text here</nowiki>

hcard-ja

2007-10-27T16:21:43Z

Vantguarde:

hcard-ja

2007-10-27T16:08:08Z

Vantguarde: properties

hcard-ja

2007-10-27T15:48:32Z

Vantguarde:

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]])のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== Introduction ==
vCard ([[rfc-2426|RFC2426]])はAppleのアドレスブック機能など、さまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し、友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard'''というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 基本情報 ===
vCard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426])のプロパティ名や値が、hCardの基礎を構成します。

hCardは、vCardのオブジェクト/プロパティ名を小文字にしたものをclass属性の値として使用します。vCardオブジェクトの入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== ルートclass名 ===
hCardのルートclass名は"vcard"です。"vcard"というclass名が指定された要素を、''hCard''と呼びます。

=== プロパティとサブプロパティ ===
hCardのプロパティは、hCard内の要素によって表されます。次にリストするプロパティをclass属性に指定することにより、プロパティを表現します。いくつかのプロパティはサブプロパティを持ちますが、これらはプロパティ要素の中にサブプロパティ要素を設け表現します。

=== プロパティリスト ===
hCardのプロパティは次の通りです。サブプロパティは括弧内に記述しています。

'''必須プロパティ'''
* '''fn'''
* '''n'''* (family-name, given-name, additional-name, honorific-prefix, honorific-suffix)
任意プロパティ
* nickname, sort-string
* url, email (type, value), tel** (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== プロパティについて ===
<nowiki>*</nowiki> 'n' プロパティは、[[hcard#Implied_.22n.22_Optimization|'n'の省略ルール]]が適用できる場合は、{{任意プロパティ}}となります。<br />
<nowiki>**</nowiki> tel - 電話番号は、[http://en.wikipedia.org/wiki/E.123 E.123]に従って記述することが{{できます}}。

=== 複数のプロパティ ===
ひとつのhCardは、一つ以上の'fn'、'n'、'bday'、'tz'、'geo'、'sort-string'、'uid'、'class'を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視することが推奨されます。

他のプロパティは複数あっても{{構いません}}。この場合、複数あるプロパティはその数だけ新しいインスタンスを作成します。

=== More Semantic Equivalents ===
プロパティの中には、HTML要素で表現するほうがより良くその意味を伝えるものがあります。以下のプロパティはそれに続く(X)HTMLで表現すべき(SHOULD)です。
* vCardの<code>URL</code>は、hCardでは<code>class="vcard"</code>を含む要素の内部にある<code><a class="url" href="...">...</a></code>になります。
* 同様にvCardの<code>EMAIL</code>は、<code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>になります。
* vCardの<code>PHOTO</code>は、<code><img class="photo" src="..." alt="...の写真" /></code>または<code><object class="photo" data="..." type="...">...の写真</object></code>になります。
* vCardの<code>UID</code>は、単純に、hCardを特定するURL(またはEMAIL)へのもう一つの意味付けになります。

=== Singular vs. Plural Properties ===
For properties which are singular (e.g. "N" and "FN"), the first descendant element with that class should take effect, any others being ignored.

For properties which can be plural (e.g. "TEL"), each class instance should create a instance of that property.

==== Singular properties ====

Singular properties: "FN", "N", "BDAY", "TZ", "GEO", "SORT-STRING", "UID", "CLASS".

All other properties are plural. This list has been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====

Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

=== Human vs. Machine readable ===

If an <code><abbr></code> element is used for a property, then the '<code>title</code>' attribute of the <code><abbr></code> element is the value of the property, instead of the contents of the element, which instead provide a human presentable version of the value.

If an <code><a></code> element is used for one or more properties, it must be treated as follows:
# For the "PHOTO" property and any other property that takes a URL as its value, the <code>href="..."</code> attribute provides the property value.
# For other properties, the element's content is the value of the property.

If an <code><img></code> element is used for one or more properties, it must be treated as follows:
# For the "PHOTO" property and any other property that takes a URL as its value, the <code>src="..."</code> attribute provides the property value.
# For other properties, the <code><img></code> element's '<code>alt</code>' attribute is the value of the property.

If an <code><object></code> element is used for one or more properties, it must be treated as follows:
# For the "PHOTO" property and any other property that takes a URL as its value, the <code>data="..."</code> attribute provides the property value.
# For other properties, the element's content is the value of the property.

=== 値の抽出 ===

あるプロパティに一致する要素があっても、その要素の一部のみをそのプロパティの値として使用すべき場合があります。
これは典型的には、TELに対するTYPE=HOMEや、TYPE=WORKのようにプロパティが下位の型を持つ場合におこります。
このため、要素中のプロパティの値となる部分を指定するための特別のクラス名"<code>value</code>"が導入されています。
例:ここにhCardの自宅の電話番号をマークアップするためのhCardの一部があります。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardの断片は次のように表示することができます:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>

=== 例外となるプロパティ ===

vCardには意味のないプロパティ、または、すでにウェブページのなかではすでにその意味が含まれているものがあります。このセクションでは、それらのプロパティについて、どうしたら良いか(または何をすべきでないか)を説明します。

# '''NAME''', '''PROFILE''', '''SOURCE''', '''PRODID''', '''VERSION''' properties as defined in Sections 2.1.2, 2.1.3, 2.1.4, 3.6.3, 3.6.9 of RFC 2426. Content publishers MUST NOT use these properties in their hCards, and as such, hCard consumers/parsers MUST IGNORE these properties if they are found within an hCard. Instead. hCard to vCard converters SHOULD use the title of the page where the hCard is found (e.g. the <code><title></code> element in (X)HTML documents) to construct the NAME property, MAY output a PROFILE value of "<code>VCARD</code>" per RFC 2426, SHOULD use the URL of the page where the hCard is found to construct the SOURCE property (e.g. perhaps as a parameter to a URL/service that converts hCards to vCards), for an output vCard stream (e.g. a .vcf file). Only services/applications that output actual vCards should write the PRODID property, with the product identifier for said service/application. Similarly only such services/applications should write the VERSION property, with the value "3.0" (without quotes) per RFC2426 Section 3.6.9.

=== 組織の連絡先情報 ===

"FN"と"ORG"プロパティが完全に同じ値を持つ場合、(典型的にはclass="fn org"のように、一つの要素に両方が指定されている場合)、そのhCardは、会社または組織の連絡先情報を表し、そのように取り扱われるべきです。この場合、hCardの作成者は、"N"プロパティを設定しないか、"N"プロパティとその全ての下位プロパティの値を空文字列に設定するかのどちらかでなくてはいけません(MUST)。パーザーは存在しない"N"プロパティを、"N"とその全ての下位プロパティの値を空文字列に設定したものとして解釈します。

=== Implied "n" Optimization ===

vCardでは"N"プロパティを必須となっていますが、vCard仕様(RFC 2426)の終わり近くにある著者達のvCardには"N"プロパティが含まれていません。(p.38) この明らかな矛盾は、仕様書上にある例のような場合に関して、単に"FN"プロパティの値から"N"プロパティの値を導くことができるようにすれば解決します。hCardでは明示的にそれを行います。

もし"FN"と"ORG"がおなじでなく(全セクション参照)、"FN"プロパティの値が正確に2語(空白で区切られた)からなり、さらに明示的な"N"プロパティがない場合、"N"プロパティは"FN"から導出されます。"FN"が1語のみ、または3語以上の場合は、hCardの作成者は"N"を明示的にマークアップしなければなりません(MUST)。これについては、組織の連絡先情報の場合は例外となります。 [http://microformats.org/wiki/hcard-ja#Organization_Contact_Info 上記を参照]

# "FN"内容は空白により2語に分割されます。
# "FN"の最初の語は"N"プロパティの"given-name"として解釈されます。
# "FN"の''2番目/最後''の語は"N"プロパティの"family-name"として解釈されます。
# 例外: もしも最初の語がカンマ","で終わっているか、 2番目の語が1文字(または後ろに余分のピリオド"."が付加されたもの)である場合、最初の語(最後にカンマがあればそれを取り除いたもの)は"family-name"として、2番目の語は"given-name"として解釈されます。

これにより、人物の記述について、以下のような典型的なケースを単純化できます。
* given-name (space) family-name
* family-name (comma) given-name
* family-name (comma) given-name-first-initial
* family-name (space) given-name-first-initial (optional period)

=== Implied "nickname" Optimization ===

Due to the prevalence of the use of nicknames/handles/usernames on the Web in actual content published on the Web (e.g. authors of [[hReview|reviews]]), hCard also has an implied "nickname" optimization to handle this.

Similar to the implied "n" optimization, if "FN" and "ORG" are not the same, and the value of the "FN" property is exactly one word, and there is no explicit "N" property, then:

# The content of the "FN" is treated as a "nickname" property value.
# Parsers should handle the missing "N" property by implying empty values for all the "N" sub-properties.

Note: the hCard may have additional explicit "nickname" property values in addition to the implied nickname.

=== Implied "organization-name" Optimization ===

The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents MUST be treated as the "organization-name".

=== Tags as Categories ===

Categories in hCard can optionally be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== Property Notes ===
* tel - Authors MAY want to follow the E.123 standard for writing values of telephone numbers.

==== type subproperty values ====

The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See RFC 2426 sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their RFC 2426 definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard RFC 2426 converted into hCard.

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)

=== Informative References ===
* Contributed from http://developers.technorati.com/wiki/hCard.
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 20040930]
* [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 20040910]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}
<nowiki>Insert non-formatted text here</nowiki>

hcard-ja

2007-10-27T15:22:28Z

Vantguarde: intro

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== Introduction ==
vCard ([[rfc-2426|RFC2426]]) はAppleのアドレスブック機能など、さまざまなところで実装され、広く使われているフォーマットです。

さて、多くのブロガーは、自分の名前を出し、友人や家族のことを書いています。人に関するこれらの情報にすこし構造を加えるだけで、アグリゲーターやスパイダーがその情報を取得し、vCardへ自動的に変換しアプリケーションで利用することができます。

この仕様は、'''hCard'''というフォーマットを定義します。これはvCardのプロパティや値を、XTHMLでそのまま表現しようとするものです。ブロガーはhCardをWebページに埋め込み、CSSで思うようにデザインすることができます。また、hCardはアプリケーションが他のファイルを参照することなしに、そのページから情報を取り出すことを可能とします。

[http://microformats.org/code/hcard/creator hCard creator]を使い、出てきたHTMLコードをblogやWebサイトに貼り付け、コンタクト情報を公開してください。

{{rfc-2119-intro}}

== フォーマット ==
=== 一般 ===
vCard標準([http://www.ietf.org/rfc/rfc2426.txt RFC2426])が、hCardの基礎となっています。

hCardの基本フォーマットは、vCardのオブジェクト/プロパティ名を小文字にしたものをクラス名として使用します。vCardオブジェクト上での入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== More Semantic Equivalents ===
プロパティの中には、HTML要素で表現するほうがより良くその意味を伝えるものがあります。以下のプロパティはそれに続く(X)HTMLで表現すべき(SHOULD)です。
* vCardの<code>URL</code>は、hCardでは<code>class="vcard"</code>を含む要素の内部にある<code><a class="url" href="...">...</a></code>になります。
* 同様にvCardの<code>EMAIL</code>は、<code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>になります。
* vCardの<code>PHOTO</code>は、<code><img class="photo" src="..." alt="...の写真" /></code>または<code><object class="photo" data="..." type="...">...の写真</object></code>になります。
* vCardの<code>UID</code>は、単純に、hCardを特定するURL(またはEMAIL)へのもう一つの意味付けになります。

=== Singular vs. Plural Properties ===
For properties which are singular (e.g. "N" and "FN"), the first descendant element with that class should take effect, any others being ignored.

For properties which can be plural (e.g. "TEL"), each class instance should create a instance of that property.

==== Singular properties ====

Singular properties: "FN", "N", "BDAY", "TZ", "GEO", "SORT-STRING", "UID", "CLASS".

All other properties are plural. This list has been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====

Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

=== Human vs. Machine readable ===

If an <code><abbr></code> element is used for a property, then the '<code>title</code>' attribute of the <code><abbr></code> element is the value of the property, instead of the contents of the element, which instead provide a human presentable version of the value.

If an <code><a></code> element is used for one or more properties, it must be treated as follows:
# For the "PHOTO" property and any other property that takes a URL as its value, the <code>href="..."</code> attribute provides the property value.
# For other properties, the element's content is the value of the property.

If an <code><img></code> element is used for one or more properties, it must be treated as follows:
# For the "PHOTO" property and any other property that takes a URL as its value, the <code>src="..."</code> attribute provides the property value.
# For other properties, the <code><img></code> element's '<code>alt</code>' attribute is the value of the property.

If an <code><object></code> element is used for one or more properties, it must be treated as follows:
# For the "PHOTO" property and any other property that takes a URL as its value, the <code>data="..."</code> attribute provides the property value.
# For other properties, the element's content is the value of the property.

=== 値の抽出 ===

あるプロパティに一致する要素があっても、その要素の一部のみをそのプロパティの値として使用すべき場合があります。
これは典型的には、TELに対するTYPE=HOMEや、TYPE=WORKのようにプロパティが下位の型を持つ場合におこります。
このため、要素中のプロパティの値となる部分を指定するための特別のクラス名"<code>value</code>"が導入されています。
例:ここにhCardの自宅の電話番号をマークアップするためのhCardの一部があります。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardの断片は次のように表示することができます:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>

=== 例外となるプロパティ ===

vCardには意味のないプロパティ、または、すでにウェブページのなかではすでにその意味が含まれているものがあります。このセクションでは、それらのプロパティについて、どうしたら良いか(または何をすべきでないか)を説明します。

# '''NAME''', '''PROFILE''', '''SOURCE''', '''PRODID''', '''VERSION''' properties as defined in Sections 2.1.2, 2.1.3, 2.1.4, 3.6.3, 3.6.9 of RFC 2426. Content publishers MUST NOT use these properties in their hCards, and as such, hCard consumers/parsers MUST IGNORE these properties if they are found within an hCard. Instead. hCard to vCard converters SHOULD use the title of the page where the hCard is found (e.g. the <code><title></code> element in (X)HTML documents) to construct the NAME property, MAY output a PROFILE value of "<code>VCARD</code>" per RFC 2426, SHOULD use the URL of the page where the hCard is found to construct the SOURCE property (e.g. perhaps as a parameter to a URL/service that converts hCards to vCards), for an output vCard stream (e.g. a .vcf file). Only services/applications that output actual vCards should write the PRODID property, with the product identifier for said service/application. Similarly only such services/applications should write the VERSION property, with the value "3.0" (without quotes) per RFC2426 Section 3.6.9.

=== 組織の連絡先情報 ===

"FN"と"ORG"プロパティが完全に同じ値を持つ場合、(典型的にはclass="fn org"のように、一つの要素に両方が指定されている場合)、そのhCardは、会社または組織の連絡先情報を表し、そのように取り扱われるべきです。この場合、hCardの作成者は、"N"プロパティを設定しないか、"N"プロパティとその全ての下位プロパティの値を空文字列に設定するかのどちらかでなくてはいけません(MUST)。パーザーは存在しない"N"プロパティを、"N"とその全ての下位プロパティの値を空文字列に設定したものとして解釈します。

=== Implied "n" Optimization ===

vCardでは"N"プロパティを必須となっていますが、vCard仕様(RFC 2426)の終わり近くにある著者達のvCardには"N"プロパティが含まれていません。(p.38) この明らかな矛盾は、仕様書上にある例のような場合に関して、単に"FN"プロパティの値から"N"プロパティの値を導くことができるようにすれば解決します。hCardでは明示的にそれを行います。

もし"FN"と"ORG"がおなじでなく(全セクション参照)、"FN"プロパティの値が正確に2語(空白で区切られた)からなり、さらに明示的な"N"プロパティがない場合、"N"プロパティは"FN"から導出されます。"FN"が1語のみ、または3語以上の場合は、hCardの作成者は"N"を明示的にマークアップしなければなりません(MUST)。これについては、組織の連絡先情報の場合は例外となります。 [http://microformats.org/wiki/hcard-ja#Organization_Contact_Info 上記を参照]

# "FN"内容は空白により2語に分割されます。
# "FN"の最初の語は"N"プロパティの"given-name"として解釈されます。
# "FN"の''2番目/最後''の語は"N"プロパティの"family-name"として解釈されます。
# 例外: もしも最初の語がカンマ","で終わっているか、 2番目の語が1文字(または後ろに余分のピリオド"."が付加されたもの)である場合、最初の語(最後にカンマがあればそれを取り除いたもの)は"family-name"として、2番目の語は"given-name"として解釈されます。

これにより、人物の記述について、以下のような典型的なケースを単純化できます。
* given-name (space) family-name
* family-name (comma) given-name
* family-name (comma) given-name-first-initial
* family-name (space) given-name-first-initial (optional period)

=== Implied "nickname" Optimization ===

Due to the prevalence of the use of nicknames/handles/usernames on the Web in actual content published on the Web (e.g. authors of [[hReview|reviews]]), hCard also has an implied "nickname" optimization to handle this.

Similar to the implied "n" optimization, if "FN" and "ORG" are not the same, and the value of the "FN" property is exactly one word, and there is no explicit "N" property, then:

# The content of the "FN" is treated as a "nickname" property value.
# Parsers should handle the missing "N" property by implying empty values for all the "N" sub-properties.

Note: the hCard may have additional explicit "nickname" property values in addition to the implied nickname.

=== Implied "organization-name" Optimization ===

The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents MUST be treated as the "organization-name".

=== Tags as Categories ===

Categories in hCard can optionally be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== ルートクラス名 ===
hCardのルートとなるクラス名は"vcard"です。

=== プロパティリスト ===
以下はhCardのプロパティのリストです。(下位のプロパティは、括弧の中に示します。)これらはvCardから取ったものです。

* fn, n (family-name, given-name, additional-name, honorific-prefix, honorific-suffix), nickname, sort-string
* url, email (type, value), tel (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== Property Notes ===
* tel - Authors MAY want to follow the E.123 standard for writing values of telephone numbers.

==== type subproperty values ====

The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See RFC 2426 sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their RFC 2426 definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard RFC 2426 converted into hCard.

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)

=== Informative References ===
* Contributed from http://developers.technorati.com/wiki/hCard.
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 20040930]
* [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 20040910]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}
<nowiki>Insert non-formatted text here</nowiki>

hcard-ja

2007-10-27T15:12:15Z

Vantguarde:

<h1>hCard</h1>
{{TOC-right}}
hCardはvCard ([[rfc-2426|RFC2426]]) のプロパティと値を用い、[[semantic-xhtml|セマンティックなXHTML]]で人や会社、組織や場所を表現するシンプルなフォーマットです。hCardは[[microformats-ja|microformats]]のひとつであり、(X)HTMLやAtom、RSSやその他のXMLに埋め込むことができます。

hCardを利用してみたいですか？ではまず、[http://microformats.org/code/hcard/creator hCard creator]を使い、コンタクト情報を公開してください。または、[[hcard-authoring|hCard authoring tips]]を読み、あなたのコンタクトページをhCardでマークアップしてください。

== hCard仕様書 ==

; 編集者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
; 作成者: [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
: [http://suda.co.uk/ Brian Suda]

; 謝辞: [[hcard#Inspiration_and_Acknowledgements|謝辞のセクション]]をご覧ください。

権利に関する情報は、[[hcard#Copyright|著作権]]と[[hcard#Patents|特許]]のセクションをご覧ください。

== Introduction ==
The vCard standard ([http://www.ietf.org/rfc/rfc2426.txt RFC2426]), has been broadly interoperably implemented (e.g. Apple's "Address Book" application built into MacOSX).

In addition, many bloggers identify themselves by name and discuss their friends and family. With just a tad bit of structure, bloggers can discuss people in their blog(s) in such a way that spiders and other aggregators can retrieve this information, automatically convert them to vCards, and use them in any vCard application or service.

This specification introduces the '''hCard''' format, which uses a 1:1 representation of the properties and values of the aforementioned vCard standard, in semantic XHTML. Bloggers can both embed hCards directly in their web pages, and style them with CSS to make them appear as desired. In addition, hCard enables applications to retrieve information directly from web pages without having to reference a separate file.

Use the [http://microformats.org/code/hcard/creator hCard creator] and copy the HTML code it generates to your blog or website to publish your contact info.

== Semantic XHTML Design Principles ==
{{semantic-xhtml-design-principles}}

== フォーマット ==
=== 一般 ===
vCard標準([http://www.ietf.org/rfc/rfc2426.txt RFC2426])が、hCardの基礎となっています。

hCardの基本フォーマットは、vCardのオブジェクト/プロパティ名を小文字にしたものをクラス名として使用します。vCardオブジェクト上での入れ子関係は、そのままXHTML要素の入れ子関係に置き換えられます。

=== More Semantic Equivalents ===
プロパティの中には、HTML要素で表現するほうがより良くその意味を伝えるものがあります。以下のプロパティはそれに続く(X)HTMLで表現すべき(SHOULD)です。
* vCardの<code>URL</code>は、hCardでは<code>class="vcard"</code>を含む要素の内部にある<code><a class="url" href="...">...</a></code>になります。
* 同様にvCardの<code>EMAIL</code>は、<code><nowiki><a class="email" href="mailto:...">...</a></nowiki></code>になります。
* vCardの<code>PHOTO</code>は、<code><img class="photo" src="..." alt="...の写真" /></code>または<code><object class="photo" data="..." type="...">...の写真</object></code>になります。
* vCardの<code>UID</code>は、単純に、hCardを特定するURL(またはEMAIL)へのもう一つの意味付けになります。

=== Singular vs. Plural Properties ===
For properties which are singular (e.g. "N" and "FN"), the first descendant element with that class should take effect, any others being ignored.

For properties which can be plural (e.g. "TEL"), each class instance should create a instance of that property.

==== Singular properties ====

Singular properties: "FN", "N", "BDAY", "TZ", "GEO", "SORT-STRING", "UID", "CLASS".

All other properties are plural. This list has been derived by analyzing the semantics of the individual properties in vCard RFC2426 and determining logically that they MUST be singular per their semantics. See [[hcard-singular-properties]] for explanations.

==== Plural Properties Singularized ====

Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

=== Human vs. Machine readable ===

If an <code><abbr></code> element is used for a property, then the '<code>title</code>' attribute of the <code><abbr></code> element is the value of the property, instead of the contents of the element, which instead provide a human presentable version of the value.

If an <code><a></code> element is used for one or more properties, it must be treated as follows:
# For the "PHOTO" property and any other property that takes a URL as its value, the <code>href="..."</code> attribute provides the property value.
# For other properties, the element's content is the value of the property.

If an <code><img></code> element is used for one or more properties, it must be treated as follows:
# For the "PHOTO" property and any other property that takes a URL as its value, the <code>src="..."</code> attribute provides the property value.
# For other properties, the <code><img></code> element's '<code>alt</code>' attribute is the value of the property.

If an <code><object></code> element is used for one or more properties, it must be treated as follows:
# For the "PHOTO" property and any other property that takes a URL as its value, the <code>data="..."</code> attribute provides the property value.
# For other properties, the element's content is the value of the property.

=== 値の抽出 ===

あるプロパティに一致する要素があっても、その要素の一部のみをそのプロパティの値として使用すべき場合があります。
これは典型的には、TELに対するTYPE=HOMEや、TYPE=WORKのようにプロパティが下位の型を持つ場合におこります。
このため、要素中のプロパティの値となる部分を指定するための特別のクラス名"<code>value</code>"が導入されています。
例:ここにhCardの自宅の電話番号をマークアップするためのhCardの一部があります。<br />

vCard:
<pre><nowiki>
TEL;TYPE=HOME:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

このhCardの断片は次のように表示することができます:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</div>

=== 例外となるプロパティ ===

vCardには意味のないプロパティ、または、すでにウェブページのなかではすでにその意味が含まれているものがあります。このセクションでは、それらのプロパティについて、どうしたら良いか(または何をすべきでないか)を説明します。

# '''NAME''', '''PROFILE''', '''SOURCE''', '''PRODID''', '''VERSION''' properties as defined in Sections 2.1.2, 2.1.3, 2.1.4, 3.6.3, 3.6.9 of RFC 2426. Content publishers MUST NOT use these properties in their hCards, and as such, hCard consumers/parsers MUST IGNORE these properties if they are found within an hCard. Instead. hCard to vCard converters SHOULD use the title of the page where the hCard is found (e.g. the <code><title></code> element in (X)HTML documents) to construct the NAME property, MAY output a PROFILE value of "<code>VCARD</code>" per RFC 2426, SHOULD use the URL of the page where the hCard is found to construct the SOURCE property (e.g. perhaps as a parameter to a URL/service that converts hCards to vCards), for an output vCard stream (e.g. a .vcf file). Only services/applications that output actual vCards should write the PRODID property, with the product identifier for said service/application. Similarly only such services/applications should write the VERSION property, with the value "3.0" (without quotes) per RFC2426 Section 3.6.9.

=== 組織の連絡先情報 ===

"FN"と"ORG"プロパティが完全に同じ値を持つ場合、(典型的にはclass="fn org"のように、一つの要素に両方が指定されている場合)、そのhCardは、会社または組織の連絡先情報を表し、そのように取り扱われるべきです。この場合、hCardの作成者は、"N"プロパティを設定しないか、"N"プロパティとその全ての下位プロパティの値を空文字列に設定するかのどちらかでなくてはいけません(MUST)。パーザーは存在しない"N"プロパティを、"N"とその全ての下位プロパティの値を空文字列に設定したものとして解釈します。

=== Implied "n" Optimization ===

vCardでは"N"プロパティを必須となっていますが、vCard仕様(RFC 2426)の終わり近くにある著者達のvCardには"N"プロパティが含まれていません。(p.38) この明らかな矛盾は、仕様書上にある例のような場合に関して、単に"FN"プロパティの値から"N"プロパティの値を導くことができるようにすれば解決します。hCardでは明示的にそれを行います。

もし"FN"と"ORG"がおなじでなく(全セクション参照)、"FN"プロパティの値が正確に2語(空白で区切られた)からなり、さらに明示的な"N"プロパティがない場合、"N"プロパティは"FN"から導出されます。"FN"が1語のみ、または3語以上の場合は、hCardの作成者は"N"を明示的にマークアップしなければなりません(MUST)。これについては、組織の連絡先情報の場合は例外となります。 [http://microformats.org/wiki/hcard-ja#Organization_Contact_Info 上記を参照]

# "FN"内容は空白により2語に分割されます。
# "FN"の最初の語は"N"プロパティの"given-name"として解釈されます。
# "FN"の''2番目/最後''の語は"N"プロパティの"family-name"として解釈されます。
# 例外: もしも最初の語がカンマ","で終わっているか、 2番目の語が1文字(または後ろに余分のピリオド"."が付加されたもの)である場合、最初の語(最後にカンマがあればそれを取り除いたもの)は"family-name"として、2番目の語は"given-name"として解釈されます。

これにより、人物の記述について、以下のような典型的なケースを単純化できます。
* given-name (space) family-name
* family-name (comma) given-name
* family-name (comma) given-name-first-initial
* family-name (space) given-name-first-initial (optional period)

=== Implied "nickname" Optimization ===

Due to the prevalence of the use of nicknames/handles/usernames on the Web in actual content published on the Web (e.g. authors of [[hReview|reviews]]), hCard also has an implied "nickname" optimization to handle this.

Similar to the implied "n" optimization, if "FN" and "ORG" are not the same, and the value of the "FN" property is exactly one word, and there is no explicit "N" property, then:

# The content of the "FN" is treated as a "nickname" property value.
# Parsers should handle the missing "N" property by implying empty values for all the "N" sub-properties.

Note: the hCard may have additional explicit "nickname" property values in addition to the implied nickname.

=== Implied "organization-name" Optimization ===

The "ORG" property has two subproperties, organization-name and organization-unit. Very often authors only publish the organization-name. Thus if an "ORG" property has no "organization-name" inside it, then its entire contents MUST be treated as the "organization-name".

=== Tags as Categories ===

Categories in hCard can optionally be represented by tags with [[rel-tag]]. When a category property is a rel-tag, the tag (as defined by rel-tag) is used for that category.

=== ルートクラス名 ===
hCardのルートとなるクラス名は"vcard"です。

=== プロパティリスト ===
以下はhCardのプロパティのリストです。(下位のプロパティは、括弧の中に示します。)これらはvCardから取ったものです。

* fn, n (family-name, given-name, additional-name, honorific-prefix, honorific-suffix), nickname, sort-string
* url, email (type, value), tel (type, value)
* adr (post-office-box, extended-address, street-address, locality, region, postal-code, country-name, type, value), label
* geo (latitude, longitude), tz
* photo, logo, sound, bday
* title, role, org (organization-name, organization-unit)
* category, note
* class, key, mailer, uid, rev

=== Property Notes ===
* tel - Authors MAY want to follow the E.123 standard for writing values of telephone numbers.

==== type subproperty values ====

The 'type' subproperty in particular takes different values depending on which property it is a subproperty of. These 'type' subproperty values are case-INSENSITIVE, meaning "Home" is the same as "home", as well as multivalued, e.g. a tel can be home and preferred:

vCard:
<pre><nowiki>
TEL;TYPE=HOME,PREF:+1.415.555.1212
</nowiki></pre>

hCard:
<pre><nowiki>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</nowiki></pre>

This could be displayed as:

<div style="border: thin dashed black; width: 95%; padding: .5em 1em; ">
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</div>

The following lists are ''informative''. See RFC 2426 sections 3.2.1 ADR, 3.3.1 TEL, and 3.3.2 EMAIL respectively for normative type values. They are repeated here for convenience. Default type subproperty value(s) is(are) first in each list and indicated in ALL CAPS. types may be multivalued.

* adr type: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* tel type: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* email type: INTERNET, x400, pref, "other IANA registered address types"

=== XMDP Profile ===

See [[hcard-profile]] for the [http://gmpg.org/xmdp XMDP] profile of hCard which contains the above complete list of properties, with references to their RFC 2426 definitions.

=== Parsing Details ===

See [[hcard-parsing|hCard parsing]].

== Examples ==

This section is informative.

=== Sample vCard ===

Here is a sample vCard:

<pre><nowiki>
BEGIN:VCARD
VERSION:3.0
N:Çelik;Tantek
FN:Tantek Çelik
URL:http://tantek.com/
ORG:Technorati
END:VCARD
</nowiki></pre>

and an equivalent in hCard with various elements optimized appropriately. See [[hcard-example1-steps| hCard Example 1]] for the derivation.

<pre><nowiki>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
<div class="org">Technorati</div>
</div>
</nowiki></pre>

This hCard might be displayed as:
<div style="border: thin dashed black; width: 95%; padding: .5em 1em;">
[http://tantek.com/ Tantek Çelik]<br />
Technorati
</div>

Note: The version information is unnecessary in hCard markup directly since the version will be defined by the profile of hCard that is used/referred to in the 'profile' attribute of the <head> element.

=== More Examples ===
See [[hcard-examples|hCard examples]] for more examples, including all examples from vCard RFC 2426 converted into hCard.

== Examples in the wild ==
This section is '''informative'''. The number of hCard examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcard-examples-in-wild|separate page]].

See [[hcard-examples-in-wild|hCard Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCard implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcard-implementations|separate page]].

See [[hcard-implementations|hCard Implementations]].

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [http://www.ietf.org/rfc/rfc2426.txt vCard RFC2426]
* [http://www.itu.int/rec/T-REC-E.123-200102-I/en ITU recommendation E.123] format of telephone numbers (chargeable document)

=== Informative References ===
* Contributed from http://developers.technorati.com/wiki/hCard.
* [http://www.w3.org/2002/12/cal/rfc2426 HTML reformatted version of RFC2426]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://tantek.com/log/2004/09.html#hcard hCard term introduced and defined on the Web, 20040930]
* [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 20040910]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 Wikipedia summary of ITU-T Recommendation E.123] - for "TEL" values.
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]

==== Specifications That Use hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== Similar Work ====
* [http://www.intertwingly.net/wiki/pie/PaceBetterPersonElement Atom PaceBetterPersonElement]
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp]

== Further Reading ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] by Garrett Dimon has a good intro to hCard
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] by Drew McLellan
* [http://www.naturalsearchblog.com/archives/2006/09/28/tips-for-local-search-engine-optimization-for-your-site/ Local Search Engine Optimization using Microformats] by Chris Silver Smith
* [http://thedredge.org/ Andrew D. Hume] has written a blog post on [http://usabletype.com/articles/2005/usable-microformats/ usable microformats] which discusses hCard
* [http://www.thefutureoftheweb.com/blog/2006/1/hcard Jesse Skinner's introduction to hCard]
* [http://blog.usweb.com/ Shaun Shull's] great post on [http://blog.usweb.com/archives/how-microformats-affect-search-engine-optimization-seo How Microformats Affect SEO], including his [[hcard|hCard]] as an example.
* [http://24ways.org/2006/styling-hcards-with-css 24 Ways: Styling hCards with CSS] A 24 Ways article - John Allsopp on styling hCard using CSS
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcard hCard tag]
* [http://www.rfc-editor.org/rfc/rfc4770.txt RFC 4770 - Extensions for Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}
<nowiki>Insert non-formatted text here</nowiki>

rel-nofollow-ja

2007-10-26T14:28:21Z

Vantguarde: recreated.

= rel="nofollow" =
__TOC__

== 2005-01-10版 ==

=== 編集者 ===
* [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
* [http://epeus.blogspot.com/ Kevin Marks] ([http://technorati.com Technorati, Inc.])

=== 原案 ===
* [http://www.google.com/googleblog/ Matt Cutts] ([http://google.com Google, Inc])
* [http://www.shellen.com/ Jason Shellen] ([http://www.blogger.com Blogger]/[http://www.google.com Google])

=== 著作権 ===
{{MicroFormatCopyrightStatement2005}}
* [[User:Tantek|Tantek]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
** When all authors/editors have done so, we can remove the MicroFormatCopyrightStatement template reference and replace it with the MicroFormatPublicDomainContributionStatement.

=== 特許 ===
{{MicroFormatPatentStatement}}

== 概要 ==
rel-nofollowは[[microformats-ja|microformats]]のひとつで、[[elemental-microformat|単純microformat]]に属するものです。<code>rel="nofollow"</code>をハイパーリンクに加えることで、検索エンジンなどリンクを解析するユーザーエージェントが、リンク先を重み付けやランキングの指標として用いないようにします。ユースケースとして、第三者がblogにつけたコメントや、作者が推奨はしないもののリンクしておきたいものがあります。より詳しく賛成や反対の意味づけを行いたい場合は、[[vote-links|VoteLinks]]をご覧ください。

== XMDPプロファイル==
<pre><nowiki>
<dl class="profile">
<dt id="rel">rel</dt>
<dd><p>
<a rel="help" href="http://www.w3.org/TR/html401/struct/links.html#adef-rel">
HTML4 definition of the 'rel' attribute.</a>
Here is an additional value.</p>
<dl>
<dt id="nofollow">nofollow</dt>
<dd>Indicates that the referred resource was not necessarily linked to
by the author of the page, and thus said reference should not afford
the referred resource any additional weight or ranking by user agents. </dd>
</dl>
</dd>
</dl>
</nowiki></pre>

== 規範的な情報 ==
* [http://gmpg.org/xmdp/ XMDP]
* http://googleblog.blogspot.com/2005/01/preventing-comment-spam.html

== 参考情報 ==
*リンク先の文書について、賛成や反対を表したい場合には、[[vote-links|VoteLinks]]を用います。rel-nofollowとVoteLinksを実装する方は、<code>rev="vote-abstain"</code>や<code>rev="vote-against"</code>などの値を、重み付けやランキングに用いないようにしてください。
* このフォーマットは、http://developers.technorati.com/wiki/RelNoFollow からの寄稿です。

== 未解決の問題 ==
rel-nofollowに関し、[http://lists.w3.org/Archives/Public/www-html W3C www-html メーリングリスト]をはじめいくつかのフォーラムから問題提起がなされています。問題は、大きく4つのカテゴリに分けられます。

* '''定義''' - nofollowは関係よりも、ユーザーエージェントが取るべき挙動の指定を意味するように感じる。relの値はソースとリンク先の関係を表す名詞であるべきだ。
* '''名前''' - nofollow はよい名前ではない。
** 車輪の再発明だ。他のロボットよけ仕様 (robots.txt, meta robots) と変わりない。
** 名前ががきちんと目的を説明していない。「このリンクをたどるな」ではなく「このリンクに重み付けを行うな」であるべきだ。[http://www.w3.org/mid/opsk3cccj9lo81gp@quark Asbjørn Ulsberg]
** 名詞ではない。
** 代替案:
*** noendorse - [http://lists.w3.org/Archives/Public/www-html/2005Jan/0046.html Micah Dubinko]
*** none
*** noweight
*** unendorsed - [http://lists.w3.org/Archives/Public/www-html/2005Jan/0057.html Lachlan Hunt]
*** unrelated - [http://lists.w3.org/Archives/Public/www-html/2005Jan/0049.html Jens Meiert]
*** untrusted
*** nonauth - [http://www.mnot.net/blog/2003/12/29/comment_spam_and_google Mark Baker]
*** norank - [http://www.digitalburg.com/ Ben Pierce]
* '''有効性''' - nofollowはspamに対し効果がない。
* '''巻き添え''' - ツールが自動的に第三者からのリンクにnofollowをつけた場合、spamではない正当なリンクが無視されたり、重み付けを行われなくなる。その結果、そのリンク先において、あまり良くない事が起こる可能性がある。

=== その他の問題 ===
rel-nofollowに関し述べられている問題は、次のサイトでも見つけることが出来ます。
* http://www.nonofollow.net/

rel-tag-ja

2007-10-26T13:46:22Z

Vantguarde: Sync'd

<h1> rel-tag </h1>

__TOC__

== 仕様ドラフト 2005-01-10 ==
; 編者/作者
:[http://tantek.com/ Tantek Çelik]
:[http://epeus.blogspot.com/ Kevin Marks]

; 原案
:[http://powazek.com/ Derek Powazek]

=== 著作権 ===
{{MicroFormatCopyrightStatement2004-ja}}
* [[User:Tantek|Tantek]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
** When all authors/editors have done so, we can remove the MicroFormatCopyrightStatement template reference and replace it with the MicroFormatPublicDomainContributionStatement.

=== 特許 ===
{{MicroFormatPatentStatement-ja}}

== 概要 ==
[[rel-tag-ja|rel-tag]]は[[microformats-ja|microformats]]のひとつです。ハイパーリンクに<code>rel="tag"</code>を書き加える事により、リンク元のページに対しページ作者が定義した「タグ（キーワードやテーマ）」を関連づけることができます。
タグはblogの記事内容すべてに関係する言葉とは限りません。たとえば次のようなリンクでタグを関連づけるとします。

<pre><nowiki><a href="http://technorati.com/tag/tech" rel="tag">tech</a></nowiki></pre>

これは作者がこのWebページ（または内容の一部）に「tech」というタグをつけていることを意味します。

リンク先のページはWeb上に存在するべき（SHOULD）であり、またタグの意味はリンクテキストの内容よりも、リンク先のページが持つ情報が優先されます。たとえば次のようなマークアップでページに対しタグ付けを行ったとします。

<pre><nowiki><a href="http://technorati.com/tag/tech" rel="tag">fish</a></nowiki></pre>

URLの最後にある単語がタグの意味として扱われるので、この場合ページのタグは「fish」ではなく「tech」となります。

== rel-tagの意図、範囲 ==
rel-tagはWebページ（又はその一部）に「タグ付け」をする目的で作られました。このため、任意のURLやページ外部のコンテンツに対し、rel-tagによりタグ付けを行える様にはできていません。現在のページから外部のURLへのタグ付けの一般的な構文についての要望はありますが、rel-tagにおいてその議論はなされるべきでないと考えています。[[xfolk|xFolk]]や[[hreview|hReview]]にてURLのタグ付けについて考えられているので、そちらを参照してください。

タグを用いるシステムにおいては、タグの表現に特化したrel-tagは優れたフォーマットと言えるでしょう。

== XMDPプロファイル ==
<pre><nowiki>
<dl class="profile">
<dt id="rel">rel</dt>
<dd><p>
<a rel="help" href="http://www.w3.org/TR/html401/struct/links.html#adef-rel">
HTML4 definition of the 'rel' attribute.</a>
Here is an additional value.</p>
<dl>
<dt id="tag">tag</dt>
<dd>Indicates that the referred resource serves as a "tag",
or keyword/subject, for the referring page.</dd>
</dl>
</dd>
</dl>
</nowiki></pre>

== タグスペースとタグの扱い ==
タグはURIの中に分かりやすい形で埋め込まれています、そのためURIからタグを機械的に抽出することが比較的容易です。具体的に説明すると、タグはURIパスの最後にある単語（一番後ろの"/"より後の文字列）となります。たとえば<pre><nowiki>http://www.example.com/tags/foo</nowiki></pre>というURIが示すタグは「foo」となります。

このため、ある二つのURIをタグとみなし比較する場合は、まず始めにタグをパスの最後から抽出することが推奨（SHOULD）されます。

''タグの抽出・比較についてはもう少し標準的な仕組みが必要だと考えています。''

rel="tag"を埋め込んだハイパーリンクが示す先はタグスペース（同じタグの付いた文書の一覧またはタグの定義）であるよう求められています。たとえば、リンク先の文書が次のURLで表されるとします。

<pre><nowiki>http://technorati.com/tag/tech </nowiki></pre>

この場合、この文書は「tech」というタグに関するタグスペースであるとみなされます。

タグとなる文字列はURLパスの最後にのみ記すことを許されています。これはクエリパラメータやフラグメント識別子がタグとして認識されないことを意味します。さて、次のURLはどう扱われるでしょうか。

<pre><nowiki>http://technorati.com/tag/tech?tag=fish#emu </nowiki></pre>

この場合も先述のとおり「tech」というタグに関するもので、「fish」や「emu」についてのものではないことに注意してください。

タグスペースに関する決まり事は「タグとなる文字列がURLパスの最後にあること」のみです。このためタグスペースはどのドメインにおいても提供可能となっています。ページ作者はいくつかのタグスペースを選びリンクすることで、特定の意味をタグに持たせることが可能です。たとえばWikipediaのページをタグスペースに用いる事ができます。

<pre><nowiki> http://en.wikipedia.org/wiki/Technology </nowiki></pre>

この場合、タグは「Technology」を指します。

URLの末にあるスラッシュは無視されます。つまり次のURL

<pre><nowiki> http://technorati.com/tag/Technology/ </nowiki></pre>
これをrel-tagに用いる場合、最後のスラッシュは取り除かれ、
<pre><nowiki> http://technorati.com/tag/Technology </nowiki></pre>
と同じ扱いを受けることになります。

== タグのエンコード ==
タグにおけるスペースは「<code>+</code>」又は「<code>%20</code>」へとエンコードして含めることが可能です。Unicode文字は[http://www.ietf.org/rfc/rfc3986.txt RFC 3986]で述べられている様にエンコードされます。たとえば次のようになります。

<pre><nowiki><a href="http://technorati.com/tag/Sant%C3%A9+et+bien-%C3%AAtre" rel="tag">Santé et bien-être</a> </nowiki></pre>

Wikipediaをタグスペースとして利用する場合には「<code>%20</code>」を利用すべきです。Wikipediaは「+」を「<code>%2B</code>」へと置換してしまうため、通常ページのタイトルに存在しない「+」を表示させてしまうからです。

== 目にみえるメタデータとしてのタグ ==
<code>rel="tag"</code>を含んだハイパーリンクは、Webページ上に現れるよう期待されています。これはページ上に現れず、閲覧者の目に届く事がほとんどないmetaキーワードとrel-tagの大きな違いです。タグがWebページに表示されるため、metaキーワードよりも弾力的にキーワードspamなどの問題に対処することができると考えています。

タグのリンクが目に見えることにより、ページ閲覧者はそのリンクが悪用されたものかを簡単に知ることができます。このためリンクを用いた不正行為をある程度抑止できると考えています。どんな目に見えないメタデータが生成されているのかを知らないページ作成者にも効果的でしょう。

このため、<code><link rel="tag" href="..." /></code> のような目に見えないタグリンクの表現は実装されるべきではありません（SHOULD NOT）。

== rel-tagの利用例 ==
このセクションは'''参考情報'''です。

以下はrel-tagを実装したWebサイトのリストです。rel-tagをパースしている、又はタグのインデックスを作っていたり、タグの整理が行われているWebサイトの例をお探しなら、きっとこのリストが役立つでしょう。もしあなたがrel-tagを利用していたら、気軽に'''このリストの上'''に追加してください。リストが大きくなったら、別のページにて紹介する予定です。

* [http://www.auctionlink.com.au AuctionLink]では[http://www.auctionlink.com.au/TagList/Auctioneers/ Auction Sales Listings]のタグにrel-tagを用いています。
** Could also use [[hcard|hCard]], e.g. on [http://www.auctionlink.com.au/Auctioneers/Auctioneer/Bonhams_Goodman_1/] [[User:AndyMabbett|Andy Mabbett]]
* Christian Hessは[http://www.hess-cr.com blog]と他のページでrel-tagを用いています。
* [http://spacedust.atspace.com/ Spacedust]はギャラリーページのマークアップにrel-tagを利用しています。
* [http://my.opera.com/dstorey/blog/ My Opera]では、全てのユーザのblogエントリがrel-tagを利用しています。
* [http://dev.opera.com/articles/view/making-wii-friendly-pages/ Dev Opera]では、記事のタグにrel-tagが使われています。
* [http://www.international.unt.edu UNT International]はほとんどのページにおいて、カテゴリをrel-tagで表現しています。
* [http://yedda.com Yedda] - Yeddaは利用者が自分につけたタグ、そしてYeddaにて質問された事柄につけられたタグにrel-tagを利用しています。
* [http://www.lingr.com Lingr]はユーザが入力したすべてのタグを表示しています。
* [http://odeo.com ODEO]では[http://odeo.com/blog/2005/07/adding-microformats-to-odeo.html rel-tagを利用しています]。
* [http://eventful.com Eventful]ではユーザがつけたタグの表現に、rel-tagが使われています。

== 実装 ==
このセクションは'''参考情報'''です。

次に紹介されているリストは、rel-tagを実装しているアプリケーションのものです。もしあなたがrel-tagを利用したサービスやソフトウェアを開発していたら、気軽に'''このリストの上'''に追加してください。リストが大きくなったら、別のページにて紹介する予定です。

* [http://ikiwiki.info ikiwiki] generates rel-tag for all tagged pages (as of version 2.6)
* [http://www.hubtag.com HubTag] helps users find a unique tag across the web for their event - eg. JohnAndBettysWeddingWimbledonMarch07
* [http://www.necctar.com Necctar] is a search engine exclusively based on tag microformat parsing and processing. Necctar uses tags entered by bloggers to index the world wide web
* Nutchは[[rel-tag]]のパーサを[http://www.mail-archive.com/nutch-commits@lucene.apache.org/msg01014.html svnレポジトリにコミットしました]。
* [http://webstandards.org/ Web Standards Project]が提供している[http://www.webstandards.org/action/dwtf/microformats/ Dreamweaver拡張スイート]を導入することにより、Dreamweaver 8でrel-tagを用いたタギングができます。
* スライドショー作成サービス[http://scooch.gr0w.com/ Scooch]では、作成者がスライドショーに埋め込んだタグのタグクラウドを見ることができます。
* Weblogシステム[http://www.s9y.org Serendipity]のFreetagプラグインは、エントリのタグ付けを可能とします。（FreetagプラグインはSPARTACUSのなかにあります。）
* [http://placenamehere.com/TXP/pnh_mf/ pnh_mf]は[http://textpattern.com/ Textpattern]でrel-tagや他のmicroformatsをテンプレートやエントリで利用可能とするプラグインです。[http://placenamehere.com/ Chris Casciano]により制作されました。
* [http://www.truist.com/blog/493/trutags-a-tagging-plugin-for-textpattern tru_tags]は[http://textpattern.com/ Textpattern]で、キーワード欄からエントリのタグ付けを可能とするプラグインです。
* [http://news.livejournal.com/86492.html?thread=24881884 LiveJournal]には[http://www.livejournal.com/support/faq.bml?cat=tags タグに関するサポートページ]が用意されています。
* [http://trac.labnotes.org/cgi-bin/trac.cgi/wiki/TagsLinks TagsLinks]を用いて、ページに埋め込まれたタグと、他のサービスが用意したタグスペースをつなげることができます。
* [http://dev.wp-plugins.org/wiki/BunnysTechnoratiTags WordPress用のタグ付けプラグイン]です。
** Note that some sites using WordPress (http://microformatique.com/ for instance) are getting incorrect tags. The tag is ?cat=12 instead of the actual tag value.
* [http://noone.org/blog/tags/Tagging Blosxom用のタグ付けプラグイン]です。
* Technoratiはrel-tagを実装した最初のサービスです。[http://technorati.com/tag/ Technorati Tags]から、Technoratiがインデックスしているタグを見ることが出来ます。
* [http://consumingexperience.blogspot.com/2005/12/updated-multiple-word-technorati-tag.html Bloggerでタグを利用するためのGreasemonkeyスクリプト]です。
* [http://tools.microformatic.com/help/xhtml/rel-lint/ rel-lint]は[[User:DrewMcLellan|Drew McLellan]]による、rel-tagを検証するツールです。

== 参照 ==
=== 標準仕様 ===
* [http://www.w3.org/TR/REC-html40/ HTML 4]
* [http://www.w3.org/TR/xhtml1/ XHTML 1]
* [http://gmpg.org/xmdp/ XMDP]
* RFC 3986ではURIの構文を規定しています。Section 3.3にURLパスとパスセグメントに関する記述があります。

=== 参考 ===
* [[hreview|hReview]]ではrel-tagを一般的なタグ、またレート付けに用いています。
* [[xfolk|xFolk]]はrel-tagを用いて、タグ付けされたリソースの分散型処理を可能としています。
* [http://developers.technorati.com/wiki/attentionxml Attention.XML]はrel-tagを用い、読者がページやweblogの投稿、又はフィードへのタグ付けを行えるようにしています。
* [[hcard|hCard]]では、rel-tagを用いたカテゴリの作成が可能です。
* [[hcalendar|hCalendar]]でも、rel-tagを用いたカテゴリの作成が可能です。
* [http://technorati.com/help/tags.html Using Technorati Tags]で、Technoratiにおけるタグの扱いを知ることが出来ます。
* rel-tagは http://developers.technorati.com/wiki/RelTag からの寄稿により作成されました。
* microformatique.comの[http://microformatique.com/?p=61 Know your rel-tag]に、rel-tagについての説明があります。

== ディスカッション ==
* フィードバックは[[rel-tag-feedback]]にてお願いします。
* [http://www.technorati.com/cosmos/referer.html rel-tagについて言及しているページ]も参照してください。
* これまでの経緯については[http://www.powazek.com/ Derek Powazek]による[http://www.powazek.com/2005/07/000532.html How Tags Happened at Technorati]をお読み下さい。

=== Q&A ===
* rel-tagに関して分からないことがありますか？それがrel属性に関する疑問ならば[[rel-faq|rel FAQ]]を、rel-tagに関する疑問であれば[[rel-tag-faq|rel-tag FAQ]]をお読み下さい。これらのページを読んでも疑問が解消されない場合は、[http://microformats.org/discuss microformats-discuss]にメールを投稿するとよいでしょう。

==Related pages==
{{rel-tag-related-pages}}

XFN-ja

2007-10-26T13:01:51Z

Vantguarde:

<h1>XFN - XHTML Friends Network</h1>

XFN (XHTML Friends Network)は、ハイパーリンクを利用して人間関係を表現するシンプルなフォーマットです。

XFNの仕様や詳細は、[http://www.gmpg.org/xfn/ GMPG.org]で見つけることができます。

* [http://gmpg.org/xfn/ XFNホームページ]
* [http://gmpg.org/xfn/intro XFNの概要]
* [http://gmpg.org/xfn/and/#idconsolidation XFNとrel="me"によるアイデンティティの確立]

このWiki上にも、XFNについて解説している文書があります。

* [[xfn-implementations]]
* [[xfn-brainstorming]]
* [[xfn-clarifications]] - GMPG.orgにあるXFNの情報に取り込まれる予定です
* [[xfn-faq]]

XFN-ja

2007-10-26T13:00:16Z

Vantguarde:

<h1>XFN - XHTML Friends Network</h1>

XFN (XHTML Friends Network)は、ハイパーリンクを利用して人間関係を表現するシンプルなフォーマットです。

XFNの仕様や詳細は、[http://www.gmpg.org/xfn/ GMPG.org]で見つけることができます。

* [http://gmpg.org/xfn/ XFNホームページ]
* [http://gmpg.org/xfn/intro XFNの概要]
* [http://gmpg.org/xfn/and/#idconsolidation XFNとrel="me"によるアイデンティティの確立]

このWiki上にも、XFNについて解説している文書があります。

* [[xfn-implementations]]
* [[xfn-brainstorming]]
* [[xfn-clarifications]] - should eventually be rolled into XFN info on GMPG.org.
* [[xfn-faq]]

rel-nofollow-ja

2007-10-26T12:20:53Z

Vantguarde:

= rel="nofollow" =
__TOC__

== 2005-01-10版 ==

=== 編集者 ===
* [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc.])
* [http://epeus.blogspot.com/ Kevin Marks] ([http://technorati.com Technorati, Inc.])

=== コンセプト ===
* [http://www.google.com/googleblog/ Matt Cutts] ([http://google.com Google, Inc])
* [http://www.shellen.com/ Jason Shellen] ([http://www.blogger.com Blogger]/[http://www.google.com Google])

=== 著作権 ===
{{MicroFormatCopyrightStatement2005}}
* [[User:Tantek|Tantek]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
** When all authors/editors have done so, we can remove the MicroFormatCopyrightStatement template reference and replace it with the MicroFormatPublicDomainContributionStatement.

=== 特許 ===
{{MicroFormatPatentStatement}}

== 概要 ==
RelNoFollow is an [[elemental-microformat|elemental microformat]], one of several [[microformats|microformat]] open standards. By adding <code>rel="nofollow"</code> to a hyperlink, a page indicates that the destination of that hyperlink {{should not}} be afforded any additional weight or ranking by user agents which perform link analysis upon web pages (e.g. search engines). Typical use cases include links created by 3rd party commenters on blogs, or links the author wishes to point to, but avoid endorsing. For more specific endorsement (or lack thereof) semantics, see VoteLinks.

== XMDPプロファイル==
<pre><nowiki>
<dl class="profile">
<dt id="rel">rel</dt>
<dd><p>
<a rel="help" href="http://www.w3.org/TR/html401/struct/links.html#adef-rel">
HTML4 definition of the 'rel' attribute.</a>
Here is an additional value.</p>
<dl>
<dt id="nofollow">nofollow</dt>
<dd>Indicates that the referred resource was not necessarily linked to
by the author of the page, and thus said reference should not afford
the referred resource any additional weight or ranking by user agents. </dd>
</dl>
</dd>
</dl>
</nowiki></pre>

== 規範的な情報 ==
* [http://gmpg.org/xmdp/ XMDP]
* http://googleblog.blogspot.com/2005/01/preventing-comment-spam.html

== 参考情報 ==
* VoteLinks can be used by an author to explicitly state their support for or against, or neutrality toward the destination of a link. Implementers implementing rel="nofollow" and VoteLinks should similarly not afford any additional weight or ranking to links with either <code>rev="vote-abstain"</code> or <code>rev="vote-against"</code>.
* Contributed from http://developers.technorati.com/wiki/RelNoFollow

== 未解決の問題 ==
These are open issues that have been raised about rel="nofollow" that have been raised in various forums, in particular, on the public [http://lists.w3.org/Archives/Public/www-html W3C www-html mailing list]. They have been grouped into four areas.

* '''Definition'''. nofollow indicates a behavior rather than a relationship from which the behavior should be inferred as appropriate for the useragent. rel values should be nouns that indicates what the resource being referenced is in relation to the source.
* '''Name'''. nofollow is a bad name.
** overloading. does not mean the same as robots exclusion standards (robots.txt, meta robots) nofollow.
** does not mean what it says. does not mean "do not follow this link", rather it means " do not add weight from this link". [http://www.w3.org/mid/opsk3cccj9lo81gp@quark Asbjørn Ulsberg]
** not a noun. see above.
** suggested alternatives:
*** noendorse - [http://lists.w3.org/Archives/Public/www-html/2005Jan/0046.html Micah Dubinko]
*** none
*** noweight
*** unendorsed - [http://lists.w3.org/Archives/Public/www-html/2005Jan/0057.html Lachlan Hunt]
*** unrelated - [http://lists.w3.org/Archives/Public/www-html/2005Jan/0049.html Jens Meiert]
*** untrusted
*** nonauth - [http://www.mnot.net/blog/2003/12/29/comment_spam_and_google Mark Baker]
*** norank - [http://www.digitalburg.com/ Ben Pierce]
* '''Efficacy'''. nofollow will not affect spamming behavior.
* '''Collateral Damage'''. If tools automatically add nofollow to all 3rd party links, then many legitimate non-spam links will be ignored or given reduced weight, and thus the destination of such links will be unfortunate casualties.

=== その他の問題 ===
Additional lists of issues raised against rel="nofollow" can be found at the following site(s):
* http://www.nonofollow.net/

Main Page-ja

2007-10-26T12:12:39Z

Vantguarde: /* 他言語でのmicroformats wiki */

<div style="float:right;margin-left:1em">__TOC__</div>

'''Microformats Wikiにようこそ！'''

初めての方は、[[introduction-ja|microformatsの手引き]]からどうぞ。編集を始める前に、[[how-to-play-ja]]を読んでください。

== はじめに ==
* [[posh-ja|<abbr title="Plain Old Semantic HTML">POSH</abbr>]] とは何なのかを理解しましょう。
* 「[http://microformats.org/about/ microformatsについて]」のページ、[http://microformats.org/ 最新ニュース]、[[press|メディア紹介例]]や [[presentations-ja|プレゼンテーション]]、microformatsに関する[[books|書籍]]、[[podcasts|ポッドキャスト]]、[[screencasts|スクリーンキャスト]]などについて読んでみてください。
* 質問がある場合は、[[faq|よく聞かれる質問]]や[[glossary|用語集]]をご覧ください。
* 誰かから直接話を聞きたければ、[[events|microformatsのイベント]]に参加してみてください。

== 定義 ==
Microformatsとは、Webサイトで人やイベント、タグを記述する際に用いるマークアップ方法です。

Microformatsは、あなたのWebサイトからフィードやAPIを早く簡単に提供するための手段です。また、Microformatsによって、さらに詳しい情報をWebで発信することができるようになります。[[what-are-microformats-ja|マイクロフォーマットとは何か]]、また[[what-can-you-do-with-microformats|マイクロフォーマットを使うと何ができるか]]にある、より詳しい説明もご覧ください。

== 協力するには ==
Microformatsをさらに高めるためには、みなさんの協力が必要です。

* あなたのWebサイトやサービス、製品で[[get-started|microformatsを利用]]する。
* マイクロフォーマットをもっと使ってもらえるよう、[[advocacy|周りにすすめる]]。
* [[testimonial|Microformatsをおすすめするエントリ]]を書く。
* [[to-do|TO DOリスト]]にあるタスクをこなす。
* [[irc-ja|IRCチャンネル]]や[[mail|メーリングリスト]]で学んだり、質問に答える (メールを送る前に、[[mailing-lists#General_guidelines|一般的なガイドライン]]を読んでください)。
* さまざまな言葉で読めるように、microformats wikiの翻訳を手伝う ([[Main_Page-ja#.E4.BB.96.E8.A8.80.E8.AA.9E.E3.81.A7.E3.81.AEmicroformats_wiki|他言語でのmicroformats wiki]])。
* 新しいmicroformatsを提案する前に、あなたのWebサイトが[[POSH]]であり、[[get-started|すでにあるmicroformatsを利用]]している事を確認する。そのあと、[[process|新しいフォーマットを提案する際のプロセス]]について良く読む。

== 仕様 ==
以下はオープンスタンダードとなった[[microformats-ja|microformats]]の仕様です。

* [[hcalendar-ja|hCalendar]] (翻訳中!) - [http://microformats.org/code/hcalendar/creator hCalendar creator]
* [[hcard-ja|hCard]] (翻訳中) - [http://microformats.org/code/hcard/creator hCard creator]
* [[rel-license-ja|rel-license]]
* [[rel-nofollow-ja|rel-nofollow]]
* [[rel-tag-ja|rel-tag]]
* [[vote-links-ja|Vote Links]]
* [[XFN-ja|XFN]] (翻訳中!) - [http://gmpg.org/xfn/creator XFN creator]
* [[XMDP-ja|XMDP]] (翻訳中!)
* [[xoxo-ja|XOXO]] (翻訳中!)

== ドラフト ==
* [[adr|adr]] - 住所のマークアップ
* [[geo|geo]] - [http://en.wikipedia.org/wiki/WGS84 世界測地系]による、緯度と経度のマークアップ
* [[hatom|hAtom]] - 更新情報を配信する (例: Weblogのエントリ)
* [[hresume-ja|hResume]] (翻訳中!) - 履歴書の公開
* [[hreview-ja|hReview]] - [http://microformats.org/code/hreview/creator hReview creator]
* [[rel-directory]]- to indicate that the destination of a hyperlink is a directory listing containing an entry for the current page
* [[rel-enclosure]] - for indicating attachments (e.g. files) to download and cache
* [[rel-home]] - indicate a hyperlink to the homepage of the site
* [[relpayment-research|rel-payment]] - indicate a payment mechanism
* [[robots-exclusion|robots exclusion]]
* [[xfolk|xFolk]]

== デザインパターン ==
{{design_patterns-ja}} 
* [[elemental-microformat-ja|単純microformats]]
* [[compound-microformat-ja|複合microformats]]

== Exploratory Discussions ==
See: [[exploratory-discussions]] for details of research and analysis of real-world [[examples]], existing formats, and brainstorming of possible new microformats, per the microformats [[process]]. Such work is categorised as being:

*[[exploratory-discussions#Active|Actively being progressed]]
*[[exploratory-discussions#Current|Current, but less active]]
*[[exploratory-discussions#Moribund|Moribund]]
*[[exploratory-discussions#Abandoned|Formally abandoned]] or
*[[exploratory-discussions#Archive|Archived]]

== 例 ==
* [[examples-in-the-wild-ja|実際の利用例]]
* [[implementations|ツールの実装]]
* [[zen-garden|Zen Garden]]

== resources ==
See [[resources]].

== user centric development ==
*[[user-interface]]
*[[data-portability]]
*[[social-network-portability]]

== shared work areas ==
* [[to-do|TODOリスト]]
* [[templates]]
* [http://microformats.org/wiki/delete pages for deletion] 

== ツール、テストケース、リサーチ ==
The first place to look for examples, code, and test cases is in the pages for each individual microformat. There are only a few cross-cutting [[tools|tools and services]] that need to process more than one microformat. That section is intended for editors, parsers, validators, test cases, and other information relevant across multiple microformats.

== 他言語でのmicroformats wiki ==
<span id="microformats_wiki_translations_in_other_languages">microformatsの記事を、さまざまな言語で読んだり、編集したりできます。</span>

* 100以上の記事のある言語
** [[Main_Page|<span lang="en">English</span> (本家の英語)]]
** [[Main_Page-fr|<span lang="fr">Français</span> (フランス語)]] <span lang="fr">{{UpdateMarker-fr}}</span>
* 10以上の記事のある言語
** [[Main_Page-pt-br|<span lang="pt-br">Português</span> (ブラジル系ポルトガル語)]]
** [[Main_Page-ja|日本語]]
* 2以上の記事のある言語
** [[Main_Page-cs|<span lang="cs">Česky</span> (チェコ語)]] {{NewMarker}}
** [[Main_Page-de|<span lang="de">Deutsch</span> (ドイツ語)]]
** [[Main_Page-es|<span lang="es">Español</span> (スペイン語)]]
** [[Main_Page-gl|<span lang="gl">Galego</span> (ガリーシア語)]] {{NewMarker}}
** [[Main_Page-pl|<span lang="pl">Polski</span> (ポーランド語)]]
** [[Main_Page-ro|<span lang="ro">Română</span> (ルーマニア語)]]
* 翻訳が始まったばかりの言語
** [[Main_Page-ar|<span lang="ar">العربية</span> (アラビア語)]]
* その他
**[http://ja.wikipedia.org/wiki/Microformat Wikipediaのmicroformatsページ]は、多くの言語版ができています。

[[other-languages]]や[[how-to-start-new-translation|how-to-start-a-new-translation]]もご覧ください。

Main Page-ja

2007-10-26T12:07:40Z

Vantguarde: Sync'd w/ the latest

<div style="float:right;margin-left:1em">__TOC__</div>

'''Microformats Wikiにようこそ！'''

初めての方は、[[introduction-ja|microformatsの手引き]]からどうぞ。編集を始める前に、[[how-to-play-ja]]を読んでください。

== はじめに ==
* [[posh-ja|<abbr title="Plain Old Semantic HTML">POSH</abbr>]] とは何なのかを理解しましょう。
* 「[http://microformats.org/about/ microformatsについて]」のページ、[http://microformats.org/ 最新ニュース]、[[press|メディア紹介例]]や [[presentations-ja|プレゼンテーション]]、microformatsに関する[[books|書籍]]、[[podcasts|ポッドキャスト]]、[[screencasts|スクリーンキャスト]]などについて読んでみてください。
* 質問がある場合は、[[faq|よく聞かれる質問]]や[[glossary|用語集]]をご覧ください。
* 誰かから直接話を聞きたければ、[[events|microformatsのイベント]]に参加してみてください。

== 定義 ==
Microformatsとは、Webサイトで人やイベント、タグを記述する際に用いるマークアップ方法です。

Microformatsは、あなたのWebサイトからフィードやAPIを早く簡単に提供するための手段です。また、Microformatsによって、さらに詳しい情報をWebで発信することができるようになります。[[what-are-microformats-ja|マイクロフォーマットとは何か]]、また[[what-can-you-do-with-microformats|マイクロフォーマットを使うと何ができるか]]にある、より詳しい説明もご覧ください。

== 協力するには ==
Microformatsをさらに高めるためには、みなさんの協力が必要です。

* あなたのWebサイトやサービス、製品で[[get-started|microformatsを利用]]する。
* マイクロフォーマットをもっと使ってもらえるよう、[[advocacy|周りにすすめる]]。
* [[testimonial|Microformatsをおすすめするエントリ]]を書く。
* [[to-do|TO DOリスト]]にあるタスクをこなす。
* [[irc-ja|IRCチャンネル]]や[[mail|メーリングリスト]]で学んだり、質問に答える (メールを送る前に、[[mailing-lists#General_guidelines|一般的なガイドライン]]を読んでください)。
* さまざまな言葉で読めるように、microformats wikiの翻訳を手伝う ([[Main_Page-ja#.E4.BB.96.E8.A8.80.E8.AA.9E.E3.81.A7.E3.81.AEmicroformats_wiki|他言語でのmicroformats wiki]])。
* 新しいmicroformatsを提案する前に、あなたのWebサイトが[[POSH]]であり、[[get-started|すでにあるmicroformatsを利用]]している事を確認する。そのあと、[[process|新しいフォーマットを提案する際のプロセス]]について良く読む。

== 仕様 ==
以下はオープンスタンダードとなった[[microformats-ja|microformats]]の仕様です。

* [[hcalendar-ja|hCalendar]] (翻訳中!) - [http://microformats.org/code/hcalendar/creator hCalendar creator]
* [[hcard-ja|hCard]] (翻訳中) - [http://microformats.org/code/hcard/creator hCard creator]
* [[rel-license-ja|rel-license]]
* [[rel-nofollow-ja|rel-nofollow]]
* [[rel-tag-ja|rel-tag]]
* [[vote-links-ja|Vote Links]]
* [[XFN-ja|XFN]] (翻訳中!) - [http://gmpg.org/xfn/creator XFN creator]
* [[XMDP-ja|XMDP]] (翻訳中!)
* [[xoxo-ja|XOXO]] (翻訳中!)

== ドラフト ==
* [[adr|adr]] - 住所のマークアップ
* [[geo|geo]] - [http://en.wikipedia.org/wiki/WGS84 世界測地系]による、緯度と経度のマークアップ
* [[hatom|hAtom]] - 更新情報を配信する (例: Weblogのエントリ)
* [[hresume-ja|hResume]] (翻訳中!) - 履歴書の公開
* [[hreview-ja|hReview]] - [http://microformats.org/code/hreview/creator hReview creator]
* [[rel-directory]]- to indicate that the destination of a hyperlink is a directory listing containing an entry for the current page
* [[rel-enclosure]] - for indicating attachments (e.g. files) to download and cache
* [[rel-home]] - indicate a hyperlink to the homepage of the site
* [[relpayment-research|rel-payment]] - indicate a payment mechanism
* [[robots-exclusion|robots exclusion]]
* [[xfolk|xFolk]]

== デザインパターン ==
{{design_patterns-ja}} 
* [[elemental-microformat-ja|単純microformats]]
* [[compound-microformat-ja|複合microformats]]

== Exploratory Discussions ==
See: [[exploratory-discussions]] for details of research and analysis of real-world [[examples]], existing formats, and brainstorming of possible new microformats, per the microformats [[process]]. Such work is categorised as being:

*[[exploratory-discussions#Active|Actively being progressed]]
*[[exploratory-discussions#Current|Current, but less active]]
*[[exploratory-discussions#Moribund|Moribund]]
*[[exploratory-discussions#Abandoned|Formally abandoned]] or
*[[exploratory-discussions#Archive|Archived]]

== 例 ==
* [[examples-in-the-wild-ja|実際の利用例]]
* [[implementations|ツールの実装]]
* [[zen-garden|Zen Garden]]

== resources ==
See [[resources]].

== user centric development ==
*[[user-interface]]
*[[data-portability]]
*[[social-network-portability]]

== shared work areas ==
* [[to-do|TODOリスト]]
* [[templates]]
* [http://microformats.org/wiki/delete pages for deletion] 

== ツール、テストケース、リサーチ ==
The first place to look for examples, code, and test cases is in the pages for each individual microformat. There are only a few cross-cutting [[tools|tools and services]] that need to process more than one microformat. That section is intended for editors, parsers, validators, test cases, and other information relevant across multiple microformats.

== 他言語でのmicroformats wiki ==
<span id="microformats_wiki_translations_in_other_languages">microformatsの記事を、さまざまな言語で読んだり、編集したりできます。</span>

* 100以上の記事のある言語
** [[Main_Page|<span lang="en">English</span> (本家の英語)]]
** [[Main_Page-fr|<span lang="fr">Français</span> (フランス語)]] <span lang="fr">{{UpdateMarker-fr}}</span>
* 10以上の記事のある言語
** [[Main_Page-pt-br|<span lang="pt-br">Português</span> (ブラジル系ポルトガル語)]]
** [[Main_Page-ja|日本語]]
* 2以上の記事のある言語
** [[Main_Page-cs|<span lang="cs">Česky</span> (Czech)]] {{NewMarker}}
** [[Main_Page-de|<span lang="de">Deutsch</span> (German)]]
** [[Main_Page-es|<span lang="es">Español</span> (Spanish)]]
** [[Main_Page-gl|<span lang="gl">Galego</span> (Galician)]] {{NewMarker}}
** [[Main_Page-pl|<span lang="pl">Polski</span> (Polish)]]
** [[Main_Page-ro|<span lang="ro">Română</span> (Romanian)]]
* languages just started
** [[Main_Page-ar|<span lang="ar">العربية</span> (Arabic)]]
* elsewhere
**[http://en.wikipedia.org/wiki/Microformat Wikipedia's article on microformats] has been translated into a number of languages.

See also [[other-languages]], and [[how-to-start-new-translation|how-to-start-a-new-translation]].

hcalendar-ja

2007-04-18T20:38:49Z

Vantguarde:

<h1>hCalendar</h1>
http://www.boogdesign.com/images/buttons/microformat_hcalendar.png

hCalendarはiCalendar ([http://www.ietf.org/rfc/rfc2445.txt RFC2445])を基とした、シンプルでオープンなカレンダー・イベント情報配信用の[[microformats-ja|microformat]]です。(X)HTMLやAtom, RSS, 任意のXMLなど、広範囲に適用可能なフォーマットとなっています。

hCalendarでイベント情報を配信するにはいくつかの方法があります。手っ取り早いのは、[http://microformats.org/code/hcalendar/creator hCalendar creator]を使うこと。でももし、すでにイベントの情報を自分のblogやwikiなどに書いている場合は[[hcalendar-authoring|hCalendar authoring tips]]を読み、hCalendarに沿うようマークアップをし直しましょう。

__TOC__

== 仕様 ==

; 編者 : [http://tantek.com/ Tantek Çelik] ([http://technorati.com Technorati, Inc])
; 作者 : [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc]
: [http://suda.co.uk/ Brian Suda]

=== 著作権 ===
{{MicroFormatCopyrightStatement2004-ja}}

=== 特許方針 ===
{{MicroFormatPatentStatement-ja}}

=== 謝辞 ===
Thanks to:
* Adam Bosworth for leading the [http://wiki.oreillynet.com/foocamp04/index.cgi?HTMLForCalendars FOO Camp 2004 HTML For Calendars presentation] which brought together a critical mass of interested parties.

== 概要 ==
iCalendar ([http://www.ietf.org/rfc/rfc2445.txt RFC2445])はAppleのiCalなど、スケジュール管理用アプリケーションに広く採用され、また実装上の相互運用性も高いフォーマットになっています。

この広く使われているフォーマットを、blogで言及されるイベント情報に応用できないでしょうか。自分のblogにこれから行われるイベントであったり、この間参加したイベントについてエントリをおこすブロガーはたくさんいます。それらのイベント情報を少し構造化し、iCalendarとして出力可能にすれば、アプリケーションやWebサービスが自動的にその情報を利用できるようになります。

この'''hCalendar'''というう仕様は、XHTMLにてiCalendarを表現するフォーマットです。ブロガーはhCalendarを直接webページに埋め込んだり、またその情報をCSSでデザインすることが可能です。それだけではありません。アプリケーションはイベント情報を直接そのhCalendarから取ってくることができるようにります。イベントについて書かれたファイルを、webページとは別に用意する必要はもうありません。

== Semantic XHTML Design Principles ==

{{semantic-xhtml-design-principles}}

For practical implementations, it should be noted that Internet Explorer's support for styling <code><nowiki><abbr></nowiki></code> elements is poor, and may require wrapper elements.

== Format ==

=== In General ===

The iCalendar standard ([http://www.ietf.org/rfc/rfc2445.txt RFC2445]) forms the basis of hCalendar.

Note: the editor and authors of this specification are tracking the [http://lists.osafoundation.org/pipermail/ietf-calsify/ "iCal-Basic" effort] and intend to base the core hCalendar profile on iCal-Basic. See references for a link to the current draft.

The basic format of hCalendar is to use iCalendar object/property names in lower-case for class names, and to map the nesting of iCalendar objects directly into nested XHTML.

=== More Semantic Equivalents ===

However, for some properties there is a more semantic equivalent, and therefore they get special treatment, e.g.:
* <code>URL</code> in iCalendar becomes <code><a class="url" href="...">...</a></code> inside the element with <code>class="vevent"</code> in hCalendar.
* <code>ATTENDEE</code>, <code>CONTACT</code>, and <code>ORGANIZER</code> in iCalendar may be represented by an [[hcard|hCard]] in hCalendar .
* A named <code>LOCATION</code> (potentially with an address and/or geo) in iCalendar may be represented by a nested [[hcard|hCard]] in hCalendar. Similarly, an address <code>LOCATION</code> may be represented by an [[adr]], and a geo (latitude and longitude) <code>LOCATION</code> may be represented by a [[geo]].
* <code>UID</code> in iCalendar simply becomes another semantic applied to a specific URL for an hCalendar event.

=== Singular vs. Plural Properties ===

For properties which are singular (e.g. "N" and "FN" from vCard), the first descendant element with that class should take effect, any others being ignored.

For properties which can be plural (e.g. "TEL" from vCard), each class instance should create a instance of that property. Plural properties with subtypes (e.g. TEL with WORK, HOME, CELL from vCard) can be optimized to share a common element for the property itself, with each instance of subtype being an appropriately classed descendant of the property element.

==== Plural Properties Singularized ====

Since plural property names become their singular equivalents, even if the original plural property permitted only a single value with multiple components, those multiple components are represented each with their own singularly named property and the the property is effectively multivalued and subject to the above treatment of multivalued properties.

=== Human vs. Machine readable ===
If an <code><nowiki><abbr></nowiki></code> element is used for a property, then the '<code>title</code>' attribute of the <code><nowiki><abbr></nowiki></code> element is the value of the property, instead of the contents of the element, which instead provide a human presentable version of the value. This specification recommends that such <code><nowiki><abbr></nowiki></code> elements be used for the following iCalendar properties:
* DTSTART, DTEND, DURATION, RDATE, RRULE

== Example ==

Here is a sample event in an iCalendar:
<pre><nowiki>
BEGIN:VCALENDAR
PRODID:-//XYZproduct//EN
VERSION:2.0
BEGIN:VEVENT
URL:http://www.web2con.com/
DTSTART:20071005
DTEND:20071020
SUMMARY:Web 2.0 Conference
LOCATION:Argent Hotel\, San Francisco\, CA
END:VEVENT
END:VCALENDAR
</nowiki></pre>

and an equivalent event in hCalendar format with various elements optimized appropriately. See [[hcalendar-example1-steps]] for the derivation.

<pre><nowiki>
<div class="vevent">
<a class="url" href="http://www.web2con.com/">http://www.web2con.com/</a>
<span class="summary">Web 2.0 Conference</span>:
<abbr class="dtstart" title="2007-10-05">October 5</abbr>-
<abbr class="dtend" title="2007-10-20">19</abbr>,
at the <span class="location">Argent Hotel, San Francisco, CA</span>
</div>
</nowiki></pre>

which could be displayed as:

<div class="vevent">
<span class="url">http://www.web2con.com/</span> 
<span class="summary">Web 2.0 Conference</span>:
<abbr class="dtstart" title="2007-10-05">October 5</abbr>-
<abbr class="dtend" title="2007-10-20">19</abbr>,
at the <span class="location">Argent Hotel, San Francisco, CA</span>
</div>

Note that this is a '''live''' hCalendar microformat, which will be found on this page by parsers.

=== Example 2===

The following example specifies a scheduled meeting that begins
at 8:30 AM EST on March 12, 1998 and ends at 9:30 AM EST on March 12,
1998.

<pre><nowiki>
BEGIN:VCALENDAR
BEGIN:VEVENT
UID:guid-1.host1.com
DTSTAMP:19980309T231000Z
DESCRIPTION:Project XYZ Review Meeting
SUMMARY:XYZ Project Review
DTSTART:19980312T133000Z
DTEND:19980312T143000Z
LOCATION:1CP Conference Room 4350
END:VEVENT
END:VCALENDAR
</nowiki></pre>

The equivalent in hCalendar:

<pre><nowiki>
<div class="vevent">
<h3 class="summary">XYZ Project Review</h3>
<p class="description">Project XYZ Review Meeting</p>
<p>To held on <abbr class="dtstart" title="1998-03-12T08:30:00-05:00">12 March 1998 from 8:30am EST</abbr>
until <abbr class="dtend" title="1998-03-12T09:30:00-05:00">9:30am EST</abbr></p>
<p>Location: <span class="location">1CP Conference Room 4350</span></p>
<small>Booked by: <span class="uid">guid-1.host1.com</span> on
<abbr class="dtstamp" title="19980309T231000Z">9 Mar 1998 6:00pm</abbr></small>
</div>
</nowiki></pre>

This could be displayed as:

----

<div class="vevent">

<h3 class="summary">XYZ Project Review</h3>
<p class="description">Project XYZ Review Meeting</p>
<p>To held on <abbr class="dtstart" title="1998-03-12T08:30:00-05:00">12 March 1998 from 8:30am EST</abbr>
until <abbr class="dtend" title="1998-03-12T09:30:00-05:00">9:30am EST</abbr></p>
<p>Location: <span class="location">1CP Conference Room 4350</span></p>
<small>Booked by: <span class="uid">guid-1.host1.com</span> on
<abbr class="dtstamp" title="19980309T231000Z">9 Mar 1998 6:00pm</abbr></small></div>

----

Note 1: The product information is not necessary since hCalendar is an interchange format. When transforming hCalendar back into iCalendar, the transforming engine should add its own product ID.

Note 2: A surrounding <code><nowiki><span class="vcalendar"></nowiki></code> element is optional, and is left out as such. It is optional since the context of a vcalendar is implied when a vevent is encountered. The implied context/scope is that of the document. Authors may explicitly use elements with class="vcalendar" to wrap sets of vevents that all belong to the same calendar, e.g. when publishing multiple calendars on the same page.

Note 3: The version information is unnecessary in hCalendar markup directly since the version will be defined by the profile of hCalendar that is used/referred to in the 'profile' attribute of the <head> element.

Note 4: ISO8601 dates (required by iCalendar) are not very human friendly. In addition, the year is often understood implicitly by humans from the context. Thus <code><nowiki><abbr></nowiki></code> elements are used to simultaneously provide a human friendly date and/or time in the visible contents of the element, while placing the respective machine parsable comprehensive ISO8601 datetime in the 'title' attribute.
The notation <code>YYYY-MM-DDThh:mm:ss</code> should be used for better readability, following the format of RFC 3339.

Note 5: The difference between the DTEND ISO8601 date (2005-10-08) and the human readable date (7) is NOT a mistake. [http://lists.osafoundation.org/pipermail/ietf-calsify/2005-September/000769.html DTEND is exclusive], meaning, that the event ends just before the DTEND. Thus for events which start on one day and end on another day, the DTEND date must be specified as the day after the day that a human would say is the last day of the event.

Note 6: The location in this example contains implicit structure (venue name, city, state) which could be marked up explicitly as an [[hcard|hCard]]. See [http://microformats.org/wiki/hcalendar-brainstorming#hCard_locations hCalendar brainstorming: hCard locations] for a informative explanation of how to do this.

==Buttons==
Don't forget that you can add one of our [[buttons#hCalendar|buttons]] to the page, to indicate the presence of hCalendar microformats. For example: http://www.boogdesign.com/images/buttons/microformat_hcalendar.png. If you can link it back to this page (or even page on your website, about your use of the microformat), so much the better!

=== More Examples ===
See [[hcalendar-examples|hCalendar examples]] for more examples, including examples from iCalendar RFC 2445 converted into hCalendar.

== Examples in the wild ==
This section is '''informative'''. The number of hCalendar examples in the wild has expanded far beyond the capacity of being kept inline in this specification. They have been moved to a [[hcalendar-examples-in-wild|separate page]].

See [[hcalendar-examples-in-wild|hCalendar Examples in the wild]].

== Implementations ==
This section is '''informative'''. The number of hCalendar implementations has also expanded beyond the capacity of keeping them inline. They have been moved to a [[hcalendar-implementations|separate page]].

See [[hcalendar-implementations|hCalendar Implementations]].

== References ==
=== Normative References ===
* [http://www.w3.org/TR/2002/REC-xhtml1-20020801/ XHTML 1.0 SE]
* [[hcard|hCard]]
* [http://www.ietf.org/rfc/rfc2445.txt iCalendar RFC2445]

=== Informative References ===
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://tantek.com/log/2004/09.html#hcalendar hCalendar term introduced and defined on the Web, 20040930]
* [http://wiki.oreillynet.com/foocamp04/index.cgi?HTMLForCalendars FOO Camp 2004 HTML For Calendars presentation, 20040911]
* [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 Simple Semantic Formats presentation, 20040910]
* [http://ietfreport.isoc.org/idref/draft-royer-ical-basic/ iCal-Basic (latest)] [http://www.faqs.org/ftp/pub/pub/internet-drafts/draft-royer-ical-basic-04.txt (draft 04)]
* Contributed from http://developers.technorati.com/wiki/hCalendar
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]

==== Specifications That Use hCalendar ====
* [[hreview|hReview]]

==== Similar Work ====
* [http://lists.osafoundation.org/pipermail/ietf-calsify/ IETF-calsify archives]
* [http://www.softwarestudio.org/iCal/2445Issues.html RFC2445 Issues List]
* [http://ietf.webdav.org/calsify/ CALSIFY WG Links And Resources]

== Further Reading ==
* [http://www.jwz.org/doc/groupware.html Groupware Bad by Jamie Zawinski] crystalizes the reason for hCalendar ('''emphasis''' added):
<blockquote>Right now people can do that by publishing .ics files, but it's not trivial to do so, and it's work on the part of other people to look at them. '''If it's not HTML hanging off our friend's home page that can be viewed in any browser on a public terminal in a library, the bar to entry is too high and it's useless.'''</blockquote>

* [http://muddybranch.thejkgroup.com/ Jason Klemow's blog]
* [http://weblog.infoworld.com/udell/2006/01/11.html#a1368 Moving forward with microformats] by [http://weblog.infoworld.com/udell Jon Udell] provides an hCalendar example and some discussion.
* See also [http://www.technorati.com/cosmos/referer.html blogs discussing this page] and the [http://technorati.com/tags/hcalendar hCalendar tag]
* [http://en.wikipedia.org/wiki/HCalendar Wikipedia article on hCalendar] (requires expansion)

== Related Pages ==
{{hcalendar-related-pages}}

vote-links-ja

2007-03-12T12:01:20Z

Vantguarde: /* 廃止された案: rel属性を用いたVote Links */

= Vote Links =
__TOC__
== Specification 2005 ==
=== 編者 ===
* [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc.] (formerly of [http://microsoft.com/ Microsoft Corporation])

=== 着想 ===
* [http://epeus.blogspot.com/ Kevin Marks], [http://technorati.com Technorati,Inc.]

=== 作者 ===
* [http://epeus.blogspot.com/ Kevin Marks], [http://technorati.com Technorati, Inc]
* [http://tantek.com/ Tantek Çelik], [http://technorati.com Technorati, Inc]

=== 著作権 ===
{{MicroFormatCopyrightStatement2004-ja}}

=== Patents ===
{{MicroFormatPatentStatement-ja}}

=== 謝辞 ===
Vote Linksに対しフィードバックをくれたみなさんに感謝します。特にEtanWexler、彼はVote Linksの文書に置いて初めて、Vote Linksはrel属性ではなくrev属性を使うべきだと指摘しました（[[vote-links-faq]]）。また同じくrel属性について考え、relやrev、linktypesの利用法を[[rel-faq ]]としてまとめたJohn Allsoppにも謝辞を述べたいと思います。

== 概要 ==
トラッキングやインデックス作成を行うアプリケーションが、リンク先の文書に対するページ作者のスタンスを理解していないというのは問題です。賛成や支持だけではなく、リンクしたリソースの内容に反論したい、又はもっと議論を重ねたい場合があるはずですから。

== 仕様 ==
Vote Linksは[[elemental-microformat-ja|単純microformat]]と呼ばれる、[[microformats]]オープンスタンダードのひとつです。
私たちはHTMLにてハイパーリンクを張るa要素、そのrev属性に対し、3つの新しい値を提案します。

"vote-for"、"vote-abstain"、そして"vote-against"がVote Linksで用いられる属性値です。これら3つの値は互いに相容れないものであり、それぞれ順に賛成、中立又は棄権、そして反対を表します。

アプリケーションの解釈にも寄りますが、rev属性のないVote Linkは"vote-for"又は"vote-abstain"として扱われることがあります。

リンクには人が分かり易いよう、補助的なコメントをtitle属性を用いて与えることが可能です。一般のブラウザであれば、コメントはリンクのロールオーバー時に現れるでしょう。

では、Vote Linksの例です。
<pre><nowiki>
<a rev="vote-for" href="http://ragingcow.blogspot.com"
title="neat spoof">Raging Cow</a>
<a rev="vote-against" href="http://ragingcow.com"
title="nasty corn syrup drink">Raging Cow</a>
</nowiki></pre>

=== 廃止された案: rel属性を用いたVote Links ===
前ドラフトではrev属性の代わりにrel属性を用いてリンクを張っていました。これに対しいくつかのフィードバックや分析が寄せられ、rel属性を使うのは適切ではなく、rev属性の方が意味をより性格に伝えられると判断されました。詳しくは[[rel-faq]]をご覧ください。

Vote Linksの実装に関しては、後方互換性の為、rel属性を用いたリンクを解釈してもよい（MAY）となっています。

しかしWebページ作者はrel属性をVote Linksで使ってはいけません（MUST NOT）。

== XMDPプロファイル ==
<pre><nowiki>
<dl class="profile">
<dt id="rev">rev</dt>
<dd><p><a rel="help" href="http://www.w3.org/TR/html401/struct/links.html#adef-rev">
HTML4 definition of the 'rev' attribute.</a>
Here are some additional values.</p>
<dl>
<dt id="vote-for">vote-for</dt>
<dd>Indicates agreement with or recommendation for the referred resource.</dd>
<dt id="vote-abstain">vote-abstain</dt>
<dd>Indicates abstention or indifference for the referred resource.</dd>
<dt id="vote-against">vote-against</dt>
<dd>Indicates disagreement with or recommendation against the referred resource.</dd>
</dl>
</dd>
</dl>
</nowiki></pre>

== 実装 ==
このセクションは'''参考情報'''です。

* [http://jyte.com/cl/jyte-should-integrate-microformats-votelinks vote-links claim]によると、[http://jyte.com/profile/brianellin.com Brian Ellin]はVote Linksを[http://jyte.com Jyte]上に、わずか30分で実装したとのことです。

* [http://moloko.itc.it/paoloblog/ Paolo Massa]は[http://moloko.itc.it/paoloblog/semantic_links/ SemanticLinks]というFirefoxの拡張を開発しています。これはvote-for又はvote-againstが付いたリンクを表示する、というものです。(なお、現在は作者の手によりSemanticLinksのダウンロード先が消されています)

== 標準仕様 ==
* [http://gmpg.org/xmdp/ XMDP]

== 関連仕様 ==
* [[xoxo]]
* [http://gmpg.org/xfn/ XFN]
* [http://developers.technorati.com/wiki/attentionxml Attention.xml]
* [[rel-license]]
* [[rel-tag]]
* [[rel-nofollow]]

== FAQ ==
* Vote LinkのFAQは[[vote-links-faq]]に、rel属性に関するものは[[rel-faq]]をご覧ください。
* [[vote-links-issues]]には、このVote Links [[microformat]]に関して、いくつかの提案があります。

Main Page-ja

2007-03-06T14:14:17Z

Vantguarde: /* 仕様 */

__NOTOC__
<h1>Microformats Wiki</h1>

'''こんにちは！''' microformats wikiにようこそ。もしこのページを見るのが初めてでしたら、[[introduction-ja|microformatsの手引き]]をご覧ください。

何か編集する前には必ず[[how-to-play-ja]]を読んでください。

新しいmicroformatsを提案する際は、必ず[[process]]を読んでからにしてください。

__TOC__

== はじめに ==

[[what-are-microformats|microformatsとは何でしょう]]？また[[what-can-you-do-with-microformats|microformatsで何ができますか]]？

まずは[http://microformats.org/about/ about page]、そして[http://microformats.org/ latest news]をご覧ください。また最新の[[press-ja|プレス]]や[[presentations-ja|プレゼンテーション]]、さらには[[podcasts|ポッドキャスト]]や[[screencasts|スクリーンキャスト]]もmicroformatsの基礎を理解する手助けになると思います。Our [[cheatsheets]] are handy if you need a quick reminder about a particular microformat.
よくある質問とその答えは[[faq|FAQ]]で、また[[glossary|用語集]]もあります。

識者からもっと教わりたいことがあれば、[[events|microformatsのイベント]]もありますよ。

== 定義 ==

[http://microformats.org/discuss/ メーリングリスト]([[mailing-lists]])での一般的な定義は、「分散的開発を実現するために用いられる、セマンティクスをHTMLに埋め込む為のシンプルな仕様」です。もう少し細かく説明すると、microformatsは下記のように定義できます。
:分散的開発を実現するために用いられる
::Webにあるリソースそのものや、それを利用するツールやサービスを分散的に処理できるようにします。
:セマンティクスをHTMLに埋め込むための
::それぞれの分野に特化することで、各仕様が小さいものとなります。
:シンプルな仕様
:人間が解読できる(X)HTML/XMLドキュメントやAtom/RSSフィード、そしてプレーンなXMLでの提供
::現存するコンテンツの利用パターンを標準化することからはじめています。
::概略的で説明的なclass名を使い、ソースをみてもわかりやすくなっています。
::現存の相互運用できる規格に基づくことにより、汎用性が高まります。

シンプルに言うと、「microformatsは成文化したコンベンションのことです。」 -- [http://easy-reader.net Aaron Gustafson]

「ブラウザーでWeb巡回しかしないんだ。それはまた20世紀的だね。」 -- [http://diveintomark.org Mark Pilgrim]

== 協力の方法 ==

microformatsをより発展させるためには次のことができます。

*Check out our open [[to-do|to do list]] for things to help get done.
*Join the [http://microformats.org/discuss mailing lists] and [[irc|IRC Channel]] to learn and help answer questions about microformats.
*[[advocacy|Advocate]] the use of microformats.
*[[Main_Page-ja#.E4.BB.96.E8.A8.80.E8.AA.9E.E3.81.A7.E3.81.AEmicroformats_wiki|他言語でのmicroformats wiki]]を見てください。そして、世界中の人が利用しやすくするためにmicroformats wikiの翻訳を手伝ってください。

== 仕様 ==

以下はオープンスタンダードとなった[[microformats-ja|microformats]]の仕様です。([[implementations|実装]]や[[examples-in-the-wild|実世界での例]]もご覧ください)

* [[hcalendar-ja|hCalendar]] - [http://microformats.org/code/hcalendar/creator hcalendar creator](翻訳中！)
* [[hcard-ja|hCard]] - [http://microformats.org/code/hcard/creator hcard creator](翻訳中！)
* [[rel-license-ja|rel-license]](翻訳完了)
* [[rel-nofollow-ja|rel-nofollow]](翻訳完了)
* [[rel-tag-ja|rel-tag]](翻訳完了)
* [[vote-links-ja|Vote Links]](翻訳完了)
* [http://gmpg.org/xfn/ XFN] ([[xfn-implementations|XFNの実装]]もご覧下さい)
* [http://gmpg.org/xmdp/ XMDP]
* [[xoxo-ja|XOXO]](翻訳中！)

== ドラフト ==

* [[adr|adr]]
* [[geo|geo]]
* [[hatom|hAtom]]
* [[hresume|hResume]]
* [[hreview-ja|hReview]] - [http://microformats.org/code/hreview/creator hreview creator]
* [[rel-directory]]
* [[rel-enclosure]]
* [[rel-home]]
* [[relpayment-research | rel-payment]]
* [[robots-exclusion|Robots Exclusion]]
* [[xfolk|xFolk]]

== デザインパターン ==

{{design_patterns-ja}} 

== Exploratory Discussions ==
Per the microformats [[process]]:
実世界での[[examples|例]]の調査や分析、既に存在するフォーマット、またmicroformatsにできそうなもののブレインストーミングをまとめています。もし何かページを追加した場合、まず[[rejected-formats]]を見てから行ってください。
* alternates [[alternates-brainstorming|alternates brainstorming]], [[alternates-examples|alternates examples]]
*[[attention]]
* blog description [[blog-description-examples|blog description examples]]
* blog info [[blog-info-examples|blog info examples]]
* blog post [[blog-post-examples|examples]], [[blog-post-formats|blog post formats]], and [[blog-post-brainstorming|blog post brainstorming]] (yielded the [[hatom|hAtom]] draft)
* book [[book-examples|book examples]], [[book-formats|book formats]], and [[book-brainstorming|book brainstorming]]
* chat [[chat-examples|chat examples]], [[chat-formats|chat formats]], and [[chat-brainstorming|chat brainstorming]]
* citation [[citation|citation effort]], [[citation-examples|citation examples]], [[citation-formats|citation formats]], [[citation-brainstorming|citation brainstorming]], and [[citation-faq|citation FAQ]]
* code [[code-examples| code examples]], [[code-brainstorming|code brainstorming]]{{NewMarker}}
* comment [[comment-problem|comment problem]], [[comment-examples|comment examples]], and [[comments-formats|comment formats]] (Some stuff needs to be extracted from [[comments-formats]])
* [[collection-description|collection description]] {{NewMarker}}
* [[course-catalog]]; [[course-catalog-examples]] {{NewMarker}}
* [[currency]]; [[currency-examples]]; [[currency-brainstorming]]; [[currency-proposal]]; [[currency-issues]]
* [[depend-examples]]: examples of dependency graphs, especially as they relate to software {{NewMarker}}
* [[digital-signatures]]: incorporation of digital signatures in Microformatted data; ([[digitalsignature-examples|digital-signature examples]], [[digitalsignature-brainstorming|digital-signatures brainstorming]]) {{NewMarker}}
* directions [[directions-examples|directions examples]] {{NewMarker}}
* directory inclusion [[directory-inclusion-examples|directory inclusion examples]], [[directory-inclusion-formats|directory inclusion formats]]. (see also [[rel-directory]])
* distributed conversation [[distributed-conversation|distributed conversation overview]], [[distributed-conversation-brainstorming|distributed conversation brainstorming]], [[distributed-conversation-examples|distributed conversation examples]], and [[distributed-conversation-formats|distributed conversation formats]]
* forms [[forms-examples|forms examples]]
* genealogy [[genealogy-formats|genealogy examples]]
* group [[group-brainstorming|group brainstorming]] and [[group-examples|group examples]]
* hash [[hash-examples|hash examples]]
* items [[items-brainstorming|items brainstorming]] and [[items-examples|items examples]]
* job listing [[job-listing-examples|job listing examples]] and [[job-listing-brainstorming|job listing brainstorming]]
* last modified [[last-modified-examples|last modified examples]], [[last-modified-formats|last modified formats]], and [[last-modified-brainstorming|last modified brainstorming]]
* hListing [[hlisting-proposal|hListing proposal]], and [[hlisting-feedback|hListing feedback]]
** Also, listing [[listing-examples|examples]], [[listing-formats|formats]], and [[listing-brainstorming|brainstorming]]
* [[product|hProduct]] - [[product-brainstorming|hProduct brainstorming]] | [[product-examples|hProduct examples]]
* location [[location-formats|location formats]]. (see also [[adr]] and [[geo]])
* [[luna]] ([[geo]]-like co-ordinates, for places on The Moon) - see also [[geo-extension-strawman]] a possible implementation {{UpdateMarker}}
* [[mars]] ([[geo]]-like co-ordinates, for places on the planet Mars)- see also [[geo-extension-strawman]] a possible implementation {{UpdateMarker}}
* measures and measurement units [[measure]]
* [[media-info]] ([[media-info-examples|media-info examples]], [[media-info-formats|media-info formats]], [[media-info-brainstorming|media-info brainstorming]])
* meeting minutes [[meeting-minutes-examples|meeting minutes examples]], [[meeting-minutes-formats|meeting minutes formats]], and [[meeting-minutes-brainstorming|meeting minutes brainstorming]]
* metalink [[metalink-examples|metalink examples]] {{NewMarker}}
* microsummary [[microsummary-brainstorming|microsummary brainstorming]]
* [[mfo-examples|MFO examples]]
* music [[music-examples|music examples]]
* photo note [[photo-note-examples|photo note examples]]
*[[question-answer]], [[question-answer-brainstorming]]; [[question-answer-examples]] {{NewMarker}}
* recipe [[recipe-examples|recipe examples]], [[recipe-brainstorming]] {{UpdateMarker}}
* rel-product [[rel-product-brainstorming|rel-product brainstorming]]
* requirements testing [[requirements-testing|requirements testing overview]], and [[requirements-testing-examples|requirements testing examples]]
* [[rest-examples|REST examples]]
* resume [[resume-brainstorming|resume brainstorming]], and [[resume-formats|resume formats]]
* review [[review-examples|review examples]], and [[review-formats|review formats]] (yielded the [[hreview|hReview]] draft)
* search results [[search-results-example|search results example]]
* show [[show-brainstorming|show brainstorming]]
* showroll [[showroll-brainstorming|brainstorming]]
* [[species]] - for the marking up of the scientific names of living things: [[species-examples]]; [[species-brainstorming]] {{UpdateMarker}}
* table [[table-examples|examples]]
* tagspeak [[tagspeak-examples|tagspeak examples]]
* tagcloud [[tagcloud-examples|tagcloud examples]], and [[tagcloud-brainstorming|tagcloud brainstorming]].
* [[thoughts-on-extending-the-geo-microformat|thoughts on extending the geo microformat]], [http://microformats.telemetry.gr examples] {{NewMarker}}
* transit table [[transit-table-examples|transit table examples]]
* [[uid]]
* widget [[widget-examples|widget examples]], and [[widget-brainstorming|widget brainstorming]]
* [[wiki-formats|wiki formats]]
* work of art [[work-of-art|work of art overview]], [[workofart-examples|work of art examples]], [[workofart-formats|work of art formats]], and [[workofart-brainstorming|work of art brainstorming]]
*[[xmdp-brainstorming|XMDP brainstorming]] (see also [[xmdp-faq]])

== 例 ==
* [[examples-in-the-wild]]
* [[implementations]]
* [[zen-garden]]

== ツール、テストケース、リサーチ ==

事例やコードやテストケースを見るために最初に見るべき場所はmicroformatを使ったそれぞれのページです. 二つ以上のmicroformatを使うツールやサービスは少ししかありません. このセクションは複数のmicroformatに関連するエディター、パーサー、妥当性検証ソフト、テストケース、その他情報等のためのものです。

*[[accessibility]]
*[[faqs-for-rdf]]
*[[icalendar-implementations]]
*[[parsing-microformats]]
*[[selected-test-cases-from-the-web]]
*[http://hg.microformats.org/ Source code repository] -- [[mercurial-quick-start|HowTo: Download code from the repository]]
*[[vcard-implementations]], [[vcard-errata]], [[vcard-suggestions]]
*[[why-are-content-standards-hard]]
*[[profile-examples-in-wild|Profile examples, in the wild]]

== 共有ワークスペース ==

* [[buttons]]
* [[icons-ja]] {{NewMarker}}
* [[spread-microformats]] {{NewMarker}}
* [[demo|デモ]] - microformatを試すデモへのリンク集
* [[events]]
* [[to-do]]
* [[user-interface]]
* [[marked-for-deletion]]
* [[microformats-issues]] {{NewMarker}} - 一つ以上のmicroformatに関するissue

== 他言語でのmicroformats wiki ==

microformatsの記事を色々な言語で読んだり編集したりできます。

* 100以上の記事のある言語
** [[Main_Page|English (本家の英語)]]
** [[Main_Page-fr|Francais (フランス語)]] {{UpdateMarker-fr}}
* 10以上の記事のある言語
** [[Main_Page-pt-br| Português (ブラジル系ポルトガル語)]] {{NewMarker-pt-br}}
** [[Main_Page-ja|日本語]]
* 2以上の記事のある言語
** [[Main_Page-es|Espanol (スペイン語)]]
** [[Main_Page-de|Deutsch (ドイツ語)]]

==== 他の場所にあるmicroformatsの翻訳版 ====

いくつかのmicroformatsは、このWiki以外の場所にて翻訳が行われています。もしあなたがその翻訳に関わっていたら、ぜひこのmicroformats wikiで作業しないか考えて頂けると幸いです。
* [http://mikroformate.pbwiki.com/ Deutsch (German) mikroformate.pbwiki.com] {{NewMarker-de}}

=== 他の言語に翻訳するのをお手伝いください！ ===

読みたい記事があなたの読みたい言葉で存在していませんか？それならば是非microformats wikiを翻訳するのにご協力ください！microformats wikiの多言語化については現在も取り組んでいます。

翻訳に際し、まずは[http://en.wikipedia.org/wiki/Wikipedia:Multilingual_coordination Wikipediaにおける多言語版の位置づけ]、そして[http://meta.wikimedia.org/wiki/How_to_start_a_new_Wikipedia 新しいWikipediaを始めるには] をご覧下さい。
一般的なTIPSやアドバイス、このコミュニティの慣習が書いてあります。

実際に翻訳を始めるときは、まず、比較的静的であまり変化がないものを集めた[[stable-pages-ja|静的ページ]]に挙がっているものを少しずつ翻訳していくことから始めましょう。そして、(ページの変更を監視できる)[[Special:Watchlist|ウォッチリスト]]機能を使って英語版と歩調を合わせるとよいでしょう。

翻訳したページの名前: 翻訳したページのページ名は、英語版のページ名の末尾にハイフンに続いてRFC 3066の言語コード付けてください。例えば日本語版では、[[Main_Page]]は[[Main_Page-ja]]に、そして [[how-to-play]]は[[how-to-play-ja]]になります。

=== 要望のある言語はこちら ===

* Chinese: 微格式 (Microformats) (see [http://msittig.blogspot.com/2005/11/since-i-translated-schedule-of.html source of translation])
* Does somebody want to see a Dutch translation???