get-started: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
m (Replace <entry-title> with {{DISPLAYTITLE:}})
 
(84 intermediate revisions by 35 users not shown)
Line 1: Line 1:
<entry-title>Get Started</entry-title>
{{DISPLAYTITLE:Get Started}}
<div style="text-indent:2em;font-weight:bold;padding:1em;background:yellow">
Latest: [http://microformats.org/2014/03/05/getting-started-with-microformats2 Get Started with microformats2]
</div>


Get started by adding support for microformats to your website, services, and products.
Get started by adding support for microformats to your website, services, and products.
Line 10: Line 13:
The best way to understand microformats is to start using them straight away. Since they're embedded in ordinary HTML, you can take existing pages and add these structured class names to the markup, but it's recommended that when doing this, you also take a close look at the overall tag structure that you're using - maybe there is a better way to say what you mean using basic HTML tags.
The best way to understand microformats is to start using them straight away. Since they're embedded in ordinary HTML, you can take existing pages and add these structured class names to the markup, but it's recommended that when doing this, you also take a close look at the overall tag structure that you're using - maybe there is a better way to say what you mean using basic HTML tags.


Many common kinds of content can be marked up in microformats. Microformats are designed to be similar to current markup styles. Chances are, you already have some of them on your site. Start with the obvious ones. For example a simple, and very popular place to start is with [[hcard|hCard]] - a microformat for displaying personal and organizational contact details. You can think of [[hcard|hCard]] as a way to embed mini business cards in web pages, but glancing over the [[hcard-examples|examples]] shows a lot more possibilities than just that.  Here are some specific places to start using microformats today:
Many common kinds of content can be marked up in microformats. Microformats are designed to be similar to current markup styles. Chances are, you already have some of them on your site. Start with the obvious ones. For example a simple, and very popular place to start is with [[h-card]] - a microformat for displaying personal and organizational contact details. You can think of [[h-card]] as a way to embed mini business cards in web pages, but glancing over the [[h-card-examples|examples]] shows a lot more possibilities than just that.  Here are some specific places to start using microformats today:


== yourself ==
== yourself ==
=== your website ===
=== your website ===
If you have your own website, read [[hcard-authoring]] for tips and guidelines on how to best markup existing content with hCard and take a look at the [[hcard-examples]], then
If you have your own website, read [[h-card-authoring]] for tips and guidelines on how to best markup existing content with h-card and take a look at the [[h-card-examples]], then
* add [[hcard|hCard]] to your contact info page along with an "Add to address book" link
* add [[h-card]] to your contact info page
* add hCard+[[xfn|XFN]] to your friends list or blog roll
* add h-card+[[xfn|XFN]] to your friends list or blog roll
* add your website and contact page to the [[hcard-examples-in-wild]] page.
* add your website and contact page to the [[h-card#Examples_in_the_wild|list of examples in the wild]]
 
using the [http://microformats.org/code/hcard/creator hCard creator] if you wish.


=== your blog ===
=== your blog ===
Line 29: Line 30:
=== website ===
=== website ===
==== contact info ====
==== contact info ====
* '''Contact info.''' Every company or organization has a contact or about page of some sort on their website. Read [[hcard-authoring]] and add [[hcard|hCard]] to the contact/about pages along with "Add to address book" links for each hCard.
* '''Contact info.''' Every company or organization has a contact or about page of some sort on their website. Read [[h-card-authoring]] and add [[h-card]] to the contact/about pages along with "Add to address book" links for each h-card.
* '''Employee directory.''' If your company has a page listing employees or others that belong to the organization, add [[hcard|hCard]] to the listings or search results.
* '''Employee directory.''' If your company has a page listing employees or others that belong to the organization, add [[h-card]] to the listings or search results.
* add those pages with hCards to the [[hcard-examples-in-wild]] page.
* add those pages with h-cards to the [[h-card#Examples_in_the_wild|list of examples in the wild]]
batterychargershop.co.uk/


==== events ====
==== events ====
Line 49: Line 49:
Wondering how to use microformats in an enterprise scenario?
Wondering how to use microformats in an enterprise scenario?


Any publication of information about people, events, reviews etc. could benefit from being marked up with hCard, hCalendar, and hReview respectively.
Any publication of information about people, events, reviews etc. could benefit from being marked up with h-card, hCalendar, and hReview respectively.


== other content ==
== other content ==
Line 74: Line 74:
* [http://www.tantek.com/presentations/2004etech/realworldsemanticspres.html Real World Semantics]
* [http://www.tantek.com/presentations/2004etech/realworldsemanticspres.html Real World Semantics]
* ...
* ...
== translations ==
Read about how to [[get-started]] in additional <span id="languages">languages</span>:
* [[get-started-fr|français]]
* [[get-started-ru|Русский]]


== see also ==
== see also ==
* [[advocacy]]
* [[advocacy]]
* [[spread-microformats]]
* [[spread-microformats]]

Latest revision as of 16:22, 18 July 2020

Latest: Get Started with microformats2

Get started by adding support for microformats to your website, services, and products.

introduction

Microformats are based on simple markup conventions that enable you to add meaningful structure to your web content.

One of the key principles of microformats, is to privilege human readable content. This means that you should think first and foremost of your content design being readable and accessible to web viewers. Using the most appropriate HTML elements and applying structured class names to your markup enables you to produce content that can be clearly understood by a human audience and also used in a structured way by automated programs and other online tools. But the point is that you shouldn't have to go out of your way to produce such machine friendly markup - microformats make it easy to integrate this greater degree of structure into your websites, without the overhead of having to learn complicated new languages or formats.

The best way to understand microformats is to start using them straight away. Since they're embedded in ordinary HTML, you can take existing pages and add these structured class names to the markup, but it's recommended that when doing this, you also take a close look at the overall tag structure that you're using - maybe there is a better way to say what you mean using basic HTML tags.

Many common kinds of content can be marked up in microformats. Microformats are designed to be similar to current markup styles. Chances are, you already have some of them on your site. Start with the obvious ones. For example a simple, and very popular place to start is with h-card - a microformat for displaying personal and organizational contact details. You can think of h-card as a way to embed mini business cards in web pages, but glancing over the examples shows a lot more possibilities than just that. Here are some specific places to start using microformats today:

yourself

your website

If you have your own website, read h-card-authoring for tips and guidelines on how to best markup existing content with h-card and take a look at the h-card-examples, then

your blog

If you have a blog:

your organization

website

contact info

  • Contact info. Every company or organization has a contact or about page of some sort on their website. Read h-card-authoring and add h-card to the contact/about pages along with "Add to address book" links for each h-card.
  • Employee directory. If your company has a page listing employees or others that belong to the organization, add h-card to the listings or search results.
  • add those pages with h-cards to the list of examples in the wild

events

Use hCalendar anywhere on the website that publishes event information. Start with the hCalendar creator.

history

If your organization publishes its history, mark up the events noted with hCalendar, thus allowing anybody to build a dynamic timeline application with your history.

products

Does your company make any products that generate HTML?

  • Make sure such products generate POSH and whenever possible, the appropriate microformats.
  • Then add those products to the implementations page.

enterprise

Wondering how to use microformats in an enterprise scenario?

Any publication of information about people, events, reviews etc. could benefit from being marked up with h-card, hCalendar, and hReview respectively.

other content

  • Do you have an explicit copyright license on your content? Then markup the link to your license with rel-license.
  • Do you publish social network / relationship info? Then mark that up with XFN.
  • Are you tagging things? Then use rel-tag (for your own stuff) or xFolk (for tagging any URL).
  • Are you publishing lists or outlines? Then use XOXO.
  • Do you publish reviews? Then use hReview.
  • Do you publish press releases? Then use hAtom.

what next

Once you have added microformats support to your website and helped your company and organization do so as well:

  • Advocate the use and support of microformats on other sites as well.

And here are a few more tips:

Try to produce clean, semantic xhtml, AKA POSH. Where there aren't microformats for specific types of content, feel free to experiment with your own poshformats.

translations

Read about how to get-started in additional languages:

see also