Revision as of 15:28, 14 July 2007

hCard cheetsheet

vcard {1}
- adr*
  - type [work|home|pref|postal|dom|intl]?
  - post-office-box?
  - street-address*
  - extended-address?
  - region?
  - locality?
  - postal-code?
  - country-name?
- agent*
- bday? (ISO date)
- class? confidentiality/access classification of the entire hCard
- category*
- email*
  - type?
  - value?
- fn {1}
- geo?
  - latitude?
  - longitude?
- key*
- label*
- logo*
- mailer*
- n?
  - honorific-prefix*
  - given-name*
  - additional-name*
  - family-name*
  - honorific-suffix*
- nickname*
- note*
- org*
  - organization-name?
  - organization-unit*
- photo*
- rev? datetime of the revision of the entire hCard
- role*
- sort-string?
- sound*
- title*
- tel* (Note E.123 for formatting info.)
  - type [home|work|pref|fax|cell|pager]?
  - value?
- tz? timezone of the person
- uid? applies to the entire hCard
- url*

bold {1}	MUST be present exactly once
italic*	OPTIONAL, and MAY occur more than once
+	MUST be present, and MAY occur more than once
?	OPTIONAL, but MUST NOT occur more than once
[square brackets]	list of common values
(parentheses)	data format
#	comment
!	awaiting documentation

FAQ: "why 'adr'?"
URL in vCard becomes <a class="url" href=...>...</a> inside the element with class 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.
If an adr-child (e.g street-address) is present it will ONLY be considered part of the hCard data IF it is inside an adr.

@@ Line 76: / Line 76: @@
 ====Geo====
 * If latitude is present, so MUST be longitude, and vice versa.
-* Coordinates MAY be combined a single &lt;abbr&gt; element; then the latitude and longitude MUST be separated by a semicolon in the title attribute and latitude MUST be first:
+* Coordinates MAY be combined a single
-:<code><nowiki><abbr class="geo" title="37.386013;-122.082932">home</abbr></nowiki></code>
-* The same number of decimal places SHOULD be used in each value.
-* Coordinates use the datum of [http://en.wikipedia.org/wiki/World_Geodetic_System WGS84].
-* [http://wikitravel.org/en/Wikitravel:Geocoding#Sources_for_lat.2Flongs Sources for latitude/ longitude coordinates]
-==Related pages==
-{{hcard-related-pages}}
-*{{cheatsheets}}