advocacy: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(→‎hCard: Wikitravel)
m (Replace <entry-title> with {{DISPLAYTITLE:}})
 
(308 intermediate revisions by 23 users not shown)
Line 1: Line 1:
<h1>Advocacy</h1>
{{DISPLAYTITLE: Advocacy }}


A lot can be done to help advocate the use of microformats. Often, simply by taking an existing site, and adding the suggested microformatting to a few of its pages as examples is all that is necessary to help the developers of the site add the microformats to the site itself. Applications, such as browsers, could also use some guidance on how to best support microformats.
A lot can be done to help advocate the use of microformats. Often, simply by taking an existing site, and adding the suggested microformatting to a few of its pages as examples is all that is necessary to help the developers of the site add the microformats to the site itself. Applications, such as browsers, could also use some guidance on how to best support microformats.


Sometimes advocacy requires comparison and analysis of alternative technologies or approaches.  As [[User:MikeSchinkel|MikeSchinkel]] pointed out, we need good answers to comments like "No, we're going to use XXX instead...".
Sometimes advocacy requires comparison and analysis of alternative technologies or approaches.  As [[User:MikeSchinkel|Mike Schinkel]] pointed out, we need good answers to comments like "No, we're going to use XYZ instead...".


The goal for this page is to include pointers for how to advocate microformats on new sites and on existing sites that are considering or using alternative approaches, as well as applications that can benefit from supporting microformats.
The goal for this page is to include pointers for how to advocate microformats on new sites and on existing sites that are considering or using alternative approaches, as well as applications that can benefit from supporting microformats.
Line 9: Line 9:
For general resources for marketing microformats, see [[spread-microformats]].
For general resources for marketing microformats, see [[spread-microformats]].


== Adding Microformats to Existing Sites ==
== Adding microformats to Existing Sites ==
Add sites here that you think would benefit from the addition of microformats. For now they are grouped by the microformat which would primarily benefit the site. Feel free to take a look at some of the sites on this list, document sample pages to be microformatted, add microformats to them, and then add the before/after of the key sections of mark-up to another wiki page for that site.


Add sites here that you think would benefit from the addition of microformats. For now they are grouped by the microformat which would primarily benefit the site (so that folks who feel they are good at adding a particular microformat.  Feel free to take a look at some of the sites on this list, document sample pages to be microformatted, add microformats to them, and then add the before/after of the key sections of markup to another wiki page for that site.
Successes are also noted; the most recent are flagged as {{SuccessMarker}}.


=== hCard ===
If your successes resulted from emails that you sent to site owners/developers, please consider sharing your successful advocacy emails on the [[advocacy-email-samples]] page, and along with each email sample, list the sites which responded positively to your email.  This way others in the community can learn from your success and hopefully use your email samples to contact additional sites and get them to adopt microformats.


Details of hCard should be added to the [http://www.imc.org/pdi/ Internet Mail Consortium's vCard page]
=== organization ===
*Requested by e-mail, 2006-11-24 [[User:AndyMabbett|Andy Mabbett]]
For now this section is organized primarily by microformat, as that's easier for the community to document and keep track of.


Adding hCard to these sites would make them quite handy for their users and for being indexed:
However, it may be more useful to publishers if we created another section organized by type of site.


* [http://dodgeball.com/ Dodgeball] venues
E.g.:
* Wikipedia Infobox Templates for people to add [[hcard|hCard]] to their generated markup
* [[education]] - how to add microformats to education sites, especially higher education sites.
** [http://en.wikipedia.org/w/index.php?title=Template:Infobox_Biography&action=edit Infobox_Biography]
* [[social networks]] - how to add microformats to social networks, especially for [[social-network-portability]].
** [http://en.wikipedia.org/w/index.php?title=Template:Infobox_actor&action=edit Infobox_actor] which should result in actor pages, e.g. [http://en.wikipedia.org/wiki/Humphrey_Bogart Humphrey Bogart]'s page, being properly hCarded.
* [http://www.imdb.com/ Internet Movie Database] (IMDb) for people (real, not characters), e.g. [http://www.imdb.com/name/nm0000007/ Humphrey Bogart]. [[User:AndyMabbett|Andy Mabbett]] 02:49, 13 Nov 2006 (PST)
**Can't find contact info! [[User:AndyMabbett|Andy Mabbett]]
* [http://www.w3.org/People/all W3C Staff listing] and individual pages, e.g. [http://www.w3.org/People/Berners-Lee/ Tim Berners-Lee]
**Requested by e-mail. [[User:AndyMabbett|Andy Mabbett]]
*Google contactas: [http://www.google.com/intl/en/contact/index.html Google USA], [http://www.google.co.uk/intl/en/contact/index.html Google UK], etc.
*Wikitravel
**e.g. [http://wikitravel.org/en/Birmingham_%28England%29 Wikitravel - Birmingham]
* ...


====Telephone Directory Listings====
etc.
Telephone Directory Listings could usefully apply hCard to their results pages. [[User:AndyMabbett|Andy Mabbett]] 03:10, 13 Nov 2006 (PST)


e.g. (please add other examples!):
== by microformat ==
*[http://www.thephonebook.bt.com/ BT]
<!-- spans with ids for preserving previous heading fragment id references -->
**Requested via [http://tinyurl.com/yhtdjy BT feedback form], 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]
* <span id="hCard">[[hcard-advocacy]]</span>
*[http://118118.com 118118.com]
** <span id="Geo">[[geo-advocacy]]</span>
**Requested via e-mail, 2006-11-13. [[User:AndyMabbett|Andy Mabbett]]
** <span id="Adr">[[adr-advocacy]]</span>
* <span id="hCalendar"> [[hcalendar-advocacy]]</span>
* <span id="hReview">[[hreview-advocacy]]</span>
* <span id="hAtom">[[hatom-advocacy]]</span>
* <span id="rel-tag">[[rel-tag-advocacy]]</span>
* <span id="VoteLinks">[[vote-links-advocacy]]</span>
* <span id="XFN">[[xfn-advocacy]]</span>


====Postal (ZIP) code Finders====
=== h-entry ===
Postal code Finders could usefully apply hCard to their results pages. [[User:AndyMabbett|Andy Mabbett]] 12:09, 13 Nov 2006 (PST)
* '''pump.io''' - add h-entry + h-card support to pump.io's web view:
** https://github.com/e14n/pump.io


e.g. (please add other examples!):
== browsers ==
*[http://pol.royalmail.com/dda/txt/pf.asp Royal Mail] (UK)
[[Browser]] support of microformats, both built-in, and via plug-ins and extension helps users make better use of the numerous existing sites that have microformats support, as well as encourage sites and site developers to add microformats support.
**Requested via [http://tinyurl.com/ya4hzu Royal Mail feedback form], 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]


====Government====
See [[browser-advocacy]].
=====UK=====
* Parliament: [http://www.parliament.uk/directories/hciolists/alms.cfm Alphabetical List of Members of Parliament] (see also [http://www.parliament.uk/directories/directories.cfm other lists of MPs and Lords]). [[User:AndyMabbett|Andy Mabbett]]


=====Europe=====
== publishing tools ==
* e.g. [http://www.europarl.org.uk/uk_meps/westmidlands.asp UK MEPs]
Getting publishing tools adopt microformats will perhaps have the biggest impact on expanding the adoption and support of microformats.
See [[cms]] for current publishing platform support.
* [[cms-advocacy]]
* [[blogging-tools-advocacy]]
Others:
* postlets.com - which crossposs to craigslist.com and other classifieds services. If they generated span+a microformats (which apparently survive posting into Craigstlist posting), the posters could get postings in hCard without any additional work.
** check oodle.com also.


=== hCalendar ===
== web agencies ==
More and more [[web-agencies]] are supporting microformats both on their own sites and on sites they build.


Details of hCalendar should be added to the [http://www.imc.org/pdi/ Internet Mail Consortium's vCalendar page]
Getting more web design, development, etc. agencies and related efforts to adopt microformats also has the indirect benefit of them supporting microformats in the sites they build and develop.
*Requested by e-mail, 2006-11-24 [[User:AndyMabbett|Andy Mabbett]]


==== W3C track at WWW2006 ====
If you are a strong and vocal supporter of microformats in your work, please feel free to add yourself to the
* DanC offers a 150 point bounty to anybody who takes [http://www.w3.org/2006/05/w3c-track the W3C track at WWW2006] and adds hCalendar markup and sends it to connolly@w3.org,www-archive@w3.org
* [[web-agencies]] page


====Television listings====
== online tutorials ==
*A major coup would be to get one of the major players (the BBC, Sky, or PBS, say), to mark up their TV or radio listings with hCalendar - does anyone have contacts in such an organisation? [[User:AndyMabbett|Andy Mabbett]] 10:53, 21 Oct 2006 (PDT)
Add [[microformats2]] to topical online tutorials, especially if they already have classic microformats examples that can be updated.
**Does anyone have URLs to the TV or radio listings of the major players? Getting those URLs would be the next step, and then doing the markup ourselves would be the next step after that. [[User:Tantek|Tantek]] 13:02, 21 Oct 2006 (PDT)


e.g. (please add other examples!):
* https://stackoverflow.com/questions/5125856/should-i-use-meta-name-author-content-your-name-or-link-rel-author-hr
*[http://www.radiotimes.com/ Radio Times] (BBC, UK)
** has [[hCard]] example that should be updated to [[h-card]]
** Requested by e-mail [[User:AndyMabbett|Andy Mabbett]]
*[http://www.tvtimes.co.uk/ TV Times] (UK)
** Requested by e-mail 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]
*BBC main listings (e.g. [http://www.bbc.co.uk/bbcone/listings/index.shtml?service_id=4223 BBC One])
** Requested by [http://www.bbc.co.uk/feedback/bbci_comment.shtml BBC Feedback Form] 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]


====Government====
== multiple microformats ==
=====UK=====
<span id="Various">In general add such sites to the page for the primary microformat which would benefit from the sites' support. See above.</span>
*[http://www.dti.gov.uk/employment/bank-public-holidays/index.html DTI: Bank Holidays] (not Scotland)
** Requested by e-mail, 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]
***Response: "At the moment we have no plans to use hCalendar or hCard coding due to unresolved concerns about accessibility issues (especially text-to-speech readers), however, we thank you for your suggestion."
*[http://www.scotland.gov.uk/Publications/2005/01/bankholidays Scottish Executive Bank Holidays]
** Requested by [http://www.scotland.gov.uk/About/HaveYourSay/WebsiteFdbck Scottish Executive feedback form], 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]


====Sports Fixtures====
== successes ==
e.g. (please add other examples!):
=== Magnolia ===
*PremiumTV (UK, Soccer, has a page for each team)
[http://ma.gnolia.com ma.gnolia] supports many microformats. These should all be incorporated into the [[examples-in-the-wild]] pages for each specific microformat.
**[http://www.avfc.premiumtv.co.uk/page/Fixtures/ Aston Villa]
* [http://wiki.ma.gnolia.com/Microformat_Feature_Requests Microformat Feature Requests on ma.gnolia wiki]
**[http://www.wba.premiumtv.co.uk/page/Fixtures/ West Bromwich Albion]
* {{SuccessMarker}} [http://ma.gnolia.com ma.gnolia] is implementing semantic features and microformats quickly. Here's a screenshot of my ma.gnolia page, and the Firefox [https://addons.mozilla.org/en-US/firefox/addon/4106 Operator extension]'s response to its code. Shiny. :) --[[User:CarlaHufstedler|Carla]] 10:30, 1 Sep 2007 (PDT)<br />
*** Requested by e-mail, 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]
[http://flickr.com/photos/hauntedpalace/1296152892/ http://farm2.static.flickr.com/1390/1296152892_20108bd860_d.jpg] (click for larger version)
****"webmaster@" bounced. [[User:AndyMabbett|Andy Mabbett]]
* {{SuccessMarker}} added a [http://wiki.ma.gnolia.com/Category:Microformats microformats category] to the ma.gnolia wiki, with information, and then added it to appropriate pages --[[User:CarlaHufstedler|Carla]] 10:37, 3 Sep 2007 (PDT)


====Concert/ Theatre Listings====
=== OpenStreetMap ===
e.g. (please add other examples!):
* I've just added Geo to OpenStreetMap documentation pages - see [http://wiki.openstreetmap.org/index.php/Birmingham Birmingham page on OpenStreetMap] for example. [[User:AndyMabbett|Andy Mabbett]] 02:39, 6 Apr 2007 (PDT)
*[http://www.birmingham-alive.com/ Birmingham Alive!] (UK)
* [http://www.openstreetmap.org OpenStreetMap] uses the geo microformat on its wiki for place pages (added by [http://wiki.openstreetmap.org/index.php/User:Pigsonthewing Andy Mabbett]) and also on the GPS trace pages and diary entry pages ([http://www.dankarran.com/blog/archives/2007/09/04/pinpoint_your_openstreetmap_diary_entries.php added] by [http://www.dankarran.com Dan Karran]).
**Requested in person; now on "to do" list


=== hReview ===
=== Wikipedia ===
* [http://www.imdb.com/ Internet Movie Database] (IMDb) for film reviews, e.g. [http://www.imdb.com/title/tt0049291/ The Harder They Fall ]. [[User:AndyMabbett|AndyMabbett]] 02:49, 13 Nov 2006 (PST)
For successes on Wikipedia, see the list of [http://en.wikipedia.org/wiki/Category:Templates_generating_microformats Wikipedia templates generating microformats].
**Can't find contact info! [[User:AndyMabbett|Andy Mabbett]]


=== hAtom ===
See also the individual microformats advocacy pages for specific microformat successes.
* TV Listings (see hCalendar, above)
*[http://www.mediawiki.org/wiki/MediaWiki *MediaWiki] (Wikipedia and other users, including this 'Wiki') - article histories
**[http://bugzilla.wikimedia.org/show_bug.cgi?id=7913 Bug 7913] raised 2006-11-13. '''[http://bugzilla.wikimedia.org/votes.cgi?action=show_user&bug_id=7913 Vote here]''' [[User:AndyMabbett|Andy Mabbett]]
*[http://rbach.priv.at/Microformats-IRC/2006-11-13 IRC logs]


=== Geo ===
Specifics:
Adding "Geo" markup to these sites would make them even more useful:
*Wikipedia
**All articles on places, e.g. [http://en.wikipedia.org/wiki/Birmingham Wikipedia - Birmingham] (note co-ordinates already present in infobox)
*Wikitravel
**All articles on places, e.g. [http://wikitravel.org/en/Birmingham_%28England%29 Wikitravel - Birmingham]


== Adding Microformats to Applications ==
Geo on Wikipedia:
*Wikipedia-IT now has Geo on all  [http://it.wikipedia.org/wiki/Speciale:PuntanoQui/Template:Coord pages using the ''coord'' template], e.g. [http://it.wikipedia.org/wiki/Messina Messina]. [[User:AndyMabbett|Andy Mabbett]] 07:05, 26 May 2007 (PDT)
*I've added geo to [http://commons.wikimedia.org/wiki/Special:Whatlinkshere/Template:Location_dec_US all images tagged in Wikimedia Commons] using decimal values. Example: [http://commons.wikimedia.org/wiki/Image:Montreal_City_Hall_Jan_2006.jpg Montreal City Hall, Jan 2006]  [[User:AndyMabbett|Andy Mabbett]] 08:54, 12 Apr 2007 (PDT)
**Now on pages tagged in D-M-S also.
* Wikipedia-NL now has Geo on all its map-links pages, e.g. [http://www.nsesoftware.nl/wiki/maps.asp?params=52_28_47_N_1_53_51_W_type:city_region:GB&src=Birmingham_%28Engeland%29 maps for Wikipedia-NL article on Birmingham]
**Called from '''87,724''' article pages as of 2006-04-09; reportedly the sixth most popular website in the Netherlands [http://www.multiscope.nl/organisatie/nieuws/sberichten/nederlandse-wikipedia-groeit-als-kool.html].
* I recently added Geo to Wikipedia-DE's map link pages  e.g. [http://tools.wikimedia.de/~magnus/geo/geohack.php?language=de&params=52_28_47_N_1_53_51_W_type:city_region:GB maps for Wikipedia-DE article on Birmingham]. [[User:AndyMabbett|Andy Mabbett]] 14:27, 9 Apr 2007 (PDT)


=== Firefox developments ===
* I've [http://en.wikipedia.org/w/index.php?title=Template%3AGeoTemplate&diff=119003866&oldid=118216477 just added] Geo to Wikipedia's [http://en.wikipedia.org/wiki/Template:GeoTemplate GeoTemplate] which is called by '''many thousands''' of other Wikipedia pages. Example: the coordinates (top right) in [http://en.wikipedia.org/wiki/Great_Barr] link to [http://tools.wikimedia.de/~magnus/geo/geohack.php?params=52.54833_N_1.93212_W_region:GB_source:enwiki-osgb36(SP047945)]; the latter now has a Geo microformat. [[User:AndyMabbett|Andy Mabbett]] 03:38, 30 Mar 2007 (PDT)
 
** [http://tools.wikimedia.de/~kolossos/wp-world/imageworld-art.php Map showing global distribution of Geo-tagged Wikipedia articles].
*Mozilla are "brainstorming" developments for Firefox 3.0 and beyond, and have a page on microformat handling at http://wiki.mozilla.org/Firefox/Feature_Brainstorming:Microformat_Handling
 
===ReminderFox===
*[http://reminderfox.mozdev.org/] ReminderFox have hCalendar import on their "to do " list.
 
== Comparisons With Alternative Approaches ==
 
=== CalDAV ===
 
====Brian Suda====
The other great thing about exposing your data as microformats, is that the data becomes Open Data. Will the general public have access to the CalDAV? (probably not) and even if they did, it will probably only serve-up .ics files... what if i don't want ICS? i need to then hack that around to get it into the format that i want... if the data were in the HTML to begin with, then i could EASILY convert that to any format i wanted. Also, sites like http://pingerati.net/ will happily take in hCalendar data and aggregate it, make your data more valuable and easily slurped up by other providers - i don't see that happening as easily with a CalDAV.
 
====Kevin Marks====
With respect to CalDAV: I spoke to the CalDAV chaps at Apple about this, they have hCalendar support as a ticket in their db:
http://trac.macosforge.org/projects/calendarserver/ticket/19


== old ==
These sites have shown no activity for 6 months or more and thus are perhaps not worth the effort.
*<span id="ClearForest">[http://sws.clearforest.com/ ClearForest Semantic Web Services ]</span> - uses natural language processing tools to recognise people, organisations, places, events and CVs (resumes) in web pages. Would benefit from recognising hCard, hResume, hCalendar, Geo, Adr, etc. Could also use them in its output.


== See Also ==
== See Also ==

Latest revision as of 16:20, 18 July 2020


A lot can be done to help advocate the use of microformats. Often, simply by taking an existing site, and adding the suggested microformatting to a few of its pages as examples is all that is necessary to help the developers of the site add the microformats to the site itself. Applications, such as browsers, could also use some guidance on how to best support microformats.

Sometimes advocacy requires comparison and analysis of alternative technologies or approaches. As Mike Schinkel pointed out, we need good answers to comments like "No, we're going to use XYZ instead...".

The goal for this page is to include pointers for how to advocate microformats on new sites and on existing sites that are considering or using alternative approaches, as well as applications that can benefit from supporting microformats.

For general resources for marketing microformats, see spread-microformats.

Adding microformats to Existing Sites

Add sites here that you think would benefit from the addition of microformats. For now they are grouped by the microformat which would primarily benefit the site. Feel free to take a look at some of the sites on this list, document sample pages to be microformatted, add microformats to them, and then add the before/after of the key sections of mark-up to another wiki page for that site.

Successes are also noted; the most recent are flagged as Success!.

If your successes resulted from emails that you sent to site owners/developers, please consider sharing your successful advocacy emails on the advocacy-email-samples page, and along with each email sample, list the sites which responded positively to your email. This way others in the community can learn from your success and hopefully use your email samples to contact additional sites and get them to adopt microformats.

organization

For now this section is organized primarily by microformat, as that's easier for the community to document and keep track of.

However, it may be more useful to publishers if we created another section organized by type of site.

E.g.:

etc.

by microformat

h-entry

browsers

Browser support of microformats, both built-in, and via plug-ins and extension helps users make better use of the numerous existing sites that have microformats support, as well as encourage sites and site developers to add microformats support.

See browser-advocacy.

publishing tools

Getting publishing tools adopt microformats will perhaps have the biggest impact on expanding the adoption and support of microformats. See cms for current publishing platform support.

Others:

  • postlets.com - which crossposs to craigslist.com and other classifieds services. If they generated span+a microformats (which apparently survive posting into Craigstlist posting), the posters could get postings in hCard without any additional work.
    • check oodle.com also.

web agencies

More and more web-agencies are supporting microformats both on their own sites and on sites they build.

Getting more web design, development, etc. agencies and related efforts to adopt microformats also has the indirect benefit of them supporting microformats in the sites they build and develop.

If you are a strong and vocal supporter of microformats in your work, please feel free to add yourself to the

online tutorials

Add microformats2 to topical online tutorials, especially if they already have classic microformats examples that can be updated.

multiple microformats

In general add such sites to the page for the primary microformat which would benefit from the sites' support. See above.

successes

Magnolia

ma.gnolia supports many microformats. These should all be incorporated into the examples-in-the-wild pages for each specific microformat.

1296152892_20108bd860_d.jpg (click for larger version)

  • Success! added a microformats category to the ma.gnolia wiki, with information, and then added it to appropriate pages --Carla 10:37, 3 Sep 2007 (PDT)

OpenStreetMap

Wikipedia

For successes on Wikipedia, see the list of Wikipedia templates generating microformats.

See also the individual microformats advocacy pages for specific microformat successes.

Specifics:

Geo on Wikipedia:

old

These sites have shown no activity for 6 months or more and thus are perhaps not worth the effort.

  • ClearForest Semantic Web Services - uses natural language processing tools to recognise people, organisations, places, events and CVs (resumes) in web pages. Would benefit from recognising hCard, hResume, hCalendar, Geo, Adr, etc. Could also use them in its output.

See Also