View source for hcard-th

<h1>hCard</h1>
{{TOC-right}}
hCard เป็นรูปแบบไมโครฟอร์แมตที่เรียบง่ายที่ใช้เป็นสัญลักษณ์ของผู้คน บริษัท องค์กร และสถานที่  hCardใช้คุณสมบัติต่างๆจากมาตรฐาน vCard ([[rfc-2426|ใน RFC2426]]) และใช้งานผ่าน [[semantic-xhtml|HTML หรือ XHTML]]

hCard เป็นหนึ่งในไม่กี่มาตรฐานเปิดใน [[microformats|ไมโครฟอร์แมต]] ที่เหมาะสำหรับการนำไป embed ใน HTML, XHTML, Atom, RSS, และ XML

อยากจะเริ่มเขียน [[hcard|hCard]] แล้วหรือยัง?  ลองดูที่ [http://microformats.org/code/hcard/creator เครื่องมือสร้าง hCard] เพื่อสร้างที่อยู่ติดต่อ  หรือจะลองอ่าน [[hcard-authoring|เกร็ดในการสร้าง hCard]] เพื่อ mark up หน้าเว็บติดต่อของคุณดูก็ได้

== Specification ==

<div class="vcard">
; <span class="role">บรรณาธิการ</span> 
: <span class="fn">[[User:Tantek|Tantek Çelik (แทนเทค เซลิค)]]</span> (<span class="url">http://tantek.com/</span>, [http://technorati.com Technorati, Inc.], และ [http://microsoft.com/ Microsoft Corporation])
</div>
; ผู้แต่ง: [http://tantek.com/ Tantek Çelik] (รายชื่อผู้มีส่วนร่วมอยู่ด้านบน)
: <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]]) ได้ถูกนำมาใช้อย่างแพร่หลาย (เช่นในโปรแกรม "Address Book" ของบริษัทแอปเปิลที่พ่วงมากับระบบปฏิบัติการ MacOSX).

นอกจากนั้น เจ้าของบล๊อกหลายๆคนก็ระบุชื่อตัวเองเวลาบล๊อก และบางคนก็พูดถึงเพื่อนๆหรือครอบครัวตัวเอง  ถ้าเราเพิ่มโคงสร้างอีกเล็กน้อยให้เนื้อหา เจ้าของบล๊อกก็สามารถพูดถึงบุคคลต่างๆเหล่านี้โดยที่ spider และ aggregator ต่างๆสามารถดึงเอาข้อมูลเกี่ยวกับบุคคลเหล่านี้ได้จากเนื้อหาหน้าเว็บและแปลงมันมาเป็น vCard เพื่อใช้ในแอพพลิเคชั่นต่างๆได้อย่างง่ายดาย

Specification นี้แนะนำฟอร์แมต '''hCard''' ซึ่งใช้คุณสมบัติและค่าต่างๆจากมาตรฐาน vCard ในเนื้อหา HTML ตามที่ได้กล่าวไว้ก่อนหน้านี้  เจ้าของบล๊อกสามารถฝัง hCard เข้าไปในหน้าเว็บได้เลย และตกแต่ง hCard ด้วย CSS ตามที่ต้องการ  นอกจากนั้น แอพพลิเคชั่นต่างๆก็สามารถดึงข้อมูล hCard จากหน้าเว็บได้โดยตรงโดยที่ไม่ต้องใช้ไฟล์อื่นเพิ่มเติมแม้แต่น้อย

คุณสามารถใช้เครื่องมือ [http://microformats.org/code/hcard/creator ตัวสร้าง hCard] และก็คัดลอก HTML ที่เครื่องมือนี้สร้้างให้ไปใส่ในบล๊อกหรือหน้าเว็บคุณเพื่อเผยแพร่ข้อมูลติดต่อของคุณได้

{{rfc-2119-intro-th}}

== รายละเอียด ==
=== ข้อมูลเบื้องต้น ===
มาตรฐาน vCard ([[rfc-2426|RFC2426]]) เป็นรากฐานสำหรับ hCard

รูปแบบของ hCard คือการใช้ class เพื่อแทน object/property ของ vCard โดยชื่อของ object/property นั้นจะถูกเขียนด้วยตัวอักษรตัวเล็ก ส่วน vCard ที่ซ้อนกันหลายชั้นจะแทนที่ด้วย HTML element ที่ซ้อนๆกัน

=== ชื่อคลาสราก (Root Class Name) ===
ชื่อคลาสรากสำหรับ hCard คือ "vcard"  element ที่มี class "vcard" ก็เป็น ''hCard'' ด้วยเช่นกัน

=== คุณสมบัติและคุณสมบัติย่อย (Properties and Sub-properties) ===
ข้อมูลของคุณสมบัติต่างๆ (properties) ใน hCard อยู่ใน element ที่เป็นตัวแทนของคุณสมบัติเหล่านั้น  โดยที่ class ของแต่ละ element เป็นตัวบ่งบอกคุณสมบัติที่ element นั้นเป็นตัวแทน  ส่วนค่าของ element ก็คือค่าของคุณสมบัตินั้นๆ

บางคุณสมบัติสามารถมีคุณสมบัติย่อย (sub-properties) ได้ ซึ่งคุณสมบัติย่อยเหล่านั้นจะถูกแทนค่า่ด้วย element ย่อยภายใน element ของคุณสมบัติแม่

=== รายชื่อคุณสมบัติ ===
รายชื่อคุณสมบัติต่างๆของ hCard อยู่ในรายการด้านล่าง (คุณสมบัติย่อยจะอยู่ในเครื่องหมายวงเล็บแบบนี้)

เพื่อความกระชับและความเข้าใจ คำอธิบายภาษาไทยของแต่ละคุณสมบัติหรือคุณสมบัติย่อยได้ถูกเขียนต่อท้ายชื่อคุณสมบัติที่เป็นภาษาอังกฤษ เวลาใช้งานไมโครฟอร์แมตในเนื้อหาของคุณ อย่าลืมใช้ชื่อคุณสมบัติภาษาอังกฤษนะครับ

'''คุณสมบัติที่จะต้องมีใน 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 คำต่อท้ายชื่อ)</span>
คุณสมบัติที่อาจมีหรือไม่มีก็ได้:
* 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' เป็นคุณสมบัติที่ {{optional-th}} ถ้า[[hcard#Implied_.22n.22_Optimization|การแทนค่าคุณสมบัติ "n" แบบเป็นนัย]]มีผลบังคับใช้<br />
<span id="note2">[[#property-list-tel|2. ^]]</span>: tel - สำหรับคุณสมบัติ tel ผู้ใช้ {{may-th}} ให้ใช้รูปแบบเบอร์โทรศัพท์ตามมาตรฐาน [http://en.wikipedia.org/wiki/E.123 E.123] ได้ โดยที่ตัวอักษรที่อยู่ในรูปแบบ (เช่น +1-555-FORMATS) {{must-th}} ถูกแทนที่ด้วยตัวเลข  นอกจากนั้นคุณยังสามารถใช้ <code>abbr</code> เพื่อแสดงตัวอักษรและระบุึ้ค่าตัวเลขไปพร้อมๆกัน  เช่น <code><nowiki><abbr title="+15553676287">+1-555-FORMATS</abbr></nowiki></code>.

=== คุณสมบัติที่เป็นเอกพจน์และพหูพจน์ ===
คุณสมบัติที่เป็นเอกพจน์มีดังนี้: 'fn', 'n', 'bday', 'tz', 'geo', 'sort-string', 'uid', 'class'

สำหรับคุณสมบัติเหล่านี้ กรณีที่มี element มากกว่าหนึ่งตัวที่เป็นตัวแทนของคุณสมบัติเดียวกัน ให้ถือว่า element ตัวแรกเท่านั้นที่มีความหมาย

คุณสมบัติอื่นๆ {{may-th}} เป็นพหูพจน์ได้  และการใช้คุณสมบัติเหล่านี้แต่ละครั้งเป็นการสร้างค่าใหม่ขึ้นมา

=== เนื้อหาสำหรับคนและเครื่อง ===
ค่าต่างๆของคุณสมบัติ ใน hCard ปกติจะมาจากเนื้อหาที่คนอ่านได้บนหน้าเว็บ โดยมีข้อยกเว้นบางประการ:

ถ้ามีการใช้ <code>&lt;abbr&gt;</code> ให้ใส่ค่าของคุณสมบัตินั้น (ซึ่งก็คือชื่อเต็ม) ใน attribute '<code>title</code>' (ของ &lt;abbr&gt;)  ส่วนเนื้อหาของ <code>&lt;abbr&gt;</code> จะใช้เพื่อแสดงคำย่อแทนเพื่อให้อ่านง่ายขึ้น

ถ้ามีการใช้ <code>&lt;a&gt;</code> {{must-th}} ทำตามกฏเหล่านี้:
# สำหรับคุณสมบัติ 'photo' และคุณสมบัติอื่นๆที่มีค่าเป็น URL ให้ใส่ค่าของคุณสมบัตินั้นใน attribute <code>href="..."</code>
# สำหรับคุณสมบัติอื่นๆที่ค่าไม่ใช่ URL ให้ใส่ค่าของคุณสมบัติในเนื้อหาของ <code>&lt;a&gt;</code>

ถ้ามีการใช้ <code>&lt;img&gt;</code> {{must-th}} ทำตามกฏเหล่านี้:
# สำหรับคุณสมบัติ 'photo' และคุณสมบัติอื่นๆที่มีค่าเป็น URL ให้ใส่ค่าของคุณสมบัตินั้นใน attribute <code>src="..."</code>
# สำหรับคุณสมบัติอื่นๆที่ค่าไม่ใช่ URL ให้ใส่ค่าของคุณสมบัตินั้นใน attribute '<code>alt</code>'

ถ้ามีการใช้ <code>&lt;object&gt;</code> {{must-th}} ทำตามกฏเหล่านี้:
# สำหรับคุณสมบัติ 'photo' และคุณสมบัติอื่นๆที่มีค่าเป็น URL ให้ใส่ค่าของคุณสมบัตินั้นใน attribute <code>data="..."</code>
# สำหรับคุณสมบัติอื่นๆที่ค่าไม่ใช่ URL ให้ใส่ค่าของคุณสมบัตินั้นในเนื้อหาของ <code>&lt;object&gt;</code>

=== Value excerpting ===
Sometimes only part of an element which is the equivalent for a property is used for the value of the property.  This typically occurs when a property has a subtype, like 'tel'. For this purpose, the special class name "<code>value</code>" is used to excerpt out the subset of the element that is the value of the property. E.g. here is an hCard fragment for marking up a home phone number:<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>

This hCard fragment 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="value">+1.415.555.1212</span>
</span>
</div>

<!-- note for Tantek: review/edit property casing from here on -->

=== Property Exceptions ===
vCard has several properties which either do not make sense on, or are already implied within the context of a web page.  This section explains what to (not) do with them.

# vCard's '''NAME''', '''PROFILE''', '''SOURCE''', '''PRODID''', '''VERSION''' properties are defined in Sections 2.1.2, 2.1.3, 2.1.4, 3.6.3, 3.6.9 of [[rfc-2426|RFC2426]].  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 HTML documents) to construct the NAME property, {{may}} output a PROFILE value of "<code>VCARD</code>" per [[rfc-2426|RFC2426]], {{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 [[rfc-2426|RFC2426]] Section 3.6.9.

=== ที่อยู่ติดต่อสำหรับองค์กร ===
ถ้าคุณสมบัติ "FN" และ "ORG" มีค่าเดียวกัน (ซึ่งอาจเกิดได้เพราะคุณสมบัติทั้งสองถูกใช้พร้อมกันในหนึ่ง element เช่น class="fn org") ให้ถือว่า hCard นั้นเป็น hCard สำหรับบริษัท องค์กร หรือสถานที่และ {{should-th}} ถูกใช้ในความหมายนี้  ในกรณีนี้ผู้สร้าง hCard {{must-not-th}} ใส่ค่า หรือใส่เป็นค่าว่างๆ (empty string) สำหรับคุณสมบัติ "N" และคุณสมบัติย่อยของมัน  นอกจากนั้น parser {{should-th}} รองรับกรณีที่ไม่มีคุณสมบัติ "N" ใน hCard ด้วย

=== การแทนค่าคุณสมบัติ "n" แบบเป็นนัย ===
ถึงแม้ว่ามาตรฐาน vCard บังคับให้คุณต้องใส่ค่าสำหรับคุณสมบัติ "N"  แต่ในตัวอย่างท้ายมาตรฐาน vCard ([[rfc-2426|RFC2426]]) (หน้า 38) เองก็ไม่ได้ใส่คุณสมบัตินี้  ทำให้เกิดความขัดแย้งกับมาตรฐานขึ้น  เราสามารถแก้ไขความขัดแย้งนี้โดยการใช้ "FN" แทนที่ "N" ในการใช้งานทั่วๆไป

ถ้าค่าของ "FN" และ "ORG" แตกต่างกัน (ลองดูในหมวดก่อนหน้า) และค่าของ "FN" มีความยาวเท่ากับสองคำ (คั่นด้วยเว้นวรรค) และก็ไม่มีการระบุคุณสมบัติ "N" ในที่ใดๆอีก ให้ถือว่าค่าของ "N" นั้นคือค่าของ คุณสมบัติ "FN"

สำหรับ "FN" ที่มีคำแค่คำเดียวให้ดูด้านล่าง  และสำหรับ "FN" ทีมีสามคำขึ้นไป ผู้แต่ง {{must-th}} ระบุ markup "N" ยกเว้นในกรณีของที่อยู่ติดต่อขององค์กร [http://microformats.org/wiki/hcard#Organization_Contact_Info ดูด้านบน]

# เนื้อหาของ "FN" แบ่งออกเป็นสอง "คำ" คั่นด้วยเว้นวรรค
# ''คำแรก'' ของ "FN" แทนความหมายของ "ชื่อ" ในคุณสมบัติ "N"
# ''คำที่สอง'' ของ "FN" แทนความหมายของ "นามสกุล" ในคุณสมบัติ "N"
# ข้อยกเว้น: ถ้าคำแรกลงท้ายด้วยคอมม่า หรือถ้าคำที่สองมีตัวอักษรเดียว (โดยมีหรือไม่มีจุดต่อท้าย) ให้ถือว่าคำแรก (ไม่รวมคอมม่า ถ้ามี) เป็น "นามสกุล" และคำที่สองคือ "ชื่อ"

กฏนี้จะทำให้การใช้งานโดยทั่วๆเหล่านี้ทำได้ง่ายขึ้น:
* ชื่อ (เว้นวรรค) นามสกุล
* นามสกุล (คอมม่า) ชื่อ
* นามสกุล (คอมม่า) ตัวอักษรแรกของชื่อ
* นามสกุล (เว้นวรรค) ตัวอักษรแรกของชื่อ (จุด ถ้ามี)

หมายเหตุจากผู้แปล: สองกรณีหลังเป็นกรณีที่ใช้บ่อยในชื่อภาษาอังกฤษ ซึ่งอาจไม่ได้ใช้สำหรับภาษาไทย ในภาษาอังกฤษนาย John Smith อาจะจะเขียนชื่อเป็น Smith, John หรือ Smith, J. หรือ Smith J ก็ได้ ในขณะที่ชื่อภาษาไทยไม่มีการใช้รูปแบบอย่างนี้

=== การแทนค่าคุณสมบัติ "nickname" แบบเป็นนัย ===
เนื่องจากมีการใช้ชื่อเล่น/นามแฝง/ชื่อผู้ใช้อย่างแพร่หลายในเนื้อหาต่างๆในอินเตอร์เน็ต (เช่นโดยผู้เขียน [[hReview|reviews]]) hCard เองก็มีวิธีการระบุชื่อเล่นเช่นกัน

คล้ายๆกับการแทนค่า "N" แบบเป็นนัย  ถ้า "FN" และ "ORG" มีค่าต่างกันและค่าของ "FN" เป็นคำที่มีความยาวหนึ่งคำ และไม่มีการระบุคุณสมบัติ "N" อื่นๆ:

# เนื้อหาของ "FN" {{must-th}} มีค่าเป็น "ชื่อเล่น"
# Parser {{should-th}} รองรับกรณีที่ไม่มีคุณสมบัติ "N" โดยสันนิษฐานว่าค่าของคุณสมบัตินี้และคุณสมบัติย่อยของมันเป็นค่าว่าง (empty value)

ถึงแม้ว่า parser {{must-th}} ทำตามกฏที่กล่าวไว้ข้างต้น ผู้เขียนข้อมูลเองก็ {{should-th}} ระบุ "ชื่อเล่น" ให้ชัดเจนเช่นกัน ยกตัวอย่างเช่น:

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

นอกเหนือจากค่า "nickname" ที่ได้มาแบบเป็นนัยจากการใช้ "FN" แล้ว ผู้ใช้ {{may-th}} ระบุค่า "nickname" อื่นๆใน hCard ได้เพิ่มเติมเช่นกัน

=== การแทนค่าคุณสมบัติ "organization-name" แบบเป็นนัย ===
คุณสมบัติ "ORG" มีสองคุณสมบัติย่อยคือ organization-name (ชื่อ) และ organization-unit (หน่วยงาน)  บ่อยครั้งที่ผู้เขียนต้องการเผยแพร่แค่ชื่อองค์กรอย่างเดียว ซึ่งในกรณีนี้ผู้เขียนไม่ต้องใส่คุณสมบัติย่อย "organization-name" แต่ {{must-th}} ใส่ชื่อองค์กรในเนื้อหาของ element แทน

=== 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 ===
ค่าของคุณสมบัติย่อย 'type' (ชนิด) ขึ้นอยู่กับคุณสมบัติหลักที่ใช้มัน  ค่าของ 'type' ไม่มีความแตกต่างระหว่างตัวอักษรเล็กหรือใหญ่ หมายความว่าค่า "Home" มีค่าเท่ากับ "home" นอกจากนั้นค่าของ 'type' ก็สามารถมีได้หลายค่า เช่น. เบอร์โทรศัทพ์ (คุณสมบัติ tel) สามารถเป็นได้ทั้งเบอร์บ้าน (home) และเบอร์ติดต่อหลัก (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>

ซึ่งสามารถแสดงผลได้เป็น:

<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' แต่ไม่มีการระบุค่าขอบคุณสมบัติย่อยนี้ผ่าน 'value' ให้ถือว่าอะไรก็ตามที่อยู่ในคุณสมบัติหลักเป็น 'value'  ยกตัวอย่างเช่น

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

มีค่าเท่ากับ:

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

ซึ่งหมายความว่าชนิดของเบอร์โทรศัพท์นี้เป็นโทรศัพท์บ้าน ("home") และค่าของมัน ("value") ก็คือ "+1.415.555.1212".

==== type สำหรับคุณสมบัติ adr tel และ email ====
รายละเอียดด้านล่างมีไว้เพื่อ ''ให้ข้อมูลอ้างอิง''  กรุณาดู [[rfc-2426|RFC2426]] บทที่ 3.2.1 ADR, 3.3.1 TEL, และ 3.3.2 EMAIL เพื่อดูรายละเอียดเพิ่มเติม  ข้อมูลในที่นี้ได้ถูกคัดลอกมาเพื่อความสะดวกในการอ่าน

ค่าที่เลือกโดยอัตโนมัติหรือค่า default คือค่าแรกที่อยู่ในแต่ละรายการด้านล่างและเขียนด้วยตัวอักษรใหญ่ทั้งหมด  คุณสมบัติย่อย 'type' สำหรับคุณสมบัติเหล่านี้สามารถมีได้มากกว่าหนึ่งค่า

* ค่าของ 'type' เมื่อใช้กับคุณสมบัติ adr: INTL, POSTAL, PARCEL, WORK, dom, home, pref
* ค่าของ 'type' เมื่อใช้กับคุณสมบัติ tel: VOICE, home, msg, work, pref, fax, cell, video, pager, bbs, modem, [http://flickr.com/photos/tags/carcellphone/ car], isdn, pcs
* ค่าของ 'type' เมื่อใช้กับคุณสมบัติ email: 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) ===

ดู [[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>

และเมื่อแปลงมาเป็น hCard โดยแปลง element ต่างๆตามความเหมาะสมแล้ว  ลองดู [[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>

หมายเหตุ: ข้อมูลเวอร์ชั่นนั้นไม่จำเป็นสำหรับ hCard เนื่องจากเลขเวอร์ชั่นจะถูกตั้งโดยโปรไฟล์ (profile) ของ hCard ที่ถูกใช้ / อ้างอิงถึงในแอททริบิวท์ 'profile' ของ <head> อยู่แล้ว

===Live example===

นี่คือตัวอย่างรายละเอียดติดต่อจากเว็บ [http://www.commerce.net/ Commercenet] ที่ได้มาจากการใช้เครื่องมือ parse ไมโครฟอร์แมตในการค้นหา:

<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>&nbsp;&nbsp;<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>

ด้านล่างคือ mark-up จากเว็บที่เอาตัวอักษรตัวหนาออกเพื่อให้อ่านง่าย โดยมีการปรับปรุงเนื้อหาคือ:
* <code>abbr</code> เพื่อขยายคำย่อ
* เพิ่มความหมายใน hyperlink เพื่อระบุ url สำหรับองค์กร โดยการใส่ url ต่อจาก fn org

<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>&nbsp;&nbsp;
    <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]] เพื่อดูตัวอย่างเพิ่มเติม รวมทั้งตัวอย่างจากการแปลง vCard [[rfc-2426|RFC2426]] มาเป็น hCard

==ปุ่มต่างๆ==
คุณสามารถใช้ปุ่มเหล่านี้ในหน้าเว็บของคุณทีมีการใช้ hCard  ลองดู [[buttons#hCard]] เพื่อดูปุ่มใหม่ๆ

* 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 จากที่เห็นที่ [http://re-run.com/about/microformat-badges microformat badges @ re-run]

== ตัวอย่างในอินเตอร์เน็ต ==
ส่วนนี้มีไว้เพื่ออ้างอิง  จำนวนตัวอย่างของการใช้ hCard ในอินเตอร์เน็ตได้ขยายมากเกินกว่าที่จะนำมาใส่ในหน้านี้ได้ ทำให้ตัวอย่างได้ถูกย้ายไปที่[[hcard-examples-in-wild|อีกหน้าหนึ่ง]]

ดู [[hcard-examples-in-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]].

== ลิขสิทธิ์ ==
ตามที่ผู้แต่ง ([[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 recommendation E.123] รูปแบบของเบอร์โทรศัพท์ (เอกสารที่อาจจะต้องจ่ายเงินเพื่อดู)
* [[rfc-2119|RFC 2119]]

=== ข้อมูลอ้างอิงทั่วไป ===
* [[hcard-history|ประวัติของ hCard]]
** [http://wiki.oreillynet.com/foocamp04/index.cgi?SimpleSemanticFormats FOO Camp 2004 การนำเสนอเรื่อง Simple Semantic Formats, 2004-09-10]
** [http://tantek.com/log/2004/09.html#hcard แนะนำความหมายของ hCard, 2004-09-30]
** ข้อมูลจาก http://developers.technorati.com/wiki/hCard 2005-06-20
* [http://www.dante.net/np/ds/osi/9594-6-X.520.A4.ps X.520 ใน 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 RFC2426 ในรูปแบบ HTML]
* [http://w3.org/TR/REC-CSS1 CSS1]
* [http://www.w3.org/TR/xhtml11 XHTML 1.1]
* [http://en.wikipedia.org/wiki/E.123 สรุปมาตรฐาน ITU-T Recommendation E.123 จากวิกิพีเดีย] - สำหรับค่า "TEL" (เบอร์โทรศัพท์)
* [http://www.imc.org/pdi/ Internet Mail Consortium Personal Data Interchange vCard and vCalendar]
* [[iso-8601|ISO8601]]

==== Specifications อื่นๆที่ใช้ hCard ====
* [[adr]]
* [[geo]]
* [[hcalendar|hCalendar]]
* [[hreview|hReview]]

==== งานที่คล้ายกัน ====
* [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 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.

== เอกสารสำหรับอ่านเพิ่มเติม ==
* [http://www.digital-web.com/articles/microformats_primer/ Digital Web Magazine: Microformats Primer] โดยการ์เร็ท ไดมอน มีการแนะนำ hCard ที่ดี
* [http://24ways.org/advent/practical-microformats-with-hcard Practical Microformats with hCard] โดยดรูว์ แม็คเลลแลน
* [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] 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 - ส่วนต่อขยายของ Instant Messaging]

== Related Pages ==
{{hcard-related-pages}}