Main Page: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
No edit summary
m (→‎Archived: fixing link)
(38 intermediate revisions by 17 users not shown)
Line 1: Line 1:
<entry-title>Welcome to the microformats wiki!</entry-title>
<entry-title>Welcome to the microformats wiki!</entry-title>
__TOC__
 
Please start with the [[introduction]] page and read [[how-to-play]] before making any edits.
'''<dfn>microformats</dfn>''' are HTML for marking up [[hCard|people, organizations]], [[hCalendar|events]], [[adr|locations]], [[hAtom|blog posts]], [[hProduct|products]], [[hReview|reviews]], [[hResume|resumes]], [[hRecipe|recipes]] etc. Sites use microformats to publish a standard API that is consumed and used by [[search engines]], [[browsers]], and other sites. See [[what-are-microformats]] for more.
 
* {{NewMarker}} '''[[microformats2]]''' is the latest stable & interoperable  version. Use it on public web pages and for APIs.


==Introduction==
==Introduction==
This wiki is the central resource of the microformats community. You'll find current versions of published microformat specifications, specification drafts and publishing patterns. The wiki also hosts development resources, such as brainstorming pages for new formats and issue tracking pages for all current and in-development microformats.
{{main|introduction}}
This wiki is the central resource of the microformats community and provides microformats authoring guides, references, specifications, drafts, publishing patterns, research, brainstorming, and issue tracking.


== Get Started==
== Get Started==
To get started with microformats:
{{main|get-started}}
Get started with microformats:


* First, be familiar writing your pages and applications with semantically rich, descriptive, ‘[[posh|<abbr title="Plain Old Semantic HTML">POSH</abbr>]]’ <abbr title="HyperText Mark-up Language">HTML</abbr>.
* First, make sure your pages and web apps use semantically rich, descriptive, ‘[[posh|<abbr title="Plain Old Semantic HTML">POSH</abbr>]]’ <abbr title="HyperText Mark-up Language">HTML</abbr>.
* Learn about microformats from the [http://microformats.org/about/ about page], [http://microformats.org/ blog], [http://www.boyacibadanaustasi.com/ boyacı], [[press]], [[presentations]], [[books]], [[podcasts]], & [[screencasts]] pages.
* Mark-up your contact info with [[hCard]] ([[hcard-authoring|see authoring tips]], [[hcard-examples|examples]]) and link from your personal site to other profiles with [[rel-me]].
* Take a look at established specifications such as [[hcard|hCard]] and [[hcalendar|hCalendar]], and follow the [[hcard-examples|examples]] to start publishing microformats.
* Questions? Read the [[faq|frequently asked questions]], ask on the [[IRC]] channel.
* Have questions? Read the [[faq|frequently asked questions]] and see the [[glossary]] for terms and definitions. You can also post to the {{MicroformatsMailingList}}.
* Want to learn more in person? Check out microformats [[events]].
* Want to learn more in person? Check out microformats [[events]].
==Definition==
Microformats are small patterns of HTML to represent commonly published things like [[hcard|people]], [[hcalendar|events]], [[hatom|blog posts]], [[hreview|reviews]] and [[rel-tag|tags]] in web pages.
Microformats enable the publishing of higher fidelity information on the Web; the fastest and simplest way to provide feeds and APIs for the information in your website.
* Read more explanations of [[what-are-microformats|what microformats are]], and [[what-can-you-do-with-microformats|what you can do with them]].


== How to contribute ==
== How to contribute ==
Do you want to help take microformats to the next level? You can:
Want to join in and contribute?


* [[get-started|Get started]] by adding microformats to your website, services, and products.
* [[get-started|Get started]] by adding microformats to your website, services, and products
* [[advocacy|Advocate]] the use of microformats on other web sites, especially those you use.
* [[advocacy|Advocate]] the use of microformats on other web sites, especially those you use
* Write a [[testimonial]].
* Read [[how-to-play]] before editing this wiki
* Join the [[irc|IRC Channel]] and [[mail|mailing lists]] to learn and help answer questions (read [[mailing-lists#General_guidelines|general guidelines]] before posting).
* Write a [[testimonial]]
* Write a blog post on: '''[[recently-in-microformats]]'''
* Do something on the [[to-do|to do list]].
* Do something on the [[to-do|to do list]].
* Join the [[irc|IRC Channel]] and [[mail|mailing lists]] to learn and help answer questions (read the [[mailing-lists#General_guidelines|general guidelines]] before posting).
* [[Main_Page#microformats_wiki_translations|Translate this microformats wiki into other languages]] to make microformats more accessible to readers of languages around the world.
* [[Main_Page#microformats_wiki_translations|Translate this microformats wiki into other languages]] to make microformats more accessible to readers of languages around the world.
* Before proposing any new microformats, make sure your website is [[POSH]], [[get-started|uses existing microformats]], and then read the [[process]].
* Before proposing any new microformats, make sure your website is [[POSH]], [[get-started|uses existing microformats]], and then read the [[process]].
Line 36: Line 34:


== Specifications ==
== Specifications ==
The list of current, stable [[microformats|Microformats]] open standard specifications.
Current, stable microformats open standard specifications.
 
* {{NewMarker}} '''[[microformats2]]''' is stable, has a test suite, publishers, and interoperable implementations. Start using it on public web pages and developing more parsers and applications.
In addition use well established microformats:
* [[hcalendar|hCalendar]] - events
* [[hcard|hCard]] - people, organizations, contacts
* [[rel-license]] - licensed content
* [[rel-nofollow]] - links in untrusted 3rd party content
* [[rel-tag]] - tag posts and pages by subject
* [[XFN]] - social relationships and [[rel-me]] links among profiles for the same person
* [[XMDP]] - define a microformat vocabulary / profile
* [[xoxo|XOXO]] - outlines
 
== Drafts ==
Drafts are newer microformats, which are still making their way through the [[process]] to become specifications. Implementers should be prepared to keep abreast of future developments and changes. Please watch the wiki pages for updates.


* [[hcalendar|hCalendar]] - [http://microformats.org/code/hcalendar/creator hCalendar creator]
* [[adr|adr]] - address location information
* [[hcard|hCard]] - [http://microformats.org/code/hcard/creator hCard creator]
* [[geo|geo]] - latitude &amp; longitude location ([http://en.wikipedia.org/wiki/WGS84 WGS84] geographic coordinates)
* [[rel-license]]
* [[hatom|hAtom]] - blog posts and other date-stamped content
* [[rel-nofollow]]
* [[hlisting|hListing]] - listings for products or services
* [[rel-tag]]
* [[hmedia|hMedia]] - media info about images, video, audio
* [[vote-links|VoteLinks]]
* [[hnews|hNews]] - news articles, extension of hAtom
* [[XFN]] - [http://gmpg.org/xfn/creator XFN creator]
* [[hproduct|hProduct]] - products
* [[XMDP]]
* [[hrecipe|hRecipe]] - cooking+baking recipes
* [[xoxo|XOXO]]
* [[hresume|hResume]] - individual resumes and CVs
* [[hreview|hReview]] - individual reviews and ratings
* [[hreview-aggregate|hReview-aggregate]] - aggregate reviews and ratings
* [[rel-author]] - link to the author's home page (from an article)
* [[rel-home]] - link to the homepage of a site
* [[rel-payment]] - link to a payment mechanism


''If you're tempted to try your hand at writing a microformat please read '''[[process|the process]]''' page first!''
''If you're tempted to try your hand at writing a microformat please read '''[[process|the process]]''' page first!''


== Drafts ==
== Exploratory Discussions ==
Drafts are newer microformats, for which the specifications haven't been completed yet. Drafts are somewhat mature in the development [[process]] (see [[exploratory-discussions]] for additional efforts that are not as far along in the process). The stability of these documents cannot be guaranteed, and implementers should be prepared to keep abreast of future developments and changes. Please watch the wiki pages for updates.
{{main|exploratory-discussions}}


* [[adr|adr]] - for marking up address information
See: [[exploratory-discussions]] for details of research and analysis of real-world [[examples]], existing formats, and brainstorming of possible new microformats, per the microformats [[process]].
* [[geo|geo]] - for marking up [http://en.wikipedia.org/wiki/WGS84 WGS84] geographic coordinates (latitude; longitude)
* [[hatom|hAtom]] - syndicating episodic content (e.g. weblog postings)
* [[haudio|hAudio]]
* [[hlisting|hListing]] - open, distributed listings
* [[hmedia|hMedia]] - A single media publishing format that relates to Images, Video and Audio.
* [[hnews|hNews]]
* [[hproduct|hProduct]]
* [[hrecipe|hRecipe]] - for cooking+baking recipes
* [[hresume|hResume]] - for publishing resumes and CVs
* [[hreview|hReview]] - [http://microformats.org/code/hreview/creator hReview creator]
* [[rel-directory]] - to indicate that the destination of a hyperlink is a directory listing containing an entry for the current page
* [[rel-enclosure]] - for indicating attachments (e.g. files) to download and cache
* [[rel-home]] - indicate a hyperlink to the homepage of the site
* [[rel-payment]] - indicate a payment mechanism
* [[robots-exclusion|robots exclusion]]
 
* [[xfolk|xFolk]]


== Design Patterns ==
== Design Patterns ==
{{design_patterns}} <!-- this can be edited in /wiki/Template:design_patterns -->
{{design_patterns}} <!-- this can be edited in /wiki/Template:design_patterns -->


== Exploratory Discussions ==
== Archived ==
See: [[exploratory-discussions]] for details of research and analysis of real-world [[examples]], existing formats, and brainstorming of possible new microformats, per the microformats [[process]].
Past specifications, drafts, and exploratory discussions which have either lacked (or lost) wide publishing support, implementation, or have been superceded by newer specs (see also [[process#related_issues_questions_regarding_document_stages|when does it make sense to demote a microformat spec]]). These may eventually be retired, deprecated, or reincorporated into other exploratory discussions.
* [[haudio|hAudio]]
* [[rel-directory]] - link to web directories
* [[rel-enclosure]] - link to attachments (e.g. files) to download and cache
* [[robots-exclusion|robots exclusion]]
* [[vote-links|VoteLinks]]
* [[xfolk|xFolk]] - tagged links


== Examples ==
== Examples ==
Line 90: Line 96:
*[[data-portability]]
*[[data-portability]]
*[[social-network-portability]]
*[[social-network-portability]]
*[http://indiewebcamp.com/ indieweb]


== Shared work areas ==
== Shared work areas ==
Line 101: Line 108:
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|tools and services]] that need to process more than one microformat. That section is intended for editors, [[parsers]], [[validators]], test cases, and other information relevant across multiple microformats.
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|tools and services]] that need to process more than one microformat. That section is intended for editors, [[parsers]], [[validators]], test cases, and other information relevant across multiple microformats.


<span id="microformats_wiki_translations"><span id="microformats_wiki_translations_in_other_languages">&nbsp;</span></span>
== Microformats wiki translations ==
== Microformats wiki translations ==
<span id="microformats_wiki_translations_in_other_languages">You may read and edit microformats articles in many other languages:</span>
You may read and edit microformats articles in many other languages:


* languages with over 100 articles
* languages with over 100 articles
** [[Main_Page-fr|<span lang="fr">Français</span> (French)]] <span lang="fr">{{UpdateMarker-fr}}</span>
** [[Main_Page-fr|<span lang="fr">Français</span> (French)]] <span lang="fr">{{UpdateMarker-fr}}</span>
* languages with over 10 articles
* languages with over 10 articles
** [[Main_Page-ja|<span lang="ja">日本語</span> (Japanese)]]
** [[Main_Page-pt-br|<span lang="pt-br">Português</span> (Brazilian Portuguese)]]
** [[Main_Page-pt-br|<span lang="pt-br">Português</span> (Brazilian Portuguese)]]
** [[Main_Page-ja|<span lang="ja">日本語</span> (Japanese)]]
** [[Main_Page-ru|<span lang="ru">Русский</span> (Russian)]]
** [[Main_Page-ru|<span lang="ru">Русский</span> (Russian)]]
* languages with over 2 articles
* languages with over 2 articles
** [[Main_Page-cs|<span lang="cs">Česky</span> (Czech)]] {{NewMarker}}
** [[Main_Page-cs|<span lang="cs">Česky</span> (Czech)]]
** [[Main_Page-zh|<span lang="zh">汉语</span> (Chinese)]]
** [[Main_Page-de|<span lang="de">Deutsch</span> (German)]]
** [[Main_Page-de|<span lang="de">Deutsch</span> (German)]]
** [[Main_Page-es|<span lang="es">Español</span> (Spanish)]]
** [[Main_Page-es|<span lang="es">Español</span> (Spanish)]]
** [[Main_Page-gl|<span lang="gl">Galego</span> (Galician)]] {{NewMarker}}
** [[Main_Page-gl|<span lang="gl">Galego</span> (Galician)]]  
** [[Main_Page-id|<span lang="id">Indonesia</span> (Bahasa Indonesia)]]
** [[Main_Page-pl|<span lang="pl">Polski</span> (Polish)]]
** [[Main_Page-pl|<span lang="pl">Polski</span> (Polish)]]
** [[Main_Page-ro|<span lang="ro">Română</span> (Romanian)]] {{NewMarker}}
** [[Main_Page-ro|<span lang="ro">Română</span> (Romanian)]]
** [[Main_Page-zh|<span lang="zh">汉语</span> (Chinese)]]
** [[Main_Page-id|<span lang="id">Indonesia</span> (Bahasa Indonesia)]] {{NewMarker}}
* languages just started
* languages just started
** [[Main_Page-fa|<span lang="fa">پارسی</span> (Farsi)]] {{NewMarker}}
** [[Main_Page-ar|<span lang="ar">العربية</span> (Arabic)]]
** [[Main_Page-ar|<span lang="ar">العربية</span> (Arabic)]]
** [[Main_Page-fa|<span lang="fa">پارسی</span> (Farsi)]]
** [[Main_Page-ka|<span lang="ka">ქართული</span> (Georgian)]] {{NewMarker}} <!-- 2013 -->
** [[Main_Page-it|<span lang="it">Italiano</span> (Italian)]]
** [[Main_Page-ko|<span lang="ko">한국어</span> (Korean)]]
** [[Main_Page-th|<span lang="th">ภาษาไทย</span> (Thai)]]
** [[Main_Page-th|<span lang="th">ภาษาไทย</span> (Thai)]]
** [[Main_Page-it|<span lang="it">Italiano</span> (Italian)]] {{NewMarker}}
** [[Main_Page-tr|<span lang="tr">Türkçe</span> (Turkish)]] {{NewMarker}} <!-- 2012-328 -->
** [[Main_Page-ko|<span lang="ko">한국어</span> (Korean)]] {{NewMarker}}
* elsewhere
* elsewhere
**[http://en.wikipedia.org/wiki/Microformat Wikipedia's article on microformats] has been translated into a number of languages.
**[http://en.wikipedia.org/wiki/Microformat Wikipedia's article on microformats] has been translated into a number of languages.


See also [[other-languages]], and [[how-to-start-new-translation|how-to-start-a-new-translation]].
See also [[other-languages]], and [[how-to-start-new-translation|how-to-start-a-new-translation]].

Revision as of 16:03, 17 November 2014

<entry-title>Welcome to the microformats wiki!</entry-title>

microformats are HTML for marking up people, organizations, events, locations, blog posts, products, reviews, resumes, recipes etc. Sites use microformats to publish a standard API that is consumed and used by search engines, browsers, and other sites. See what-are-microformats for more.

  • new! microformats2 is the latest stable & interoperable version. Use it on public web pages and for APIs.

Introduction

Main article: introduction

This wiki is the central resource of the microformats community and provides microformats authoring guides, references, specifications, drafts, publishing patterns, research, brainstorming, and issue tracking.

Get Started

Main article: get-started

Get started with microformats:

How to contribute

Want to join in and contribute?

This wiki has a number of enhancements to assist development and contributions to microformats. Before you start editing, see the wiki introduction page for instructions.

Specifications

Current, stable microformats open standard specifications.

  • new! microformats2 is stable, has a test suite, publishers, and interoperable implementations. Start using it on public web pages and developing more parsers and applications.

In addition use well established microformats:

  • hCalendar - events
  • hCard - people, organizations, contacts
  • rel-license - licensed content
  • rel-nofollow - links in untrusted 3rd party content
  • rel-tag - tag posts and pages by subject
  • XFN - social relationships and rel-me links among profiles for the same person
  • XMDP - define a microformat vocabulary / profile
  • XOXO - outlines

Drafts

Drafts are newer microformats, which are still making their way through the process to become specifications. Implementers should be prepared to keep abreast of future developments and changes. Please watch the wiki pages for updates.

  • adr - address location information
  • geo - latitude & longitude location (WGS84 geographic coordinates)
  • hAtom - blog posts and other date-stamped content
  • hListing - listings for products or services
  • hMedia - media info about images, video, audio
  • hNews - news articles, extension of hAtom
  • hProduct - products
  • hRecipe - cooking+baking recipes
  • hResume - individual resumes and CVs
  • hReview - individual reviews and ratings
  • hReview-aggregate - aggregate reviews and ratings
  • rel-author - link to the author's home page (from an article)
  • rel-home - link to the homepage of a site
  • rel-payment - link to a payment mechanism

If you're tempted to try your hand at writing a microformat please read the process page first!

Exploratory Discussions

Main article: exploratory-discussions

See: exploratory-discussions for details of research and analysis of real-world examples, existing formats, and brainstorming of possible new microformats, per the microformats process.

Design Patterns

Design patterns are common uses of markup across microformats.

Archived

Past specifications, drafts, and exploratory discussions which have either lacked (or lost) wide publishing support, implementation, or have been superceded by newer specs (see also when does it make sense to demote a microformat spec). These may eventually be retired, deprecated, or reincorporated into other exploratory discussions.

Examples

Resources

See resources.

User centric development

Shared work areas

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. That section is intended for editors, parsers, validators, test cases, and other information relevant across multiple microformats.

 

Microformats wiki translations

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

See also other-languages, and how-to-start-a-new-translation.