Main Page: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(add see blog / feed at the top since domain home page redirects here now, float TOC to right)
 
(429 intermediate revisions by more than 100 users not shown)
Line 1: Line 1:
<entry-title>Welcome to the microformats wiki!</entry-title>
{{DISPLAYTITLE:Welcome to the microformats wiki!}}
__TOC__
Please start with the [[introduction]] page and read [[how-to-play]] before making any edits.


==Introduction==
'''<dfn>microformats</dfn>''' are HTML for marking up [[h-card|people, organizations]], [[h-event|events]], [[h-adr|locations]], [[h-entry|blog posts]], [[h-product|products]], [[h-review|reviews]], [[h-resume|resumes]], [[h-recipe|recipes]] etc. Sites use microformats to publish a standard API that is consumed and used by [[search engines]], [[browsers]], and other web sites. See [[what-are-microformats]] for more.


Welcome to Apparelus.com–the best wholesale clothing supplier on the Internet. We are proud to offer our customers high quality merchandise at bargain basement prices. You will be amazed at how much value there is in our online inventory. Whatever type of wholesale clothes you are looking for, we have it. From wholesale pants to wholesale dresses, few other wholesale suppliers can match the quality and cost of our wholesale garments.
* See '''[[microformats2]]''' for a technical overview and summary of how to use microformats on public web pages and for APIs.


At Apparelus.com, we are always on the cutting edge of fashion and our inventory of wholesale clothing is constantly expanding and evolving. We now offer over 4,000 styles of apparel and accessories. Shopping for the coming season? We have just brought in new fashion lines for the fall. We make sure our inventory is always up-to-date. When you shop with us, you can be assured that our clothing represent the most current trends that you will see in retail stores from coast to coast.
If you are looking for the '''microformats.org blog''', see:
 
* https://microformats.org/blog ([https://microformats.org/feed RSS feed])
When our customers shop for wholesale apparel with us, they are guaranteed a smooth and easy shopping experience. Orders can be placed online in a matter or minutes, and customer service can be reach via live chat or by phone. We accept all major credit cards, PayPal and our online orders are always secure. We even offer free shipping on all U.S. orders over $299 (excluding HI and AK). That’s a reduction of $50 from our previous offer of free shipping on orders over $299. You won’t find a better deal or value for your money in wholesale clothing and apparel anywhere on the Internet.
<span style="float:right">__TOC__</span>
==Introduction==
{{main|introduction|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.


==Definition==
== Get Started==
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.
{{main|get-started|Getting Started}}
Get started with microformats:


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.
* Make sure your pages and web apps use proper ‘[[posh|<abbr title="Plain Old Semantic HTML">POSH</abbr>]]’ <abbr title="HyperText Mark-up Language">HTML</abbr>.
 
* Mark-up your contact info with [[h-card]], link to other profiles with [[rel-me]]
* Read more explanations of [[what-are-microformats|what microformats are]], and [[what-can-you-do-with-microformats|what you can do with them]].
* Mark-up your blog with [[h-entry]]. See https://indieweb.org/ for more
* Questions? Read the [[faq|frequently asked questions]], ask on [[IRC]]
* Want to learn more in person? Check out microformats [[events]]


== 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.
* Join the [[irc|IRC Channel]] to learn and help answer questions.
* Write a [[testimonial]].
* Write a [[testimonial]]
* 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]].
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 ==
== Specifications ==
The list of current, stable [[microformats|Microformats]] open standard specifications.
'''[[microformats2]]''' is stable, has a test suite, publishers, and interoperable implementations. Use it on public web pages and developing more parsers and applications.


* [[hcalendar|hCalendar]] - [http://microformats.org/code/hcalendar/creator hCalendar creator]
Current, stable microformats open standard specifications.
* [[hcard|hCard]] - [http://microformats.org/code/hcard/creator hCard creator]
 
* [[rel-license]]
=== Parsing ===
* [[rel-nofollow]]
If you are implementing a microformats2 parser, see:
* [[rel-tag]]
* [[microformats2-parsing]]
* [[vote-links|VoteLinks]]
 
* [[XFN]] - [http://gmpg.org/xfn/creator XFN creator]
=== Vocabularies ===
* [[XMDP]]
microformats2 vocabularies:
* [[xoxo|XOXO]]
* [[h-adr]]
* [[h-card]]
* [[h-entry]]
* [[h-event]]
* [[h-feed]]
* [[h-geo]]
* [[h-item]]
* [[h-listing]]
* [[h-product]]
* [[h-recipe]]
* [[h-resume]]
* [[h-review]]
* [[h-review-aggregate]]
 
=== rel microformats ===
Some microformats require only a rel attribute and are widely supported by consuming sites and software.
* [[rel-author]] - link to the author's home page (from an article)
* [[rel-enclosure]] - link to attachments (e.g. files) to download and cache
* [[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
 
=== Classic Microformats ===
In addition use well established classic microformats for the primary subject of a page for legacy [[search engines]] support.
 
* [[hatom|hAtom]] - blog posts and other date-stamped content
* [[hcalendar|hCalendar]] - events
* [[hcard|hCard]] - people, organizations, contacts
* [[hlisting|hListing]] - listings for products or services
* [[hmedia|hMedia]] - media info about images, video, audio
* [[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
 
* [[adr|adr]] - address location information
* [[geo|geo]] - latitude &amp; longitude location ([http://en.wikipedia.org/wiki/WGS84 WGS84] geographic coordinates)
 
==== Classic Drafts ====
Drafts are classic microformats which have varying degrees of support by consuming applications. They are stable and yet still open to change based on consuming application support, per the [[process]] to become specifications.
 
* [[hnews|hNews]] - news articles, extension of hAtom


''If you're tempted to try your hand at writing a microformat please read '''[[process|the process]]''' page first!''
* [[rel-home]] - link to the homepage of a site
* [[rel-payment]] - link to a payment mechanism


== Drafts ==
* [[XMDP]] - define a microformat vocabulary / profile
Drafts are newer microformats, for which the specifications haven't been completed yet. Although drafts are somewhat mature in the development 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.
* [[xoxo|XOXO]] - outlines


* [[adr|adr]] - for marking up address information
''If you're tempted to try your hand at writing a microformat please read '''[[process|the process]]''' page first!'' and then take a look at [[exploratory-discussions]] for details of prior research, 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]]
* [[hproduct|hProduct]]
* [[recipe|hRecipe]]
* [[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 -->
* [[elemental-microformat|elemental microformats]]
* [[compound-microformat|compound microformats]]


== 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]]
* [[robots-exclusion|robots exclusion]]
* [[xfolk|xFolk]] - tagged links
 
* [[rel-directory]] - link to web directories
* [[vote-links|VoteLinks]]


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


== Shared work areas ==
== Shared work areas ==
Line 93: Line 134:
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)]]
* languages just started
* languages just started
** [[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]].
== community ==
<span class="h-card"><strong class="p-name p-org">microformats.org</strong> is <span class="p-note">a community focused on using an empirical (rather than aspirational) [[process]] to research web data & information human publishing behaviors, openly document it on our wiki (<span class="p-url p-uid">http://microformats.org/wiki/</span>), discuss it in [[IRC]] (<span class="p-url">irc://irc.freenode.net/microformats</span>), then brainstorm ideas & proposals based on that research for simple formats based on HTML to interoperably represent that information on the web, incrementally implement, and iterate.</span></span>

Latest revision as of 20:37, 12 September 2024


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 web sites. See what-are-microformats for more.

  • See microformats2 for a technical overview and summary of how to use microformats on public web pages and for APIs.

If you are looking for the microformats.org blog, see:

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

microformats2 is stable, has a test suite, publishers, and interoperable implementations. Use it on public web pages and developing more parsers and applications.

Current, stable microformats open standard specifications.

Parsing

If you are implementing a microformats2 parser, see:

Vocabularies

microformats2 vocabularies:

rel microformats

Some microformats require only a rel attribute and are widely supported by consuming sites and software.

  • rel-author - link to the author's home page (from an article)
  • rel-enclosure - link to attachments (e.g. files) to download and cache
  • 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

Classic Microformats

In addition use well established classic microformats for the primary subject of a page for legacy search engines support.

  • adr - address location information
  • geo - latitude & longitude location (WGS84 geographic coordinates)

Classic Drafts

Drafts are classic microformats which have varying degrees of support by consuming applications. They are stable and yet still open to change based on consuming application support, per the process to become specifications.

  • hNews - news articles, extension of hAtom
  • XMDP - define a microformat vocabulary / profile
  • XOXO - outlines

If you're tempted to try your hand at writing a microformat please read the process page first! and then take a look at exploratory-discussions for details of prior research, 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.

community

microformats.org is a community focused on using an empirical (rather than aspirational) process to research web data & information human publishing behaviors, openly document it on our wiki (http://microformats.org/wiki/), discuss it in IRC (irc://irc.freenode.net/microformats), then brainstorm ideas & proposals based on that research for simple formats based on HTML to interoperably represent that information on the web, incrementally implement, and iterate.