profile-uris: Difference between revisions
(added a few more profile URLs) |
m (Atom advice, page cleanups) |
||
Line 52: | Line 52: | ||
<source lang=html4strict><p>This page uses | <source lang=html4strict><p>This page uses | ||
<a rel="profile" href="http://gmpg.org/xfn/11">XFN 1.1</a>!</p> | <a rel="profile" href="http://gmpg.org/xfn/11">XFN 1.1</a>!</p> | ||
</source> | |||
=== Atom 1.0 === | |||
(This is a draft idea being implemented in the XML::Atom::Microformats Perl parsing module.) | |||
To indicate that an Atom <code><content></code> element contains a Microformat, give the entry a <code><link rel="profile"></code> link to the relevant profile URI. You can indicate that ''all'' entries within a feed contain a particular microformat by including <code><link rel="profile"></code> on the root Atom <code><feed></code> element. | |||
Example: | |||
<source lang=xml> | |||
<feed> | |||
<title>Example Feed</title> | |||
<link rel="profile" href="http://ufs.cc/x/hcard" /> | |||
<entry> | |||
<title>Example Entry Containing hCard</title> | |||
<content type="text/html">...</content> | |||
</entry> | |||
<entry> | |||
<title>Example Entry Containing hCard and hCalendar</title> | |||
<content type="text/html">...</content> | |||
<link rel="profile" href="http://ufs.cc/x/hcalendar" /> | |||
</entry> | |||
</feed> | |||
</source> | </source> | ||
Line 63: | Line 86: | ||
=== Cognition=== | === Cognition=== | ||
In "strict mode", [http://buzzword.org.uk/ | In "strict mode", [http://buzzword.org.uk/swignition/ Swignition] (formerly called Cognition) refuses to parse any microformats where the profile URI has not been explicitly declared on the page. (It will however, still parse microformats for which there exists no profile URI!) | ||
=== HTML::Microformats === | |||
[http://microformats.org/wiki/parsers#HTML::Microformats HTML::Microformats] uses profile URIs to toggle support for individual microformats. | |||
== Issues == | == Issues == | ||
Line 158: | Line 185: | ||
¶ = non-XMDP profile. | ¶ = non-XMDP profile. | ||
=== Other Interesting Profile URIs === | |||
* [http://purl.org/uF/pattern-data-class/1 Experimental data-* class pattern] | * [http://purl.org/uF/pattern-data-class/1 Experimental data-* class pattern] | ||
* [http://purl.org/stuff/hdoap/profile hDOAP (posh format)] ¶† | * [http://purl.org/stuff/hdoap/profile hDOAP (posh format)] ¶† |
Revision as of 09:51, 28 April 2010
Individual Microformats
- adr
- geo
- hCard
- http://microformats.org/profile/hcard
- http://ufs.cc/x/hcard
- hAtom
- http://microformats.org/profile/hatom
- http://ufs.cc/x/hatom
- hCalendar
- http://microformats.org/profile/hcalendar
- http://ufs.cc/x/hcalendar
- hResume
- http://microformats.org/profile/hresume
- http://ufs.cc/x/hresume
- hReview
- http://microformats.org/profile/hreview
- http://ufs.cc/x/hreview
- rel-license
- http://microformats.org/profile/rel-license
- http://ufs.cc/x/rel-license
- rel-nofollow
- http://microformats.org/profile/rel-nofollow
- http://ufs.cc/x/rel-nofollow
- rel-tag
- http://microformats.org/profile/rel-tag
- http://ufs.cc/x/rel-tag
- vote-links
- http://microformats.org/profile/vote-links
- http://ufs.cc/x/vote-links
- XFN
- http://gmpg.org/xfn/11
- xFolk
- http://microformats.org/profile/xfolk
- http://ufs.cc/x/xfolk
- XMDP
- http://gmpg.org/xmdp/1
- XOXO
- http://microformats.org/profile/xoxo
- http://ufs.cc/x/xoxo
How to link to a profile URI
HTML 4.x / XHTML 1.x
<head profile="http://gmpg.org/xfn/11 http://microformats.org/profile/hcard">
(X)HTML 5 / XHTML 2
An alternative method is provided for people using markup languages which do not support <head profile>
. Add rel="profile"
to either a visible link (<a>
) or hidden link (<link>
).
Example:
<p>This page uses
<a rel="profile" href="http://gmpg.org/xfn/11">XFN 1.1</a>!</p>
Atom 1.0
(This is a draft idea being implemented in the XML::Atom::Microformats Perl parsing module.)
To indicate that an Atom <content>
element contains a Microformat, give the entry a <link rel="profile">
link to the relevant profile URI. You can indicate that all entries within a feed contain a particular microformat by including <link rel="profile">
on the root Atom <feed>
element.
Example:
<feed>
<title>Example Feed</title>
<link rel="profile" href="http://ufs.cc/x/hcard" />
<entry>
<title>Example Entry Containing hCard</title>
<content type="text/html">...</content>
</entry>
<entry>
<title>Example Entry Containing hCard and hCalendar</title>
<content type="text/html">...</content>
<link rel="profile" href="http://ufs.cc/x/hcalendar" />
</entry>
</feed>
Content Management Systems
For cms's there is:
Implementations
GRDDL
Tools that support GRDDL use profiles to parse microformats.
Cognition
In "strict mode", Swignition (formerly called Cognition) refuses to parse any microformats where the profile URI has not been explicitly declared on the page. (It will however, still parse microformats for which there exists no profile URI!)
HTML::Microformats
HTML::Microformats uses profile URIs to toggle support for individual microformats.
Issues
When this section gets too big, move it to profile-uris-issues Some issues include:
- what domain to use? Candidates include:
- microformats.org
- www.w3.org
- gmpg.org
- One proposal is: use www.w3.org, following W3C namespace policy.
- Use microformats.org and GMPG profile URIs - Tantek 10:17, 6 August 2009 (UTC)
- what about versioning? How to keep in sync with the wiki and test materials?
- As to versioning, change the profile whenever the underlying spec changes significantly (within some reasonable latency, say, a couple weeks or a month). For example: an hCard Profile at w3.org, and discussion: an hCard profile that seems to work with GRDDL.
- what profile URI to use for combinations, such as hcard and hcalendar?
- note HTML4.01 states "that one or more meta data profiles, [are] separated by white space"; though it's simpler for authors if they can just use one profile URI.
- e.g. use
<head profile="http://microformats.org/profile/hcard http://microformats.org/profile/hcalendar">
- More profiles are needed.
- Like which ones??
Validator warning
Due to inconsistent wording of the HTML specs, HTMLTidy (and other tools?) give "Warning: <head> escaping malformed URI reference" when more than one profile is used, e.g.
<head profile="http://microformats.org/profile/hcard http://microformats.org/profile/hcalendar">
W3C HTML validator has very poor validation of attributes and is technically unable to check this case. The HTML DTD however defines profile
attribute as %URI
(it's an alias for CDATA
), same as <a href>
attribute.
Experimental URIs
The following includes URIs to external experimental XMDPs, and should only be used for testing purposes.
Experimental Combined Profile
The following URL covers all non-draft Microformats as of March 2008, except XMDP. You can mix and match it with other XMDP profiles for new/draft microformats.
Experimental Individual Microformats
- adr
- (Use an hCard profile.)
- (Or use the combined profile.)
- figure
- http://purl.org/uF/figure/draft
- geo
- http://purl.org/uF/geo/0.9/
- (Or use an hCard profile.)
- (Or use the combined profile.)
- hAtom
- http://purl.org/uF/hAtom/0.1/
- hAudio
- http://purl.org/NET/haudio †
- http://purl.org/uF/hAudio/0.9/ †
- hCalendar
- http://purl.org/uF/hCalendar/1.0/ †
- http://www.w3.org/2002/12/cal/hcal ¶†
- http://dannyayers.com/microformats/hcalendar-profile †
- (Or use the combined profile.)
- hCard
- http://purl.org/uF/hCard/1.0/ †
- http://www.w3.org/2006/03/hcard †
- (Or use the combined profile.)
- hResume
- http://microformats.org/wiki/hresume-profile
- hReview
- http://www.purl.org/stuff/rev# †
- rel-license
- http://purl.org/uF/rel-license/1.0/ †
- (Or use the combined profile.)
- rel-nofollow
- http://purl.org/uF/rel-nofollow/1.0/
- (Or use the combined profile.)
- rel-tag
- http://purl.org/uF/rel-tag/1.0/
- (Or use the combined profile.)
- VoteLinks
- http://purl.org/uF/VoteLinks/1.0/ †
- http://tommorris.org/profiles/votelinks ¶†
- (Or use the combined profile.)
- XFN
- http://gmpg.org/xfn/11
- http://gmpg.org/xfn/1 (older version)
- (Or use the combined profile.)
- xFolk
- http://microformats.org/wiki/xfolk-profile
- XOXO
- (Use the combined profile.)
† = GRDDL-enabled.
¶ = non-XMDP profile.
Other Interesting Profile URIs
See also
- hcard-profile
- hcalendar-profile
- Profile URI examples, in the wild
- faqs-for-rdf for discussion of connecting microformats to URIs.