hcard-th: Difference between revisions
m (→Specification) |
|||
(2 intermediate revisions by the same user not shown) | |||
Line 7: | Line 7: | ||
อยากจะเริ่มเขียน [[hcard|hCard]] แล้วหรือยัง? ลองดูที่ [http://microformats.org/code/hcard/creator เครื่องมือสร้าง hCard] เพื่อสร้างที่อยู่ติดต่อ หรือจะลองอ่าน [[hcard-authoring|เกร็ดในการสร้าง hCard]] เพื่อ mark up หน้าเว็บติดต่อของคุณดูก็ได้ | อยากจะเริ่มเขียน [[hcard|hCard]] แล้วหรือยัง? ลองดูที่ [http://microformats.org/code/hcard/creator เครื่องมือสร้าง hCard] เพื่อสร้างที่อยู่ติดต่อ หรือจะลองอ่าน [[hcard-authoring|เกร็ดในการสร้าง hCard]] เพื่อ mark up หน้าเว็บติดต่อของคุณดูก็ได้ | ||
== | == ข้อกำหนด == | ||
<div class="vcard"> | <div class="vcard"> | ||
Line 362: | Line 362: | ||
* [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp] | * [http://www.jabber.org/jeps/jep-0054.html JEP-0054: vcard-temp] | ||
== | == แรงบันดาลใจและกิตติกรรมประกาศ == | ||
ขอบคุณ: เพื่อนที่ดีของผม [http://vadim.com/ Vadim] ซึ่งทำให้ผมได้รู้จักกับ vCard ''หลาย'' ปีที่แล้ว ถ้าผมใ่ส่ใจในเรื่องนี้มากกว่านี้สักหน่อยในตอนนั้น ผมคงจะช่วยให้หลายๆคนไม่ต้องเสียเวลาสร้างมาตรฐานใหม่เพื่อที่ทำสิ่งเดียวกับมาตรฐานที่มีอยู่แล้ว | |||
== | == บันทึกเกี่ยวกับส่วนดัดแปลงจาก vCard == | ||
ส่วนนี้มีไว้เพื่อ ''อ้างอิง'' | |||
<div id="Semantic_XHTML_Design_Principles"> | <div id="Semantic_XHTML_Design_Principles">ดู: [[hcard-design-methodology]].</div> | ||
=== More Semantic Equivalents === | === More Semantic Equivalents === | ||
Line 377: | Line 377: | ||
* <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard. | * <code>UID</code> in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard. | ||
=== | === ส่วนดัดแปลงเกี่ยวกับการใช้เอกพจน์และพหูพจน์ === | ||
[[hcard#Singular_vs._Plural_Properties|รายชื่อคุณสมบัติที่เป็นเอกพจน์และพหูพจน์]] ได้มาจากการวิเคราะห์ความหมายของแต่ละคุณสมบัติใน vCard RFC2426 และตัดสินใจว่าคุณสมบัติไหน{{must-th}}เป็นเอกพจน์โดยดูตามความหมายของคุณสมบัตินั้นๆ ดูคำอธิบายเพิ่มเติมที่ [[hcard-singular-properties]] | |||
==== Plural Properties Singularized ==== | ==== Plural Properties Singularized ==== |
Latest revision as of 13:29, 6 August 2008
hCard
hCard เป็นรูปแบบไมโครฟอร์แมตที่เรียบง่ายที่ใช้เป็นสัญลักษณ์ของผู้คน บริษัท องค์กร และสถานที่ hCardใช้คุณสมบัติต่างๆจากมาตรฐาน vCard (ใน RFC2426) และใช้งานผ่าน HTML หรือ XHTML
hCard เป็นหนึ่งในไม่กี่มาตรฐานเปิดใน ไมโครฟอร์แมต ที่เหมาะสำหรับการนำไป embed ใน HTML, XHTML, Atom, RSS, และ XML
อยากจะเริ่มเขียน hCard แล้วหรือยัง? ลองดูที่ เครื่องมือสร้าง hCard เพื่อสร้างที่อยู่ติดต่อ หรือจะลองอ่าน เกร็ดในการสร้าง hCard เพื่อ mark up หน้าเว็บติดต่อของคุณดูก็ได้
ข้อกำหนด
- บรรณาธิการ
- Tantek Çelik (แทนเทค เซลิค) (http://tantek.com/, Technorati, Inc., และ Microsoft Corporation)
- ผู้แต่ง
- Tantek Çelik (รายชื่อผู้มีส่วนร่วมอยู่ด้านบน)
- Brian Suda (ไบรอัน ซูดา) (http://suda.co.uk/)
- กิตติกรรมประกาศ
- ดู กิตติกรรมประกาศ.
ลิขสิทธิ์ และ สิทธิบัตรมีผลบังคับใช้ตามที่ระบุ
แนะนำ
มาตรฐาน vCard (RFC2426) ได้ถูกนำมาใช้อย่างแพร่หลาย (เช่นในโปรแกรม "Address Book" ของบริษัทแอปเปิลที่พ่วงมากับระบบปฏิบัติการ MacOSX).
นอกจากนั้น เจ้าของบล๊อกหลายๆคนก็ระบุชื่อตัวเองเวลาบล๊อก และบางคนก็พูดถึงเพื่อนๆหรือครอบครัวตัวเอง ถ้าเราเพิ่มโคงสร้างอีกเล็กน้อยให้เนื้อหา เจ้าของบล๊อกก็สามารถพูดถึงบุคคลต่างๆเหล่านี้โดยที่ spider และ aggregator ต่างๆสามารถดึงเอาข้อมูลเกี่ยวกับบุคคลเหล่านี้ได้จากเนื้อหาหน้าเว็บและแปลงมันมาเป็น vCard เพื่อใช้ในแอพพลิเคชั่นต่างๆได้อย่างง่ายดาย
Specification นี้แนะนำฟอร์แมต hCard ซึ่งใช้คุณสมบัติและค่าต่างๆจากมาตรฐาน vCard ในเนื้อหา HTML ตามที่ได้กล่าวไว้ก่อนหน้านี้ เจ้าของบล๊อกสามารถฝัง hCard เข้าไปในหน้าเว็บได้เลย และตกแต่ง hCard ด้วย CSS ตามที่ต้องการ นอกจากนั้น แอพพลิเคชั่นต่างๆก็สามารถดึงข้อมูล hCard จากหน้าเว็บได้โดยตรงโดยที่ไม่ต้องใช้ไฟล์อื่นเพิ่มเติมแม้แต่น้อย
คุณสามารถใช้เครื่องมือ ตัวสร้าง hCard และก็คัดลอก HTML ที่เครื่องมือนี้สร้้างให้ไปใส่ในบล๊อกหรือหน้าเว็บคุณเพื่อเผยแพร่ข้อมูลติดต่อของคุณได้
คำพิเศษเหล่านี้ "จะต้อง ", "จะต้องไม่", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "ไม่ควรจะ", "RECOMMENDED", "สามารถ ", และ "มีหรือไม่มีก็ได้ " ให้ตีความหมายตามคำอธิบายใน RFC 2119.
รายละเอียด
ข้อมูลเบื้องต้น
มาตรฐาน vCard (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
- n1 (family-name นามสุกล, given-name ชื่อ, additional-name ชื่ออื่นๆ เช่นชื่อกลางถ้ามี, honorific-prefix คำนำหน้าชื่อ, honorific-suffix คำต่อท้ายชื่อ)
คุณสมบัติที่อาจมีหรือไม่มีก็ได้:
- nickname ชื่อเล่น, sort-string วิธีการเรียงลำดับชื่อ
- url ลิงก์ในอินเตอร์เน็ต, email อีเมล์ (type ชนิดของอีเมล์, value อีเมล์สำหรับชนิดนี้), tel เบอร์โทรศัพท์2 (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
หมายเหตุเกี่ยวกับคุณสมบัติ
1. ^: คุณสมบัติ 'n' เป็นคุณสมบัติที่ มีหรือไม่มีก็ได้ ถ้าการแทนค่าคุณสมบัติ "n" แบบเป็นนัยมีผลบังคับใช้
2. ^: tel - สำหรับคุณสมบัติ tel ผู้ใช้ สามารถ ให้ใช้รูปแบบเบอร์โทรศัพท์ตามมาตรฐาน E.123 ได้ โดยที่ตัวอักษรที่อยู่ในรูปแบบ (เช่น +1-555-FORMATS) จะต้อง ถูกแทนที่ด้วยตัวเลข นอกจากนั้นคุณยังสามารถใช้ abbr
เพื่อแสดงตัวอักษรและระบุึ้ค่าตัวเลขไปพร้อมๆกัน เช่น <abbr title="+15553676287">+1-555-FORMATS</abbr>
.
คุณสมบัติที่เป็นเอกพจน์และพหูพจน์
คุณสมบัติที่เป็นเอกพจน์มีดังนี้: 'fn', 'n', 'bday', 'tz', 'geo', 'sort-string', 'uid', 'class'
สำหรับคุณสมบัติเหล่านี้ กรณีที่มี element มากกว่าหนึ่งตัวที่เป็นตัวแทนของคุณสมบัติเดียวกัน ให้ถือว่า element ตัวแรกเท่านั้นที่มีความหมาย
คุณสมบัติอื่นๆ สามารถ เป็นพหูพจน์ได้ และการใช้คุณสมบัติเหล่านี้แต่ละครั้งเป็นการสร้างค่าใหม่ขึ้นมา
เนื้อหาสำหรับคนและเครื่อง
ค่าต่างๆของคุณสมบัติ ใน hCard ปกติจะมาจากเนื้อหาที่คนอ่านได้บนหน้าเว็บ โดยมีข้อยกเว้นบางประการ:
ถ้ามีการใช้ <abbr>
ให้ใส่ค่าของคุณสมบัตินั้น (ซึ่งก็คือชื่อเต็ม) ใน attribute 'title
' (ของ <abbr>) ส่วนเนื้อหาของ <abbr>
จะใช้เพื่อแสดงคำย่อแทนเพื่อให้อ่านง่ายขึ้น
ถ้ามีการใช้ <a>
จะต้อง ทำตามกฏเหล่านี้:
- สำหรับคุณสมบัติ 'photo' และคุณสมบัติอื่นๆที่มีค่าเป็น URL ให้ใส่ค่าของคุณสมบัตินั้นใน attribute
href="..."
- สำหรับคุณสมบัติอื่นๆที่ค่าไม่ใช่ URL ให้ใส่ค่าของคุณสมบัติในเนื้อหาของ
<a>
ถ้ามีการใช้ <img>
จะต้อง ทำตามกฏเหล่านี้:
- สำหรับคุณสมบัติ 'photo' และคุณสมบัติอื่นๆที่มีค่าเป็น URL ให้ใส่ค่าของคุณสมบัตินั้นใน attribute
src="..."
- สำหรับคุณสมบัติอื่นๆที่ค่าไม่ใช่ URL ให้ใส่ค่าของคุณสมบัตินั้นใน attribute '
alt
'
ถ้ามีการใช้ <object>
จะต้อง ทำตามกฏเหล่านี้:
- สำหรับคุณสมบัติ 'photo' และคุณสมบัติอื่นๆที่มีค่าเป็น URL ให้ใส่ค่าของคุณสมบัตินั้นใน attribute
data="..."
- สำหรับคุณสมบัติอื่นๆที่ค่าไม่ใช่ URL ให้ใส่ค่าของคุณสมบัตินั้นในเนื้อหาของ
<object>
การตัดตอนเนื้อหาเพื่อแทนค่าของคุณสมบัติ
ในบางครั้งแค่ส่วนใดส่วนหนึ่งของ element ถูกใช้แทนค่าของคุณสมบัติ เช่นในคุณสมบัติย่อยของ 'tel' ที่ใช้แทนชนิดของบอร์โทรศัพท์ สำหรับกรณีนี้ให้ใช้ชื่อ class "value
" เพื่อตัดตอนเนื้อหาส่วนที่แทนค่าของคุณสมบัติใน markup
ด้านล่างเป็นตัวอย่างของการใช้ class นี้สำหรับแทนค่าเบอร์โทรศัพท์บ้าน:
vCard:
TEL;TYPE=HOME:+1.415.555.1212
hCard:
<span class="tel"> <span class="type">home</span>: <span class="value">+1.415.555.1212</span> </span>
hCard นี้สามารถแสดงผลเป็น:
home: +1.415.555.1212
คุณสมบัติที่ไม่ใช้
vCard มีคุณสมบัติบางอันที่ไม่มีความหมายสำหรับเนื้อหาในหน้าเว็บ เนื้อหาส่วนนี้อธิบายว่าทำไมคุณไม่ควรใช้คุณสมบัติเหล่านั้น
- คุณสมบัติ NAME, PROFILE, SOURCE, PRODID, และ VERSION ของ vCard ถูกอธิบายในหัวข้อ 2.1.2, 2.1.3, 2.1.4, 3.6.3, และ 3.6.9 ของ RFC2426 ผู้เผยแพร่เนื้อหาจะต้องไม่ใช้คุณสมบัติเหล่านี้ใน hCard และผู้ใช้เนื้อหานี้จะต้องไม่นำคุณสมบัติเหล่านี้มาใช้ถ้ามีอยู่ใน hCard
- เมื่อมีการแปลงจาก vCard เป็น hCard คุณ ควรจะ ใช้ชื่อของหน้าเว็บที่มี hCard (จาก
<title>
ของเอกสาร HTML) เพื่อสร้างคุณสมบัติ NAME - MAY output a PROFILE value of "
VCARD
" per 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 RFC2426 Section 3.6.9.
ที่อยู่ติดต่อสำหรับองค์กร
ถ้าคุณสมบัติ "FN" และ "ORG" มีค่าเดียวกัน (ซึ่งอาจเกิดได้เพราะคุณสมบัติทั้งสองถูกใช้พร้อมกันในหนึ่ง element เช่น class="fn org") ให้ถือว่า hCard นั้นเป็น hCard สำหรับบริษัท องค์กร หรือสถานที่และ ควรจะ ถูกใช้ในความหมายนี้ ในกรณีนี้ผู้สร้าง hCard จะต้องไม่ ใส่ค่า หรือใส่เป็นค่าว่างๆ (empty string) สำหรับคุณสมบัติ "N" และคุณสมบัติย่อยของมัน นอกจากนั้น parser ควรจะ รองรับกรณีที่ไม่มีคุณสมบัติ "N" ใน hCard ด้วย
การแทนค่าคุณสมบัติ "n" แบบเป็นนัย
ถึงแม้ว่ามาตรฐาน vCard บังคับให้คุณต้องใส่ค่าสำหรับคุณสมบัติ "N" แต่ในตัวอย่างท้ายมาตรฐาน vCard (RFC2426) (หน้า 38) เองก็ไม่ได้ใส่คุณสมบัตินี้ ทำให้เกิดความขัดแย้งกับมาตรฐานขึ้น เราสามารถแก้ไขความขัดแย้งนี้โดยการใช้ "FN" แทนที่ "N" ในการใช้งานทั่วๆไป
ถ้าค่าของ "FN" และ "ORG" แตกต่างกัน (ลองดูในหมวดก่อนหน้า) และค่าของ "FN" มีความยาวเท่ากับสองคำ (คั่นด้วยเว้นวรรค) และก็ไม่มีการระบุคุณสมบัติ "N" ในที่ใดๆอีก ให้ถือว่าค่าของ "N" นั้นคือค่าของ คุณสมบัติ "FN"
สำหรับ "FN" ที่มีคำแค่คำเดียวให้ดูด้านล่าง และสำหรับ "FN" ทีมีสามคำขึ้นไป ผู้แต่ง จะต้อง ระบุ markup "N" ยกเว้นในกรณีของที่อยู่ติดต่อขององค์กร ดูด้านบน
- เนื้อหาของ "FN" แบ่งออกเป็นสอง "คำ" คั่นด้วยเว้นวรรค
- คำแรก ของ "FN" แทนความหมายของ "ชื่อ" ในคุณสมบัติ "N"
- คำที่สอง ของ "FN" แทนความหมายของ "นามสกุล" ในคุณสมบัติ "N"
- ข้อยกเว้น: ถ้าคำแรกลงท้ายด้วยคอมม่า หรือถ้าคำที่สองมีตัวอักษรเดียว (โดยมีหรือไม่มีจุดต่อท้าย) ให้ถือว่าคำแรก (ไม่รวมคอมม่า ถ้ามี) เป็น "นามสกุล" และคำที่สองคือ "ชื่อ"
กฏนี้จะทำให้การใช้งานโดยทั่วๆเหล่านี้ทำได้ง่ายขึ้น:
- ชื่อ (เว้นวรรค) นามสกุล
- นามสกุล (คอมม่า) ชื่อ
- นามสกุล (คอมม่า) ตัวอักษรแรกของชื่อ
- นามสกุล (เว้นวรรค) ตัวอักษรแรกของชื่อ (จุด ถ้ามี)
หมายเหตุจากผู้แปล: สองกรณีหลังเป็นกรณีที่ใช้บ่อยในชื่อภาษาอังกฤษ ซึ่งอาจไม่ได้ใช้สำหรับภาษาไทย ในภาษาอังกฤษนาย John Smith อาจะจะเขียนชื่อเป็น Smith, John หรือ Smith, J. หรือ Smith J ก็ได้ ในขณะที่ชื่อภาษาไทยไม่มีการใช้รูปแบบอย่างนี้
การแทนค่าคุณสมบัติ "nickname" แบบเป็นนัย
เนื่องจากมีการใช้ชื่อเล่น/นามแฝง/ชื่อผู้ใช้อย่างแพร่หลายในเนื้อหาต่างๆในอินเตอร์เน็ต (เช่นโดยผู้เขียน reviews) hCard เองก็มีวิธีการระบุชื่อเล่นเช่นกัน
คล้ายๆกับการแทนค่า "N" แบบเป็นนัย ถ้า "FN" และ "ORG" มีค่าต่างกันและค่าของ "FN" เป็นคำที่มีความยาวหนึ่งคำ และไม่มีการระบุคุณสมบัติ "N" อื่นๆ:
- เนื้อหาของ "FN" จะต้อง มีค่าเป็น "ชื่อเล่น"
- Parser ควรจะ รองรับกรณีที่ไม่มีคุณสมบัติ "N" โดยสันนิษฐานว่าค่าของคุณสมบัตินี้และคุณสมบัติย่อยของมันเป็นค่าว่าง (empty value)
ถึงแม้ว่า parser จะต้อง ทำตามกฏที่กล่าวไว้ข้างต้น ผู้เขียนข้อมูลเองก็ ควรจะ ระบุ "ชื่อเล่น" ให้ชัดเจนเช่นกัน ยกตัวอย่างเช่น:
<span class="vcard"> <span class="fn nickname">daveman692</span> </span>
นอกเหนือจากค่า "nickname" ที่ได้มาแบบเป็นนัยจากการใช้ "FN" แล้ว ผู้ใช้ สามารถ ระบุค่า "nickname" อื่นๆใน hCard ได้เพิ่มเติมเช่นกัน
การแทนค่าคุณสมบัติ "organization-name" แบบเป็นนัย
คุณสมบัติ "ORG" มีสองคุณสมบัติย่อยคือ organization-name (ชื่อ) และ organization-unit (หน่วยงาน) บ่อยครั้งที่ผู้เขียนต้องการเผยแพร่แค่ชื่อองค์กรอย่างเดียว ซึ่งในกรณีนี้ผู้เขียนไม่ต้องใส่คุณสมบัติย่อย "organization-name" แต่ จะต้อง ใส่ชื่อองค์กรในเนื้อหาของ element แทน
การใช้ Tag เพื่อจัดกลุ่ม
คุณ สามารถ แทนคุณสมบัติกลุ่มใน hCard ได้โดยการใช้ tag ผ่าน rel-tag เมื่อคุณสมบัติ category เป็น rel-tag ค่าของ tag นั้นถือเป็นชื่อของกลุ่ม
ค่าของคุณสมบัติย่อย type
ค่าของคุณสมบัติย่อย 'type' (ชนิด) ขึ้นอยู่กับคุณสมบัติหลักที่ใช้มัน ค่าของ 'type' ไม่มีความแตกต่างระหว่างตัวอักษรเล็กหรือใหญ่ หมายความว่าค่า "Home" มีค่าเท่ากับ "home" นอกจากนั้นค่าของ 'type' ก็สามารถมีได้หลายค่า เช่น. เบอร์โทรศัทพ์ (คุณสมบัติ tel) สามารถเป็นได้ทั้งเบอร์บ้าน (home) และเบอร์ติดต่อหลัก (preferred):
vCard:
TEL;TYPE=HOME,PREF:+1.415.555.1212
hCard:
<span class="tel"><span class="type">Home</span> (<span class="type">pref</span>erred): <span class="value">+1.415.555.1212</span> </span>
ซึ่งสามารถแสดงผลได้เป็น:
Home (preferred): +1.415.555.1212
คุณสมบัติที่ไม่ระบุค่า
เมื่อมีการระบุคุึณสมบัติย่อย 'type' แต่ไม่มีการระบุค่าขอบคุณสมบัติย่อยนี้ผ่าน 'value' ให้ถือว่าอะไรก็ตามที่อยู่ในคุณสมบัติหลักเป็น 'value' ยกตัวอย่างเช่น
<span class="tel"><span class="type">Home</span> +1.415.555.1212</span>
มีค่าเท่ากับ:
<span class="tel"><span class="type">Home</span><span class="value"> +1.415.555.1212</span></span>
ซึ่งหมายความว่าชนิดของเบอร์โทรศัพท์นี้เป็นโทรศัพท์บ้าน ("home") และค่าของมัน ("value") ก็คือ "+1.415.555.1212".
type สำหรับคุณสมบัติ adr tel และ email
รายละเอียดด้านล่างมีไว้เพื่อ ให้ข้อมูลอ้างอิง กรุณาดู 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, car, isdn, pcs
- ค่าของ 'type' เมื่อใช้กับคุณสมบัติ email: INTERNET, x400, pref, "other IANA registered address types"
XMDP Profile
See hcard-profile for the XMDP profile of hCard which contains the above complete list of properties, with references to their RFC2426 definitions.
การวิเคราะห์คำในประโยค (ทางไวยากรณ์) (Parsing)
ดู การวิเคราะห์คำทางไวยากรณ์สำหรับ hCard
ตัวอย่าง
ตัวอย่างของ vCard
ด้านล่างนี้เป็นตัวอย่างของ vCard:
BEGIN:VCARD VERSION:3.0 N:Çelik;Tantek FN:Tantek Çelik URL:http://tantek.com/ END:VCARD
และเมื่อแปลงมาเป็น hCard โดยแปลง element ต่างๆตามความเหมาะสมแล้ว ลองดู hCard Example 1 สำหรับรูปแบบพลิกแพลงอื่น
<div class="vcard"> <a class="url fn" href="http://tantek.com/">Tantek Çelik</a> </div>
hCard นี้สามารถถุูกแสดงผลแบบนี้:
หมายเหตุ: ข้อมูลเวอร์ชั่นนั้นไม่จำเป็นสำหรับ hCard เนื่องจากเลขเวอร์ชั่นจะถูกตั้งโดยโปรไฟล์ (profile) ของ hCard ที่ถูกใช้ / อ้างอิงถึงในแอททริบิวท์ 'profile' ของ <head> อยู่แล้ว
Live example
นี่คือตัวอย่างรายละเอียดติดต่อจากเว็บ Commercenet ที่ได้มาจากการใช้เครื่องมือ parse ไมโครฟอร์แมตในการค้นหา:
Palo Alto, CA 94301
ด้านล่างคือ mark-up จากเว็บที่เอาตัวอักษรตัวหนาออกเพื่อให้อ่านง่าย โดยมีการปรับปรุงเนื้อหาคือ:
abbr
เพื่อขยายคำย่อ- เพิ่มความหมายใน hyperlink เพื่อระบุ url สำหรับองค์กร โดยการใส่ url ต่อจาก fn org
<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>
ตัวอย่างอื่นๆ
ลองดู ตัวอย่าง hCard เพื่อดูตัวอย่างเพิ่มเติม รวมทั้งตัวอย่างจากการแปลง vCard RFC2426 มาเป็น hCard
ปุ่มต่างๆ
คุณสามารถใช้ปุ่มเหล่านี้ในหน้าเว็บของคุณทีมีการใช้ hCard ลองดู buttons#hCard เพื่อดูปุ่มใหม่ๆ
(mirror:
)
- ปุ่มที่สร้างด้วย CSS จากที่เห็นที่ microformat badges @ re-run
ตัวอย่างในอินเตอร์เน็ต
ส่วนนี้มีไว้เพื่ออ้างอิง จำนวนตัวอย่างของการใช้ hCard ในอินเตอร์เน็ตได้ขยายมากเกินกว่าที่จะนำมาใส่ในหน้านี้ได้ ทำให้ตัวอย่างได้ถูกย้ายไปที่อีกหน้าหนึ่ง
ดู ตัวอย่างของ 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 separate page.
ลิขสิทธิ์
ตามที่ผู้แต่ง (Tantek Çelik, Brian Suda) ได้ระบุไว้ เอกสารฉบับนี้ได้รับอนุญาติให้เผยแพร่กับสาธารณะได้
Public Domain Contribution Requirement. Since the author(s) released this work into the public domain, in order to maintain this work's public domain status, all contributors to this page agree to release their contributions to this page to the public domain as well. Contributors may indicate their agreement by adding the public domain release template to their user page per the Voluntary Public Domain Declarations instructions. Unreleased contributions may be reverted/removed.
สิทธิบัตร
This specification is subject to a royalty free patent policy, e.g. per the W3C Patent Policy, and IETF RFC3667 & RFC3668.
ข้อมูลอ้างอิง
ข้อมูลอ้างอิงเกี่ยวกับมาตรฐาน
- XHTML 1.0 SE
- vCard RFC2426
- ITU recommendation E.123 รูปแบบของเบอร์โทรศัพท์ (เอกสารที่อาจจะต้องจ่ายเงินเพื่อดู)
- RFC 2119
ข้อมูลอ้างอิงทั่วไป
- ประวัติของ hCard
- X.520 ใน Postscript (HTMLization courtesy of Google Cache) - vCard refers to ROLE as being "based on the X.520 Business Category explanatory attribute".
- RFC2426 ในรูปแบบ HTML
- CSS1
- XHTML 1.1
- สรุปมาตรฐาน ITU-T Recommendation E.123 จากวิกิพีเดีย - สำหรับค่า "TEL" (เบอร์โทรศัพท์)
- Internet Mail Consortium Personal Data Interchange vCard and vCalendar
- ISO8601
Specifications อื่นๆที่ใช้ hCard
งานที่คล้ายกัน
แรงบันดาลใจและกิตติกรรมประกาศ
ขอบคุณ: เพื่อนที่ดีของผม Vadim ซึ่งทำให้ผมได้รู้จักกับ vCard หลาย ปีที่แล้ว ถ้าผมใ่ส่ใจในเรื่องนี้มากกว่านี้สักหน่อยในตอนนั้น ผมคงจะช่วยให้หลายๆคนไม่ต้องเสียเวลาสร้างมาตรฐานใหม่เพื่อที่ทำสิ่งเดียวกับมาตรฐานที่มีอยู่แล้ว
บันทึกเกี่ยวกับส่วนดัดแปลงจาก vCard
ส่วนนี้มีไว้เพื่อ อ้างอิง
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:
URL
in vCard becomes<a class="url" href="...">...</a>
inside the element withclass="vcard"
in hCard.- Similarly,
EMAIL
in vCard becomes<a class="email" href="mailto:...">...</a>
PHOTO
in vCard becomes<img class="photo" src="..." alt="Photo of ..." />
or<object class="photo" data="..." type="...">Photo of ...</object>
UID
in vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.
ส่วนดัดแปลงเกี่ยวกับการใช้เอกพจน์และพหูพจน์
รายชื่อคุณสมบัติที่เป็นเอกพจน์และพหูพจน์ ได้มาจากการวิเคราะห์ความหมายของแต่ละคุณสมบัติใน vCard RFC2426 และตัดสินใจว่าคุณสมบัติไหนจะต้องเป็นเอกพจน์โดยดูตามความหมายของคุณสมบัตินั้นๆ ดูคำอธิบายเพิ่มเติมที่ hcard-singular-properties
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.
เอกสารสำหรับอ่านเพิ่มเติม
- Digital Web Magazine: Microformats Primer โดยการ์เร็ท ไดมอน มีการแนะนำ hCard ที่ดี
- Practical Microformats with hCard โดยดรูว์ แม็คเลลแลน
- Local Search Engine Optimization using Microformats โดยคริส ซิลเวอร์ สมิธ
- Andrew D. Hume ได้เขียนบล๊อกเกี่ยวกับ usable microformats ซึ่งพูดถึง hCard
- Jesse Skinner's introduction to hCard
- Shaun Shull's great post on How Microformats Affect SEO, including his hCard as an example.
- 24 Ways: Styling hCards with CSS A 24 Ways article - John Allsopp on styling hCard using CSS
- See also blogs discussing this page and the hCard tag
- RFC 4770 - ส่วนต่อขยายของ Instant Messaging
Related Pages
- hCard
- hCard cheatsheet - hCard properties
- hCard creator (feedback) - create your own hCard.
- hCard authoring - learn how to add hCard markup to your existing contact info.
- hCard examples - example usage of various classes within hCard.
- hCard examples in the wild - an on-going list of websites which use hCards.
- hcard-supporting-user-profiles - sites with user profiles marked up with hCard - a very common example.
- hCard FAQ - if you have any questions about hCard, check here.
- hCard implementations - websites or tools which either generate or parse hCards.
- hCard parsing - normative details of how to parse hCards.
- hCards and pages - semantic distinctions between different hCards on a page, and how to identify each
- hcard-user-interface - techniques and issues surrounding user-interfaces to author, publish, and display hCards.
- hCard profile - the XMDP profile for hCard
- hCard singular properties - an explanation of the list of singular properties in hCard.
- hCard tests - a wiki page with actual embedded hCards to try parsing.
- hCard advocacy - encourage others to use hCard
- hCard "to do" - jobs to do
The hCard specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added. These thoughts, issues, and questions are kept in separate pages.
- hCard brainstorming - brainstorms and other explorations relating to hCard.
- hcard-parsing-brainstorming - brainstorming specific to parsing of hCard
- geo brainstorming
- hCard feedback - general feedback (as opposed to specific issues).
- hCard issues - specific issues with the specification.
- vCard errata - corrections to the vCard specification, which underlies hCard.
- vCard suggestions - suggested improvements to the vCard specification.