Main Page: Difference between revisions
No edit summary |
m (Reverted edits by Wirelessspeakers (Talk) to last version by Tantek) |
||
Line 1: | Line 1: | ||
<entry-title>Welcome to the microformats wiki!</entry-title> | |||
'''<dfn>microformats</dfn>''' are extensions to 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]], aggregators, and other tools. See [[what-are-microformats]] for more. | |||
==Introduction== | |||
{{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== | |||
{{main|get-started}} | |||
Get started with microformats: | |||
* 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>. | |||
* 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]]. | |||
* Questions? Read the [[faq|frequently asked questions]], ask on the [[IRC]] channel. | |||
* Want to learn more in person? Check out microformats [[events]]. | |||
== How to contribute == | |||
Want to join in and contribute? | |||
* [[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 | |||
* 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]] | |||
* Do something on the [[to-do|to do list]]. | |||
* [[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]] - 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. | |||
* [[adr|adr]] - address location information | |||
* [[geo|geo]] - latitude & longitude location ([http://en.wikipedia.org/wiki/WGS84 WGS84] geographic coordinates) | |||
* [[hatom|hAtom]] - blog posts and other date-stamped content | |||
* [[hlisting|hListing]] - listings for products or services | |||
* [[hmedia|hMedia]] - media info about images, video, audio | |||
* [[hnews|hNews]] - news articles, extension of hAtom | |||
* [[hproduct|hProduct]] - products | |||
* [[hrecipe|hRecipe]] - cooking+baking recipes | |||
* [[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!'' | |||
== Exploratory Discussions == | |||
{{main|exploratory-discussions}} | |||
'''New: [[microformats 2]]''' has sufficiently stabilized to start using on public web pages and developing parsers and applications. | |||
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}} <!-- this can be edited in /wiki/Template:design_patterns --> | |||
== 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 [[process#related_issues_questions_regarding_document_stages: process|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-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. | |||
<span id="microformats_wiki_translations"><span id="microformats_wiki_translations_in_other_languages"> </span></span> | |||
== Microformats wiki translations == | |||
You may read and edit microformats articles in many other languages: | |||
* 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-fa|<span lang="fa">پارسی</span> (Farsi)]] {{NewMarker}} | |||
** [[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:48, 31 October 2012
<entry-title>Welcome to the microformats wiki!</entry-title>
microformats are extensions to 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, aggregators, and other tools. See what-are-microformats for more.
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 with microformats:
- First, make sure your pages and web apps use semantically rich, descriptive, ‘POSH’ HTML.
- Mark-up your contact info with hCard (see authoring tips, examples) and link from your personal site to other profiles with rel-me.
- Questions? Read the frequently asked questions, ask on the IRC channel.
- Want to learn more in person? Check out microformats events.
How to contribute
Want to join in and contribute?
- Get started by adding microformats to your website, services, and products
- Advocate the use of microformats on other web sites, especially those you use
- Read how-to-play before editing this wiki
- Join the IRC Channel and mailing lists to learn and help answer questions (read general guidelines before posting).
- Write a testimonial
- Do something on the to do list.
- 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 - 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
New: microformats 2 has sufficiently stabilized to start using on public web pages and developing parsers and applications.
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.
- abbr-design-pattern
- class-design-pattern
- date-design-pattern
- datetime-design-pattern
- include-pattern
- value-class-pattern
- rel-design-pattern
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.
- hAudio
- rel-directory - link to web directories
- rel-enclosure - link to attachments (e.g. files) to download and cache
- robots exclusion
- VoteLinks
- xFolk - tagged links
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
- پارسی (Farsi) new!
- العربية (Arabic)
- ภาษาไทย (Thai)
- Italiano (Italian) new!
- 한국어 (Korean) new!
- 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.