hcard-ja

2011-07-18T02:08:22Z

Genomepunk: /* その他の例 */ h2要素のマークアップが反映されていなかったのを修正

<entry-title>hCard 1.0</entry-title>

<span class="vcard"><span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="role">Editor</span>, <span class="role">Author</span>)</span>, <span class="vcard"><span class="fn">[[User:Brian|Brian Suda]]</span> (<span class="role">Author</span>)</span>
----
<dfn style="font-style:normal;font-weight:bold">hCard</dfn> は、vCard ([[rfc-2426|RFC2426]]) のプロパティと値を利用して、[[semantic-xhtml|HTML]] で人や会社、組織や場所を表現する [[microformats-ja|microformat]] です。hCard は HTML や XHTML はもちろんのこと、Atom、RSS、その他の XML に埋め込むことができます。

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

== 例 ==
hCards are most often used to represent people:
<source lang=html4strict>
<div class="vcard">
<a class="url fn" href="http://tantek.com/">Tantek Çelik</a>
</div>
</source>
and organizations:
<source lang=html4strict>
<div class="vcard">
<a class="url fn org" href="http://microformats.org/">microformats.org</a>
</div>
</source>

The class '''<code>vcard</code>''' is a ''[[hcard#Root_Class_Name|root class name]]'' that indicates the presence of an hCard. The classes '''<code>url</code>''', '''<code>fn</code>''', and '''<code>org</code>''' are ''properties'' that indicate aspects of the hCard. See the [[hcard#Property_List|list of properties]] for more.

'''Want to get started with writing an [[hcard|hCard]]?''' Use the [http://microformats.org/code/hcard/creator hCard creator] to write up some contact information and publish it, or follow the [[hcard-authoring|hCard authoring tips]] to add hCard markup to your current contact page.

== 状態 ==
hCard 1.0 is a microformats.org specification. Public discussion on hCard takes place on [[hcard-feedback]], the #microformats [[irc]] channel on irc.freenode.net, and [http://microformats.org/discuss/mail/microformats-discuss/ microformats-discuss mailing list].

=== 利用できる言語 ===
The English version of this specification is the only normative version. For translations of this document see the [[#translations]] section.

=== 訂正事項と更新事項 ===
Known errors and issues in this specification are corrected in [[hcard-issues-resolved|resolved]] and [[hcard-issues-closed|closed]] issues. Please check there before reporting [[hcard-issues|issues]].

The hCard 1.0.1 update is currently under development and incorporates known errata corrections as well as the [[value-class-pattern]].

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

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

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

== 適合性 ==
{{rfc-2119-intro-ja}}

== フォーマット ==
=== 基本情報 ===
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)

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

=== プロパティについて ===
<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'、'reｖ' を持つことはありません。これらのプロパティが複数ある場合は、最初の値を残し、他の値を無視するべきです ({{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:
<source lang=html4strict>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1.415.555.1212</span>
</span>
</source>

この 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>

You may want to customize/localize the visible punctuation and not want to include it in what machines see. Use multiple class="value" elements which are then concatenated. E.g.

<source lang=html4strict>
<span class="tel">
<span class="type">home</span>:
<span class="value">+1</span>.<span class="value">415</span>.<span class="value">555</span>.<span class="value">1212</span></span>
</span>
</source>

No change in display, but the parsed hCard property value then becomes in vCard:

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


=== プロパティの例外 ===
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"（organization；組織）プロパティが同じ値を持っている場合 (多くの場合、これらは 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}})。次のような場合においてもです。

<source lang=html4strict>
<span class="vcard">
<span class="fn nickname">daveman692</span>
</span>
</source>

また、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:
<source lang=html4strict>
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred):
<span class="value">+1.415.555.1212</span>
</span>
</source>

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

<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.

<source lang=html4strict>
<span class="tel"><span class="type">Home</span> +1.415.555.1212</span>
</source>

is equivalent to:

<source lang=html4strict>
<span class="tel"><span class="type">Home</span><span class="value"> +1.415.555.1212</span></span>
</source>

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>

=== プロファイル ===
hCard の <span id="XMDP_Profile">XMDP プロファイル</span> は http://microformats.org/profile/hcard にあります。

hCard を使うコンテンツは、
<source lang=html4strict>
<link rel="profile" href="http://microformats.org/profile/hcard">
</source>
や
<source lang=html4strict>
このコンテンツは <a rel="profile" href="http://microformats.org/profile/hcard">hCard</a> を使っています。
</source>
又は
<source lang=html4strict>
<head rel="profile" href="http://microformats.org/profile/hcard">
</source>
などとしてこのプロファイルに触れるべきです（{{should}}）。
（profile 属性は HTML5 で廃止予定です）
なお、上にある方法を組み合わせてもかまいません。

=== パース処理 ===
[[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]] をご覧ください。

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

この 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

<source lang=html4strict>
<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>
</source>

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

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

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

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

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

== 記事 ==
このセクションは'''参考情報'''です。hCard の<span id="その他の読み物">他の読み物</span>は[[hcard-articles-ja|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://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] をご覧ください。

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

{{MicroFormatPublicDomainContributionStatement}}

== 特許 ==
{{MicroFormatPatentStatement-ja}}

== 参考文献 ==
=== 規範的な参考文献 ===
* [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]] に解説があるので、そちらをご覧ください。

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

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

[[Category:hCard]]

== 翻訳 ==
* [[hcard|english]]（英語）
* [[hcard-fr|français]]（フランス語）
* [[hcard-ru|Русский]]（ロシア語）
* [[hcard-zh|汉语]]（中国語）

Microformats Wiki - User contributions [en]

hcard-ja