Microformats Wiki - User contributions [en]

Main Page

2006-09-17T04:29:40Z

Jim Dalton: /* Exploratory Discussions */ added links to job listing examples and brainstorming (existing pages)

__NOTOC__
= Microformats Wiki =

'''Please read [[how-to-play]] before making any edits.'''

'''Please read [[process]] before proposing any new microformats.'''

== Introduction ==

[[what-are-microformats|What are microformats]]? And [[what-can-you-do-with-microformats|what can you do with them]]? See the [http://microformats.org/about/ about page] for an overview, and the [[introduction]] page for more info. Recent [[press]], [[presentations]], [[podcasts]], and [[screencasts]] are also a good place for some background reading/listening. Frequently asked questions are answered in the [[faq]]. Want something or want to contribute? Help with things [[to-do]]. Want to learn more in person? Check out microformats [[events]].

One popular definition from our [http://microformats.org/discuss/ mailing list] (see also: [[mailing-lists]]) is "simple conventions for embedding semantics in HTML to enable decentralized development." More precisely, microformats can be defined as:
:simple conventions
:for embedding semantic markup
::for a specific problem domain
:in human-readable (X)HTML/XML documents, Atom/RSS feeds, and "plain" XML
::that normalize existing content usage patterns
::using brief, descriptive class names
::often based on existing interoperable standards
:to enable decentralized development
::of resources, tools, and services

"Or do you just use your browser to browse? That's so 20th century." -- [http://diveintomark.org Mark Pilgrim]

== How to contribute ==

Want to help take microformats to the next level?

Check out our open [[to-do]] list for things to help get done. Join the [http://microformats.org/discuss mailing lists and irc channel] and learn and help answer questions about microformats.

Take a look at the [[Main_Page#microformats_wiki_in_other_languages| microformats wiki in other languages]] and help translate the microformats wiki to make microformats globally accessible.

== Specifications ==
[[microformats|Microformats]] open standards specifications (see also: [[implementations]])
* [[hcalendar|hCalendar]]
* [[hcard|hCard]]
* [[rel-license]]
* [[rel-nofollow]]
* [[rel-tag]]
* [[vote-links|VoteLinks]]
* [http://gmpg.org/xfn/ XFN] (see also: [[xfn-implementations]])
* [http://gmpg.org/xmdp/ XMDP]
* [[xoxo|XOXO]]

== Drafts ==
* [[adr|adr]]
* [[geo|geo]]
* [[hatom|hAtom]] {{NewMarker}}
* [[hresume|hResume]] {{NewMarker}}
* [[hreview|hReview]]
* [[rel-directory]]
* [[rel-enclosure]]
* [[rel-home]]
* [[relpayment-research | rel-payment]]
* [[robots-exclusion|Robots Exclusion]]
* [[xfolk|xFolk]]

== Design Patterns ==

{{design_patterns}} 

== Exploratory Discussions ==
Research and analysis of real-world [[examples]], existing formats, and brainstorming to motivate the microformat.
*[[attention]]
* blog description [[blog-description-examples|examples]]
* blog info [[blog-info-examples|examples]]
* blog post [[blog-post-examples|examples]], [[blog-post-formats|formats]], and [[blog-post-brainstorming|brainstorming]] (yielded the [[hatom|hAtom]] draft)
* book [[book-examples|examples]], [[book-formats|formats]], and [[book-brainstorming|brainstorming]]
* chat [[chat-examples|examples]], [[chat-formats|formats]], and [[chat-brainstorming|brainstorming]]
* citation [[citation|effort]], [[citation-examples|examples]], [[citation-formats|formats]], [[citation-brainstorming|brainstorming]], and [[citation-faq|FAQ]]
* comment [[comment-problem|problem]], [[comment-examples|examples]], and [[comments-formats|formats]] (Some stuff needs to be extracted from [[comments-formats]])
* currency [[currency-examples|examples and brainstorming]] {{NewMarker}}
* directions [[directions-examples|examples]] {{NewMarker}}
* directory inclusion [[directory-inclusion-examples|examples]], [[directory-inclusion-formats|formats]]. (see also [[rel-directory]])
* distributed conversation [[distributed-conversation|overview]], [[distributed-conversation-brainstorming|brainstorming]], [[distributed-conversation-examples|examples]], and [[distributed-conversation-formats|formats]]
* forms [[forms-examples|examples]]
* genealogy [[genealogy-formats|examples]]
* group [[group-brainstorming|brainstorming]] and [[group-examples|examples]]
* hash [[hash-examples|examples]]
* job listing [[job-listing-examples|examples]] and [[job-listing-brainstorming|brainstorming]]
* last modified [[last-modified-examples|examples]], [[last-modified-formats|formats]], and [[last-modified-brainstorming|brainstorming]]
* hListing [[hlisting-proposal|proposal]], and [[hlisting-feedback|feedback]] {{NewMarker}}
** Also, listing [[listing-examples|examples]], [[listing-formats|formats]], and [[listing-brainstorming|brainstorming]]
* location [[location-formats|formats]]. (see also [[adr]] and [[geo]])
* media info [[media-info-examples|examples]]
* meeting minutes [[meeting-minutes-examples|examples]], [[meeting-minutes-formats|formats]], and [[meeting-minutes-brainstorming|brainstorming]]
* metalink [[metalink-examples|examples]] {{NewMarker}}
* [[mfo-examples|MFO examples]]
* music [[music-examples|examples]]
* photo note [[photo-note-examples|examples]]
* recipe [[recipe-examples|examples]]
* rel-product [[rel-product-brainstorming|brainstorming]]
* requirements testing [[requirements-testing|overview]], and [[requirements-testing-examples|examples]]
* [[rest-examples|REST examples]]
* resume [[resume-brainstorming|brainstorming]], and [[resume-formats|formats]]
* review [[review-examples|examples]], and [[review-formats|formats]] (yielded the [[hreview|hReview]] draft)
* search results [[search-results-example|example]]
* show [[show-brainstorming|brainstorming]]
* showroll [[showroll-brainstorming|brainstorming]]
* table [[table-examples|examples]]
* tagspeak [[tagspeak-examples|examples]]
* transit table [[transit-table-examples|examples]]
* [[uid]]
* widget [[widget-examples|examples]], and [[widget-brainstorming|brainstorming]]
* [[wiki-formats|wiki formats]]
* work of art [[work-of-art|overview]], [[workofart-examples|examples]], [[workofart-formats|formats]], and [[workofart-brainstorming|brainstorming]] {{NewMarker}}
*[[xmdp-brainstorming|XMDP brainstorming]] (see also [[xmdp-faq]])

== Examples ==
* [[examples]]
* [[zen-garden]]

== Tools & Test Cases & Additional Research ==

The first place to look for examples, code, and test cases is in the pages for each individual microformat. There are only a few cross-cutting tools and services that need to process more than one microformat. This section is intended for editors, parsers, validators, test cases, and other information relevant across multiple microformats.

*[[accessibility]]
*[[faqs-for-rdf]]
*[[icalendar-implementations]]
*[[parsing-microformats]]
*[[selected-test-cases-from-the-web]]
*[http://hg.microformats.org/ Source code repository]
*[[vcard-implementations]], [[vcard-errata]]
*[[why-are-content-standards-hard]]

== shared work areas ==
* [[buttons]] {{NewMarker}}
* [[demo]] - a page with links for quickly demonstrating microformats working in practice.
* [[events]] {{NewMarker}}
* [[to-do]]
* [[user-interface]]
* [[marked-for-deletion]]

== microformats wiki in other languages ==

You may read and edit microformats articles in many other languages:

* languages with over 50 articles
** [[Main_Page-fr|Français (French)]] {{NewMarker-fr}}
* languages with over 2 articles
** [[Main_Page-ja|日本語 (Japanese)]]
** [[Main_Page-es|Español (Spanish)]]
* languages with 2 articles
** [[Main_Page-de|Deutsch (German)]]

==== microformats translations elsewhere ====
These are offsite pages/sites with translations about microformats. If you are working on one of these, please consider translating the main microformats website!
* [http://mikroformate.pbwiki.com/ Deutsch (German) mikroformate.pbwiki.com] {{NewMarker}}

=== Start a microformats wiki in another language ===

Don't see the language you want? Help translate the microformats wiki into another language!

We're still figuring this out.

For now, see the [http://en.wikipedia.org/wiki/Wikipedia:Multilingual_coordination Wikipedia page on Multilingual coordination], and [http://meta.wikimedia.org/wiki/How_to_start_a_new_Wikipedia How to start a new Wikipedia] for some good general tips, advice, and community conventions.

You may want to start with the list of [[stable-pages]], which are pages that are relatively stable, and have only minimal/editorial changes, which makes them much easier to keep in sync with the English versions, by using the [[Special:Watchlist|my watchlist]] feature (use it to watch the pages you've translated for changes).

Page naming: for the translated version of a page, use the same name for the page, and simply add the RFC 3066 language identifier code as a dash suffix. E.g. for the French version, [[Main_Page]] becomes [[Main_Page-fr]], and [[how-to-play]] becomes [[how-to-play-fr]].

==== more languages folks want to see ====

* Chinese: 微格式 (Microformats) (see [http://msittig.blogspot.com/2005/11/since-i-translated-schedule-of.html source of translation])

group-examples

2006-08-11T18:49:26Z

Jim Dalton: added real world examples

= Introduction =
This page is to collect examples of '''groups''' and how members of groups / group memberships are organized and marked up.

== Real World Examples ==

=== Flickr Groups ===

The following example is a member of [http://flickr.com/groups/microformats/ Flickr Groups]. Note that the code below is _not_ from the main group but on a members page at http://www.flickr.com/groups_members.gne?id=41758902@N00.

<pre><nowiki>
<p class="MembersList">
<a href="/photos/luxuryluke/">
<img src="http://static.flickr.com/3/buddyicons/75654019@N00.jpg?1155219928" alt="view profile" width="48" height="48"><br />
luxuryluke
</a>
</p>
</nowiki></pre>

=== YouTube Groups ===

The following example is for a member of a [http://www.youtube.com/group/mentosgeysercontest|YouTube group]. Again, the actual member list is on a different URI - http://www.youtube.com/groups_members?name=mentosgeysercontest .

<pre><nowiki>
<div class="v120vEntry">
<div class="vstill">
<a href="/user/spoiledmilk"><img src="http://sjl-static2.sjl.youtube.com/vi/3TYkzmGX9E8/2.jpg" class="vimg"></a>
</div>
<div class="vtitle">
<a href="/profile?user=spoiledmilk">spoiledmilk</a>
</div>
<div class="vfacets">
<span class="grayText">Joined:</span> August 02, 2006<br>
<span class="grayText">Videos:</span> <a href="/profile_videos?user=spoiledmilk">21</a>
</div>
</div> 
</nowiki></pre>

=== LinkedIn Connections ===

A different take...these are "members" of someone's profile (i.e. their connections) on LinkedIn. This is from the "connections" link on a person's profile.

<pre><nowiki>
<td width="33%">
<span name="connection">
<a href="/profile?viewProfile=&key=725541&goback=%2Econ_1%2Evpf_44779_0_*1_*1_*2_Gerry_XXXXXX%2C+SPHR%2Ebcc_44779_1" >Eric XXXXXX</a>
</span><br>
<span name="headline" class="headline">Sr. Corporate Recruiter - XXXXXX Pharmaceuticals</span>
</td>
</nowiki></pre>

''Note since this is a closed network I "x'ed" out identifying info from the above.'' --[[User:Jim Dalton|Jim Dalton]] 11:49, 11 Aug 2006 (PDT)

=== Others ===
* [http://microformats.org/about/people/ microformats | People] - Contributers to a project should be marked up.
* [http://ma.gnolia.com/groups/microformats Ma.gnolia Groups]
* [http://forum.textdrive.com/userlist.php Forum Userlists]
* [http://groups.myspace.com/index.cfm?fuseaction=groups.categories Myspace Groups]

== See also ==
* [[group-brainstorming]]

group-examples

2006-08-10T17:48:50Z

Jim Dalton:

= Introduction =
This page is to collect examples of '''groups''' and how members of groups / group memberships are organized and marked up.

== Real World Examples ==

* [http://microformats.org/about/people/ microformats | People] - Contributers to a project should be marked up.
* [http://ma.gnolia.com/groups/microformats Ma.gnolia Groups]
* [http://flickr.com/groups/microformats/ Flickr Groups]
* [http://forum.textdrive.com/userlist.php Forum Userlists]
* [http://groups.myspace.com/index.cfm?fuseaction=groups.categories Myspace Groups]

== See also ==
* [[group-brainstorming]]

group-brainstorming

2006-08-10T17:46:57Z

Jim Dalton: /* Real World Examples */ moved examples list to groups-examples

= Group Brainstorming =

This page is for brainstorming about ideas, proposals, constraints, requirements for a Groups microformat.

== Authors ==

* [[User:ChrisMessina | Chris Messina]]
* [[User:Josh | Josh Peek]]
* [http://tantek.com/ Tantek Çelik]

== Problem ==

See [http://microformats.org/discuss/mail/microformats-discuss/2006-February/003181.html Chris Messina's original thoughts] on microformats-discuss.

Not every page belongs to one user. We need a microformat to define a group of people.

There are two distinct problems here though.

The problem that Chris's proposal describes is actually just one of tagging. By tagging people with the same tag, you "place" them into a group as defined by that tag. That's the model presented by Chris's ASCII art diagram.

The simpler problem to solve is perhaps the Group equivalent of [http://gmpg.org/xfn/ XFN]

How does a person indicate that they belong to of a group?

How does a group indicate that a person is a member of that group?

== A Proposed Structure ==

From [http://microformats.org/discuss/mail/microformats-discuss/2006-February/003181.html Chris Messina's original post]

--Group Name
| Description
| Tags
|
+--+ Members
| |
| +-- Member 1 (hcard)
| |
| +-- Member 2 (hcard)
|
+--+ Pool
|
+--+ Topic
|
+-- Post 1 (hatom)
|
+-- Post 2 (hatom)

This model is totally overdesigned. A groups microformat should start as simple as possible, meaning, nothing but the idea of a group and members. That's the 80% in common case across various systems. People in a group. A group with people. Nothing more. -Tantek

<s>Add optional roles. Groups may have "admins", "moderators", or "members". Or if you were marking up a contributes page, you could have "programmers", "designers", etc.</s> Is this what you mean by tags? - Josh

No, those are roles. I mean the very *name* of a group could be interpreted simply as a tag on a person.

For example a named group of bookmarks are nothing more than a tag that all those bookmarks share.

Any taxonomy of group roles (admins, moderators, etc.) should be postponed.

-Tantek

To keep it simple, could we say that hGroup is just a container for other microformats. That would cover members (hcards) and topics (atom). - Josh

No. Both (a) naming and (b) proposing a structure (container) are both premature for a microformat, until the proper research has been done and documented on the wiki. Please follow the [[process]].

-Tantek

== Real World Examples ==

See [[group-examples]] for current implementations.

== Rel Group Member Proposal ==

I think Eran proposed this first, but just to make sure it is captured:
* rel="group" - used by an individual to link to their groups
* rel="member" - used by a group's site on links to its members

== Possible Implementations ==

Groups could define there members on their own homepage. Social web sites could pick up the group list from the groups site instead. You'd instantly have your group on every (dreaming) social web service.

== See Also ==
* [[hcard]]
* [http://gmpg.org/xfn/ XFN]

group-examples

2006-08-10T17:46:20Z

Jim Dalton: Moved real world examples list from group-brainstorming

Main Page

2006-08-10T17:38:57Z

Jim Dalton: Added link to group brainstorming and examples under Exploratory Discussions

__NOTOC__
= Microformats Wiki =

'''Please read [[how-to-play]] before making any edits.'''

'''Please read [[process]] before proposing any new microformats.'''

== Introduction ==

[[what-are-microformats|What are microformats]]? And [[what-can-you-do-with-microformats|what can you do with them]]? See the [http://microformats.org/about/ about page] for an overview, and the [[introduction]] page for more info. Recent [[press]], [[presentations]], [[podcasts]], and [[screencasts]] are also a good place for some background reading/listening. Frequently asked questions are answered in the [[faq]]. Want something or want to contribute? Help with things [[to-do]]. Want to learn more in person? Check out microformats [[events]].

One popular definition from our [http://microformats.org/discuss/ mailing list] (see also: [[mailing-lists]]) is "simple conventions for embedding semantics in HTML to enable decentralized development." More precisely, microformats can be defined as:
:simple conventions
:for embedding semantic markup
::for a specific problem domain
:in human-readable (X)HTML/XML documents, Atom/RSS feeds, and "plain" XML
::that normalize existing content usage patterns
::using brief, descriptive class names
::often based on existing interoperable standards
:to enable decentralized development
::of resources, tools, and services

"Or do you just use your browser to browse? That's so 20th century." -- [http://diveintomark.org Mark Pilgrim]

== Specifications ==
[[microformats|Microformats]] open standards specifications (see also: [[implementations]])
* [[hcalendar|hCalendar]]
* [[hcard|hCard]]
* [[rel-license]]
* [[rel-nofollow]]
* [[rel-tag]]
* [[vote-links|VoteLinks]]
* [http://gmpg.org/xfn/ XFN] (see also: [[xfn-implementations]])
* [http://gmpg.org/xmdp/ XMDP]
* [[xoxo|XOXO]]

== Drafts ==
* [[adr|adr]]
* [[geo|geo]]
* [[hatom|hAtom]] {{NewMarker}}
* [[hresume|hResume]] {{NewMarker}}
* [[hreview|hReview]]
* [[rel-directory]]
* [[rel-enclosure]]
* [[rel-home]]
* [[relpayment-research | rel-payment]]
* [[robots-exclusion|Robots Exclusion]]
* [[xfolk|xFolk]]

== Design Patterns ==

{{design_patterns}} 

== Exploratory Discussions ==
Research and analysis of real-world [[examples]], existing formats, and brainstorming to motivate the microformat.
*[[attention]]
* blog description [[blog-description-examples|examples]]
* blog info [[blog-info-examples|examples]]
* blog post [[blog-post-examples|examples]], [[blog-post-formats|formats]], and [[blog-post-brainstorming|brainstorming]] (yielded the [[hatom|hAtom]] draft)
* book [[book-examples|examples]], [[book-formats|formats]], and [[book-brainstorming|brainstorming]]
* chat [[chat-examples|examples]], [[chat-formats|formats]], and [[chat-brainstorming|brainstorming]]
* citation [[citation|effort]], [[citation-examples|examples]], [[citation-formats|formats]], [[citation-brainstorming|brainstorming]], and [[citation-faq|FAQ]]
* comment [[comment-problem|problem]], [[comment-examples|examples]], and [[comments-formats|formats]] (Some stuff needs to be extracted from [[comments-formats]])
* currency [[currency-examples|examples and brainstorming]] {{NewMarker}}
* directions [[directions-examples|examples]] {{NewMarker}}
* directory inclusion [[directory-inclusion-examples|examples]], [[directory-inclusion-formats|formats]]. (see also [[rel-directory]])
* distributed conversation [[distributed-conversation|overview]], [[distributed-conversation-brainstorming|brainstorming]], [[distributed-conversation-examples|examples]], and [[distributed-conversation-formats|formats]]
* forms [[forms-examples|examples]]
* genealogy [[genealogy-formats|examples]]
* group [[group-brainstorming|brainstorming]] and [[group-examples|examples]]
* hash [[hash-examples|examples]]
* last modified [[last-modified-examples|examples]], [[last-modified-formats|formats]], and [[last-modified-brainstorming|brainstorming]]
* hListing [[hlisting-proposal|proposal]], and [[hlisting-feedback|feedback]] {{NewMarker}}
** Also, listing [[listing-examples|examples]], [[listing-formats|formats]], and [[listing-brainstorming|brainstorming]]
* location [[location-formats|formats]]. (see also [[adr]] and [[geo]])
* media info [[media-info-examples|examples]]
* meeting minutes [[meeting-minutes-examples|examples]], [[meeting-minutes-formats|formats]], and [[meeting-minutes-brainstorming|brainstorming]]
* metalink [[metalink-examples|examples]] {{NewMarker}}
* [[mfo-examples|MFO examples]]
* music [[music-examples|examples]]
* photo note [[photo-note-examples|examples]]
* recipe [[recipe-examples|examples]]
* rel-product [[rel-product-brainstorming|brainstorming]]
* requirements testing [[requirements-testing|overview]], and [[requirements-testing-examples|examples]]
* [[rest-examples|REST examples]]
* resume [[resume-brainstorming|brainstorming]], and [[resume-formats|formats]]
* review [[review-examples|examples]], and [[review-formats|formats]] (yielded the [[hreview|hReview]] draft)
* search results [[search-results-example|example]]
* show [[show-brainstorming|brainstorming]]
* showroll [[showroll-brainstorming|brainstorming]]
* table [[table-examples|examples]]
* tagspeak [[tagspeak-examples|examples]]
* transit table [[transit-table-examples|examples]]
* [[uid]]
* widget [[widget-examples|examples]], and [[widget-brainstorming|brainstorming]]
* [[wiki-formats|wiki formats]]
* work of art [[work-of-art|overview]], [[workofart-examples|examples]], [[workofart-formats|formats]], and [[workofart-brainstorming|brainstorming]] {{NewMarker}}
*[[xmdp-brainstorming|XMDP brainstorming]] (see also [[xmdp-faq]])

== Examples ==
* [[examples]]
* [[zen-garden]]

== Tools & Test Cases & Additional Research ==

The first place to look for examples, code, and test cases is in the pages for each individual microformat. There are only a few cross-cutting tools and services that need to process more than one microformat. This section is intended for editors, parsers, validators, test cases, and other information relevant across multiple microformats.

*[[accessibility]]
*[[faqs-for-rdf]]
*[[icalendar-implementations]]
*[[parsing-microformats]]
*[[selected-test-cases-from-the-web]]
*[http://hg.microformats.org/ Source code repository]
*[[vcard-implementations]], [[vcard-errata]]
*[[why-are-content-standards-hard]]

== shared work areas ==
* [[buttons]] {{NewMarker}}
* [[demo]] - a page with links for quickly demonstrating microformats working in practice.
* [[events]] {{NewMarker}}
* [[to-do]]
* [[user-interface]]
* [[marked-for-deletion]]

== microformats wiki in other languages ==

You may read and edit microformats articles in many other languages:

* languages with over 50 articles
** [[Main_Page-fr|Français (French)]] {{NewMarker-fr}}
* languages with over 2 articles
** [[Main_Page-ja|日本語 (Japanese)]]
** [[Main_Page-es|Español (Spanish)]]
* languages with 2 articles
** [[Main_Page-de|Deutsch (German)]]

==== microformats translations elsewhere ====
These are offsite pages/sites with translations about microformats. If you are working on one of these, please consider translating the main microformats website!
* [http://mikroformate.pbwiki.com/ Deutsch (German) mikroformate.pbwiki.com] {{NewMarker}}

=== Start a microformats wiki in another language ===

Don't see the language you want? Help translate the microformats wiki into another language!

We're still figuring this out.

For now, see the [http://en.wikipedia.org/wiki/Wikipedia:Multilingual_coordination Wikipedia page on Multilingual coordination], and [http://meta.wikimedia.org/wiki/How_to_start_a_new_Wikipedia How to start a new Wikipedia] for some good general tips, advice, and community conventions.

You may want to start with the list of [[stable-pages]], which are pages that are relatively stable, and have only minimal/editorial changes, which makes them much easier to keep in sync with the English versions, by using the [[Special:Watchlist|my watchlist]] feature (use it to watch the pages you've translated for changes).

Page naming: for the translated version of a page, use the same name for the page, and simply add the RFC 3066 language identifier code as a dash suffix. E.g. for the French version, [[Main_Page]] becomes [[Main_Page-fr]], and [[how-to-play]] becomes [[how-to-play-fr]].

==== more languages folks want to see ====

* Chinese: 微格式 (Microformats) (see [http://msittig.blogspot.com/2005/11/since-i-translated-schedule-of.html source of translation])