http://microformats.org/wiki/api.php?action=feedcontributions&feedformat=atom&user=AnarchycoMicroformats Wiki - User contributions [en]2026-05-25T16:29:04ZUser contributionsMediaWiki 1.38.4http://microformats.org/wiki/index.php?title=OpenService_Extensions&diff=34167OpenService Extensions2008-05-17T16:28:36Z<p>Anarchyco: </p>
<hr />
<div>To increase the value of web content annotated with microformats (or other semantic web technologies) it is required to define a language that can be used by web applications' developers to describe and publish the services available for different semantic contents (e.g. for a hCard).<br />
<br />
There could be other alternatives, but one of them is to extend Microsoft [http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx Open Service Description] and reusing also some [http://www.opensearch.org Open Search] concepts.<br />
<br />
= Generic OpenService Extensions =<br />
<br />
==mime-type==<br />
<br />
OpenService description documents are referred to via the following type: <br />
<br />
'''application/openservicedescription+xml''' <br />
<br />
This type is pending IANA registration. <br />
<br />
==Automatic Discovery==<br />
<br />
HTML and XHTML documents may reference related OpenService description documents '''via the HTML 4.0 <link/> element'''. <br />
<br />
The following restrictions apply: <br />
* The "type" attribute must contain the value "application/openservicedescription+xml ". <br />
* The "rel" attribute must contain the value "service". <br />
* The "href" attribute must contain a URI that resolves to an OpenService description document. <br />
* The "title" attribute may contain a human-readable plain text string describing the service. <br />
<br />
The HTML <head/> element should include a "profile" attribute that contains the value "http://www.microsoft.com/schemas/openservicedescription/1.0". <br />
Example of an HTML document that includes OpenSearch autodiscovery link elements: <br />
<br />
<pre><br />
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><br />
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"><br />
<head profile="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<!--- ... ---><br />
<link rel="service"<br />
type="application/openservicedescription+xml" <br />
href="http://example.com/service1.xml"<br />
title="Service 1" /><br />
<link rel="service"<br />
type="application/opensearchdescription+xml" <br />
href="http://example.com/service2.xml"<br />
title="Service 2" /><br />
<!--- ... ---><br />
</head><br />
<body><br />
<!--- ... ---><br />
</body><br />
</html><br />
</pre><br />
<br />
The "rel" attribute of the link element should contain the value "service" when referring to OpenService description documents. This relationship value is pending IANA registration. <br />
<br />
== Restricted services ==<br />
<br />
Tag services that should be used only in a concrete domain/url scope. <br />
<br />
It's not intended to be a security mechanism, but a method to describe services that are only useful for a web site, in order to avoid showing useless services when the user is in other web sites, to improve the user experience.<br />
<br />
<pre><br />
<activityAction context="document" domain="wikipedia.org"><br />
<execute method="get" action="http://wikipedia.org/showhistory?url={documentUrl}"><br />
</execute><br />
</activityAction><br />
</pre><br />
<br />
Open issues:<br />
* Should it be a domain or a url?<br />
* Which name to use for this attribute? (domain, scope, url, restrict...)<br />
<br />
= OpenService extension for microformats contexts (a.k.a. Semantic Activities) =<br />
<br />
This specification extends the original [http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx OpenService specification].<br />
<br />
OpenService description includes the concept of context which is used to describe the content this service can be applied to. The possible contexts included in the original OpenService specification are selection, document and link. <br />
This specification extends the possible '''contexts''' to include microformats. The value used for these new contexts must be the standard microformat name as defined in microformats.org (e.g. hCard, hCalendar, tag). To indicate a required parent for the microformat, a dotted notation can be used (e.g. hCard.adr indicates an addr content that must be child of a hCard content)<br />
<br />
Other required extension is new '''variables''' that can be used to compose the url parameters that will be sent to the service. These new variables include the microformats' properties: <br />
* The name of the variables must be the standard property name as defined in microformats.org and prepended by the microformat name to avoid collisions (hCard.fn, hCalendar.location, tag).<br />
* The value of the variable must be the value of the microformat's property. <br />
** If the property is a composed property.... TBD<br />
** If more than one instance of the property are found (plural properties), they must be included separated by commas.<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Videos"><br />
<activityAction context="adr"><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre><br />
<br />
All variables are treated as required unless it the modifier "?". An optional variable that cannot be resolved is treated as an empty string for an inline parameterized URL. In a form-based parameterized URL the entire parameter element is ignored.<br />
<br />
Example of an optional variable in an inline parameterized URL:<br />
<pre><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</pre><br />
<br />
Pending issues:<br />
* Include support for services that require more than one microformat.<br />
* Include support for semantic content other than microformats (RDF, RDFa, eRDF)<br />
* Should every identifier be prepended by a "microformat." prefix to avoid collisions (e.g. microformat.hCard.adr)?<br />
<br />
= OpenService extension to describe Operator User Scripts =<br />
<br />
......<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="tag"><br />
<execute method="script"><br />
<script><br />
<![CDATA[<br />
if (semanticObject.tag) {<br />
return("http://youtube.com/results?search_query=" + encodeURIComponent(semanticObject.tag));<br />
}<br />
]]><br />
</script><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre></div>Anarchycohttp://microformats.org/wiki/index.php?title=OpenService_Extensions&diff=27070OpenService Extensions2008-05-07T11:13:20Z<p>Anarchyco: /* Restricted services */</p>
<hr />
<div>To increase the value of web content annotated with microformats (or other semantic web technologies) it is required to define a language that can be used by web applications to describe and publish their services available for different semantic contents (e.g. for a hCard).<br />
<br />
There could be other alternatives, but one of them is to extend Microsoft [http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx Open Service Description] and reusing also some [http://www.opensearch.org Open Search] concepts.<br />
<br />
= Generic OpenService Extension =<br />
<br />
==mime-type==<br />
<br />
OpenService description documents are referred to via the following type: <br />
<br />
'''application/openservicedescription+xml''' <br />
<br />
This type is pending IANA registration. <br />
<br />
==Automatic Discovery==<br />
<br />
HTML and XHTML documents may reference related OpenService description documents '''via the HTML 4.0 <link/> element'''. <br />
<br />
The following restrictions apply: <br />
* The "type" attribute must contain the value "application/openservicedescription+xml ". <br />
* The "rel" attribute must contain the value "service". <br />
* The "href" attribute must contain a URI that resolves to an OpenService description document. <br />
* The "title" attribute may contain a human-readable plain text string describing the service. <br />
<br />
The HTML <head/> element should include a "profile" attribute that contains the value "http://www.microsoft.com/schemas/openservicedescription/1.0". <br />
Example of an HTML document that includes OpenSearch autodiscovery link elements: <br />
<br />
<pre><br />
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><br />
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"><br />
<head profile="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<!--- ... ---><br />
<link rel="service"<br />
type="application/openservicedescription+xml" <br />
href="http://example.com/service1.xml"<br />
title="Service 1" /><br />
<link rel="service"<br />
type="application/opensearchdescription+xml" <br />
href="http://example.com/service2.xml"<br />
title="Service 2" /><br />
<!--- ... ---><br />
</head><br />
<body><br />
<!--- ... ---><br />
</body><br />
</html><br />
</pre><br />
<br />
The "rel" attribute of the link element should contain the value "service" when referring to OpenService description documents. This relationship value is pending IANA registration. <br />
<br />
== Restricted services ==<br />
<br />
Tag services that should be used only in a concrete domain/url scope. <br />
<br />
It's not intended to be a security mechanism, but a method to describe services that are only useful for a web site, in order to avoid showing useless services when the user is in other web sites, to improve the user experience.<br />
<br />
<pre><br />
<activityAction context="document" domain="wikipedia.org"><br />
<execute method="get" action="http://wikipedia.org/showhistory?url={documentUrl}"><br />
</execute><br />
</activityAction><br />
</pre><br />
<br />
Open issues:<br />
* Should it be a domain or a url?<br />
* Which name to use for this attribute? (domain, scope, url, restrict...)<br />
<br />
= OpenService extension for microformats contexts (a.k.a. microservices) =<br />
<br />
This specification extends the original [http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx OpenService specification].<br />
<br />
OpenService description includes the concept of context which is used to describe the content this service can be applied to. The possible contexts included in the original OpenService specification are selection, document and link. <br />
This specification extends the possible '''contexts''' to include microformats. The value used must be the standard microformat name as defined in microformats.org (e.g. hCard, hCalendar, tag). To indicate a required parent for the microformat a dotted notation can be used (e.g. hCard.adr indicates an addr content that must be child of a hCard content)<br />
<br />
Other required extension is new '''variables''' that can be used to compose the url parameters that will be sent to the service. These new variables include the microformats' properties: <br />
* The name of the variables must be the standard property name as defined in microformats.org and prepended by the microformat name to avoid collisions (hCard.fn, hCalendar.location, tag).<br />
* The value of the variable must be the value of the microformat's property. <br />
** If the property is a composed property.... TBD<br />
** If more than one instance of the property are found (plural properties), they must be included separated by commas.<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Videos"><br />
<activityAction context="adr"><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre><br />
<br />
All variables are treated as required unless it the modifier "?". An optional variable that cannot be resolved is treated as an empty string for an inline parameterized URL. In a form-based parameterized URL the entire parameter element is ignored.<br />
<br />
Example of an optional variable in an inline parameterized URL:<br />
<pre><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</pre><br />
<br />
Pending issues:<br />
* Include support for services that require more than one microformat.<br />
* Include support for semantic content other than microformats (RDF, RDFa, eRDF)<br />
* Should every identifier be prepended by a "microformat." prefix to avoid collisions (e.g. microformat.hCard.adr)?<br />
<br />
= OpenService extension to describe Operator User Scripts =<br />
<br />
......<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="tag"><br />
<execute method="script"><br />
<script><br />
<![CDATA[<br />
if (semanticObject.tag) {<br />
return("http://youtube.com/results?search_query=" + encodeURIComponent(semanticObject.tag));<br />
}<br />
]]><br />
</script><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre></div>Anarchycohttp://microformats.org/wiki/index.php?title=OpenService_Extensions&diff=26951OpenService Extensions2008-05-07T11:11:50Z<p>Anarchyco: </p>
<hr />
<div>To increase the value of web content annotated with microformats (or other semantic web technologies) it is required to define a language that can be used by web applications to describe and publish their services available for different semantic contents (e.g. for a hCard).<br />
<br />
There could be other alternatives, but one of them is to extend Microsoft [http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx Open Service Description] and reusing also some [http://www.opensearch.org Open Search] concepts.<br />
<br />
= Generic OpenService Extension =<br />
<br />
==mime-type==<br />
<br />
OpenService description documents are referred to via the following type: <br />
<br />
'''application/openservicedescription+xml''' <br />
<br />
This type is pending IANA registration. <br />
<br />
==Automatic Discovery==<br />
<br />
HTML and XHTML documents may reference related OpenService description documents '''via the HTML 4.0 <link/> element'''. <br />
<br />
The following restrictions apply: <br />
* The "type" attribute must contain the value "application/openservicedescription+xml ". <br />
* The "rel" attribute must contain the value "service". <br />
* The "href" attribute must contain a URI that resolves to an OpenService description document. <br />
* The "title" attribute may contain a human-readable plain text string describing the service. <br />
<br />
The HTML <head/> element should include a "profile" attribute that contains the value "http://www.microsoft.com/schemas/openservicedescription/1.0". <br />
Example of an HTML document that includes OpenSearch autodiscovery link elements: <br />
<br />
<pre><br />
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><br />
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"><br />
<head profile="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<!--- ... ---><br />
<link rel="service"<br />
type="application/openservicedescription+xml" <br />
href="http://example.com/service1.xml"<br />
title="Service 1" /><br />
<link rel="service"<br />
type="application/opensearchdescription+xml" <br />
href="http://example.com/service2.xml"<br />
title="Service 2" /><br />
<!--- ... ---><br />
</head><br />
<body><br />
<!--- ... ---><br />
</body><br />
</html><br />
</pre><br />
<br />
The "rel" attribute of the link element should contain the value "service" when referring to OpenService description documents. This relationship value is pending IANA registration. <br />
<br />
== Restricted services ==<br />
<br />
Tag services that should be used only in a concrete domain/url scope. <br />
<br />
It's not intended to be a security mechanism, but a method to describe services that are only useful for a web site, in order to avoid showing useless services when the user is in other web sites, to improve the user experience.<br />
<br />
<pre><br />
<activityAction context="document" domain="wikipedia.org"><br />
<execute method="get" action="http://wikipedia.org/showhistory?url={documentUrl}"><br />
</execute><br />
</activityAction><br />
</pre><br />
<br />
= OpenService extension for microformats contexts (a.k.a. microservices) =<br />
<br />
This specification extends the original [http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx OpenService specification].<br />
<br />
OpenService description includes the concept of context which is used to describe the content this service can be applied to. The possible contexts included in the original OpenService specification are selection, document and link. <br />
This specification extends the possible '''contexts''' to include microformats. The value used must be the standard microformat name as defined in microformats.org (e.g. hCard, hCalendar, tag). To indicate a required parent for the microformat a dotted notation can be used (e.g. hCard.adr indicates an addr content that must be child of a hCard content)<br />
<br />
Other required extension is new '''variables''' that can be used to compose the url parameters that will be sent to the service. These new variables include the microformats' properties: <br />
* The name of the variables must be the standard property name as defined in microformats.org and prepended by the microformat name to avoid collisions (hCard.fn, hCalendar.location, tag).<br />
* The value of the variable must be the value of the microformat's property. <br />
** If the property is a composed property.... TBD<br />
** If more than one instance of the property are found (plural properties), they must be included separated by commas.<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Videos"><br />
<activityAction context="adr"><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre><br />
<br />
All variables are treated as required unless it the modifier "?". An optional variable that cannot be resolved is treated as an empty string for an inline parameterized URL. In a form-based parameterized URL the entire parameter element is ignored.<br />
<br />
Example of an optional variable in an inline parameterized URL:<br />
<pre><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</pre><br />
<br />
Pending issues:<br />
* Include support for services that require more than one microformat.<br />
* Include support for semantic content other than microformats (RDF, RDFa, eRDF)<br />
* Should every identifier be prepended by a "microformat." prefix to avoid collisions (e.g. microformat.hCard.adr)?<br />
<br />
= OpenService extension to describe Operator User Scripts =<br />
<br />
......<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="tag"><br />
<execute method="script"><br />
<script><br />
<![CDATA[<br />
if (semanticObject.tag) {<br />
return("http://youtube.com/results?search_query=" + encodeURIComponent(semanticObject.tag));<br />
}<br />
]]><br />
</script><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre></div>Anarchycohttp://microformats.org/wiki/index.php?title=OpenService_Extensions&diff=26950OpenService Extensions2008-04-29T10:54:31Z<p>Anarchyco: </p>
<hr />
<div>To increase the value of web content annotated with microformats (or other semantic web technologies) it is required to define a language that can be used by web applications to describe and publish their services available for different semantic contents (e.g. for a hCard).<br />
<br />
There could be other alternatives, but one of them is to extend Microsoft [http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx Open Service Description] and reusing also some [http://www.opensearch.org Open Search] concepts.<br />
<br />
= Generic OpenService Extension =<br />
<br />
==mime-type==<br />
<br />
OpenService description documents are referred to via the following type: <br />
<br />
'''application/openservicedescription+xml''' <br />
<br />
This type is pending IANA registration. <br />
<br />
==Automatic Discovery==<br />
<br />
HTML and XHTML documents may reference related OpenService description documents '''via the HTML 4.0 <link/> element'''. <br />
<br />
The following restrictions apply: <br />
* The "type" attribute must contain the value "application/openservicedescription+xml ". <br />
* The "rel" attribute must contain the value "service". <br />
* The "href" attribute must contain a URI that resolves to an OpenService description document. <br />
* The "title" attribute may contain a human-readable plain text string describing the service. <br />
<br />
The HTML <head/> element should include a "profile" attribute that contains the value "http://www.microsoft.com/schemas/openservicedescription/1.0". <br />
Example of an HTML document that includes OpenSearch autodiscovery link elements: <br />
<br />
<pre><br />
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><br />
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"><br />
<head profile="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<!--- ... ---><br />
<link rel="service"<br />
type="application/openservicedescription+xml" <br />
href="http://example.com/service1.xml"<br />
title="Service 1" /><br />
<link rel="service"<br />
type="application/opensearchdescription+xml" <br />
href="http://example.com/service2.xml"<br />
title="Service 2" /><br />
<!--- ... ---><br />
</head><br />
<body><br />
<!--- ... ---><br />
</body><br />
</html><br />
</pre><br />
<br />
The "rel" attribute of the link element should contain the value "service" when referring to OpenService description documents. This relationship value is pending IANA registration. <br />
<br />
= OpenService extension for microformats contexts (a.k.a. microservices) =<br />
<br />
This specification extends the original [http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx OpenService specification].<br />
<br />
OpenService description includes the concept of context which is used to describe the content this service can be applied to. The possible contexts included in the original OpenService specification are selection, document and link. <br />
This specification extends the possible '''contexts''' to include microformats. The value used must be the standard microformat name as defined in microformats.org (e.g. hCard, hCalendar, tag). To indicate a required parent for the microformat a dotted notation can be used (e.g. hCard.adr indicates an addr content that must be child of a hCard content)<br />
<br />
Other required extension is new '''variables''' that can be used to compose the url parameters that will be sent to the service. These new variables include the microformats' properties: <br />
* The name of the variables must be the standard property name as defined in microformats.org and prepended by the microformat name to avoid collisions (hCard.fn, hCalendar.location, tag).<br />
* The value of the variable must be the value of the microformat's property. <br />
** If the property is a composed property.... TBD<br />
** If more than one instance of the property are found (plural properties), they must be included separated by commas.<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Videos"><br />
<activityAction context="adr"><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre><br />
<br />
All variables are treated as required unless it the modifier "?". An optional variable that cannot be resolved is treated as an empty string for an inline parameterized URL. In a form-based parameterized URL the entire parameter element is ignored.<br />
<br />
Example of an optional variable in an inline parameterized URL:<br />
<pre><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</pre><br />
<br />
Pending issues:<br />
* Include support for services that require more than one microformat.<br />
* Include support for semantic content other than microformats (RDF, RDFa, eRDF)<br />
* Should every identifier be prepended by a "microformat." prefix to avoid collisions (e.g. microformat.hCard.adr)?<br />
<br />
= OpenService extension to describe Operator User Scripts =<br />
<br />
......<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="tag"><br />
<execute method="script"><br />
<script><br />
<![CDATA[<br />
if (semanticObject.tag) {<br />
return("http://youtube.com/results?search_query=" + encodeURIComponent(semanticObject.tag));<br />
}<br />
]]><br />
</script><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre></div>Anarchycohttp://microformats.org/wiki/index.php?title=OpenService_Extensions&diff=26874OpenService Extensions2008-04-28T22:35:58Z<p>Anarchyco: /* OpenService extension for microformats contexts (a.k.a. microservices) */</p>
<hr />
<div>To increase the value of web content annotated with microformats (or other semantic web technologies) it is required to define a language that can be used by web applications to describe and publish their services available for different semantic contents (e.g. for a hCard).<br />
<br />
There could be other alternatives, but one of them is to extend Microsoft [http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx Open Service Description] and reusing also some [http://www.opensearch.org Open Search] concepts.<br />
<br />
= Generic OpenService Extension =<br />
<br />
==mime-type==<br />
<br />
OpenService description documents are referred to via the following type: <br />
<br />
application/openservicedescription+xml <br />
<br />
This type is pending IANA registration. <br />
<br />
==Automatic Discovery==<br />
<br />
HTML and XHTML documents may reference related OpenService description documents via the HTML 4.0 <link/> element. <br />
<br />
The following restrictions apply: <br />
* The "type" attribute must contain the value "application/openservicedescription+xml ". <br />
* The "rel" attribute must contain the value "service". <br />
* The "href" attribute must contain a URI that resolves to an OpenService description document. <br />
* The "title" attribute may contain a human-readable plain text string describing the service. <br />
<br />
The HTML <head/> element should include a "profile" attribute that contains the value "http://www.microsoft.com/schemas/openservicedescription/1.0". <br />
Example of an HTML document that includes OpenSearch autodiscovery link elements: <br />
<br />
<pre><br />
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><br />
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"><br />
<head profile="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<!--- ... ---><br />
<link rel="service"<br />
type="application/openservicedescription+xml" <br />
href="http://example.com/service1.xml"<br />
title="Service 1" /><br />
<link rel="service"<br />
type="application/opensearchdescription+xml" <br />
href="http://example.com/service2.xml"<br />
title="Service 2" /><br />
<!--- ... ---><br />
</head><br />
<body><br />
<!--- ... ---><br />
</body><br />
</html><br />
</pre><br />
<br />
The "rel" attribute of the link element should contain the value "service" when referring to OpenService description documents. This relationship value is pending IANA registration. <br />
<br />
= OpenService extension for microformats contexts (a.k.a. microservices) =<br />
<br />
This specification extends the original [http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx OpenService specification].<br />
<br />
OpenService description includes the concept of context which is used to describe the content this service can be applied to. The possible contexts included in the original OpenService specification are selection, document and link. <br />
This specification extends the possible '''contexts''' to include microformats. The value used must be the standard microformat name as defined in microformats.org (e.g. hCard, hCalendar, tag). To indicate a required parent for the microformat a dotted notation can be used (e.g. hCard.adr indicates an addr content that must be child of a hCard content)<br />
<br />
Other required extension is new '''variables''' that can be used to compose the url parameters that will be sent to the service. These new variables include the microformats' properties: <br />
* The name of the variables must be the standard property name as defined in microformats.org and prepended by the microformat name to avoid collisions (hCard.fn, hCalendar.location, tag).<br />
* The value of the variable must be the value of the microformat's property. <br />
** If the property is a composed property.... TBD<br />
** If more than one instance of the property is found (plural properties), they must be included separated by commas.<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="adr"><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre><br />
<br />
All variables are treated as required unless it the modifier "?". An optional variable that cannot be resolved is treated as an empty string for an inline parameterized URL. In a form-based parameterized URL the entire parameter element is ignored.<br />
<br />
Example of an optional variable in an inline parameterized URL:<br />
<pre><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</pre><br />
<br />
Pending issues:<br />
* Include support for services that require more than one microformat.<br />
* Include support for semantic content other than microformats (RDF, RDFa, eRDF)<br />
* Should every identifier be prepended by a "microformat" prefix to avoid collisions (e.g. microformat.hCard.adr)?<br />
<br />
= OpenService extension to describe Operator User Scripts =<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="tag"><br />
<execute method="script"><br />
<script><br />
<![CDATA[<br />
if (semanticObject.tag) {<br />
return("http://youtube.com/results?search_query=" + encodeURIComponent(semanticObject.tag));<br />
}<br />
]]><br />
</script><br />
</execute><br />
</activityAction><br />
</activity><br />
<br />
</openServiceDescription><br />
</pre></div>Anarchycohttp://microformats.org/wiki/index.php?title=OpenService_Extensions&diff=26873OpenService Extensions2008-04-28T22:26:47Z<p>Anarchyco: </p>
<hr />
<div>To increase the value of web content annotated with microformats (or other semantic web technologies) it is required to define a language that can be used by web applications to describe and publish their services available for different semantic contents (e.g. for a hCard).<br />
<br />
There could be other alternatives, but one of them is to extend Microsoft [http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx Open Service Description] and reusing also some [http://www.opensearch.org Open Search] concepts.<br />
<br />
= Generic OpenService Extension =<br />
<br />
==mime-type==<br />
<br />
OpenService description documents are referred to via the following type: <br />
<br />
application/openservicedescription+xml <br />
<br />
This type is pending IANA registration. <br />
<br />
==Automatic Discovery==<br />
<br />
HTML and XHTML documents may reference related OpenService description documents via the HTML 4.0 <link/> element. <br />
<br />
The following restrictions apply: <br />
* The "type" attribute must contain the value "application/openservicedescription+xml ". <br />
* The "rel" attribute must contain the value "service". <br />
* The "href" attribute must contain a URI that resolves to an OpenService description document. <br />
* The "title" attribute may contain a human-readable plain text string describing the service. <br />
<br />
The HTML <head/> element should include a "profile" attribute that contains the value "http://www.microsoft.com/schemas/openservicedescription/1.0". <br />
Example of an HTML document that includes OpenSearch autodiscovery link elements: <br />
<br />
<pre><br />
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><br />
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"><br />
<head profile="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<!--- ... ---><br />
<link rel="service"<br />
type="application/openservicedescription+xml" <br />
href="http://example.com/service1.xml"<br />
title="Service 1" /><br />
<link rel="service"<br />
type="application/opensearchdescription+xml" <br />
href="http://example.com/service2.xml"<br />
title="Service 2" /><br />
<!--- ... ---><br />
</head><br />
<body><br />
<!--- ... ---><br />
</body><br />
</html><br />
</pre><br />
<br />
The "rel" attribute of the link element should contain the value "service" when referring to OpenService description documents. This relationship value is pending IANA registration. <br />
<br />
= OpenService extension for microformats contexts (a.k.a. microservices) =<br />
<br />
This specification extends the original [http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx OpenService specification].<br />
<br />
OpenService description includes the concept of context which is used to describe the content this service can be applied to. The possible contexts included in the original OpenService specification are selection, document and link. <br />
This specification extends the possible '''contexts''' to include microformats. The value used must be the standard microformat name as defined in microformats.org (e.g. hCard, hCalendar, tag). To indicate a required parent for the microformat a dotted notation can be used (e.g. hCard.adr indicates an addr content that must be child of a hCard content)<br />
<br />
Other required extension is new '''variables''' that can be used to compose the url parameters that will be sent to the service. These new variables include the microformats' properties: <br />
* The name of the variables must be the standard property name as defined in microformats.org and prepended by the microformat name to avoid collisions (hCard.fn, hCalendar.location, tag).<br />
* The value of the variable must be the value of the microformat's property. <br />
** If the property is a composed property.... TBD<br />
** If more than one instance of the property is found (plural properties), they must be included separated by commas.<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="adr"><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre><br />
<br />
All variables are treated as required unless it the modifier "?". An optional variable that cannot be resolved is treated as an empty string for an inline parameterized URL. In a form-based parameterized URL the entire parameter element is ignored.<br />
<br />
Example of an optional variable in an inline parameterized URL:<br />
<pre><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</pre><br />
<br />
Pending issues:<br />
* Include support for services that require more than one microformat.<br />
* Include support for semantic content other than microformats (RDF, RDFa, eRDF)<br />
* Should be very identifier prepended by a "microformat" prefix to avoid collisions (e.g. microformat.hCard.adr)?<br />
<br />
= OpenService extension to describe Operator User Scripts =<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="tag"><br />
<execute method="script"><br />
<script><br />
<![CDATA[<br />
if (semanticObject.tag) {<br />
return("http://youtube.com/results?search_query=" + encodeURIComponent(semanticObject.tag));<br />
}<br />
]]><br />
</script><br />
</execute><br />
</activityAction><br />
</activity><br />
<br />
</openServiceDescription><br />
</pre></div>Anarchycohttp://microformats.org/wiki/index.php?title=OpenService_Extensions&diff=26872OpenService Extensions2008-04-28T22:26:00Z<p>Anarchyco: </p>
<hr />
<div>To increase the value of web content annotated with microformats (or other semantic web technologies) it is required to define a language that can be used by web applications to describe and publish their services available for different semantic contents (e.g. for a hCard).<br />
<br />
There could be other alternatives, but one of them is to extend Microsoft [[http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx Open Service Description]] and reusing also some [[http://www.opensearch.org Open Search]] concepts.<br />
<br />
= Generic OpenService Extension =<br />
<br />
==mime-type==<br />
<br />
OpenService description documents are referred to via the following type: <br />
<br />
application/openservicedescription+xml <br />
<br />
This type is pending IANA registration. <br />
<br />
==Automatic Discovery==<br />
<br />
HTML and XHTML documents may reference related OpenService description documents via the HTML 4.0 <link/> element. <br />
<br />
The following restrictions apply: <br />
* The "type" attribute must contain the value "application/openservicedescription+xml ". <br />
* The "rel" attribute must contain the value "service". <br />
* The "href" attribute must contain a URI that resolves to an OpenService description document. <br />
* The "title" attribute may contain a human-readable plain text string describing the service. <br />
<br />
The HTML <head/> element should include a "profile" attribute that contains the value "http://www.microsoft.com/schemas/openservicedescription/1.0". <br />
Example of an HTML document that includes OpenSearch autodiscovery link elements: <br />
<br />
<pre><br />
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><br />
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"><br />
<head profile="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<!--- ... ---><br />
<link rel="service"<br />
type="application/openservicedescription+xml" <br />
href="http://example.com/service1.xml"<br />
title="Service 1" /><br />
<link rel="service"<br />
type="application/opensearchdescription+xml" <br />
href="http://example.com/service2.xml"<br />
title="Service 2" /><br />
<!--- ... ---><br />
</head><br />
<body><br />
<!--- ... ---><br />
</body><br />
</html><br />
</pre><br />
<br />
The "rel" attribute of the link element should contain the value "service" when referring to OpenService description documents. This relationship value is pending IANA registration. <br />
<br />
= OpenService extension for microformats contexts (a.k.a. microservices) =<br />
<br />
This specification extends the original [[http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx OpenService specification]].<br />
<br />
OpenService description includes the concept of context which is used to describe the content this service can be applied to. The possible contexts included in the original OpenService specification are selection, document and link. <br />
This specification extends the possible '''contexts''' to include microformats. The value used must be the standard microformat name as defined in microformats.org (e.g. hCard, hCalendar, tag). To indicate a required parent for the microformat a dotted notation can be used (e.g. hCard.adr indicates an addr content that must be child of a hCard content)<br />
<br />
Other required extension is new '''variables''' that can be used to compose the url parameters that will be sent to the service. These new variables include the microformats' properties: <br />
* The name of the variables must be the standard property name as defined in microformats.org and prepended by the microformat name to avoid collisions (hCard.fn, hCalendar.location, tag).<br />
* The value of the variable must be the value of the microformat's property. <br />
** If the property is a composed property.... TBD<br />
** If more than one instance of the property is found (plural properties), they must be included separated by commas.<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="adr"><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre><br />
<br />
All variables are treated as required unless it the modifier "?". An optional variable that cannot be resolved is treated as an empty string for an inline parameterized URL. In a form-based parameterized URL the entire parameter element is ignored.<br />
<br />
Example of an optional variable in an inline parameterized URL:<br />
<pre><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</pre><br />
<br />
Pending issues:<br />
* Include support for services that require more than one microformat.<br />
* Include support for semantic content other than microformats (RDF, RDFa, eRDF)<br />
* Should be very identifier prepended by a "microformat" prefix to avoid collisions (e.g. microformat.hCard.adr)?<br />
<br />
= OpenService extension to describe Operator User Scripts =<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="tag"><br />
<execute method="script"><br />
<script><br />
<![CDATA[<br />
if (semanticObject.tag) {<br />
return("http://youtube.com/results?search_query=" + encodeURIComponent(semanticObject.tag));<br />
}<br />
]]><br />
</script><br />
</execute><br />
</activityAction><br />
</activity><br />
<br />
</openServiceDescription><br />
</pre></div>Anarchycohttp://microformats.org/wiki/index.php?title=OpenService_Extensions&diff=26871OpenService Extensions2008-04-28T22:18:22Z<p>Anarchyco: /* OpenService extension for microformats contexts (a.k.a. microservices) */</p>
<hr />
<div>To increase the value of web content annotated with microformats (or other semantic web technologies) it is required to define a language that can be used by web applications to describe and publish their services available for different semantic contents (e.g. for a hCard).<br />
<br />
There could be other alternatives, but one of them is to extend Microsoft [[http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx|Open Service Description]] and reusing also some [[http://www.opensearch.org|Open Search]] concepts.<br />
<br />
= Generic OpenService Extension =<br />
<br />
==mime-type==<br />
<br />
OpenService description documents are referred to via the following type: <br />
<br />
application/openservicedescription+xml <br />
<br />
This type is pending IANA registration. <br />
<br />
==Automatic Discovery==<br />
<br />
HTML and XHTML documents may reference related OpenService description documents via the HTML 4.0 <link/> element. <br />
<br />
The following restrictions apply: <br />
* The "type" attribute must contain the value "application/openservicedescription+xml ". <br />
* The "rel" attribute must contain the value "service". <br />
* The "href" attribute must contain a URI that resolves to an OpenService description document. <br />
* The "title" attribute may contain a human-readable plain text string describing the service. <br />
<br />
The HTML <head/> element should include a "profile" attribute that contains the value "http://www.microsoft.com/schemas/openservicedescription/1.0". <br />
Example of an HTML document that includes OpenSearch autodiscovery link elements: <br />
<br />
<pre><br />
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><br />
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"><br />
<head profile="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<!--- ... ---><br />
<link rel="service"<br />
type="application/openservicedescription+xml" <br />
href="http://example.com/service1.xml"<br />
title="Service 1" /><br />
<link rel="service"<br />
type="application/opensearchdescription+xml" <br />
href="http://example.com/service2.xml"<br />
title="Service 2" /><br />
<!--- ... ---><br />
</head><br />
<body><br />
<!--- ... ---><br />
</body><br />
</html><br />
</pre><br />
<br />
The "rel" attribute of the link element should contain the value "service" when referring to OpenService description documents. This relationship value is pending IANA registration. <br />
<br />
= OpenService extension for microformats contexts (a.k.a. microservices) =<br />
<br />
This specification extends the original [[http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx | OpenService specification]].<br />
<br />
OpenService description includes the concept of context which is used to describe the content this service can be applied to. The possible contexts included in the original OpenService specification are selection, document and link. This specification extends that values to include microformats as posible '''contexts'''. The value used must be the standard microformat name as defined in microformats.org (e.g. hCard, hCalendar, tag). To indicate a required parent for the microformat a dotted notation can be used (e.g. hCard.addr)<br />
<br />
The other extension required is new '''variables''' that can be used to compose the url parameters that will be sent to the service. These new variables include the microformats' properties. <br />
* The name of the variables must be the standard property name as defined in microformats.org and prepended by the microformat name to avoid collisions (hCard.fn, hCalendar.location, tag).<br />
* The value of the variable must be the value of the microformat's property. <br />
** If the property is a composed property.... TBD<br />
** If more than one instance of the properties is found (plural properties), they must be included separated by commas.<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="adr"><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre><br />
<br />
All variables are treated as required unless it the modifier "?". An optional variable that cannot be resolved is treated as an empty string for an inline parameterized URL. In a form-based parameterized URL the entire parameter element is ignored.<br />
<br />
Example of an optional variable in an inline parameterized URL:<br />
<pre><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</pre><br />
<br />
Pending issues:<br />
* Include support for services that require more than one microformat.<br />
* Include support for semantic content other than microformats (RDF, RDFa, eRDF)<br />
<br />
= OpenService extension to describe Operator User Scripts =<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="tag"><br />
<execute method="script"><br />
<script><br />
<![CDATA[<br />
if (semanticObject.tag) {<br />
return("http://youtube.com/results?search_query=" + encodeURIComponent(semanticObject.tag));<br />
}<br />
]]><br />
</script><br />
</execute><br />
</activityAction><br />
</activity><br />
<br />
</openServiceDescription><br />
</pre></div>Anarchycohttp://microformats.org/wiki/index.php?title=OpenService_Extensions&diff=26870OpenService Extensions2008-04-28T22:17:14Z<p>Anarchyco: /* Automatic Discovery */</p>
<hr />
<div>To increase the value of web content annotated with microformats (or other semantic web technologies) it is required to define a language that can be used by web applications to describe and publish their services available for different semantic contents (e.g. for a hCard).<br />
<br />
There could be other alternatives, but one of them is to extend Microsoft [[http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx|Open Service Description]] and reusing also some [[http://www.opensearch.org|Open Search]] concepts.<br />
<br />
= Generic OpenService Extension =<br />
<br />
==mime-type==<br />
<br />
OpenService description documents are referred to via the following type: <br />
<br />
application/openservicedescription+xml <br />
<br />
This type is pending IANA registration. <br />
<br />
==Automatic Discovery==<br />
<br />
HTML and XHTML documents may reference related OpenService description documents via the HTML 4.0 <link/> element. <br />
<br />
The following restrictions apply: <br />
* The "type" attribute must contain the value "application/openservicedescription+xml ". <br />
* The "rel" attribute must contain the value "service". <br />
* The "href" attribute must contain a URI that resolves to an OpenService description document. <br />
* The "title" attribute may contain a human-readable plain text string describing the service. <br />
<br />
The HTML <head/> element should include a "profile" attribute that contains the value "http://www.microsoft.com/schemas/openservicedescription/1.0". <br />
Example of an HTML document that includes OpenSearch autodiscovery link elements: <br />
<br />
<pre><br />
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><br />
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"><br />
<head profile="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<!--- ... ---><br />
<link rel="service"<br />
type="application/openservicedescription+xml" <br />
href="http://example.com/service1.xml"<br />
title="Service 1" /><br />
<link rel="service"<br />
type="application/opensearchdescription+xml" <br />
href="http://example.com/service2.xml"<br />
title="Service 2" /><br />
<!--- ... ---><br />
</head><br />
<body><br />
<!--- ... ---><br />
</body><br />
</html><br />
</pre><br />
<br />
The "rel" attribute of the link element should contain the value "service" when referring to OpenService description documents. This relationship value is pending IANA registration. <br />
<br />
= OpenService extension for microformats contexts (a.k.a. microservices) =<br />
<br />
This specification extends the original [[http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx|OpenService specification]].<br />
<br />
OpenService description includes the concept of context which is used to describe the content this service can be applied to. The possible contexts included in the original OpenService specification are selection, document and link. This specification extends that values to include microformats as posible '''contexts'''. The value used must be the standard microformat name as defined in microformats.org (e.g. hCard, hCalendar, tag). To indicate a required parent for the microformat a dotted notation can be used (e.g. hCard.addr)<br />
<br />
The other extension required is new '''variables''' that can be used to compose the url parameters that will be sent to the service. These new variables include the microformats' properties. <br />
* The name of the variables must be the standard property name as defined in microformats.org and prepended by the microformat name to avoid collisions (hCard.fn, hCalendar.location, tag).<br />
* The value of the variable must be the value of the microformat's property. <br />
** If the property is a composed property.... TBD<br />
** If more than one instance of the properties is found (plural properties), they must be included separated by commas.<br />
<br />
The variables can be<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="adr"><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre><br />
<br />
All variables are treated as required unless it the modifier "?". An optional variable that cannot be resolved is treated as an empty string for an inline parameterized URL. In a form-based parameterized URL the entire parameter element is ignored.<br />
<br />
Example of an optional variable in an inline parameterized URL:<br />
<pre><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</pre><br />
<br />
Pending issues:<br />
* Include support for services that require more than one microformat.<br />
* Include support for semantic content other than microformats (RDF, RDFa, eRDF)<br />
<br />
= OpenService extension to describe Operator User Scripts =<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="tag"><br />
<execute method="script"><br />
<script><br />
<![CDATA[<br />
if (semanticObject.tag) {<br />
return("http://youtube.com/results?search_query=" + encodeURIComponent(semanticObject.tag));<br />
}<br />
]]><br />
</script><br />
</execute><br />
</activityAction><br />
</activity><br />
<br />
</openServiceDescription><br />
</pre></div>Anarchycohttp://microformats.org/wiki/index.php?title=OpenService_Extensions&diff=26869OpenService Extensions2008-04-28T22:16:39Z<p>Anarchyco: </p>
<hr />
<div>To increase the value of web content annotated with microformats (or other semantic web technologies) it is required to define a language that can be used by web applications to describe and publish their services available for different semantic contents (e.g. for a hCard).<br />
<br />
There could be other alternatives, but one of them is to extend Microsoft [[http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx|Open Service Description]] and reusing also some [[http://www.opensearch.org|Open Search]] concepts.<br />
<br />
= Generic OpenService Extension =<br />
<br />
==mime-type==<br />
<br />
OpenService description documents are referred to via the following type: <br />
<br />
application/openservicedescription+xml <br />
<br />
This type is pending IANA registration. <br />
<br />
==Automatic Discovery==<br />
<br />
HTML and XHTML documents may reference related OpenService description documents via the HTML 4.0 <link/> element. <br />
<br />
The following restrictions apply: <br />
* The "type" attribute must contain the value "application/openservicedescription+xml ". <br />
* The "rel" attribute must contain the value "service". <br />
* The "href" attribute must contain a URI that resolves to an OpenService description document. <br />
* The "title" attribute may contain a human-readable plain text string describing the service. <br />
<br />
The HTML <head/> element should include a "profile" attribute that contains the value "http://www.microsoft.com/schemas/openservicedescription/1.0". <br />
Example of an HTML document that includes OpenSearch autodiscovery link elements: <br />
<br />
<pre><br />
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><br />
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"><br />
<head profile="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<!--- ... ---><br />
<link rel="service"<br />
type="application/openservicedescription+xml" <br />
href="http://example.com/service1.xml"<br />
title="Service 1" /><br />
<link rel="service"<br />
type="application/opensearchdescription+xml" <br />
href="http://example.com/service2.xml"<br />
title="Service 2" /><br />
<!--- ... ---><br />
</head><br />
<body><br />
<!--- ... ---><br />
</body><br />
</html><br />
<pre><br />
<br />
The "rel" attribute of the link element should contain the value "service" when referring to OpenService description documents. This relationship value is pending IANA registration. <br />
<br />
= OpenService extension for microformats contexts (a.k.a. microservices) =<br />
<br />
This specification extends the original [[http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx|OpenService specification]].<br />
<br />
OpenService description includes the concept of context which is used to describe the content this service can be applied to. The possible contexts included in the original OpenService specification are selection, document and link. This specification extends that values to include microformats as posible '''contexts'''. The value used must be the standard microformat name as defined in microformats.org (e.g. hCard, hCalendar, tag). To indicate a required parent for the microformat a dotted notation can be used (e.g. hCard.addr)<br />
<br />
The other extension required is new '''variables''' that can be used to compose the url parameters that will be sent to the service. These new variables include the microformats' properties. <br />
* The name of the variables must be the standard property name as defined in microformats.org and prepended by the microformat name to avoid collisions (hCard.fn, hCalendar.location, tag).<br />
* The value of the variable must be the value of the microformat's property. <br />
** If the property is a composed property.... TBD<br />
** If more than one instance of the properties is found (plural properties), they must be included separated by commas.<br />
<br />
The variables can be<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="adr"><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre><br />
<br />
All variables are treated as required unless it the modifier "?". An optional variable that cannot be resolved is treated as an empty string for an inline parameterized URL. In a form-based parameterized URL the entire parameter element is ignored.<br />
<br />
Example of an optional variable in an inline parameterized URL:<br />
<pre><br />
<execute method="get" action="http://youtube.com/results?search_query={adr.street-address}"><br />
</pre><br />
<br />
Pending issues:<br />
* Include support for services that require more than one microformat.<br />
* Include support for semantic content other than microformats (RDF, RDFa, eRDF)<br />
<br />
= OpenService extension to describe Operator User Scripts =<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="tag"><br />
<execute method="script"><br />
<script><br />
<![CDATA[<br />
if (semanticObject.tag) {<br />
return("http://youtube.com/results?search_query=" + encodeURIComponent(semanticObject.tag));<br />
}<br />
]]><br />
</script><br />
</execute><br />
</activityAction><br />
</activity><br />
<br />
</openServiceDescription><br />
</pre></div>Anarchycohttp://microformats.org/wiki/index.php?title=OpenService_Extensions&diff=26868OpenService Extensions2008-04-28T21:53:38Z<p>Anarchyco: </p>
<hr />
<div>To increase the value of web content annotated with microformats (or other semantic web technologies) it is required to define a language that can be used by web applications to describe and publish their services available for different semantic contents (e.g. for a hCard).<br />
<br />
There could be other alternatives, but one of them is to extend Microsoft [[http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx|Open Service Description]] and reusing also some [[http://www.opensearch.org|Open Search]] concepts.<br />
<br />
= Generic OpenService Extension =<br />
<br />
==mime-type==<br />
<br />
OpenService description documents are referred to via the following type: <br />
<br />
application/openservicedescription+xml <br />
<br />
This type is pending IANA registration. <br />
<br />
==Automatic Discovery==<br />
<br />
HTML and XHTML documents may reference related OpenService description documents via the HTML 4.0 <link/> element. <br />
<br />
The following restrictions apply: <br />
* The "type" attribute must contain the value "application/openservicedescription+xml ". <br />
* The "rel" attribute must contain the value "service". <br />
* The "href" attribute must contain a URI that resolves to an OpenService description document. <br />
* The "title" attribute may contain a human-readable plain text string describing the service. <br />
<br />
The HTML <head/> element should include a "profile" attribute that contains the value "http://www.microsoft.com/schemas/openservicedescription/1.0". <br />
Example of an HTML document that includes OpenSearch autodiscovery link elements: <br />
<br />
<pre><br />
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"><br />
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"><br />
<head profile="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<!--- ... ---><br />
<link rel="service"<br />
type="application/openservicedescription+xml" <br />
href="http://example.com/service1.xml"<br />
title="Service 1" /><br />
<link rel="service"<br />
type="application/opensearchdescription+xml" <br />
href="http://example.com/service2.xml"<br />
title="Service 2" /><br />
<!--- ... ---><br />
</head><br />
<body><br />
<!--- ... ---><br />
</body><br />
</html><br />
<pre><br />
<br />
The "rel" attribute of the link element should contain the value "service" when referring to OpenService description documents. This relationship value is pending IANA registration. <br />
<br />
= OpenService extension for microformats contexts (a.k.a. microservices) =<br />
<br />
OpenService description includes the context concept which is used to describe the content this service can be applied to. The possible contexts included in the original OpenService specification are This specification extends that values to include microformats as posible '''contexts'''.<br />
<br />
The other extension required is the '''variables''' that can be used to compose the url parameters that will be sent to the service. These new variables include the values of the microservices.<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription<br />
xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="tag"><br />
<execute method="get"<br />
action="http://youtube.com/results?search_query={tag.tag}"><br />
</execute><br />
</activityAction><br />
</activity><br />
</openServiceDescription><br />
</pre><br />
<br />
Pending issues:<br />
* Include support for services that require more than one microformat.<br />
* Include support for semantic content other than microformats (RDF, RDFa, eRDF)<br />
= OpenService extension to describe Operator User Scripts =<br />
<br />
<pre><br />
<?xml version="1.0" encoding="utf-8"?><br />
<openServiceDescription xmlns="http://www.microsoft.com/schemas/openservicedescription/1.0"><br />
<display><br />
<name>Find videos on YouTube</name><br />
<icon>http://www.youtube.com/favicon.ico</icon><br />
</display><br />
<br />
<homepageUrl>http://youtube.com</homepageUrl><br />
<activity category="Tags"><br />
<activityAction context="tag"><br />
<execute method="script"><br />
<script><br />
<![CDATA[<br />
if (semanticObject.tag) {<br />
return("http://youtube.com/results?search_query=" + encodeURIComponent(semanticObject.tag));<br />
}<br />
]]><br />
</script><br />
</execute><br />
</activityAction><br />
</activity><br />
<br />
</openServiceDescription><br />
</pre></div>Anarchycohttp://microformats.org/wiki/index.php?title=OpenService_Extensions&diff=26867OpenService Extensions2008-04-28T20:55:42Z<p>Anarchyco: </p>
<hr />
<div>To increase the value of web content annotated with microformats (or other semantic web technologies) it is required to define a language that can be used by web applications to describe and publish their services available for different semantic contents (e.g. for a hCard).<br />
<br />
There could be other alternatives, but one of them is to extend Microsoft [[http://msdn2.microsoft.com/en-us/library/cc304163(VS.85).aspx|Open Service Description]] and reusing also some [[http://www.opensearch.org|Open Search]] concepts.<br />
<br />
= Generic OpenService Extension =<br />
<br />
==mime-type==<br />
<br />
application/opensearchdescription+xml<br />
<br />
==HTML Discovery==<br />
<br />
= OpenService extension for microformats contexts =<br />
<br />
<br />
= OpenService extension to describe Operator User Scripts =</div>Anarchyco