The Safari Microformats plugin notifies you when the author of the website has published Microformats and allows you to easily import hCards and hCalendars in Address Book and iCal. This plugin was inspired by the idea and mockup of Jon Hicks.

When a hCard or hCalendar is present in the website you visit, the Microformats logo will be shown in the address bar.

Click on the logo, and a sheet opens, showing you all the Microformats. You can add them individually, or all at once.

At the bottom of the sheet, you can choose in which iCal calendar and Address Book group you wish to import the Microformats data. If you have installed Growl , a notification will be shown when you import data. Click the notification and iCal or Address Book will launch.

• Latest version for Safari 3.2.1: safari-microformats-0.1.3.tgz (OSX 10.5 only!)
• Latest version for Safari 4.0.3: safari-microformats-0.1.5.tgz (OSX 10.5 only!)

• Unzip the file you downloaded by doubleclicking on it.
• Install SIMBL
• Copy safarimicroformats.bundle to the SIMBL plugins folder ( /Library/Application Support/SIMBL/Plugins/ ).
• Restart Safari.

• Remove the safarimicroformats.bundle file from the SIMBL plugins folder ( /Library/Application Support/SIMBL/Plugins/ ).
• Restart Safari.

The software is provided as-is, and I take no responsibility for any unwanted side effects or problems by using it.

If you like the plugin, please consider a small donation.

• 16 june 2009 — version 0.1.5
  • compatible with Safari 4
• 2 march 2009 — version 0.1.4
  • compatible with Safari 4 Beta 1
• 3 november 2008 — version 0.1.3
  • circumvent crash when html5 video element is present with a poster attribute
  • fix parsing of fn value when accented characters are present
• 18 march 2008 — version 0.1.2
  • compatible with Safari 3.1
  • added possibility to copy the contents of a microformat (just hit cmd-c in the list)
• 25 november 2007 — version 0.1.1
  • implemented include pattern
  • fixed slow loading pages (e.g. Twitter)
  • updated location bar logo
• 19 november 2007 — version 0.1.0
  • initial version

What are Microformats?

For all your questions on what they are, how to implement them, and all their specifications: microformats.org.
Be sure to take a look at the wiki at microformats.org/wiki.

Why only Leopard? How about a version for Tiger?

Sorry, this plugin is 10.5+ only, seeing as Obj-C 2 features are used.

Safari showed a message that the plugin is incompatible with the current version. What should I do?

Just wait. I follow new releases closely, and will do my best to provide you with an updated version as fast as I can. There is no real need to email me asking when the new version will be out, as the answer will always be the same: it's ready when it's ready. The more enterprising users that go mucking about in plist files must be warned that doing so will most likely set your Mac on fire.

Why is not all information in my Microformat being imported?

Not necessarily all information present in hCards and hCalendars maps onto the parameters of the respective objects in Address Book and iCal. In the case of hCards, I do not believe shoving everything in notes is an acceptable solution, so if you wish for Address Book to support e.g. the geo information, please tell Apple about it.

My Microformats are being parsed incorrectly!

That's not a question! The first thing you should do is debug the parsing. Look at the debug output and verify each step. Errors will be marked in red so you can easily spot them. If you are convinced the parser did something wrong, take a look at the Microformats wiki and locate the rule that is being violated. Next step: double check. If you are still convinced, send me a properly formatted bugreport.

How should I format my dates so they get parsed correctly?

To avoid all problems, make sure your dates are formed according to ISO8601 (RFC 3339).
In short, it is YYYY-MM-DDTHH:MM:SSZ±XX:XX

How can I debug?

Open the Terminal (/Applications/Utilities/Terminal.app) and typing the following: defaults write com.apple.Safari kn_mf_debug 1 When you restart Safari, everytime microformats are present, a window will appear containing a dump of parser-information. Items in green are assignments of information. Yellow items are warnings. Red items are errors, e.g. date parse errors, missing nodes, ...
To disable the debugging, enter the following in the terminal. defaults write com.apple.Safari kn_mf_debug 0

How do I send a bugreport?

Please use the contact form to send your bugreports.
Send along the following information with it:

• The URL of the website containing the Microformats.
• A problem description.
• The vcard or vevent node and its contents:
  e.g. <div><span>My Incorrect hCard</span></div>
  
• The debug output.
• A link to the section on the Microformats wiki which the parser violates (if applicable).