Main Page: Difference between revisions
Cormierl20 (talk | contribs) No edit summary |
m (Reverted edits by Cormierl20 (Talk) to last version by Tantek) |
||
Line 1: | Line 1: | ||
<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. | |||
== | ==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. | |||
== Get Started== | |||
To 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>. | |||
* Learn about microformats from the [http://microformats.org/about/ about page], [http://microformats.org/ blog], [[press]], [[presentations]], [[books]], [[podcasts]], & [[screencasts]] pages. | |||
* Take a look at established specifications such as [[hcard|hCard]] and [[hcalendar|hCalendar]], and follow the [[hcard-examples|examples]] to start publishing microformats. | |||
* 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]]. | |||
==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 == | |||
Do you want to help take microformats to the next level? You can: | |||
[http:// | * [[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. | |||
* Write a [[testimonial]]. | |||
* 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. | |||
* Before proposing any new microformats, make sure your website is [[POSH]], [[get-started|uses existing microformats]], and then read the [[process]]. | |||
This wiki has a number of enhancements to assist development and contributions to microformats. Before you start editing, see the [[wiki-2|wiki introduction page]] for instructions. | |||
== Specifications == | |||
The list of current, stable [[microformats|Microformats]] open standard specifications. | |||
* [[hcalendar|hCalendar]] - [http://microformats.org/code/hcalendar/creator hCalendar creator] | |||
* [[hcard|hCard]] - [http://microformats.org/code/hcard/creator hCard creator] | |||
* [[rel-license]] | |||
* [[rel-nofollow]] | |||
* [[rel-tag]] | |||
* [[vote-links|VoteLinks]] | |||
* [[XFN]] - [http://gmpg.org/xfn/creator XFN creator] | |||
* [[XMDP]] | |||
* [[xoxo|XOXO]] | |||
''If you're tempted to try your hand at writing a microformat please read '''[[process|the process]]''' page first!'' | |||
== Drafts == | |||
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. | |||
* [[adr|adr]] - for marking up address information | |||
* [[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}} <!-- this can be edited in /wiki/Template:design_patterns --> | |||
== 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]]. | |||
== Examples == | |||
* [[examples-in-the-wild]] | |||
* [[implementations]] | |||
* [[zen-garden]] | |||
== Resources == | |||
See [[resources]]. | |||
== User centric development == | |||
*[[user-interface]] | |||
*[[data-portability]] | |||
*[[social-network-portability]] | |||
== Shared work areas == | |||
* [[to-do]] | |||
* [[templates]] | |||
* [http://microformats.org/wiki/delete pages for deletion] <!-- keep as external link; removes from "what links here" --> | |||
* [[Special:Specialpages|"Special" wiki pages]] | |||
* [[year-in-review]] | |||
== 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|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 == | |||
<span id="microformats_wiki_translations_in_other_languages">You may read and edit microformats articles in many other languages:</span> | |||
* languages with over 100 articles | |||
** [[Main_Page-fr|<span lang="fr">Français</span> (French)]] <span lang="fr">{{UpdateMarker-fr}}</span> | |||
* languages with over 10 articles | |||
** [[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)]] | |||
* languages with over 2 articles | |||
** [[Main_Page-cs|<span lang="cs">Česky</span> (Czech)]] {{NewMarker}} | |||
** [[Main_Page-de|<span lang="de">Deutsch</span> (German)]] | |||
** [[Main_Page-es|<span lang="es">Español</span> (Spanish)]] | |||
** [[Main_Page-gl|<span lang="gl">Galego</span> (Galician)]] {{NewMarker}} | |||
** [[Main_Page-pl|<span lang="pl">Polski</span> (Polish)]] | |||
** [[Main_Page-ro|<span lang="ro">Română</span> (Romanian)]] {{NewMarker}} | |||
** [[Main_Page-zh|<span lang="zh">汉语</span> (Chinese)]] | |||
** [[Main_Page-id|<span lang="id">Indonesia</span> (Bahasa Indonesia)]] {{NewMarker}} | |||
* languages just started | |||
** [[Main_Page-ar|<span lang="ar">العربية</span> (Arabic)]] | |||
** [[Main_Page-th|<span lang="th">ภาษาไทย</span> (Thai)]] | |||
** [[Main_Page-it|<span lang="it">Italiano</span> (Italian)]] {{NewMarker}} | |||
** [[Main_Page-ko|<span lang="ko">한국어</span> (Korean)]] {{NewMarker}} | |||
* elsewhere | |||
**[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]]. |
Revision as of 06:46, 9 December 2009
<entry-title>Welcome to the microformats wiki!</entry-title>
Please start with the introduction page and read how-to-play before making any edits.
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.
Get Started
To get started with microformats:
- First, be familiar writing your pages and applications with semantically rich, descriptive, ‘POSH’ HTML.
- Learn about microformats from the about page, blog, press, presentations, books, podcasts, & screencasts pages.
- Take a look at established specifications such as hCard and hCalendar, and follow the examples to start publishing microformats.
- Have questions? Read the frequently asked questions and see the glossary for terms and definitions. You can also post to the mailing list.
- Want to learn more in person? Check out microformats events.
Definition
Microformats are small patterns of HTML to represent commonly published things like people, events, blog posts, reviews and 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 microformats are, and what you can do with them.
How to contribute
Do you want to help take microformats to the next level? You can:
- Get started by adding microformats to your website, services, and products.
- Advocate the use of microformats on other web sites, especially those you use.
- Write a testimonial.
- Do something on the to do list.
- Join the IRC Channel and mailing lists to learn and help answer questions (read the general guidelines before posting).
- 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, uses existing microformats, and then read the process.
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
The list of current, stable Microformats open standard specifications.
- hCalendar - hCalendar creator
- hCard - hCard creator
- rel-license
- rel-nofollow
- rel-tag
- VoteLinks
- XFN - XFN creator
- XMDP
- XOXO
If you're tempted to try your hand at writing a microformat please read the process page first!
Drafts
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.
- adr - for marking up address information
- geo - for marking up WGS84 geographic coordinates (latitude; longitude)
- hAtom - syndicating episodic content (e.g. weblog postings)
- hAudio
- hListing - open, distributed listings
- hMedia - A single media publishing format that relates to Images, Video and Audio.
- hNews
- hProduct
- hRecipe - for cooking+baking recipes
- hResume - for publishing resumes and CVs
- hReview - 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
- xFolk
Design Patterns
Design patterns are common uses of markup across microformats.
- abbr-design-pattern
- class-design-pattern
- date-design-pattern
- datetime-design-pattern
- include-pattern
- value-class-pattern
- rel-design-pattern
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.
Examples
Resources
See resources.
User centric development
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:
- languages with over 100 articles
- Français (French) mis à jour!
- languages with over 10 articles
- languages with over 2 articles
- languages just started
- elsewhere
- Wikipedia's article on microformats has been translated into a number of languages.
See also other-languages, and how-to-start-a-new-translation.