Microformats Wiki - User contributions [en]

hcard-xfn-supporting-friends-lists

2010-03-03T06:06:08Z

Edsu: /* Services with XFN rel="me" to one external site */

<entry-title>hCard+XFN supporting friends lists</entry-title>
Welcome! If you have an account on any of the following services, you already have a list of your friends' hCards with your relationship to them in XFN which you can provide to other services to save time by either importing or subscribing to social network information so you can change it on one site, and have other sites automatically updated, rather than having to re-add/remove all your social network contacts multiple times every time you meet a new person, decide to unfriend someone etc.

== Services with hCard+XFN supporting friends lists ==
The following web sites support publishing hCard+XFN friends lists and are thus suitable for importing/subscribing to other sites that support hCard+XFN. Alphabetically sorted. Feel free to add sites with hCard+XFN supporting friends lists here. Please include a link to the site home page, and instructions for retrieving the URL of your hCard+XFN supporting friends list on that site.

<div style="font-size:larger">
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz]
* [http://hi5.com/ Hi5] - e.g. http://lindner.hi5.com/
* [http://identi.ca/ Identica] - All user (e.g., [http://identi.ca/csarven csarven]) and group (e.g., [http://identi.ca/group/microformats microformats]) profile URLs.
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* [http://lifestrea.ms/ lifestrea.ms] - you have one user profile per social group that you want to share information with: <nowiki>http://lifestrea.ms/user/[username]/</nowiki>. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* http://www.bkmks.com/icons/nytimes.com.gif [http://timespeople.nytimes.com/ NYTimes TimesPeople] - e.g. http://timespeople.nytimes.com/view/user/19390043/1/index.html
* [http://proofile.org Proofile] - Full support of hCard and XFN.
* [http://www.qmpeople.com/ qmpeople] - Uses hCard+XFN for profiles (<nowiki>http://www.qmpeople.com/users/[username]</nowiki> - e.g. [http://www.qmpeople.com/users/laserion laserion])
* http://identoo.com/images/icons/services/slideshare.gif [http://www.slideshare.net/ SlideShare] - partial contacts list at profile at <nowiki>http://www.slideshare.net/USERNAME</nowiki>, e.g. [http://www.slideshare.net/adactio Jeremy Keith's profile], paginated contacts list at <nowiki>http://www.slideshare.net/USERNAME/following</nowiki>, e.g. [http://www.slideshare.net/adactio/following People Jeremy Keith follows].
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
</div>

== Services that import hCard+XFN supporting friends lists ==
The following web sites let you import hCard+XFN friends lists, e.g. from the above sites, and make use of both the XFN information and the hCards in the friends lists. Alphabetically sorted. Feel free to add sites supporting hCard+XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.

=== import ===
The following sites do one time imports of friends lists.

* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - as [http://blog.dopplr.com/index.php/2007/06/23/importing-your-social-network-from-other-sites/ announced] login and go to Dopplr's [http://www.dopplr.com/account/invitations_via/hcard hCard contact import page] to import.
* [http://t.heproject.com/ The Project] - Login with your OpenID and the site automatically tries to subscribe to your XFN friends list where it intersects with their userbase
** appears to fail logging in with a delegated OpenID, e.g. http://tantek.com/ - unable to verify import friends list support. [[User:Tantek|Tantek]] 10:03, 1 Feb 2008 (PST)

=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.

=== delegation ===
The following sites support fully delegating your friends list to an external hCard+XFN friends list.
* None currently.

== Services with XFN supporting friends lists ==
These sites support XFN markup on friends lists. It is a superset of the sites that support XFN and hCard on friends lists.
<div style="font-size:larger">
* [http://3eep.com/ 3eep] - each user's friends are linked to with XFN is located at <nowiki>http://3eep.com/users/[username]</nowiki>
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* [http://couchsurfing.com CouchSurfing] profiles have XFN Friendly friends lists (e.g. [http://www.couchsurfing.com/people/guaka Guaka's]).
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* [http://flugpo.com Flugpo] - check your friends page linked from your profile.
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz]
* [http://identi.ca/ Identica] - All user (e.g., [http://identi.ca/csarven csarven]) and group (e.g., [http://identi.ca/group/microformats microformats]) profile pages contain rel=contact to their friends' URL.
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* http://www.linkedin.com/img/pic/pic_in_17x17.gif [http://www.linkedin.com/ LinkedIn] - LinkedIn Connections use XFN and are marked up with rel="contact".
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* [http://lifestrea.ms/ lifestrea.ms] - one friends list per social group that you want to share information with: <nowiki>http://lifestrea.ms/user/[username]/</nowiki>. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
* http://pulse.plaxo.com/pulse/img/event_icons/LiveJournal.gif [http://livejournal.com LiveJournal] (see [[implementations#LiveJournal|LiveJournal]] implementation entry) - login, click on the "Profile" link, and copy the URL which should start with <nowiki>http://USERNAME.livejournal.com/profile</nowiki> where USERNAME is your LJ username. E.g. [http://daveman692.livejournal.com/profile]. LiveJournal profiles have complete friends lists marked up in XFN.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://meetlisten.com Meetlisten] - e.g. http://meetlisten.com/home/profile.php?id=1 and (e.g. [http://meetlisten.com/home/friends.php?id=6 MAKACOW-Brazil's]).
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* http://identoo.com/images/icons/services/odeo.gif [http://odeo.com Odeo] — the "peep's" list of each user is marked up with XFN (rel="contact") e.g. http://odeo.com/profile/JeremyKeith . See [http://odeo.com/blog/2005/07/adding-microformats-to-odeo.html announcing blog post].
* [http://www.qmpeople.com/ qmpeople] - Uses XFN for public friendships - e.g. http://www.qmpeople.com/users/laserion
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://skateboardspot.info/image/icon/favicon.png [http://skateboardspot.info/ skateboardspot.info] - Log in and click on your username in the top right corner. The URL to your userpage (that you'll see now) is the URL to your hCard. Also 10 people of your contact list will be displayed there. To see all of them click the "... display all friends" link.
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/ (see also [http://wiki.www.videntity.org/wiki/Social_Networking_Unlimited Videntity XFN support documentation]).
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
</div>

== Services that import XFN supporting friends lists ==
The following web sites support importing your existing XFN supporting friends lists, e.g. from the above sites. Alphabetically sorted. Feel free to add sites supporting XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.
=== import ===
The following sites do one time imports of friends lists.
* None currently.
=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.
=== delegation ===
The following sites support fully delegating your friends list to an external XFN friends list.
* None currently.

== Services with XFN rel="me" to multiple external sites ==
The following services have a UI for entering any number of websites/homepages/blogs and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* [http://huffduffer.com/ Huffduffer] uses rel="me" on profile pages if a URL is provided and then uses the Google Social Graph API to find other profiles which are then also linked with rel="me" — e.g. http://huffduffer.com/clagnut
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* [http://lifestrea.ms/ lifestrea.ms] - supporting all your appearances on the web. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
* http://www.linkedin.com/img/pic/pic_in_17x17.gif [http://www.linkedin.com/ LinkedIn] - e.g. http://www.linkedin.com/in/steveganz rel="me" is applied to "My Website" and "My Blog" on your public profile.
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* [http://proofile.org Proofile] - e.g. http://proofile.org/ueli.weiss
* http://www.dandyid.org/code/images/miscellaneous/favicons/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.typepad.com/.s/static.typepad.com/.shared:v35.14:typepad:en_us/images/profile/service_icons/typepad.png [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
</div>

== Services with XFN rel="me" to one external site ==
The following services have a UI for entering one website/homepage/blog and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* [http://delicious.com Delicious] - e.g. http://delicious.com/inkdroid
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - enter your website/homepage/blog into the "Website:" field on the [http://www.dopplr.com/account/profile Dopplr: Account Management] page, and enable your public profile and be sure the "Show homepage" checkbox is checked.
* [http://eventful.com/ Eventful] - login, click on your username, and copy that URL.
* http://pulse.plaxo.com/pulse/img/event_icons/Flickr.gif [http://flickr.com/ Flickr] - login, click "Your Photos", click "Profile", and copy the URL which should be <nowiki>http://flickr.com/people/[username]/</nowiki>
** Flickr supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Flickr contacts page. See [http://flickr.com/photos/factoryjoe/113866484/ screenshot of Flickr UI in Flock browser using Flocktails extension - March 17th 2006].
* [http://github.com GitHub] - e.g. http://github.com/ry/
* [http://identi.ca/ Identica] - Some user (e.g., [http://identi.ca/csarven csarven]) and group (e.g., [http://identi.ca/group/microformats microformats]) profiles have a link to their home/personal URLs.
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* [http://jpgmag.com JPG Magazine]
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last.FM] - login, go to your profile, and copy the URL which should start with <nowiki>http://www.last.fm/user/</nowiki>
** Last.FM supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Last.FM friends page.
* [http://lifestrea.ms/ lifestrea.ms] - supporting all your external appearances on the web. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - see [http://ma.gnolia.com/blog/2006/08/21/a-microadvance-in-our-microformats supports rel=me announcement].
* [http://nsyght.com Nsyght] - e.g. [http://nsyght.com/users/lisa sample profile].
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* [http://www.qmpeople.com/ qmpeople] - e.g. http://www.qmpeople.com/users/laserion
* [http://soup.io Soup] - on user profile
* http://www.dandyid.org/code/images/miscellaneous/favicons/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.typepad.com/.s/static.typepad.com/.shared:v35.14:typepad:en_us/images/profile/service_icons/typepad.png [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
</div>

== Implement hCard XFN supporting friends lists ==
Want to implement hCard+XFN on your site so you can list it here?

# '''Markup friends with hCard.''' See the [[hcard-authoring|hCard authoring]] page for how to mark-up names, links, icons of people in friends lists with hCard.
# '''XFN on friend links.''' Friends lists should be marked up with XFN per [[xfn-clarifications#mapping_community_site_.22friends.22|XFN clarifications: mapping community site friends]]. See also the [http://www.gmpg.org/xfn/join XFN: Getting Started] page for how to markup links to people with XFN. See also the [[hcard-examples#hCard_and_XFN|hCard examples: hCard and XFN]] which demonstrates this and the previous step quite well.
# '''rel="me" to a user's other URLs'''. Hyperlinks to users' home pages or blogs should have the XFN <code>rel="me"</code> attribute to support user-driven (since the user chooses the URL to link to) identity consolidation.
# '''rel="me" on "View All Friends..." links'''. If a user profile page on your site links to a separate page for that user's friends list, add <code>rel="me"</code> to that link.
# '''rel="me" on friends list pagination links'''. If your site paginates a user's friend list into multiple pages, be sure to add <code>rel="me next"</code> to your "Next" pagination hyperlinks, and similarly <code>rel="me prev"</code> to your "Previous" pagination hyperlinks.

Please also consider implementing [[hcard-supporting-user-profiles|hCard user profiles]].

== Implement import XFN friends lists ==
Want to implement importing (and preferably subscribing to) XFN friends lists on your site so you can list it here?

In addition to implementing hCard XFN supporting friends lists yourself (see above), do the following:

# '''Provide a user interface to "Import Friends"''' (like a button or menu item)
# '''When chosen, provide a text input field for the user to enter their profile URL''' (such as their blog or XFN friends list URL). If you already have the user's "Website", pre-fill the field with it, or if the user has many "Other Profiles", pre-fill the field with the first, and let the user pick any of them with a Select pop-up menu, or provide the user the option to just import XFN from all of them at once.
# '''Parse the [[XFN]] at the URL(s) given''' (links with rel="contact" or "acquaintance" or "friend" etc.) and check to see if there are any users on your site with any of those links as their rel="me" "Website" or among their rel="me" "Other Profiles" and add them to a list of people to invite. Crawl any symmetrical rel="me" links, especially symmetrical rel="me next" and/or rel="me prev" friends list pagination links for additional URLs to parse for XFN. Consider also parsing those URLs simultaneously for hCards that have those XFN links as class="url" hCard properties, and if the hCards have additional contact information such as instant messaging or email, add them to the list of people to invite. You can use the [http://zwitserloot.com/org.microformats.hCard/ Java hCard Parser] which also has support for XFN.
# '''Present the list of people to invite''', perhaps sorted by "closeness" of XFN relationships (e.g. list family relationships before just romantic relationships before just friends before just professional relationships before just acquaintances before just contacts before just met etc.) with a "Add Friend" button next to each. When clicked, use [[XHR]] to add that person without altering the overall list, and change the Add button into a Cancel button. Perhaps put an "Add all" button at the top (or bottom) to let the user simply add everyone listed with one click.
# '''Consider also providing a checkbox "<nowiki>[x]</nowiki> Subscribe to XFN friends"''' which would automatically run this import perhaps once a day and notify the user of new contacts found that they may want to add, and similarly present an "Add all" button.

== Sites that should support hCard and XFN ==
=== Should support rel-me ===
See and please add to: [[hcard-advocacy#XFN_rel_me|hCard advocacy - XFN rel="me"]].
=== Should support friend lists ===
See and please add to: [[hcard-advocacy#hCard_XFN_friends_lists|hCard advocacy - hCard XFN friends lists]].

== For more information ==
In addition to the previous "Implement" sections, see the [[hcard-authoring|hCard authoring]] page for how to mark-up information about a person with hCard, and [http://gmpg.org/xfn/join XFN getting started] page for how to mark-up friend links with XFN.

Join the [http://microformats.org/discuss microformats community], in particular the #microformats IRC channel on irc://irc.freenode.net#microformats and the [http://microformats.org/mailman/listinfo/microformats-dev/ microformats-dev mailing list], and send a message stating that you'd like to add hCard to the profiles and hCard+XFN supporting friends lists (and importing thereof) to your website.

Please also consider implementing [[hcard-supporting-user-profiles|hCard supporting user profiles]].

See [[hcard-xfn-supporting-friends-lists-issues|hCard+XFN supporting friends lists issues]] for issues, problems with implementations.

== archived sites ==
Some sites that supported hCard XFN friends lists and [[rel-me]] are no longer operating, and can only be accessed via http://archive.org/
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce]
** When operational, Pownce supported rel="me" linking to multiple other profiles (previous documentation: http://pownce.com/t/notes/644806/ supports rel="me" for LOTS of other profiles ).

== see also ==
* [[xfn|XFN]] ([http://gmpg.org/xfn/ spec], [[xfn-faq|FAQ]], [[xfn-implementations|implementations]] - there are a few more in there that need to be copied and expanded in this page.)
* [[hcard-supporting-user-profiles]]
* [[hcard|hCard]] ([[hcard-authoring|authoring]], [[hcard-faq|FAQ]])
* [[social-network-portability]]
* [[data-portability]]
* [[user-interface]]

hcard-xfn-supporting-friends-lists

2010-03-03T05:34:29Z

Edsu: /* Services with XFN rel="me" to one external site */

<entry-title>hCard+XFN supporting friends lists</entry-title>
Welcome! If you have an account on any of the following services, you already have a list of your friends' hCards with your relationship to them in XFN which you can provide to other services to save time by either importing or subscribing to social network information so you can change it on one site, and have other sites automatically updated, rather than having to re-add/remove all your social network contacts multiple times every time you meet a new person, decide to unfriend someone etc.

== Services with hCard+XFN supporting friends lists ==
The following web sites support publishing hCard+XFN friends lists and are thus suitable for importing/subscribing to other sites that support hCard+XFN. Alphabetically sorted. Feel free to add sites with hCard+XFN supporting friends lists here. Please include a link to the site home page, and instructions for retrieving the URL of your hCard+XFN supporting friends list on that site.

<div style="font-size:larger">
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz]
* [http://hi5.com/ Hi5] - e.g. http://lindner.hi5.com/
* [http://identi.ca/ Identica] - All user (e.g., [http://identi.ca/csarven csarven]) and group (e.g., [http://identi.ca/group/microformats microformats]) profile URLs.
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* [http://lifestrea.ms/ lifestrea.ms] - you have one user profile per social group that you want to share information with: <nowiki>http://lifestrea.ms/user/[username]/</nowiki>. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* http://www.bkmks.com/icons/nytimes.com.gif [http://timespeople.nytimes.com/ NYTimes TimesPeople] - e.g. http://timespeople.nytimes.com/view/user/19390043/1/index.html
* [http://proofile.org Proofile] - Full support of hCard and XFN.
* [http://www.qmpeople.com/ qmpeople] - Uses hCard+XFN for profiles (<nowiki>http://www.qmpeople.com/users/[username]</nowiki> - e.g. [http://www.qmpeople.com/users/laserion laserion])
* http://identoo.com/images/icons/services/slideshare.gif [http://www.slideshare.net/ SlideShare] - partial contacts list at profile at <nowiki>http://www.slideshare.net/USERNAME</nowiki>, e.g. [http://www.slideshare.net/adactio Jeremy Keith's profile], paginated contacts list at <nowiki>http://www.slideshare.net/USERNAME/following</nowiki>, e.g. [http://www.slideshare.net/adactio/following People Jeremy Keith follows].
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
</div>

== Services that import hCard+XFN supporting friends lists ==
The following web sites let you import hCard+XFN friends lists, e.g. from the above sites, and make use of both the XFN information and the hCards in the friends lists. Alphabetically sorted. Feel free to add sites supporting hCard+XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.

=== import ===
The following sites do one time imports of friends lists.

* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - as [http://blog.dopplr.com/index.php/2007/06/23/importing-your-social-network-from-other-sites/ announced] login and go to Dopplr's [http://www.dopplr.com/account/invitations_via/hcard hCard contact import page] to import.
* [http://t.heproject.com/ The Project] - Login with your OpenID and the site automatically tries to subscribe to your XFN friends list where it intersects with their userbase
** appears to fail logging in with a delegated OpenID, e.g. http://tantek.com/ - unable to verify import friends list support. [[User:Tantek|Tantek]] 10:03, 1 Feb 2008 (PST)

=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.

=== delegation ===
The following sites support fully delegating your friends list to an external hCard+XFN friends list.
* None currently.

== Services with XFN supporting friends lists ==
These sites support XFN markup on friends lists. It is a superset of the sites that support XFN and hCard on friends lists.
<div style="font-size:larger">
* [http://3eep.com/ 3eep] - each user's friends are linked to with XFN is located at <nowiki>http://3eep.com/users/[username]</nowiki>
* http://identoo.com/images/icons/services/corkd.gif [http://www.corkd.com/ Cork'd] - login and copy the URL which should start with <nowiki>http://www.corkd.com/people/</nowiki>
* [http://couchsurfing.com CouchSurfing] profiles have XFN Friendly friends lists (e.g. [http://www.couchsurfing.com/people/guaka Guaka's]).
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - login and note that your user page has hCard and XFN for your contacts
* [http://flugpo.com Flugpo] - check your friends page linked from your profile.
* [http://gaia.com/ Gaia Community] - e.g. http://sphorbis.gaia.com/ - built by [http://www.zaadz.com Zaadz]
* [http://identi.ca/ Identica] - All user (e.g., [http://identi.ca/csarven csarven]) and group (e.g., [http://identi.ca/group/microformats microformats]) profile pages contain rel=contact to their friends' URL.
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* http://www.linkedin.com/img/pic/pic_in_17x17.gif [http://www.linkedin.com/ LinkedIn] - LinkedIn Connections use XFN and are marked up with rel="contact".
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last FM] - login, click the "Friends" tab, and copy the URL which should look like: <nowiki>http://www.last.fm/user/[username]/friends/</nowiki>
* [http://lifestrea.ms/ lifestrea.ms] - one friends list per social group that you want to share information with: <nowiki>http://lifestrea.ms/user/[username]/</nowiki>. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
* http://pulse.plaxo.com/pulse/img/event_icons/LiveJournal.gif [http://livejournal.com LiveJournal] (see [[implementations#LiveJournal|LiveJournal]] implementation entry) - login, click on the "Profile" link, and copy the URL which should start with <nowiki>http://USERNAME.livejournal.com/profile</nowiki> where USERNAME is your LJ username. E.g. [http://daveman692.livejournal.com/profile]. LiveJournal profiles have complete friends lists marked up in XFN.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - View your contacts page <nowiki>http://ma.gnolia.com/people/[username]/contacts</nowiki> . Note [[hcard-xfn-supporting-friends-lists-issues#Magnolia|issue(s)]].
* [http://meetlisten.com Meetlisten] - e.g. http://meetlisten.com/home/profile.php?id=1 and (e.g. [http://meetlisten.com/home/friends.php?id=6 MAKACOW-Brazil's]).
* [http://www.nsyght.com/ Nsyght] - Visit your profile page and select "view all" on the friends component. Should look like this: <nowiki>http://www.nsyght.com/friends/[username]/</nowiki>, e.g. [http://nsyght.com/users/lisa sample profile].
* http://identoo.com/images/icons/services/odeo.gif [http://odeo.com Odeo] — the "peep's" list of each user is marked up with XFN (rel="contact") e.g. http://odeo.com/profile/JeremyKeith . See [http://odeo.com/blog/2005/07/adding-microformats-to-odeo.html announcing blog post].
* [http://www.qmpeople.com/ qmpeople] - Uses XFN for public friendships - e.g. http://www.qmpeople.com/users/laserion
* [http://soup.io Soup] - On user profile if the "Friends list" element is displayed (on by default), else at <nowiki>/friends</nowiki>
* http://skateboardspot.info/image/icon/favicon.png [http://skateboardspot.info/ skateboardspot.info] - Log in and click on your username in the top right corner. The URL to your userpage (that you'll see now) is the URL to your hCard. Also 10 people of your contact list will be displayed there. To see all of them click the "... display all friends" link.
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/ (see also [http://wiki.www.videntity.org/wiki/Social_Networking_Unlimited Videntity XFN support documentation]).
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
</div>

== Services that import XFN supporting friends lists ==
The following web sites support importing your existing XFN supporting friends lists, e.g. from the above sites. Alphabetically sorted. Feel free to add sites supporting XFN import here. Please include a link to the site home page, and instructions for how to import friends on the site.
=== import ===
The following sites do one time imports of friends lists.
* None currently.
=== import and subscribe ===
The following sites support both importing and subscribing to friends lists.
* None currently.
=== delegation ===
The following sites support fully delegating your friends list to an external XFN friends list.
* None currently.

== Services with XFN rel="me" to multiple external sites ==
The following services have a UI for entering any number of websites/homepages/blogs and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* [http://huffduffer.com/ Huffduffer] uses rel="me" on profile pages if a URL is provided and then uses the Google Social Graph API to find other profiles which are then also linked with rel="me" — e.g. http://huffduffer.com/clagnut
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* [http://lifestrea.ms/ lifestrea.ms] - supporting all your appearances on the web. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
* http://www.linkedin.com/img/pic/pic_in_17x17.gif [http://www.linkedin.com/ LinkedIn] - e.g. http://www.linkedin.com/in/steveganz rel="me" is applied to "My Website" and "My Blog" on your public profile.
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* [http://proofile.org Proofile] - e.g. http://proofile.org/ueli.weiss
* http://www.dandyid.org/code/images/miscellaneous/favicons/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.typepad.com/.s/static.typepad.com/.shared:v35.14:typepad:en_us/images/profile/service_icons/typepad.png [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
</div>

== Services with XFN rel="me" to one external site ==
The following services have a UI for entering one website/homepage/blog and publish it as part of your profile, linking to it with [[rel-me]].
<div style="font-size:larger">
* [http://delicious.com Delicious] - e.g. http://delicious.com/inkdroid
* http://pulse.plaxo.com/pulse/img/event_icons/Digg.gif [http://digg.com/ Digg] - e.g. http://digg.com/users/tantek
* http://identoo.com/images/icons/services/dopplr.gif [http://dopplr.com Dopplr] - enter your website/homepage/blog into the "Website:" field on the [http://www.dopplr.com/account/profile Dopplr: Account Management] page, and enable your public profile and be sure the "Show homepage" checkbox is checked.
* [http://eventful.com/ Eventful] - login, click on your username, and copy that URL.
* http://pulse.plaxo.com/pulse/img/event_icons/Flickr.gif [http://flickr.com/ Flickr] - login, click "Your Photos", click "Profile", and copy the URL which should be <nowiki>http://flickr.com/people/[username]/</nowiki>
** Flickr supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Flickr contacts page. See [http://flickr.com/photos/factoryjoe/113866484/ screenshot of Flickr UI in Flock browser using Flocktails extension - March 17th 2006].
* [http://identi.ca/ Identica] - Some user (e.g., [http://identi.ca/csarven csarven]) and group (e.g., [http://identi.ca/group/microformats microformats]) profiles have a link to their home/personal URLs.
* http://identoo.com/images/icons/services/identoo.gif [http://identoo.com/ Identoo] - e.g. [http://identoo.com/dirk.olbertz sample profile]
* [http://jpgmag.com JPG Magazine]
* http://pulse.plaxo.com/pulse/img/event_icons/LastFM.gif [http://www.last.fm/ Last.FM] - login, go to your profile, and copy the URL which should start with <nowiki>http://www.last.fm/user/</nowiki>
** Last.FM supports rel="me" identity consolidation with your webpage that you enter into your profile, and with your Last.FM friends page.
* [http://lifestrea.ms/ lifestrea.ms] - supporting all your external appearances on the web. Examples: [http://lifestrea.ms/user/thomas.huhn/ public profile] or [http://lifestrea.ms/user/solution-media.thomas.huhn/ professional profile] of the same person.
* http://pulse.plaxo.com/pulse/img/event_icons/Magnolia.gif [http://ma.gnolia.com/ Ma.gnolia] - see [http://ma.gnolia.com/blog/2006/08/21/a-microadvance-in-our-microformats supports rel=me announcement].
* [http://nsyght.com Nsyght] - e.g. [http://nsyght.com/users/lisa sample profile].
* http://pulse.plaxo.com/pulse/img/event_icons/plaxo.gif [http://plaxo.com/ Plaxo] - e.g. http://joseph.myplaxo.com/
* [http://www.qmpeople.com/ qmpeople] - e.g. http://www.qmpeople.com/users/laserion
* [http://soup.io Soup] - on user profile
* http://www.dandyid.org/code/images/miscellaneous/favicons/technorati.png [http://technorati.com/ Technorati] - e.g. http://technorati.com/people/technorati/tantek
* http://www.typepad.com/.s/static.typepad.com/.shared:v35.14:typepad:en_us/images/profile/service_icons/typepad.png [http://typepad.com/ TypePad] - e.g. http://www.markpasc.typepad.com/
* http://pulse.plaxo.com/pulse/img/event_icons/Twitter.gif [http://twitter.com/ Twitter] - login, click on "Your profile" at the top, and copy the URL
* [http://videntity.org/ Videntity.org] - e.g. http://danda.videntity.org/
* http://openid.net/wp-content/uploads/vox.png [http://vox.com/ Vox] - e.g. http://anil.vox.com/
* [http://wordpress.com Wordpress.com] and any other blogs using Wordpress 1.5 or later have XFN supporting blog rolls (for friends and [[rel-me]]).
</div>

== Implement hCard XFN supporting friends lists ==
Want to implement hCard+XFN on your site so you can list it here?

# '''Markup friends with hCard.''' See the [[hcard-authoring|hCard authoring]] page for how to mark-up names, links, icons of people in friends lists with hCard.
# '''XFN on friend links.''' Friends lists should be marked up with XFN per [[xfn-clarifications#mapping_community_site_.22friends.22|XFN clarifications: mapping community site friends]]. See also the [http://www.gmpg.org/xfn/join XFN: Getting Started] page for how to markup links to people with XFN. See also the [[hcard-examples#hCard_and_XFN|hCard examples: hCard and XFN]] which demonstrates this and the previous step quite well.
# '''rel="me" to a user's other URLs'''. Hyperlinks to users' home pages or blogs should have the XFN <code>rel="me"</code> attribute to support user-driven (since the user chooses the URL to link to) identity consolidation.
# '''rel="me" on "View All Friends..." links'''. If a user profile page on your site links to a separate page for that user's friends list, add <code>rel="me"</code> to that link.
# '''rel="me" on friends list pagination links'''. If your site paginates a user's friend list into multiple pages, be sure to add <code>rel="me next"</code> to your "Next" pagination hyperlinks, and similarly <code>rel="me prev"</code> to your "Previous" pagination hyperlinks.

Please also consider implementing [[hcard-supporting-user-profiles|hCard user profiles]].

== Implement import XFN friends lists ==
Want to implement importing (and preferably subscribing to) XFN friends lists on your site so you can list it here?

In addition to implementing hCard XFN supporting friends lists yourself (see above), do the following:

# '''Provide a user interface to "Import Friends"''' (like a button or menu item)
# '''When chosen, provide a text input field for the user to enter their profile URL''' (such as their blog or XFN friends list URL). If you already have the user's "Website", pre-fill the field with it, or if the user has many "Other Profiles", pre-fill the field with the first, and let the user pick any of them with a Select pop-up menu, or provide the user the option to just import XFN from all of them at once.
# '''Parse the [[XFN]] at the URL(s) given''' (links with rel="contact" or "acquaintance" or "friend" etc.) and check to see if there are any users on your site with any of those links as their rel="me" "Website" or among their rel="me" "Other Profiles" and add them to a list of people to invite. Crawl any symmetrical rel="me" links, especially symmetrical rel="me next" and/or rel="me prev" friends list pagination links for additional URLs to parse for XFN. Consider also parsing those URLs simultaneously for hCards that have those XFN links as class="url" hCard properties, and if the hCards have additional contact information such as instant messaging or email, add them to the list of people to invite. You can use the [http://zwitserloot.com/org.microformats.hCard/ Java hCard Parser] which also has support for XFN.
# '''Present the list of people to invite''', perhaps sorted by "closeness" of XFN relationships (e.g. list family relationships before just romantic relationships before just friends before just professional relationships before just acquaintances before just contacts before just met etc.) with a "Add Friend" button next to each. When clicked, use [[XHR]] to add that person without altering the overall list, and change the Add button into a Cancel button. Perhaps put an "Add all" button at the top (or bottom) to let the user simply add everyone listed with one click.
# '''Consider also providing a checkbox "<nowiki>[x]</nowiki> Subscribe to XFN friends"''' which would automatically run this import perhaps once a day and notify the user of new contacts found that they may want to add, and similarly present an "Add all" button.

== Sites that should support hCard and XFN ==
=== Should support rel-me ===
See and please add to: [[hcard-advocacy#XFN_rel_me|hCard advocacy - XFN rel="me"]].
=== Should support friend lists ===
See and please add to: [[hcard-advocacy#hCard_XFN_friends_lists|hCard advocacy - hCard XFN friends lists]].

== For more information ==
In addition to the previous "Implement" sections, see the [[hcard-authoring|hCard authoring]] page for how to mark-up information about a person with hCard, and [http://gmpg.org/xfn/join XFN getting started] page for how to mark-up friend links with XFN.

Join the [http://microformats.org/discuss microformats community], in particular the #microformats IRC channel on irc://irc.freenode.net#microformats and the [http://microformats.org/mailman/listinfo/microformats-dev/ microformats-dev mailing list], and send a message stating that you'd like to add hCard to the profiles and hCard+XFN supporting friends lists (and importing thereof) to your website.

Please also consider implementing [[hcard-supporting-user-profiles|hCard supporting user profiles]].

See [[hcard-xfn-supporting-friends-lists-issues|hCard+XFN supporting friends lists issues]] for issues, problems with implementations.

== archived sites ==
Some sites that supported hCard XFN friends lists and [[rel-me]] are no longer operating, and can only be accessed via http://archive.org/
* http://pulse.plaxo.com/pulse/img/event_icons/Pownce.gif [http://pownce.com/ Pownce]
** When operational, Pownce supported rel="me" linking to multiple other profiles (previous documentation: http://pownce.com/t/notes/644806/ supports rel="me" for LOTS of other profiles ).

== see also ==
* [[xfn|XFN]] ([http://gmpg.org/xfn/ spec], [[xfn-faq|FAQ]], [[xfn-implementations|implementations]] - there are a few more in there that need to be copied and expanded in this page.)
* [[hcard-supporting-user-profiles]]
* [[hcard|hCard]] ([[hcard-authoring|authoring]], [[hcard-faq|FAQ]])
* [[social-network-portability]]
* [[data-portability]]
* [[user-interface]]

citation

2010-02-07T14:15:42Z

Edsu: /* Copyright */

<h1> Citation microformat efforts </h1>

This wiki page outlines the overall effort to develop a citation microformat. We are documenting current examples of [http://en.wikipedia.org/wiki/Citation cites/citations] on the web today, their implicit/explicit schemas, and current cite/citation formats, with the intent of deriving a cite microformat from that research.

__TOC__

;Authors
:[http://tantek.com/ Tantek Çelik]
:[http://suda.co.uk/ Brian Suda]
:[http://www.inkdroid.org Ed Summers]

== Copyright ==
{{MicroFormatPublicDomainContributionStatement}}
* [[User:Tantek|Tantek]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
* [[User:Brian|Brian Suda]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
* [[User:Edsu|Ed Summers]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.

== Semantic XHTML Design Principles ==
{{semantic-xhtml-design-principles}}

== Example Citations ==
[[citation-examples|Citation Examples]] are citations found in the wild that could benefit from semantic mark-up. This is a growing list of examples from all sorts of places including W3C specifications, RFCs and others. These are the examples which will determine the schema for the citation microformat.

== Known Citation Formats ==
The [[citation-formats|Citation Formats Page]] will be a running tab of known formats for publishing citations.

Eventually, I would like to see a chart of how each value from the implicit schema determined by the [[citation-examples]] is represented in each format, and what formats have additional properties that do not map between them. (For example, Format1 calls 'author' 'author', in format2 'author' is called 'writer'. etc)

== A Prescriptive Proposal ==

Here is a proposal which was derived from what one actually has to give as information in a citation in university work. (I don't know where to put that, so I put it right here.)

First, we need a frame, let's say "hcitation". Multiple citations can be put in a "hcitation" frame. Inside there, we need to describe the type of citation; I suggest "monograph", "anthology", "periodical" , "reference", "thesis" , "standard", "internet", or "specialist".

If a "label" was used to refer to the resource in the text (often in square brackets) it can be named so.

Here comes the list of field names we need: "article", "atime", "author", "ctime", "department", "edition", "editor", "eligibility", "employer", "number", "overalltitle", "pagerange", "part", "place", "publisher", "subseries", "title", "type", "url", "volume", "volumetitle", "year".

The field "page" is to mark up which page you actually quote from. Marking up whatever as "prefix" should give you a hint that this is to be put at first place, but not to refer to when sorting. E.G. "The" should be marked as "prefix" either in "The Crocodile" and also in "Crocodile, the".

<table border="1">
<tr>
<th>Field</th>
<th>Description</th>
<th><code>monograph</code></th>
<th><code>anthology</code></th>
<th><code>periodical</code></th>
<th><code>thesis</code></th>
<th><code>standard</code></th>
<th><code>internet</code></th>
<th><code>specialist</code></th>
</tr>
<tr>
<td><code>article</code></td>
<td>Name of the Article in question</td>
<td align="center"> </td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>atime</code></td>
<td>Last access time for online ressources. Use abbr
convention for datetime encoding.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">11</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">5</td>
<td align="center"> </td>
</tr>
<tr>
<td><code>author</code></td>
<td>Creator. Use fn or n markup for every single entity.</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center"> </td>
<td align="center">1</td>
<td align="center">1</td>
</tr>
<tr>
<td><code>ctime</code></td>
<td>Date / Last modification. Use abbr convention for
datetime encoding.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">8</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center">5</td>
</tr>
<tr>
<td><code>department</code></td>
<td>special field / faculty</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">3</td>
</tr>
<tr>
<td><code>edition</code></td>
<td>Edition information</td>
<td align="center">6</td>
<td align="center">8</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">2</td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>editor</code></td>
<td>Editors of an anthology. Use fn or n markup for every single entity. Add "transl" for translators and "comp" for compilers</td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>eligibility</code></td>
<td>Qualification of a specialist</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">2</td>
</tr>
<tr>
<td><code>employer</code></td>
<td>Name of university eg.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
</tr>
<tr>
<td><code>number</code></td>
<td>Number</td>
<td align="center">10</td>
<td align="center">12</td>
<td align="center">9</td>
<td align="center"> </td>
<td align="center">1</td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>overalltitle</code></td>
<td>Overall Title / Title of series</td>
<td align="center">9</td>
<td align="center">11</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">8</td>
</tr>
<tr>
<td><code>pagerange</code></td>
<td>Page range of an article in an anthology / periodical</td>
<td align="center"> </td>
<td align="center">13</td>
<td align="center">10</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>part</code></td>
<td>Part of article (if having several parts)</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>place</code></td>
<td>Place of publication</td>
<td align="center">7</td>
<td align="center">9</td>
<td align="center"> </td>
<td align="center">5</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>publisher</code></td>
<td>House of Publish</td>
<td align="center">8</td>
<td align="center">10</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>subseries</code></td>
<td>name of subseries, If any</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>title</code></td>
<td>The main title. Anthology: name of antology.
Periodical: name of periodical</td>
<td align="center">3</td>
<td align="center">5</td>
<td align="center">5</td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center">6</td>
</tr>
<tr>
<td><code>type</code></td>
<td>Type (type of thesis or type of utterance (radio
interview, e-mail, ...) of a speciaist)</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">7</td>
</tr>
<tr>
<td><code>url</code></td>
<td>URL</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">12</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
</tr>
<tr>
<td><code>volume</code></td>
<td>Volume information (eg. Vol. 22)</td>
<td align="center">4</td>
<td align="center">6</td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>volumetitle</code></td>
<td>Volume title</td>
<td align="center">5</td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>year</code></td>
<td>Year of appearance. 4 digit year. Use abbr convention
for datetime encoding.</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center"> </td>
<td align="center">2</td>
<td align="center"> </td>
</tr>
</table>

This table shows what has to go together. Numbers give the typical ordered structure of the values. Other Information than given here (eg. ISBN, ...) actually has not to be put into citations, students would recive negative evaluations if they do so. (I hope this will help somehow. sorry for bad english.)

=== Sample Usage ===

<pre><nowiki>
<h1>The Bibliography</h1>

<table class="hcitation">
<tr>
<th scope="row" style="font-variant: small-caps; ">[MR06]</th>
<td class="monograph">
<a name="sr06">

Miller,
Michael
C.
 ;

Mathew
Roth

(2006):

Students' Jokes : A complete collection of jokes students laugh about.
Vol. 23:
Computational Linguists' Jokes.

4th completely revised Edition.
München :
Weltbild
(Fictional publications of munich's students
2675)
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[R08a]</th>
<td class="anthology">
<a name="r08a">

Roth,
Mathew

(2008):
&bdquo;Using semantic HTML for bibliographic citations.“
In:

Michael
B.
Smith
 ;

John
Miller

(Eds.)
(2008):

Being POSH : Usage of semantic HTML in web pages.
Vol. 4:
Whatever you read.

1st Edition.
New York :
Public Press
(Books on data processing
1435)
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[R08b]</th>
<td class="periodical">
<a name="r08b">

Roth,
Mathew

(2008):
&bdquo;Using semantic HTML in scientific work.“
P. 1; P. 2.
In:

The Computational Linguist.

Development of the Semantic Web.
2
(2008)
No. 16,
Pp. 124–131
(Access: <abbr title="20080714T1612+0200">14.07.2008 16:12 CEST</abbr>)
<http://www.sample.url/web/address/1234.pdf>
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[S07]</th>
<td class="thesis">
<a name="s07">

Smith,
John

(2007):

Semantic Data Extraction from the World Wide Web.

University of Munich,
Department of Computational Linguistics,
Diss.
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[SVG11]</th>
<td class="standard">
<a name="svg11">
ISO 1234567
(1-2003</edition>):

Scalable Vector Graphics (SVG) 1.1 Specification.

</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[Wik08]</th>
<td class="internet">
<a name="wik08">

Wikipedia, the free encyclopedia,

(2008):

Microformat.

(Version: <abbr class="ctime" title="2008-06-19">19th June 2008</abbr>.
Access: <abbr class="atime" title="20080703T1423+0200">3rd July 2008 14:23 CEST</abbr>)
<<a href="http://en.wikipedia.org/w/index.php?title=Microformat&oldid=220275451" class="url">http://en.wikipedia.org/w/index.php?title=Microformat&oldid=220275451</a>>
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[W08]</th>
<td class="specialist">
<a name="w08">

Wang,
Wu

(Professor of Informatics,
Department of Applied Sciences,
University of Michigan)
(<abbr class="ctime" title="20000801T0918+0100D0007">01.08.2000, 9:18–9:25 MEZ</abbr>)
Science News.
Interview.
Michigan Television
</a>
</td>
</tr>
</table>
</nowiki></pre>

== Issues ==
The [[citation-issues]] page is intended to capture ongoing issues.

== To Do ==
* [[existing-classes|Using existing class names]] and creating new names, create property names for the profile
* Based on implicit schemas in [[citation-examples]], and terms from one or more [[citation-formats]], do some [[citation-brainstorming]] for a simple citation microformat.
* Create additional strawman proposals

== Modularity ==
My hope for this microformat is that it can be a sort of module that can be used in other microformats. Once this is developed and flushed out, citation references could easily be used for publications on a Resume/CV, therefore the citation microformat would be a module (subset) of all the possible Resume Values.

Other Microformats that could use the Citation Module
* [[hresume|hResume]]
* [[work-of-art]]

Other Microformats that the Citation Module will use
* [[hcard|hCard]] encodings for things like Author, Publisher (people and companies)
* [[hatom|hAtom]] encodings as a possible container, and author/date-time properties
* [[rel-tag]] encoding for keywords
* [[rel-license]] encoding for copyright

== References ==
=== Informative References ===
* [http://ocoins.info/ COinS]
* [http://xmlresume.sourceforge.net/ XMLResume]: if part of the drive for citations is for publications for a resume/CV then some of this information could be useful
* [http://www.citeulike.org/ CiteUlike] is a free service to help academics to share, store, and organise the academic papers they are reading
* [http://www.connotea.org/ Connotea] is a scientific bookmarking service from Nature.
* [http://www.ariadne.ac.uk/issue43/chudnov/ OpenURL] with Autodiscovery
* [http://cipolo.med.yale.edu/mailman/listinfo/gcs-pcs-list "Gather, Create, Share" and "Personal Collection Systems" memes, and systems implementing either or both]
* [http://www.loc.gov/standards/mods/ Metadata Object Description Schema] developed by the Library of Congress
* [http://www.dublincore.org/documents/dc-citation-guidelines/ Guidelines for Encoding Bibliographic Citation Information in Dublin Core Metadata]
* [http://www.ecst.csuchico.edu/~jacobsd/bib/formats/bibtex.html BibTeX reference] from Dana Jacobsen
* [http://www.refman.com/support/risformat_intro.asp RIS Format Specification] from Thomson ResearchSoft, makers of ReferenceManager
* [http://www.zotero.org/ Zotero] - "Firefox extension to help you collect, manage, and cite your research sources"
*[http://www.doi.org/ DOI] ([http://www.crossref.org/02publishers/guidelines.html CrossRef Guidelines] for use of DOIs in citations)
* [http://info-uri.info/ INFO URI] (URI scheme for representing legacy namespaces)
*[http://www.isbn-international.org/ ISBN] ([http://en.wikipedia.org/wiki/International_Standard_Book_Number ISBN on Wikipedia])
*[http://www.issn.org/ ISSN] ([http://en.wikipedia.org/wiki/International_Standard_Serial_Number ISSN on Wikipedia])
* [http://opcit.eprints.org/ Open Citation Project] - OpCit, a three year (1999-2002)R&D project funded by the Joint NSF - JISC International Digital Libraries Research Programme.
* [http://www.docbook.org/ DocBook] (markup langauige for books); [http://en.wikipedia.org/wiki/Docbook DocBook on Wikipedia]
* [http://www.bl.uk/news/2007/pressrelease20071022.html RDA: Resource Description and Access]

== See Also ==
{{citation-related-pages}}

citation

2010-02-07T14:15:05Z

Edsu: /* Copyright */

<h1> Citation microformat efforts </h1>

This wiki page outlines the overall effort to develop a citation microformat. We are documenting current examples of [http://en.wikipedia.org/wiki/Citation cites/citations] on the web today, their implicit/explicit schemas, and current cite/citation formats, with the intent of deriving a cite microformat from that research.

__TOC__

;Authors
:[http://tantek.com/ Tantek Çelik]
:[http://suda.co.uk/ Brian Suda]
:[http://www.inkdroid.org Ed Summers]

== Copyright ==
{{MicroFormatPublicDomainContributionStatement}}
* [[User:Tantek|Tantek]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
* [[User:Brian|Brian Suda]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
* [[User:Edsu|Ed Summers]]: I release all my contributions to this specification into the public domain.

== Semantic XHTML Design Principles ==
{{semantic-xhtml-design-principles}}

== Example Citations ==
[[citation-examples|Citation Examples]] are citations found in the wild that could benefit from semantic mark-up. This is a growing list of examples from all sorts of places including W3C specifications, RFCs and others. These are the examples which will determine the schema for the citation microformat.

== Known Citation Formats ==
The [[citation-formats|Citation Formats Page]] will be a running tab of known formats for publishing citations.

Eventually, I would like to see a chart of how each value from the implicit schema determined by the [[citation-examples]] is represented in each format, and what formats have additional properties that do not map between them. (For example, Format1 calls 'author' 'author', in format2 'author' is called 'writer'. etc)

== A Prescriptive Proposal ==

Here is a proposal which was derived from what one actually has to give as information in a citation in university work. (I don't know where to put that, so I put it right here.)

First, we need a frame, let's say "hcitation". Multiple citations can be put in a "hcitation" frame. Inside there, we need to describe the type of citation; I suggest "monograph", "anthology", "periodical" , "reference", "thesis" , "standard", "internet", or "specialist".

If a "label" was used to refer to the resource in the text (often in square brackets) it can be named so.

Here comes the list of field names we need: "article", "atime", "author", "ctime", "department", "edition", "editor", "eligibility", "employer", "number", "overalltitle", "pagerange", "part", "place", "publisher", "subseries", "title", "type", "url", "volume", "volumetitle", "year".

The field "page" is to mark up which page you actually quote from. Marking up whatever as "prefix" should give you a hint that this is to be put at first place, but not to refer to when sorting. E.G. "The" should be marked as "prefix" either in "The Crocodile" and also in "Crocodile, the".

<table border="1">
<tr>
<th>Field</th>
<th>Description</th>
<th><code>monograph</code></th>
<th><code>anthology</code></th>
<th><code>periodical</code></th>
<th><code>thesis</code></th>
<th><code>standard</code></th>
<th><code>internet</code></th>
<th><code>specialist</code></th>
</tr>
<tr>
<td><code>article</code></td>
<td>Name of the Article in question</td>
<td align="center"> </td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>atime</code></td>
<td>Last access time for online ressources. Use abbr
convention for datetime encoding.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">11</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">5</td>
<td align="center"> </td>
</tr>
<tr>
<td><code>author</code></td>
<td>Creator. Use fn or n markup for every single entity.</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center"> </td>
<td align="center">1</td>
<td align="center">1</td>
</tr>
<tr>
<td><code>ctime</code></td>
<td>Date / Last modification. Use abbr convention for
datetime encoding.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">8</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center">5</td>
</tr>
<tr>
<td><code>department</code></td>
<td>special field / faculty</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">3</td>
</tr>
<tr>
<td><code>edition</code></td>
<td>Edition information</td>
<td align="center">6</td>
<td align="center">8</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">2</td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>editor</code></td>
<td>Editors of an anthology. Use fn or n markup for every single entity. Add "transl" for translators and "comp" for compilers</td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>eligibility</code></td>
<td>Qualification of a specialist</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">2</td>
</tr>
<tr>
<td><code>employer</code></td>
<td>Name of university eg.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
</tr>
<tr>
<td><code>number</code></td>
<td>Number</td>
<td align="center">10</td>
<td align="center">12</td>
<td align="center">9</td>
<td align="center"> </td>
<td align="center">1</td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>overalltitle</code></td>
<td>Overall Title / Title of series</td>
<td align="center">9</td>
<td align="center">11</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">8</td>
</tr>
<tr>
<td><code>pagerange</code></td>
<td>Page range of an article in an anthology / periodical</td>
<td align="center"> </td>
<td align="center">13</td>
<td align="center">10</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>part</code></td>
<td>Part of article (if having several parts)</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>place</code></td>
<td>Place of publication</td>
<td align="center">7</td>
<td align="center">9</td>
<td align="center"> </td>
<td align="center">5</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>publisher</code></td>
<td>House of Publish</td>
<td align="center">8</td>
<td align="center">10</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>subseries</code></td>
<td>name of subseries, If any</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>title</code></td>
<td>The main title. Anthology: name of antology.
Periodical: name of periodical</td>
<td align="center">3</td>
<td align="center">5</td>
<td align="center">5</td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center">6</td>
</tr>
<tr>
<td><code>type</code></td>
<td>Type (type of thesis or type of utterance (radio
interview, e-mail, ...) of a speciaist)</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">7</td>
</tr>
<tr>
<td><code>url</code></td>
<td>URL</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">12</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
</tr>
<tr>
<td><code>volume</code></td>
<td>Volume information (eg. Vol. 22)</td>
<td align="center">4</td>
<td align="center">6</td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>volumetitle</code></td>
<td>Volume title</td>
<td align="center">5</td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>year</code></td>
<td>Year of appearance. 4 digit year. Use abbr convention
for datetime encoding.</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center"> </td>
<td align="center">2</td>
<td align="center"> </td>
</tr>
</table>

This table shows what has to go together. Numbers give the typical ordered structure of the values. Other Information than given here (eg. ISBN, ...) actually has not to be put into citations, students would recive negative evaluations if they do so. (I hope this will help somehow. sorry for bad english.)

=== Sample Usage ===

<pre><nowiki>
<h1>The Bibliography</h1>

<table class="hcitation">
<tr>
<th scope="row" style="font-variant: small-caps; ">[MR06]</th>
<td class="monograph">
<a name="sr06">

Miller,
Michael
C.
 ;

Mathew
Roth

(2006):

Students' Jokes : A complete collection of jokes students laugh about.
Vol. 23:
Computational Linguists' Jokes.

4th completely revised Edition.
München :
Weltbild
(Fictional publications of munich's students
2675)
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[R08a]</th>
<td class="anthology">
<a name="r08a">

Roth,
Mathew

(2008):
&bdquo;Using semantic HTML for bibliographic citations.“
In:

Michael
B.
Smith
 ;

John
Miller

(Eds.)
(2008):

Being POSH : Usage of semantic HTML in web pages.
Vol. 4:
Whatever you read.

1st Edition.
New York :
Public Press
(Books on data processing
1435)
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[R08b]</th>
<td class="periodical">
<a name="r08b">

Roth,
Mathew

(2008):
&bdquo;Using semantic HTML in scientific work.“
P. 1; P. 2.
In:

The Computational Linguist.

Development of the Semantic Web.
2
(2008)
No. 16,
Pp. 124–131
(Access: <abbr title="20080714T1612+0200">14.07.2008 16:12 CEST</abbr>)
<http://www.sample.url/web/address/1234.pdf>
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[S07]</th>
<td class="thesis">
<a name="s07">

Smith,
John

(2007):

Semantic Data Extraction from the World Wide Web.

University of Munich,
Department of Computational Linguistics,
Diss.
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[SVG11]</th>
<td class="standard">
<a name="svg11">
ISO 1234567
(1-2003</edition>):

Scalable Vector Graphics (SVG) 1.1 Specification.

</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[Wik08]</th>
<td class="internet">
<a name="wik08">

Wikipedia, the free encyclopedia,

(2008):

Microformat.

(Version: <abbr class="ctime" title="2008-06-19">19th June 2008</abbr>.
Access: <abbr class="atime" title="20080703T1423+0200">3rd July 2008 14:23 CEST</abbr>)
<<a href="http://en.wikipedia.org/w/index.php?title=Microformat&oldid=220275451" class="url">http://en.wikipedia.org/w/index.php?title=Microformat&oldid=220275451</a>>
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[W08]</th>
<td class="specialist">
<a name="w08">

Wang,
Wu

(Professor of Informatics,
Department of Applied Sciences,
University of Michigan)
(<abbr class="ctime" title="20000801T0918+0100D0007">01.08.2000, 9:18–9:25 MEZ</abbr>)
Science News.
Interview.
Michigan Television
</a>
</td>
</tr>
</table>
</nowiki></pre>

== Issues ==
The [[citation-issues]] page is intended to capture ongoing issues.

== To Do ==
* [[existing-classes|Using existing class names]] and creating new names, create property names for the profile
* Based on implicit schemas in [[citation-examples]], and terms from one or more [[citation-formats]], do some [[citation-brainstorming]] for a simple citation microformat.
* Create additional strawman proposals

== Modularity ==
My hope for this microformat is that it can be a sort of module that can be used in other microformats. Once this is developed and flushed out, citation references could easily be used for publications on a Resume/CV, therefore the citation microformat would be a module (subset) of all the possible Resume Values.

Other Microformats that could use the Citation Module
* [[hresume|hResume]]
* [[work-of-art]]

Other Microformats that the Citation Module will use
* [[hcard|hCard]] encodings for things like Author, Publisher (people and companies)
* [[hatom|hAtom]] encodings as a possible container, and author/date-time properties
* [[rel-tag]] encoding for keywords
* [[rel-license]] encoding for copyright

== References ==
=== Informative References ===
* [http://ocoins.info/ COinS]
* [http://xmlresume.sourceforge.net/ XMLResume]: if part of the drive for citations is for publications for a resume/CV then some of this information could be useful
* [http://www.citeulike.org/ CiteUlike] is a free service to help academics to share, store, and organise the academic papers they are reading
* [http://www.connotea.org/ Connotea] is a scientific bookmarking service from Nature.
* [http://www.ariadne.ac.uk/issue43/chudnov/ OpenURL] with Autodiscovery
* [http://cipolo.med.yale.edu/mailman/listinfo/gcs-pcs-list "Gather, Create, Share" and "Personal Collection Systems" memes, and systems implementing either or both]
* [http://www.loc.gov/standards/mods/ Metadata Object Description Schema] developed by the Library of Congress
* [http://www.dublincore.org/documents/dc-citation-guidelines/ Guidelines for Encoding Bibliographic Citation Information in Dublin Core Metadata]
* [http://www.ecst.csuchico.edu/~jacobsd/bib/formats/bibtex.html BibTeX reference] from Dana Jacobsen
* [http://www.refman.com/support/risformat_intro.asp RIS Format Specification] from Thomson ResearchSoft, makers of ReferenceManager
* [http://www.zotero.org/ Zotero] - "Firefox extension to help you collect, manage, and cite your research sources"
*[http://www.doi.org/ DOI] ([http://www.crossref.org/02publishers/guidelines.html CrossRef Guidelines] for use of DOIs in citations)
* [http://info-uri.info/ INFO URI] (URI scheme for representing legacy namespaces)
*[http://www.isbn-international.org/ ISBN] ([http://en.wikipedia.org/wiki/International_Standard_Book_Number ISBN on Wikipedia])
*[http://www.issn.org/ ISSN] ([http://en.wikipedia.org/wiki/International_Standard_Serial_Number ISSN on Wikipedia])
* [http://opcit.eprints.org/ Open Citation Project] - OpCit, a three year (1999-2002)R&D project funded by the Joint NSF - JISC International Digital Libraries Research Programme.
* [http://www.docbook.org/ DocBook] (markup langauige for books); [http://en.wikipedia.org/wiki/Docbook DocBook on Wikipedia]
* [http://www.bl.uk/news/2007/pressrelease20071022.html RDA: Resource Description and Access]

== See Also ==
{{citation-related-pages}}

citation

2010-02-07T14:14:30Z

Edsu: /* Copyright */

<h1> Citation microformat efforts </h1>

This wiki page outlines the overall effort to develop a citation microformat. We are documenting current examples of [http://en.wikipedia.org/wiki/Citation cites/citations] on the web today, their implicit/explicit schemas, and current cite/citation formats, with the intent of deriving a cite microformat from that research.

__TOC__

;Authors
:[http://tantek.com/ Tantek Çelik]
:[http://suda.co.uk/ Brian Suda]
:[http://www.inkdroid.org Ed Summers]

== Copyright ==
{{MicroFormatPublicDomainContributionStatement}}
* [[User:Tantek|Tantek]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
** When all authors/editors have done so, we can remove the MicroFormatCopyrightStatement template reference and replace it with the MicroFormatPublicDomainContributionStatement.
* [[User:Brian|Brian Suda]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
* [[User:Edsu|Ed Summers]]: I release all my contributions to this specification into the public domain.

== Semantic XHTML Design Principles ==
{{semantic-xhtml-design-principles}}

== Example Citations ==
[[citation-examples|Citation Examples]] are citations found in the wild that could benefit from semantic mark-up. This is a growing list of examples from all sorts of places including W3C specifications, RFCs and others. These are the examples which will determine the schema for the citation microformat.

== Known Citation Formats ==
The [[citation-formats|Citation Formats Page]] will be a running tab of known formats for publishing citations.

Eventually, I would like to see a chart of how each value from the implicit schema determined by the [[citation-examples]] is represented in each format, and what formats have additional properties that do not map between them. (For example, Format1 calls 'author' 'author', in format2 'author' is called 'writer'. etc)

== A Prescriptive Proposal ==

Here is a proposal which was derived from what one actually has to give as information in a citation in university work. (I don't know where to put that, so I put it right here.)

First, we need a frame, let's say "hcitation". Multiple citations can be put in a "hcitation" frame. Inside there, we need to describe the type of citation; I suggest "monograph", "anthology", "periodical" , "reference", "thesis" , "standard", "internet", or "specialist".

If a "label" was used to refer to the resource in the text (often in square brackets) it can be named so.

Here comes the list of field names we need: "article", "atime", "author", "ctime", "department", "edition", "editor", "eligibility", "employer", "number", "overalltitle", "pagerange", "part", "place", "publisher", "subseries", "title", "type", "url", "volume", "volumetitle", "year".

The field "page" is to mark up which page you actually quote from. Marking up whatever as "prefix" should give you a hint that this is to be put at first place, but not to refer to when sorting. E.G. "The" should be marked as "prefix" either in "The Crocodile" and also in "Crocodile, the".

<table border="1">
<tr>
<th>Field</th>
<th>Description</th>
<th><code>monograph</code></th>
<th><code>anthology</code></th>
<th><code>periodical</code></th>
<th><code>thesis</code></th>
<th><code>standard</code></th>
<th><code>internet</code></th>
<th><code>specialist</code></th>
</tr>
<tr>
<td><code>article</code></td>
<td>Name of the Article in question</td>
<td align="center"> </td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>atime</code></td>
<td>Last access time for online ressources. Use abbr
convention for datetime encoding.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">11</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">5</td>
<td align="center"> </td>
</tr>
<tr>
<td><code>author</code></td>
<td>Creator. Use fn or n markup for every single entity.</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center"> </td>
<td align="center">1</td>
<td align="center">1</td>
</tr>
<tr>
<td><code>ctime</code></td>
<td>Date / Last modification. Use abbr convention for
datetime encoding.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">8</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center">5</td>
</tr>
<tr>
<td><code>department</code></td>
<td>special field / faculty</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">3</td>
</tr>
<tr>
<td><code>edition</code></td>
<td>Edition information</td>
<td align="center">6</td>
<td align="center">8</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">2</td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>editor</code></td>
<td>Editors of an anthology. Use fn or n markup for every single entity. Add "transl" for translators and "comp" for compilers</td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>eligibility</code></td>
<td>Qualification of a specialist</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">2</td>
</tr>
<tr>
<td><code>employer</code></td>
<td>Name of university eg.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
</tr>
<tr>
<td><code>number</code></td>
<td>Number</td>
<td align="center">10</td>
<td align="center">12</td>
<td align="center">9</td>
<td align="center"> </td>
<td align="center">1</td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>overalltitle</code></td>
<td>Overall Title / Title of series</td>
<td align="center">9</td>
<td align="center">11</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">8</td>
</tr>
<tr>
<td><code>pagerange</code></td>
<td>Page range of an article in an anthology / periodical</td>
<td align="center"> </td>
<td align="center">13</td>
<td align="center">10</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>part</code></td>
<td>Part of article (if having several parts)</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>place</code></td>
<td>Place of publication</td>
<td align="center">7</td>
<td align="center">9</td>
<td align="center"> </td>
<td align="center">5</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>publisher</code></td>
<td>House of Publish</td>
<td align="center">8</td>
<td align="center">10</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>subseries</code></td>
<td>name of subseries, If any</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>title</code></td>
<td>The main title. Anthology: name of antology.
Periodical: name of periodical</td>
<td align="center">3</td>
<td align="center">5</td>
<td align="center">5</td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center">6</td>
</tr>
<tr>
<td><code>type</code></td>
<td>Type (type of thesis or type of utterance (radio
interview, e-mail, ...) of a speciaist)</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">7</td>
</tr>
<tr>
<td><code>url</code></td>
<td>URL</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">12</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
</tr>
<tr>
<td><code>volume</code></td>
<td>Volume information (eg. Vol. 22)</td>
<td align="center">4</td>
<td align="center">6</td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>volumetitle</code></td>
<td>Volume title</td>
<td align="center">5</td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>year</code></td>
<td>Year of appearance. 4 digit year. Use abbr convention
for datetime encoding.</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center"> </td>
<td align="center">2</td>
<td align="center"> </td>
</tr>
</table>

This table shows what has to go together. Numbers give the typical ordered structure of the values. Other Information than given here (eg. ISBN, ...) actually has not to be put into citations, students would recive negative evaluations if they do so. (I hope this will help somehow. sorry for bad english.)

=== Sample Usage ===

<pre><nowiki>
<h1>The Bibliography</h1>

<table class="hcitation">
<tr>
<th scope="row" style="font-variant: small-caps; ">[MR06]</th>
<td class="monograph">
<a name="sr06">

Miller,
Michael
C.
 ;

Mathew
Roth

(2006):

Students' Jokes : A complete collection of jokes students laugh about.
Vol. 23:
Computational Linguists' Jokes.

4th completely revised Edition.
München :
Weltbild
(Fictional publications of munich's students
2675)
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[R08a]</th>
<td class="anthology">
<a name="r08a">

Roth,
Mathew

(2008):
&bdquo;Using semantic HTML for bibliographic citations.“
In:

Michael
B.
Smith
 ;

John
Miller

(Eds.)
(2008):

Being POSH : Usage of semantic HTML in web pages.
Vol. 4:
Whatever you read.

1st Edition.
New York :
Public Press
(Books on data processing
1435)
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[R08b]</th>
<td class="periodical">
<a name="r08b">

Roth,
Mathew

(2008):
&bdquo;Using semantic HTML in scientific work.“
P. 1; P. 2.
In:

The Computational Linguist.

Development of the Semantic Web.
2
(2008)
No. 16,
Pp. 124–131
(Access: <abbr title="20080714T1612+0200">14.07.2008 16:12 CEST</abbr>)
<http://www.sample.url/web/address/1234.pdf>
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[S07]</th>
<td class="thesis">
<a name="s07">

Smith,
John

(2007):

Semantic Data Extraction from the World Wide Web.

University of Munich,
Department of Computational Linguistics,
Diss.
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[SVG11]</th>
<td class="standard">
<a name="svg11">
ISO 1234567
(1-2003</edition>):

Scalable Vector Graphics (SVG) 1.1 Specification.

</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[Wik08]</th>
<td class="internet">
<a name="wik08">

Wikipedia, the free encyclopedia,

(2008):

Microformat.

(Version: <abbr class="ctime" title="2008-06-19">19th June 2008</abbr>.
Access: <abbr class="atime" title="20080703T1423+0200">3rd July 2008 14:23 CEST</abbr>)
<<a href="http://en.wikipedia.org/w/index.php?title=Microformat&oldid=220275451" class="url">http://en.wikipedia.org/w/index.php?title=Microformat&oldid=220275451</a>>
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[W08]</th>
<td class="specialist">
<a name="w08">

Wang,
Wu

(Professor of Informatics,
Department of Applied Sciences,
University of Michigan)
(<abbr class="ctime" title="20000801T0918+0100D0007">01.08.2000, 9:18–9:25 MEZ</abbr>)
Science News.
Interview.
Michigan Television
</a>
</td>
</tr>
</table>
</nowiki></pre>

== Issues ==
The [[citation-issues]] page is intended to capture ongoing issues.

== To Do ==
* [[existing-classes|Using existing class names]] and creating new names, create property names for the profile
* Based on implicit schemas in [[citation-examples]], and terms from one or more [[citation-formats]], do some [[citation-brainstorming]] for a simple citation microformat.
* Create additional strawman proposals

== Modularity ==
My hope for this microformat is that it can be a sort of module that can be used in other microformats. Once this is developed and flushed out, citation references could easily be used for publications on a Resume/CV, therefore the citation microformat would be a module (subset) of all the possible Resume Values.

Other Microformats that could use the Citation Module
* [[hresume|hResume]]
* [[work-of-art]]

Other Microformats that the Citation Module will use
* [[hcard|hCard]] encodings for things like Author, Publisher (people and companies)
* [[hatom|hAtom]] encodings as a possible container, and author/date-time properties
* [[rel-tag]] encoding for keywords
* [[rel-license]] encoding for copyright

== References ==
=== Informative References ===
* [http://ocoins.info/ COinS]
* [http://xmlresume.sourceforge.net/ XMLResume]: if part of the drive for citations is for publications for a resume/CV then some of this information could be useful
* [http://www.citeulike.org/ CiteUlike] is a free service to help academics to share, store, and organise the academic papers they are reading
* [http://www.connotea.org/ Connotea] is a scientific bookmarking service from Nature.
* [http://www.ariadne.ac.uk/issue43/chudnov/ OpenURL] with Autodiscovery
* [http://cipolo.med.yale.edu/mailman/listinfo/gcs-pcs-list "Gather, Create, Share" and "Personal Collection Systems" memes, and systems implementing either or both]
* [http://www.loc.gov/standards/mods/ Metadata Object Description Schema] developed by the Library of Congress
* [http://www.dublincore.org/documents/dc-citation-guidelines/ Guidelines for Encoding Bibliographic Citation Information in Dublin Core Metadata]
* [http://www.ecst.csuchico.edu/~jacobsd/bib/formats/bibtex.html BibTeX reference] from Dana Jacobsen
* [http://www.refman.com/support/risformat_intro.asp RIS Format Specification] from Thomson ResearchSoft, makers of ReferenceManager
* [http://www.zotero.org/ Zotero] - "Firefox extension to help you collect, manage, and cite your research sources"
*[http://www.doi.org/ DOI] ([http://www.crossref.org/02publishers/guidelines.html CrossRef Guidelines] for use of DOIs in citations)
* [http://info-uri.info/ INFO URI] (URI scheme for representing legacy namespaces)
*[http://www.isbn-international.org/ ISBN] ([http://en.wikipedia.org/wiki/International_Standard_Book_Number ISBN on Wikipedia])
*[http://www.issn.org/ ISSN] ([http://en.wikipedia.org/wiki/International_Standard_Serial_Number ISSN on Wikipedia])
* [http://opcit.eprints.org/ Open Citation Project] - OpCit, a three year (1999-2002)R&D project funded by the Joint NSF - JISC International Digital Libraries Research Programme.
* [http://www.docbook.org/ DocBook] (markup langauige for books); [http://en.wikipedia.org/wiki/Docbook DocBook on Wikipedia]
* [http://www.bl.uk/news/2007/pressrelease20071022.html RDA: Resource Description and Access]

== See Also ==
{{citation-related-pages}}

citation

2010-02-07T14:13:39Z

Edsu: Undo revision 41847 by Edsu (Talk)

<h1> Citation microformat efforts </h1>

This wiki page outlines the overall effort to develop a citation microformat. We are documenting current examples of [http://en.wikipedia.org/wiki/Citation cites/citations] on the web today, their implicit/explicit schemas, and current cite/citation formats, with the intent of deriving a cite microformat from that research.

__TOC__

;Authors
:[http://tantek.com/ Tantek Çelik]
:[http://suda.co.uk/ Brian Suda]
:[http://www.inkdroid.org Ed Summers]

== Copyright ==
{{MicroFormatCopyrightStatement2004}}
* [[User:Tantek|Tantek]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
** When all authors/editors have done so, we can remove the MicroFormatCopyrightStatement template reference and replace it with the MicroFormatPublicDomainContributionStatement.
* [[User:Brian|Brian Suda]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
* [[User:Edsu|Ed Summers]]: I release all my contributions to this specification into the public domain.

== Semantic XHTML Design Principles ==
{{semantic-xhtml-design-principles}}

== Example Citations ==
[[citation-examples|Citation Examples]] are citations found in the wild that could benefit from semantic mark-up. This is a growing list of examples from all sorts of places including W3C specifications, RFCs and others. These are the examples which will determine the schema for the citation microformat.

== Known Citation Formats ==
The [[citation-formats|Citation Formats Page]] will be a running tab of known formats for publishing citations.

Eventually, I would like to see a chart of how each value from the implicit schema determined by the [[citation-examples]] is represented in each format, and what formats have additional properties that do not map between them. (For example, Format1 calls 'author' 'author', in format2 'author' is called 'writer'. etc)

== A Prescriptive Proposal ==

Here is a proposal which was derived from what one actually has to give as information in a citation in university work. (I don't know where to put that, so I put it right here.)

First, we need a frame, let's say "hcitation". Multiple citations can be put in a "hcitation" frame. Inside there, we need to describe the type of citation; I suggest "monograph", "anthology", "periodical" , "reference", "thesis" , "standard", "internet", or "specialist".

If a "label" was used to refer to the resource in the text (often in square brackets) it can be named so.

Here comes the list of field names we need: "article", "atime", "author", "ctime", "department", "edition", "editor", "eligibility", "employer", "number", "overalltitle", "pagerange", "part", "place", "publisher", "subseries", "title", "type", "url", "volume", "volumetitle", "year".

The field "page" is to mark up which page you actually quote from. Marking up whatever as "prefix" should give you a hint that this is to be put at first place, but not to refer to when sorting. E.G. "The" should be marked as "prefix" either in "The Crocodile" and also in "Crocodile, the".

<table border="1">
<tr>
<th>Field</th>
<th>Description</th>
<th><code>monograph</code></th>
<th><code>anthology</code></th>
<th><code>periodical</code></th>
<th><code>thesis</code></th>
<th><code>standard</code></th>
<th><code>internet</code></th>
<th><code>specialist</code></th>
</tr>
<tr>
<td><code>article</code></td>
<td>Name of the Article in question</td>
<td align="center"> </td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>atime</code></td>
<td>Last access time for online ressources. Use abbr
convention for datetime encoding.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">11</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">5</td>
<td align="center"> </td>
</tr>
<tr>
<td><code>author</code></td>
<td>Creator. Use fn or n markup for every single entity.</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center"> </td>
<td align="center">1</td>
<td align="center">1</td>
</tr>
<tr>
<td><code>ctime</code></td>
<td>Date / Last modification. Use abbr convention for
datetime encoding.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">8</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center">5</td>
</tr>
<tr>
<td><code>department</code></td>
<td>special field / faculty</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">3</td>
</tr>
<tr>
<td><code>edition</code></td>
<td>Edition information</td>
<td align="center">6</td>
<td align="center">8</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">2</td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>editor</code></td>
<td>Editors of an anthology. Use fn or n markup for every single entity. Add "transl" for translators and "comp" for compilers</td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>eligibility</code></td>
<td>Qualification of a specialist</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">2</td>
</tr>
<tr>
<td><code>employer</code></td>
<td>Name of university eg.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
</tr>
<tr>
<td><code>number</code></td>
<td>Number</td>
<td align="center">10</td>
<td align="center">12</td>
<td align="center">9</td>
<td align="center"> </td>
<td align="center">1</td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>overalltitle</code></td>
<td>Overall Title / Title of series</td>
<td align="center">9</td>
<td align="center">11</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">8</td>
</tr>
<tr>
<td><code>pagerange</code></td>
<td>Page range of an article in an anthology / periodical</td>
<td align="center"> </td>
<td align="center">13</td>
<td align="center">10</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>part</code></td>
<td>Part of article (if having several parts)</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>place</code></td>
<td>Place of publication</td>
<td align="center">7</td>
<td align="center">9</td>
<td align="center"> </td>
<td align="center">5</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>publisher</code></td>
<td>House of Publish</td>
<td align="center">8</td>
<td align="center">10</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>subseries</code></td>
<td>name of subseries, If any</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>title</code></td>
<td>The main title. Anthology: name of antology.
Periodical: name of periodical</td>
<td align="center">3</td>
<td align="center">5</td>
<td align="center">5</td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center">6</td>
</tr>
<tr>
<td><code>type</code></td>
<td>Type (type of thesis or type of utterance (radio
interview, e-mail, ...) of a speciaist)</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">7</td>
</tr>
<tr>
<td><code>url</code></td>
<td>URL</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">12</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
</tr>
<tr>
<td><code>volume</code></td>
<td>Volume information (eg. Vol. 22)</td>
<td align="center">4</td>
<td align="center">6</td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>volumetitle</code></td>
<td>Volume title</td>
<td align="center">5</td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>year</code></td>
<td>Year of appearance. 4 digit year. Use abbr convention
for datetime encoding.</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center"> </td>
<td align="center">2</td>
<td align="center"> </td>
</tr>
</table>

This table shows what has to go together. Numbers give the typical ordered structure of the values. Other Information than given here (eg. ISBN, ...) actually has not to be put into citations, students would recive negative evaluations if they do so. (I hope this will help somehow. sorry for bad english.)

=== Sample Usage ===

<pre><nowiki>
<h1>The Bibliography</h1>

<table class="hcitation">
<tr>
<th scope="row" style="font-variant: small-caps; ">[MR06]</th>
<td class="monograph">
<a name="sr06">

Miller,
Michael
C.
 ;

Mathew
Roth

(2006):

Students' Jokes : A complete collection of jokes students laugh about.
Vol. 23:
Computational Linguists' Jokes.

4th completely revised Edition.
München :
Weltbild
(Fictional publications of munich's students
2675)
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[R08a]</th>
<td class="anthology">
<a name="r08a">

Roth,
Mathew

(2008):
&bdquo;Using semantic HTML for bibliographic citations.“
In:

Michael
B.
Smith
 ;

John
Miller

(Eds.)
(2008):

Being POSH : Usage of semantic HTML in web pages.
Vol. 4:
Whatever you read.

1st Edition.
New York :
Public Press
(Books on data processing
1435)
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[R08b]</th>
<td class="periodical">
<a name="r08b">

Roth,
Mathew

(2008):
&bdquo;Using semantic HTML in scientific work.“
P. 1; P. 2.
In:

The Computational Linguist.

Development of the Semantic Web.
2
(2008)
No. 16,
Pp. 124–131
(Access: <abbr title="20080714T1612+0200">14.07.2008 16:12 CEST</abbr>)
<http://www.sample.url/web/address/1234.pdf>
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[S07]</th>
<td class="thesis">
<a name="s07">

Smith,
John

(2007):

Semantic Data Extraction from the World Wide Web.

University of Munich,
Department of Computational Linguistics,
Diss.
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[SVG11]</th>
<td class="standard">
<a name="svg11">
ISO 1234567
(1-2003</edition>):

Scalable Vector Graphics (SVG) 1.1 Specification.

</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[Wik08]</th>
<td class="internet">
<a name="wik08">

Wikipedia, the free encyclopedia,

(2008):

Microformat.

(Version: <abbr class="ctime" title="2008-06-19">19th June 2008</abbr>.
Access: <abbr class="atime" title="20080703T1423+0200">3rd July 2008 14:23 CEST</abbr>)
<<a href="http://en.wikipedia.org/w/index.php?title=Microformat&oldid=220275451" class="url">http://en.wikipedia.org/w/index.php?title=Microformat&oldid=220275451</a>>
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[W08]</th>
<td class="specialist">
<a name="w08">

Wang,
Wu

(Professor of Informatics,
Department of Applied Sciences,
University of Michigan)
(<abbr class="ctime" title="20000801T0918+0100D0007">01.08.2000, 9:18–9:25 MEZ</abbr>)
Science News.
Interview.
Michigan Television
</a>
</td>
</tr>
</table>
</nowiki></pre>

== Issues ==
The [[citation-issues]] page is intended to capture ongoing issues.

== To Do ==
* [[existing-classes|Using existing class names]] and creating new names, create property names for the profile
* Based on implicit schemas in [[citation-examples]], and terms from one or more [[citation-formats]], do some [[citation-brainstorming]] for a simple citation microformat.
* Create additional strawman proposals

== Modularity ==
My hope for this microformat is that it can be a sort of module that can be used in other microformats. Once this is developed and flushed out, citation references could easily be used for publications on a Resume/CV, therefore the citation microformat would be a module (subset) of all the possible Resume Values.

Other Microformats that could use the Citation Module
* [[hresume|hResume]]
* [[work-of-art]]

Other Microformats that the Citation Module will use
* [[hcard|hCard]] encodings for things like Author, Publisher (people and companies)
* [[hatom|hAtom]] encodings as a possible container, and author/date-time properties
* [[rel-tag]] encoding for keywords
* [[rel-license]] encoding for copyright

== References ==
=== Informative References ===
* [http://ocoins.info/ COinS]
* [http://xmlresume.sourceforge.net/ XMLResume]: if part of the drive for citations is for publications for a resume/CV then some of this information could be useful
* [http://www.citeulike.org/ CiteUlike] is a free service to help academics to share, store, and organise the academic papers they are reading
* [http://www.connotea.org/ Connotea] is a scientific bookmarking service from Nature.
* [http://www.ariadne.ac.uk/issue43/chudnov/ OpenURL] with Autodiscovery
* [http://cipolo.med.yale.edu/mailman/listinfo/gcs-pcs-list "Gather, Create, Share" and "Personal Collection Systems" memes, and systems implementing either or both]
* [http://www.loc.gov/standards/mods/ Metadata Object Description Schema] developed by the Library of Congress
* [http://www.dublincore.org/documents/dc-citation-guidelines/ Guidelines for Encoding Bibliographic Citation Information in Dublin Core Metadata]
* [http://www.ecst.csuchico.edu/~jacobsd/bib/formats/bibtex.html BibTeX reference] from Dana Jacobsen
* [http://www.refman.com/support/risformat_intro.asp RIS Format Specification] from Thomson ResearchSoft, makers of ReferenceManager
* [http://www.zotero.org/ Zotero] - "Firefox extension to help you collect, manage, and cite your research sources"
*[http://www.doi.org/ DOI] ([http://www.crossref.org/02publishers/guidelines.html CrossRef Guidelines] for use of DOIs in citations)
* [http://info-uri.info/ INFO URI] (URI scheme for representing legacy namespaces)
*[http://www.isbn-international.org/ ISBN] ([http://en.wikipedia.org/wiki/International_Standard_Book_Number ISBN on Wikipedia])
*[http://www.issn.org/ ISSN] ([http://en.wikipedia.org/wiki/International_Standard_Serial_Number ISSN on Wikipedia])
* [http://opcit.eprints.org/ Open Citation Project] - OpCit, a three year (1999-2002)R&D project funded by the Joint NSF - JISC International Digital Libraries Research Programme.
* [http://www.docbook.org/ DocBook] (markup langauige for books); [http://en.wikipedia.org/wiki/Docbook DocBook on Wikipedia]
* [http://www.bl.uk/news/2007/pressrelease20071022.html RDA: Resource Description and Access]

== See Also ==
{{citation-related-pages}}

citation

2010-02-07T14:05:07Z

Edsu: /* Copyright */ - switched to public domain since all the authors agree

<h1> Citation microformat efforts </h1>

This wiki page outlines the overall effort to develop a citation microformat. We are documenting current examples of [http://en.wikipedia.org/wiki/Citation cites/citations] on the web today, their implicit/explicit schemas, and current cite/citation formats, with the intent of deriving a cite microformat from that research.

__TOC__

;Authors
:[http://tantek.com/ Tantek Çelik]
:[http://suda.co.uk/ Brian Suda]
:[http://www.inkdroid.org Ed Summers]

== Copyright ==
{{cc-public-domain-release}}

== Semantic XHTML Design Principles ==
{{semantic-xhtml-design-principles}}

== Example Citations ==
[[citation-examples|Citation Examples]] are citations found in the wild that could benefit from semantic mark-up. This is a growing list of examples from all sorts of places including W3C specifications, RFCs and others. These are the examples which will determine the schema for the citation microformat.

== Known Citation Formats ==
The [[citation-formats|Citation Formats Page]] will be a running tab of known formats for publishing citations.

Eventually, I would like to see a chart of how each value from the implicit schema determined by the [[citation-examples]] is represented in each format, and what formats have additional properties that do not map between them. (For example, Format1 calls 'author' 'author', in format2 'author' is called 'writer'. etc)

== A Prescriptive Proposal ==

Here is a proposal which was derived from what one actually has to give as information in a citation in university work. (I don't know where to put that, so I put it right here.)

First, we need a frame, let's say "hcitation". Multiple citations can be put in a "hcitation" frame. Inside there, we need to describe the type of citation; I suggest "monograph", "anthology", "periodical" , "reference", "thesis" , "standard", "internet", or "specialist".

If a "label" was used to refer to the resource in the text (often in square brackets) it can be named so.

Here comes the list of field names we need: "article", "atime", "author", "ctime", "department", "edition", "editor", "eligibility", "employer", "number", "overalltitle", "pagerange", "part", "place", "publisher", "subseries", "title", "type", "url", "volume", "volumetitle", "year".

The field "page" is to mark up which page you actually quote from. Marking up whatever as "prefix" should give you a hint that this is to be put at first place, but not to refer to when sorting. E.G. "The" should be marked as "prefix" either in "The Crocodile" and also in "Crocodile, the".

<table border="1">
<tr>
<th>Field</th>
<th>Description</th>
<th><code>monograph</code></th>
<th><code>anthology</code></th>
<th><code>periodical</code></th>
<th><code>thesis</code></th>
<th><code>standard</code></th>
<th><code>internet</code></th>
<th><code>specialist</code></th>
</tr>
<tr>
<td><code>article</code></td>
<td>Name of the Article in question</td>
<td align="center"> </td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>atime</code></td>
<td>Last access time for online ressources. Use abbr
convention for datetime encoding.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">11</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">5</td>
<td align="center"> </td>
</tr>
<tr>
<td><code>author</code></td>
<td>Creator. Use fn or n markup for every single entity.</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center"> </td>
<td align="center">1</td>
<td align="center">1</td>
</tr>
<tr>
<td><code>ctime</code></td>
<td>Date / Last modification. Use abbr convention for
datetime encoding.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">8</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center">5</td>
</tr>
<tr>
<td><code>department</code></td>
<td>special field / faculty</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">3</td>
</tr>
<tr>
<td><code>edition</code></td>
<td>Edition information</td>
<td align="center">6</td>
<td align="center">8</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">2</td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>editor</code></td>
<td>Editors of an anthology. Use fn or n markup for every single entity. Add "transl" for translators and "comp" for compilers</td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>eligibility</code></td>
<td>Qualification of a specialist</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">2</td>
</tr>
<tr>
<td><code>employer</code></td>
<td>Name of university eg.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
</tr>
<tr>
<td><code>number</code></td>
<td>Number</td>
<td align="center">10</td>
<td align="center">12</td>
<td align="center">9</td>
<td align="center"> </td>
<td align="center">1</td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>overalltitle</code></td>
<td>Overall Title / Title of series</td>
<td align="center">9</td>
<td align="center">11</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">8</td>
</tr>
<tr>
<td><code>pagerange</code></td>
<td>Page range of an article in an anthology / periodical</td>
<td align="center"> </td>
<td align="center">13</td>
<td align="center">10</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>part</code></td>
<td>Part of article (if having several parts)</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>place</code></td>
<td>Place of publication</td>
<td align="center">7</td>
<td align="center">9</td>
<td align="center"> </td>
<td align="center">5</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>publisher</code></td>
<td>House of Publish</td>
<td align="center">8</td>
<td align="center">10</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>subseries</code></td>
<td>name of subseries, If any</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>title</code></td>
<td>The main title. Anthology: name of antology.
Periodical: name of periodical</td>
<td align="center">3</td>
<td align="center">5</td>
<td align="center">5</td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center">6</td>
</tr>
<tr>
<td><code>type</code></td>
<td>Type (type of thesis or type of utterance (radio
interview, e-mail, ...) of a speciaist)</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">7</td>
</tr>
<tr>
<td><code>url</code></td>
<td>URL</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">12</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
</tr>
<tr>
<td><code>volume</code></td>
<td>Volume information (eg. Vol. 22)</td>
<td align="center">4</td>
<td align="center">6</td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>volumetitle</code></td>
<td>Volume title</td>
<td align="center">5</td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>year</code></td>
<td>Year of appearance. 4 digit year. Use abbr convention
for datetime encoding.</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center"> </td>
<td align="center">2</td>
<td align="center"> </td>
</tr>
</table>

This table shows what has to go together. Numbers give the typical ordered structure of the values. Other Information than given here (eg. ISBN, ...) actually has not to be put into citations, students would recive negative evaluations if they do so. (I hope this will help somehow. sorry for bad english.)

=== Sample Usage ===

<pre><nowiki>
<h1>The Bibliography</h1>

<table class="hcitation">
<tr>
<th scope="row" style="font-variant: small-caps; ">[MR06]</th>
<td class="monograph">
<a name="sr06">

Miller,
Michael
C.
 ;

Mathew
Roth

(2006):

Students' Jokes : A complete collection of jokes students laugh about.
Vol. 23:
Computational Linguists' Jokes.

4th completely revised Edition.
München :
Weltbild
(Fictional publications of munich's students
2675)
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[R08a]</th>
<td class="anthology">
<a name="r08a">

Roth,
Mathew

(2008):
&bdquo;Using semantic HTML for bibliographic citations.“
In:

Michael
B.
Smith
 ;

John
Miller

(Eds.)
(2008):

Being POSH : Usage of semantic HTML in web pages.
Vol. 4:
Whatever you read.

1st Edition.
New York :
Public Press
(Books on data processing
1435)
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[R08b]</th>
<td class="periodical">
<a name="r08b">

Roth,
Mathew

(2008):
&bdquo;Using semantic HTML in scientific work.“
P. 1; P. 2.
In:

The Computational Linguist.

Development of the Semantic Web.
2
(2008)
No. 16,
Pp. 124–131
(Access: <abbr title="20080714T1612+0200">14.07.2008 16:12 CEST</abbr>)
<http://www.sample.url/web/address/1234.pdf>
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[S07]</th>
<td class="thesis">
<a name="s07">

Smith,
John

(2007):

Semantic Data Extraction from the World Wide Web.

University of Munich,
Department of Computational Linguistics,
Diss.
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[SVG11]</th>
<td class="standard">
<a name="svg11">
ISO 1234567
(1-2003</edition>):

Scalable Vector Graphics (SVG) 1.1 Specification.

</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[Wik08]</th>
<td class="internet">
<a name="wik08">

Wikipedia, the free encyclopedia,

(2008):

Microformat.

(Version: <abbr class="ctime" title="2008-06-19">19th June 2008</abbr>.
Access: <abbr class="atime" title="20080703T1423+0200">3rd July 2008 14:23 CEST</abbr>)
<<a href="http://en.wikipedia.org/w/index.php?title=Microformat&oldid=220275451" class="url">http://en.wikipedia.org/w/index.php?title=Microformat&oldid=220275451</a>>
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[W08]</th>
<td class="specialist">
<a name="w08">

Wang,
Wu

(Professor of Informatics,
Department of Applied Sciences,
University of Michigan)
(<abbr class="ctime" title="20000801T0918+0100D0007">01.08.2000, 9:18–9:25 MEZ</abbr>)
Science News.
Interview.
Michigan Television
</a>
</td>
</tr>
</table>
</nowiki></pre>

== Issues ==
The [[citation-issues]] page is intended to capture ongoing issues.

== To Do ==
* [[existing-classes|Using existing class names]] and creating new names, create property names for the profile
* Based on implicit schemas in [[citation-examples]], and terms from one or more [[citation-formats]], do some [[citation-brainstorming]] for a simple citation microformat.
* Create additional strawman proposals

== Modularity ==
My hope for this microformat is that it can be a sort of module that can be used in other microformats. Once this is developed and flushed out, citation references could easily be used for publications on a Resume/CV, therefore the citation microformat would be a module (subset) of all the possible Resume Values.

Other Microformats that could use the Citation Module
* [[hresume|hResume]]
* [[work-of-art]]

Other Microformats that the Citation Module will use
* [[hcard|hCard]] encodings for things like Author, Publisher (people and companies)
* [[hatom|hAtom]] encodings as a possible container, and author/date-time properties
* [[rel-tag]] encoding for keywords
* [[rel-license]] encoding for copyright

== References ==
=== Informative References ===
* [http://ocoins.info/ COinS]
* [http://xmlresume.sourceforge.net/ XMLResume]: if part of the drive for citations is for publications for a resume/CV then some of this information could be useful
* [http://www.citeulike.org/ CiteUlike] is a free service to help academics to share, store, and organise the academic papers they are reading
* [http://www.connotea.org/ Connotea] is a scientific bookmarking service from Nature.
* [http://www.ariadne.ac.uk/issue43/chudnov/ OpenURL] with Autodiscovery
* [http://cipolo.med.yale.edu/mailman/listinfo/gcs-pcs-list "Gather, Create, Share" and "Personal Collection Systems" memes, and systems implementing either or both]
* [http://www.loc.gov/standards/mods/ Metadata Object Description Schema] developed by the Library of Congress
* [http://www.dublincore.org/documents/dc-citation-guidelines/ Guidelines for Encoding Bibliographic Citation Information in Dublin Core Metadata]
* [http://www.ecst.csuchico.edu/~jacobsd/bib/formats/bibtex.html BibTeX reference] from Dana Jacobsen
* [http://www.refman.com/support/risformat_intro.asp RIS Format Specification] from Thomson ResearchSoft, makers of ReferenceManager
* [http://www.zotero.org/ Zotero] - "Firefox extension to help you collect, manage, and cite your research sources"
*[http://www.doi.org/ DOI] ([http://www.crossref.org/02publishers/guidelines.html CrossRef Guidelines] for use of DOIs in citations)
* [http://info-uri.info/ INFO URI] (URI scheme for representing legacy namespaces)
*[http://www.isbn-international.org/ ISBN] ([http://en.wikipedia.org/wiki/International_Standard_Book_Number ISBN on Wikipedia])
*[http://www.issn.org/ ISSN] ([http://en.wikipedia.org/wiki/International_Standard_Serial_Number ISSN on Wikipedia])
* [http://opcit.eprints.org/ Open Citation Project] - OpCit, a three year (1999-2002)R&D project funded by the Joint NSF - JISC International Digital Libraries Research Programme.
* [http://www.docbook.org/ DocBook] (markup langauige for books); [http://en.wikipedia.org/wiki/Docbook DocBook on Wikipedia]
* [http://www.bl.uk/news/2007/pressrelease20071022.html RDA: Resource Description and Access]

== See Also ==
{{citation-related-pages}}

User:Edsu

2010-02-07T14:03:01Z

Edsu:

Ed Summers

* homepage: [http://inkdroid.org http://inkdroid.org]
* twitter: [http://inkdroid.org/edsu edsu]

User:Edsu

2010-02-07T14:02:35Z

Edsu:

Ed Summers

homepage: [http://inkdroid.org http://inkdroid.org]
twitter: [http://inkdroid.org/edsu edsu]

User:Edsu

2010-02-07T14:01:41Z

Edsu: New page: Ed Summers [http://inkdroid.org]

Ed Summers

[http://inkdroid.org]

citation

2010-02-07T13:59:07Z

Edsu: /* Copyright */

<h1> Citation microformat efforts </h1>

This wiki page outlines the overall effort to develop a citation microformat. We are documenting current examples of [http://en.wikipedia.org/wiki/Citation cites/citations] on the web today, their implicit/explicit schemas, and current cite/citation formats, with the intent of deriving a cite microformat from that research.

__TOC__

;Authors
:[http://tantek.com/ Tantek Çelik]
:[http://suda.co.uk/ Brian Suda]
:[http://www.inkdroid.org Ed Summers]

== Copyright ==
{{MicroFormatCopyrightStatement2004}}
* [[User:Tantek|Tantek]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
** When all authors/editors have done so, we can remove the MicroFormatCopyrightStatement template reference and replace it with the MicroFormatPublicDomainContributionStatement.
* [[User:Brian|Brian Suda]]: I release all my contributions to this specification into the public domain and I encourage the other authors to do so as well.
* [[User:Edsu|Ed Summers]]: I release all my contributions to this specification into the public domain.

== Semantic XHTML Design Principles ==
{{semantic-xhtml-design-principles}}

== Example Citations ==
[[citation-examples|Citation Examples]] are citations found in the wild that could benefit from semantic mark-up. This is a growing list of examples from all sorts of places including W3C specifications, RFCs and others. These are the examples which will determine the schema for the citation microformat.

== Known Citation Formats ==
The [[citation-formats|Citation Formats Page]] will be a running tab of known formats for publishing citations.

Eventually, I would like to see a chart of how each value from the implicit schema determined by the [[citation-examples]] is represented in each format, and what formats have additional properties that do not map between them. (For example, Format1 calls 'author' 'author', in format2 'author' is called 'writer'. etc)

== A Prescriptive Proposal ==

Here is a proposal which was derived from what one actually has to give as information in a citation in university work. (I don't know where to put that, so I put it right here.)

First, we need a frame, let's say "hcitation". Multiple citations can be put in a "hcitation" frame. Inside there, we need to describe the type of citation; I suggest "monograph", "anthology", "periodical" , "reference", "thesis" , "standard", "internet", or "specialist".

If a "label" was used to refer to the resource in the text (often in square brackets) it can be named so.

Here comes the list of field names we need: "article", "atime", "author", "ctime", "department", "edition", "editor", "eligibility", "employer", "number", "overalltitle", "pagerange", "part", "place", "publisher", "subseries", "title", "type", "url", "volume", "volumetitle", "year".

The field "page" is to mark up which page you actually quote from. Marking up whatever as "prefix" should give you a hint that this is to be put at first place, but not to refer to when sorting. E.G. "The" should be marked as "prefix" either in "The Crocodile" and also in "Crocodile, the".

<table border="1">
<tr>
<th>Field</th>
<th>Description</th>
<th><code>monograph</code></th>
<th><code>anthology</code></th>
<th><code>periodical</code></th>
<th><code>thesis</code></th>
<th><code>standard</code></th>
<th><code>internet</code></th>
<th><code>specialist</code></th>
</tr>
<tr>
<td><code>article</code></td>
<td>Name of the Article in question</td>
<td align="center"> </td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>atime</code></td>
<td>Last access time for online ressources. Use abbr
convention for datetime encoding.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">11</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">5</td>
<td align="center"> </td>
</tr>
<tr>
<td><code>author</code></td>
<td>Creator. Use fn or n markup for every single entity.</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center">1</td>
<td align="center"> </td>
<td align="center">1</td>
<td align="center">1</td>
</tr>
<tr>
<td><code>ctime</code></td>
<td>Date / Last modification. Use abbr convention for
datetime encoding.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">8</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center">5</td>
</tr>
<tr>
<td><code>department</code></td>
<td>special field / faculty</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">3</td>
</tr>
<tr>
<td><code>edition</code></td>
<td>Edition information</td>
<td align="center">6</td>
<td align="center">8</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">2</td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>editor</code></td>
<td>Editors of an anthology. Use fn or n markup for every single entity. Add "transl" for translators and "comp" for compilers</td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>eligibility</code></td>
<td>Qualification of a specialist</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">2</td>
</tr>
<tr>
<td><code>employer</code></td>
<td>Name of university eg.</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
</tr>
<tr>
<td><code>number</code></td>
<td>Number</td>
<td align="center">10</td>
<td align="center">12</td>
<td align="center">9</td>
<td align="center"> </td>
<td align="center">1</td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>overalltitle</code></td>
<td>Overall Title / Title of series</td>
<td align="center">9</td>
<td align="center">11</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">8</td>
</tr>
<tr>
<td><code>pagerange</code></td>
<td>Page range of an article in an anthology / periodical</td>
<td align="center"> </td>
<td align="center">13</td>
<td align="center">10</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>part</code></td>
<td>Part of article (if having several parts)</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">4</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>place</code></td>
<td>Place of publication</td>
<td align="center">7</td>
<td align="center">9</td>
<td align="center"> </td>
<td align="center">5</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>publisher</code></td>
<td>House of Publish</td>
<td align="center">8</td>
<td align="center">10</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>subseries</code></td>
<td>name of subseries, If any</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>title</code></td>
<td>The main title. Anthology: name of antology.
Periodical: name of periodical</td>
<td align="center">3</td>
<td align="center">5</td>
<td align="center">5</td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center">3</td>
<td align="center">6</td>
</tr>
<tr>
<td><code>type</code></td>
<td>Type (type of thesis or type of utterance (radio
interview, e-mail, ...) of a speciaist)</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">7</td>
</tr>
<tr>
<td><code>url</code></td>
<td>URL</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">12</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center">6</td>
<td align="center"> </td>
</tr>
<tr>
<td><code>volume</code></td>
<td>Volume information (eg. Vol. 22)</td>
<td align="center">4</td>
<td align="center">6</td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>volumetitle</code></td>
<td>Volume title</td>
<td align="center">5</td>
<td align="center">7</td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
<td align="center"> </td>
</tr>
<tr>
<td><code>year</code></td>
<td>Year of appearance. 4 digit year. Use abbr convention
for datetime encoding.</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center">2</td>
<td align="center"> </td>
<td align="center">2</td>
<td align="center"> </td>
</tr>
</table>

This table shows what has to go together. Numbers give the typical ordered structure of the values. Other Information than given here (eg. ISBN, ...) actually has not to be put into citations, students would recive negative evaluations if they do so. (I hope this will help somehow. sorry for bad english.)

=== Sample Usage ===

<pre><nowiki>
<h1>The Bibliography</h1>

<table class="hcitation">
<tr>
<th scope="row" style="font-variant: small-caps; ">[MR06]</th>
<td class="monograph">
<a name="sr06">

Miller,
Michael
C.
 ;

Mathew
Roth

(2006):

Students' Jokes : A complete collection of jokes students laugh about.
Vol. 23:
Computational Linguists' Jokes.

4th completely revised Edition.
München :
Weltbild
(Fictional publications of munich's students
2675)
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[R08a]</th>
<td class="anthology">
<a name="r08a">

Roth,
Mathew

(2008):
&bdquo;Using semantic HTML for bibliographic citations.“
In:

Michael
B.
Smith
 ;

John
Miller

(Eds.)
(2008):

Being POSH : Usage of semantic HTML in web pages.
Vol. 4:
Whatever you read.

1st Edition.
New York :
Public Press
(Books on data processing
1435)
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[R08b]</th>
<td class="periodical">
<a name="r08b">

Roth,
Mathew

(2008):
&bdquo;Using semantic HTML in scientific work.“
P. 1; P. 2.
In:

The Computational Linguist.

Development of the Semantic Web.
2
(2008)
No. 16,
Pp. 124–131
(Access: <abbr title="20080714T1612+0200">14.07.2008 16:12 CEST</abbr>)
<http://www.sample.url/web/address/1234.pdf>
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[S07]</th>
<td class="thesis">
<a name="s07">

Smith,
John

(2007):

Semantic Data Extraction from the World Wide Web.

University of Munich,
Department of Computational Linguistics,
Diss.
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[SVG11]</th>
<td class="standard">
<a name="svg11">
ISO 1234567
(1-2003</edition>):

Scalable Vector Graphics (SVG) 1.1 Specification.

</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[Wik08]</th>
<td class="internet">
<a name="wik08">

Wikipedia, the free encyclopedia,

(2008):

Microformat.

(Version: <abbr class="ctime" title="2008-06-19">19th June 2008</abbr>.
Access: <abbr class="atime" title="20080703T1423+0200">3rd July 2008 14:23 CEST</abbr>)
<<a href="http://en.wikipedia.org/w/index.php?title=Microformat&oldid=220275451" class="url">http://en.wikipedia.org/w/index.php?title=Microformat&oldid=220275451</a>>
</a>
</td>
</tr>
<tr>
<th scope="row" style="font-variant: small-caps; ">[W08]</th>
<td class="specialist">
<a name="w08">

Wang,
Wu

(Professor of Informatics,
Department of Applied Sciences,
University of Michigan)
(<abbr class="ctime" title="20000801T0918+0100D0007">01.08.2000, 9:18–9:25 MEZ</abbr>)
Science News.
Interview.
Michigan Television
</a>
</td>
</tr>
</table>
</nowiki></pre>

== Issues ==
The [[citation-issues]] page is intended to capture ongoing issues.

== To Do ==
* [[existing-classes|Using existing class names]] and creating new names, create property names for the profile
* Based on implicit schemas in [[citation-examples]], and terms from one or more [[citation-formats]], do some [[citation-brainstorming]] for a simple citation microformat.
* Create additional strawman proposals

== Modularity ==
My hope for this microformat is that it can be a sort of module that can be used in other microformats. Once this is developed and flushed out, citation references could easily be used for publications on a Resume/CV, therefore the citation microformat would be a module (subset) of all the possible Resume Values.

Other Microformats that could use the Citation Module
* [[hresume|hResume]]
* [[work-of-art]]

Other Microformats that the Citation Module will use
* [[hcard|hCard]] encodings for things like Author, Publisher (people and companies)
* [[hatom|hAtom]] encodings as a possible container, and author/date-time properties
* [[rel-tag]] encoding for keywords
* [[rel-license]] encoding for copyright

== References ==
=== Informative References ===
* [http://ocoins.info/ COinS]
* [http://xmlresume.sourceforge.net/ XMLResume]: if part of the drive for citations is for publications for a resume/CV then some of this information could be useful
* [http://www.citeulike.org/ CiteUlike] is a free service to help academics to share, store, and organise the academic papers they are reading
* [http://www.connotea.org/ Connotea] is a scientific bookmarking service from Nature.
* [http://www.ariadne.ac.uk/issue43/chudnov/ OpenURL] with Autodiscovery
* [http://cipolo.med.yale.edu/mailman/listinfo/gcs-pcs-list "Gather, Create, Share" and "Personal Collection Systems" memes, and systems implementing either or both]
* [http://www.loc.gov/standards/mods/ Metadata Object Description Schema] developed by the Library of Congress
* [http://www.dublincore.org/documents/dc-citation-guidelines/ Guidelines for Encoding Bibliographic Citation Information in Dublin Core Metadata]
* [http://www.ecst.csuchico.edu/~jacobsd/bib/formats/bibtex.html BibTeX reference] from Dana Jacobsen
* [http://www.refman.com/support/risformat_intro.asp RIS Format Specification] from Thomson ResearchSoft, makers of ReferenceManager
* [http://www.zotero.org/ Zotero] - "Firefox extension to help you collect, manage, and cite your research sources"
*[http://www.doi.org/ DOI] ([http://www.crossref.org/02publishers/guidelines.html CrossRef Guidelines] for use of DOIs in citations)
* [http://info-uri.info/ INFO URI] (URI scheme for representing legacy namespaces)
*[http://www.isbn-international.org/ ISBN] ([http://en.wikipedia.org/wiki/International_Standard_Book_Number ISBN on Wikipedia])
*[http://www.issn.org/ ISSN] ([http://en.wikipedia.org/wiki/International_Standard_Serial_Number ISSN on Wikipedia])
* [http://opcit.eprints.org/ Open Citation Project] - OpCit, a three year (1999-2002)R&D project funded by the Joint NSF - JISC International Digital Libraries Research Programme.
* [http://www.docbook.org/ DocBook] (markup langauige for books); [http://en.wikipedia.org/wiki/Docbook DocBook on Wikipedia]
* [http://www.bl.uk/news/2007/pressrelease20071022.html RDA: Resource Description and Access]

== See Also ==
{{citation-related-pages}}