hcard-cheatsheet: Difference between revisions
		
		
		
		
		
		Jump to navigation
		Jump to search
		
				
		
		
	
| AndyMabbett (talk | contribs) m (→Properties) | AndyMabbett (talk | contribs)   (→Properties:   (4)) | ||
| Line 4: | Line 4: | ||
| *class="'''vcard'''" (1) | *class="'''vcard'''" (1) | ||
| **class="''[[adr]]''" | **class="''[[adr]]''" (4) | ||
| ***class="type" [work|home|pref|postal|dom|intl] | ***class="type" [work|home|pref|postal|dom|intl] | ||
| ***class="post-office-box" | ***class="post-office-box" | ||
| Line 13: | Line 13: | ||
| ***class="postal-code" | ***class="postal-code" | ||
| ***class="country-name" | ***class="country-name" | ||
| **class="''agent''" | **class="''agent''" (4) | ||
| **class="[[hcard-singular-properties#bday|bday]]" ([[datetime-design-pattern |ISO date]])  (3) | **class="[[hcard-singular-properties#bday|bday]]" ([[datetime-design-pattern |ISO date]])  (3) | ||
| **class="[[hcard-singular-properties#class|class]]" – confidentiality/access classification of the ''entire'' hCard  (3) | **class="[[hcard-singular-properties#class|class]]" – confidentiality/access classification of the ''entire'' hCard  (3) | ||
| **class="''category''" | **class="''category''" (4) | ||
| **class="''email''" | **class="''email''" (4) | ||
| ***class="type" | ***class="type" | ||
| ***class="value" | ***class="value" | ||
| Line 24: | Line 24: | ||
| ***class="latitude" | ***class="latitude" | ||
| ***class="longitude" | ***class="longitude" | ||
| **class="''key''" | **class="''key''" (4) | ||
| **class="''label''" | **class="''label''" (4) | ||
| **class="''logo''" | **class="''logo''" (4) | ||
| **class="''mailer''" | **class="''mailer''" (4) | ||
| **class="[[hcard-singular-properties#n|n]]" (3) | **class="[[hcard-singular-properties#n|n]]" (3) | ||
| ***class="''honorific-prefix''" | ***class="''honorific-prefix''" | ||
| Line 34: | Line 34: | ||
| ***class="''family-name''" | ***class="''family-name''" | ||
| ***class="''honorific-suffix''" | ***class="''honorific-suffix''" | ||
| **class="''nickname''" | **class="''nickname''" (4) | ||
| **class="''note''" | **class="''note''" (4) | ||
| **class="''org''" | **class="''org''" (4) | ||
| ***class="organization-name"  | ***class="organization-name" | ||
| ***class="''organization-unit''" | ***class="''organization-unit''" | ||
| **class="''photo''" | **class="''photo''" (4) | ||
| **class="[[hcard-singular-properties#rev|rev]]" – datetime of the revision of the ''entire'' hCard (3) | **class="[[hcard-singular-properties#rev|rev]]" – datetime of the revision of the ''entire'' hCard (3) | ||
| **class="''role''" | **class="''role''" (4) | ||
| **class="[[hcard-singular-properties#sort-string|sort-string]]" (3) | **class="[[hcard-singular-properties#sort-string|sort-string]]" (3) | ||
| **class="''sound''" | **class="''sound''" (4) | ||
| **class="''title''" | **class="''title''" (4) | ||
| **class="''tel''" (Note [http://en.wikipedia.org/wiki/E.123 E.123] for formatting info.)   | **class="''tel''" (Note [http://en.wikipedia.org/wiki/E.123 E.123] for formatting info.) (4) | ||
| ***class="type" [home|work|pref|fax|cell|pager] | ***class="type" [home|work|pref|fax|cell|pager] | ||
| ***class="value" | ***class="value" | ||
| **class="[[hcard-singular-properties#tz|tz]]" – timezone of the person (3) | **class="[[hcard-singular-properties#tz|tz]]" – timezone of the person (3) | ||
| **class="[[hcard-singular-properties#uid|uid]]" – applies to the ''entire'' hCard (3) | **class="[[hcard-singular-properties#uid|uid]]" – applies to the ''entire'' hCard (3) | ||
| **class="''url''" | **class="''url''" (4) | ||
| ==Key== | ==Key== | ||
Revision as of 18:59, 28 November 2006
hCard cheetsheet
Properties
- class="vcard" (1)
- class="adr" (4)
- class="type" [work|home|pref|postal|dom|intl]
- class="post-office-box"
- class="street-address"
- class="extended-address"
- class="region"
- class="locality"
- class="postal-code"
- class="country-name"
 
- class="agent" (4)
- class="bday" (ISO date) (3)
- class="class" – confidentiality/access classification of the entire hCard (3)
- class="category" (4)
- class="email" (4)
- class="type"
- class="value"
 
- class="fn" (1)
- class="geo" (3)
- class="latitude"
- class="longitude"
 
- class="key" (4)
- class="label" (4)
- class="logo" (4)
- class="mailer" (4)
- class="n" (3)
- class="honorific-prefix"
- class="given-name"
- class="additional-name"
- class="family-name"
- class="honorific-suffix"
 
- class="nickname" (4)
- class="note" (4)
- class="org" (4)
- class="organization-name"
- class="organization-unit"
 
- class="photo" (4)
- class="rev" – datetime of the revision of the entire hCard (3)
- class="role" (4)
- class="sort-string" (3)
- class="sound" (4)
- class="title" (4)
- class="tel" (Note E.123 for formatting info.) (4)
- class="type" [home|work|pref|fax|cell|pager]
- class="value"
 
- class="tz" – timezone of the person (3)
- class="uid" – applies to the entire hCard (3)
- class="url" (4)
 
- class="adr" (4)
Key
- 1 - Single occurrence required
- 2 - One or more, required (n/a)
- 3 - single occurrence optional
- 4 - zero or more occurrence
- [square brackets] - common list of values
- (data format)
- pref = preferred
- dom = domestic
- intl = international
- cell = mobile
Notes
- URLin vCard becomes- <a class="url" href="...">...</a>inside the element with- class="vcard"in hCard.
- Similarly, EMAILin vCard becomes<a class="email" href="mailto:...">...</a>
- PHOTOin vCard becomes- <img class="photo" src="..." alt="Photo of ..." />or- <object class="photo" data="..." type="...">Photo of ...</object>
- UIDin vCard simply becomes another semantic applied to a specific URL (or EMAIL) for an hCard.
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.