Microformats
The Calais response format supports three Microformats: rel-tag, hCard and hCalendar. The Microformats output is returned as one stream of text and enables insertion directly into HTML pages without affecting the page layout; that is, adding the Microformats for each entity so that entitites/events can be visually highlighted by Microformats-aware browsers. (This is done by using the <span> tag in the Microformats output.) The returned Microformats are based on the most relevant metadata elements (Entities, Events and Facts) from the Calais Semantic Metadata. The Entities, Events and Facts used for each Microformat type are summarized below.
Please remember to modify the outputFormat and reltagBaseURL input parameters as described here to get proper Microformats output. reltagBaseURL needs to be a valid URL, that rel-tag values will be appended to.
rel-tag
The rel-tag format serves as the tags/keywords/categories for an article they refer to. We selected a subset of the Calais Semantic Metadata that is most suitable for assignment as tags/keywords/categories for a given article. The subset includes Entities, in which case the rel-tag value will be the attribute values for these entities, and Events and Facts, in which case the rel-tag values will be human-readable keywords/categories that indicate the Event type.
The following table summarizes the metadata elements included in the rel-tag Microformats: (Entities are shown before Events and Facts)
| Metadata Element | rel-tag Value |
| Company | value of attribute Company |
| Holiday | value of attribute Holiday |
| NaturalDisaster | value of attribute NaturalDisaster |
| Organization | value of attribute Organization |
| Person | value of attribute Person |
| Technology | value of attribute Technology |
| Acquisition | "M&A" |
| Alliance | "Business Partnership" |
| Bankruptcy | "Bankruptcy" |
| BusinessRelation | "Business Partnership" |
| Buybacks | "Security Buyback" |
| CompanyLegalIssues | "Legal Issues" |
| CompanyReorganization | "Reorganization" |
| IPO | "IPO" |
| JointVenture | "Business Partnership" |
| ManagementChange | "Management Change" |
| Merger | "M&A" |
| StockSplit | "Stock Split" |
hCard
The hCard format is used to represent people, companies/organizations and places. We selected a subset of the Calais Semantic Metadata that is most suitable to represent the relationships between people and companies/organizations and between companies/organizations and places; the output does not include hCard results for each and every Person, Company or Organization identified.
The following table shows the mapping between Calais metadata elements and their attributes to hCard attributes.
| Metadata Element | hCard Atrribute | Attribute of Metadata Element |
| PersonProfessional | fn | value of attribute Person |
| n | value of attribute Person | |
| title | value of attribute Position | |
| org | value of attribute Company or Organization | |
| CompanyLocation | fn | value of attribute Company |
| n | value of attribute Company | |
| adr | locality value of attribute City | |
| adr region | value of attribute ProvinceOrState | |
| adr country-name | value of attribute Country | |
| adr type | "Work" |
hCalendar
The hCalendar format is used to represent calendar events. We selected the two relevant Event types from the Calais Semantic Metadata to output calendar events in the hCalendar format.
The following table shows the mapping between Calais metadata elements and their attributes to hCalendar attributes.
| Metadata Element | hCalendar Atrribute | Attribute of Metadata Element |
| ConferenceCall | dtstart | value of attribute Date |
| summary | values of attributes Company + Quarter+CCallType (appended) | |
| CompanyMeeting | dtstart | value of attribute Date |
| summary | values of attributes Company + CompanyMeetingType (appended) | |
| location | MeetingSite, City, ProvinceOrState, Country (taking only the non-empty values) |
Examples:
Text Input:
2007 Monday August 20, 9:00 am ET
Tensleep Corporation (Other OTC:TENS.PK - News) (""Tensleep"") announced that with the acquisition of XSTV Media, Inc. (""XSTV""),
it will become an online independent sports company. The transaction is
to close on or before September 15, 2007. Tensleep will, by the end of
this week or early next week, call a special meeting of shareholders to
approve the change name to ""XSTV Corporation.""
David Bailey, an analyst at Gerard Klauer Mattison, said such cuts ""could include head count reductions.""
Layoffs
to some degree are inevitable, said IDC analyst Roger Kay. For years,
the company enjoyed a lower cost structure than other PC makers because
it sold computers directly.
International
Star Inc. (OTC BB: ILST) announced that the annual meeting of
shareholders of International Star Inc. will be held on May 19, 2008,
at 3:00 p.m. (local time) at The Hilton Hotel, 104 Market Street,
Shreveport, La., 71101.
Microformats Output:
<!-- Use of the Calais Web Service is governed by the Terms of Service located at http://www.opencalais.com. By using this service or the results of the service you agree to these terms of service. -->
<!--
hCards:David Bailey,Roger Kay,
hcalendars:International Star Inc. (International Star, Inc.) Shareholders' Meeting,
rel-tags: Tensleep Corporation, XSTV Corporation,International Star Inc., Gerard Klauer Mattison,XSTV Media Inc.,David Bailey,Roger Kay,IDC,M&A,-->
<OpenCalaisMicroformats>
<Description>
<allowDistribution>true</allowDistribution>
<allowSearch>true<allowSearch>
<calaisRequestID>37f7b46a-e07f-4b92-94db-5fe82db6cbfa<calaisRequestID>
<externalID></externalID>
<id>http://id.opencalais.com/P1vTISZiXiz*Jq3uz1z5qw</id>
<about>http://d.opencalais.com/dochash-1/93df9843-ef7b-3311-890d-d358094454d8</about>
</Description>
<Microformats>
<cards>
<hcard>
<span class="vcard">
<abbr class="fn" title="David Bailey">David Bailey</abbr>
<abbr class="org"title="Harris Nesbitt Gerard, Inc" />
<abbr class="title"title="analyst " />
</span>
</hcard>
<hcard>
<span class="vcard">
<abbr class="fn" title="Roger Kay">Roger Kay</abbr>
<abbr class="org" title="Investment Development Co" />
<abbr class="title" title="analyst " />
</span>
</hcard>
</cards>
<calendars>
<hcalendar>
<span id="hcalendar-International-Star-Inc.-(International-Star,-Inc.)-Shareholders'-Meeting" class="vevent">
<abbr title="20080519" class="dtstart">May 19, 2008</abbr>
<span class="summary">International Star Inc. (International Star, Inc.) Shareholders' Meeting
<span class="location">The Hilton Hotel, Shreveport,Louisiana,United States</span>
<span class="geo">
<abbr class="latitude" title="32.468056" />
<abbr class="longitude" title="-93.77111" />
</span>
</span>
</hcalendar>
</calendars>
<rel-tags>
<rel-tag>
<a href="/Tensleep%20Corporation" rel="tag">Tensleep Corporation</a>
</rel-tag>
<rel-tag>
<a href="/XSTV%20Corporation" rel="tag">XSTV Corporation</a>
</rel-tag>
<rel-tag>
<a href="/International%20Star%20Inc." rel="tag">International Star Inc.</a>
</rel-tag>
<rel-tag>
<a href="/Gerard%20Klauer%20Mattison" rel="tag">Gerard Klauer Mattison</a>
</rel-tag>
<rel-tag>
<a href="/XSTV%20Media%20Inc." rel="tag">XSTV Media Inc.</a>
</rel-tag>
<rel-tag>
<a href="/David%20Bailey" rel="tag">David Bailey</a>
</rel-tag>
<rel-tag>
<a href="/Roger%20Kay" rel="tag">Roger Kay</a>
</rel-tag>
<rel-tag>
<a href="/IDC" rel="tag">IDC</a>
</rel-tag>
<rel-tag>
<a href="/M&A" rel="tag">M&A</a>
</rel-tag>
</rel-tags>
</Microformats>
</OpenCalaisMicroformats>
Microformats Schema
<!-- Comment -->
<OpenCalaisMicroformats><Microformats>
<Description>
<id></id>
<about></about>
..................
</Description><cards></hcard><hcard><hcard>
<span class="vcard">
<span class="fn"></span>
<span class="org"></span>
<span class="title"> </span>
</span>
</hcard>
.......................................
-- list of hcard
</cards>
<calendars><hcalendar></calendars>
<span id=" " class=" ">
<abbr title="" class="dtstart"> </abbr>
<span class="summary"> </span>
<span class="location"> </span>
</span>
</hcalendar>
<hcalendar>
………………………….
</hcalendar>
--list of hcalendar
<rel-tags><rel-tag></rel-tags>
<a href="" rel="tag"</a>
</rel-tag>
------------list of rel-tag
</Microformats>
</OpenCalaisMicroformats>
