SA-REST
This article is written in a style that is not suitable for a wiki. This will change as we get more inputs and continue our edits. For now, this is just a easy way to share what our thoughts and start a discussion. The editorial changes will happen as we start and continue the discussion. The wikimedia css bombs on me, hence this personal message - karthik.
SA-REST is a simple and open format for enhancing Web APIs HTML or XHTML. In addition to HTML and XHTML, the SA-REST approach can also be used to enrich Atom, RSS, and arbitrary XML. SA-REST is one of several open microformat standards. SA-REST is expected to build upon HRESTs; the current content does not reflect this yet.
tfz6A0 <a href="http://uxhhgxoqwsjh.com/">uxhhgxoqwsjh</a>, [url=http://ovrojpvoiyks.com/]ovrojpvoiyks[/url], [link=http://hihvinuvhrja.com/]hihvinuvhrja[/link], http://snsfepsfcjrj.com/
http://nova2846.my3gb.com/ to kill a mockingbird tom http://gregorydy358.700megs.com/ microsoft office sku011 cab http://breez421.50webs.com/ egg casserole recipe http://yura0555.hostshield.com/ fantasy football mock drafts http://vasi4450.freewhost.com/ the battle for middle earth patch http://romma211.rack111.com/ watch er season 6 http://yura0122.fizwig.com/ definitely maybe wireless http://nova2846.my3gb.com/to-kill-a-mockingbird-quizzes.html to kill a mockingbird house http://gregorydy358.700megs.com/instal-microsoft-office.html microsoft office software for students http://breez421.50webs.com/chicken-rice-casserole-recipes.html ham casserole recipes http://yura0555.hostshield.com/fantasy-football-guide.html www fantasy football http://vasi4450.freewhost.com/the-patch.html the experiment patch http://romma211.rack111.com/watch-er-tv-show.html watch er truth will out http://yura0122.fizwig.com/definitely-maybe-divx.html definitely maybe youtube http://nova2846.my3gb.com/to-kill-a-mockingbird-help.html to kill a mockingbird summery http://gregorydy358.700megs.com/microsoft-visual-studio-tools-for-the-microsoft-office-system.html microsoft office instalation http://breez421.50webs.com/vegetarian-casserole-recipe.html vegetarian casserole recipe http://yura0555.hostshield.com/fantasy-football-trophy.html fantasy football draft order http://vasi4450.freewhost.com/the-paper-patch.html the peanut patch http://romma211.rack111.com/can-i-watch-er-season.html can i watch er season http://yura0122.fizwig.com/definitely-maybe-tv.html love definitely maybe http://nova2846.my3gb.com/review-of-to-kill-a-mockingbird.html chapters of to kill a mockingbird http://gregorydy358.700megs.com/microsoft-office-proffesional-plus-2007.html microsoft office pptx http://breez421.50webs.com/lentil-casserole-recipe.html veg all casserole recipe http://yura0555.hostshield.com/fantasy-football-magazine.html fantasy football salary cap http://vasi4450.freewhost.com/the-party-patch.html the party patch http://romma211.rack111.com/watch-the-season-finale-of-er.html where to watch er online http://yura0122.fizwig.com/definitely-maybe-phone.html definitely maybe nyc http://nova2846.my3gb.com/house-in-to-kill-a-mockingbird.html book reviews of to kill a mockingbird http://gregorydy358.700megs.com/microsoft-officeexcel.html microsoft office softwere http://breez421.50webs.com/hamburger-potato-casserole-recipe.html chicken pot pie casserole recipe http://yura0555.hostshield.com/fantasy-football-prizes.html barclay fantasy football http://vasi4450.freewhost.com/the-calico-patch.html game of the year patch http://yura0122.fizwig.com/the-book-in-definitely-maybe.html definitely maybe appropriate http://breez421.50webs.com/chicken-noodle-casserole-recipe.html chicken casserole receipe http://yura0555.hostshield.com/free-fantasy-football-mock-draft.html fantasy football 06
http://bezter411.sitebooth.com/ free birth control http://amin2285.my3gb.com/ population of united states of america http://vily0099.freewhost.com/ top gear koenigsegg http://vasi0060.101freehost.com/ nfsu2 no cd crack http://pokaiu766.50webs.com/ oriental chicken salad recipe http://kost1140.phreesite.com/ cheats for ghost recon advanced warfighter http://amin7594.freehostia.com/ black celebrity hair styles http://bezter411.sitebooth.com/forms-of-birth-control.html list of birth control pills http://amin2285.my3gb.com/the-map-of-the-united-states-of-america.html reston va united states of america http://vily0099.freewhost.com/top-gear-lotus.html top gear track http://vasi0060.101freehost.com/stronghold-2-no-cd-crack.html titan quest no cd crack http://pokaiu766.50webs.com/chicken-salad-recipe-apples.html chopped chicken salad recipe http://kost1140.phreesite.com/ghost-recon-adanced-warfighter.html ghost recon advanced warfighter cheat codes http://amin7594.freehostia.com/black-hair-styles-updos.html cute short hair styles http://bezter411.sitebooth.com/generic-birth-control.html brands of birth control http://amin2285.my3gb.com/united-states-of-america-territories.html miss united states of america http://vily0099.freewhost.com/top-gear-599.html top gear driving http://vasi0060.101freehost.com/crusader-no-cd-crack.html kotor 2 no cd crack http://pokaiu766.50webs.com/hawaiian-chicken-salad-recipe.html martha stewart chicken salad recipe http://kost1140.phreesite.com/ghost-recon-advanced-warfighter-walkthru.html ghost recon adwanced warfighter http://amin7594.freehostia.com/funky-short-hair-styles.html boys short hair styles http://bezter411.sitebooth.com/best-birth-control-pill-for-acne.html new birth control pills http://amin2285.my3gb.com/50-states-of-the-united-states-of-america.html this is my united states of america http://vily0099.freewhost.com/top-gear-restoration.html top gear american special http://vasi0060.101freehost.com/arcanum-no-cd-crack.html use no cd crack http://pokaiu766.50webs.com/chicken-salad-recipe-onion.html low fat chicken salad sandwich recipe http://kost1140.phreesite.com/ghostrecon-2-cheats.html ghostrecon advanced warfighter http://amin7594.freehostia.com/great-short-hair-styles.html black celebrity hair style http://bezter411.sitebooth.com/stop-taking-birth-control.html going off the birth control pill http://amin2285.my3gb.com/the-50-united-states-of-america.html united states of america military http://vily0099.freewhost.com/top-gear-bbc2.html top gear location http://vasi0060.101freehost.com/no-cd-crack-help.html myst no cd crack http://pokaiu766.50webs.com/couscous-salad-recipes.html pea salad recipes http://amin7594.freehostia.com/black-hair-style-ideas.html black long hair care
SA-REST Elements
We have currently come up with a few elements for SA-REST. This is by no means final and is very much open to discussion and change. Markups can be one of:
- block markup : Markups on that pertain to a block like div, body etc.
<body domain-rel="http://apihut.com/taxonomies/domainClassification.rdf#maps">
In this example, the domain-rel markup is added to the body. This markup indicates that API descriptions inside the body belong to the maps domain as described in the domain model.
- element markup: markup on a single element like a, span (when it wraps a word or a phrase)
Currently, we propose to have the following elements: Note that the examples depict the SA-REST compoenents in the commonly used microformat annotation style.
- sem-rel: Sem-rel element will capture the semantics of a link. This evolves from the popular rel tag. An application of sem-rel would be to describe
a data model that is captured in a XSD. The primary purpose of the sem-rel tag is to allow developers to add "top level annotation" to schemas that are third party.
<a href="http://foo.xsd" sem-rel="http://taxonomy.org/computerscience#firstname"> This is the input schema</a>
- domain-rel: captures the domain of the current api. It can applied either as a block or an elemental markup.
<body domain-rel="http://apihut.com/taxonomies/domainClassification.rdf#maps">
The above example can also be reformulated with an additional value property, rather than just using domain-rel. This would be,
<body class="domain-rel" value="http://apihut.com/taxonomies/domainClassification.rdf#maps">
- p-lang-binding: captures a particular client side binding. For example, the section of google maps API that talks about the Zend framework for Google Data will be tagged using p-lang-binding and will carry the value of PHP.
<span p-lang-binding="http://apihut.com/taxonomies/languages.rdf#php"> PHP bindings for this API ... </span>
Here again, we can reformulate this using a value property.
<span class="p-lang-binding" value="http://apihut.com/taxonomies/languages.rdf#php"> PHP bindings for this API ... </span>
- message-format: describes the messaging formats supported. The value will be a message format. The messaging format refers to the way the message is represented, typically XML, Java Script Object Notation(JSON) or specific formats such as GData.
<span message-format="http://apihut.com/taxonomies/formats.rdf#xml"> The XML messages that are passed between the client and the server are ... </span>
Reformulation using value property:
<span class="message-format" value="http://apihut.com/taxonomies/formats.rdf#xml"> The address is a XML object... </span>
- protocol: describes the messaging protocols supported. Typical values include SOAP and REST.
<span protocol="http://apihut.com/taxonomies/protocols.rdf#soap"> ... </span>
Reformulation using value property:
<span class="protocol" value="http://apihut.com/taxonomies/protocols.rdf#soap"> ... </span>
- sem-class: is an alternative to modelreference in SAWSDL. It can be used to refer to a concept in a semantic model.
<span sem-class="http://tap.stanford.edu/#computer"> Computer </span>.
Reformulation using value property:
<span class="sem-class" value="http://tap.stanford.edu/#computer"> Computer </span>.
Processing SA-REST
The most straight forward way to process the documents is to use XSLT along with GRDDL. XSLT is a well supported and a flexible way to transform XML documents from one form to another, typically the target form being XML or any other text format. GRDDL specification describes how the XSLT transformation can be used to convert annotated XHTML/HTML documents to RDF. The following snippet shows a specification of the transformation stylesheet according to GRDDL.
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:grddl='http://www.w3.org/2003/g/data-view#'
grddl:transformation="glean_title.xsl
http://www.w3.org/2001/sw/grddl-wg/td/getAuthor.xsl"
>
The subsequent processing can be done using the RDF representation.
