tidying up (history resides in hg...)
authordanbri <danbri@google.com>
Wed, 02 Oct 2013 18:07:58 +0200
changeset 115 de1876d806db
parent 114 744494d69a14
child 116 6d50ae05a771
tidying up (history resides in hg...)
schema.org/ext/ActionBase.html
schema.org/ext/action.html
--- a/schema.org/ext/ActionBase.html	Wed Oct 02 18:06:33 2013 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,114 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
-<title>Action - Schema documentation</title>
-</head>	
-<body>   
-<!-- todo: restore nicer CSS -->
-<!-- to verify schema graph after edits, use  rapper -q -i rdfa Actions2013-actiontypes.html  or http://www.w3.org/2012/pyRdfa/#distill_by_input --> 
-
-
-<div class="type" typeof="rdfs:Class" resource="http://schema.org/Action">
-
-<h2 property="rdfs:label" class="page-title"><span class="schema_type">Action</span></h2>
-
-<p class="narrow"><strong>Subclass of:</strong> <a property="rdfs:subClassOf" href="http://schema.org/Thing">Thing</a></p>
-
-<p class="description" property="rdfs:comment">An action performed by a direct agent and indirect participants upon a direct object, starting at an origin towards a destination. Happens at a location, with the help of an inanimate instrument. The execution of the action may produce a result. Specific action sub-type documentation specifies the exact expectation of each argument/role/slot.</p>
-
-
-<table class="properties" border="1" cellpadding="10">
-
-<tbody>
-
-<tr><td class="section" colspan="3">Properties added by Action</td></tr>
-
-<tr typeof="rdf:Property" href="http://schema.org/agent">
-<th property="rdfs:label">agent</th>
-<td>
- <link property="http://schema.org/domain" href="http://schema.org/Action"></link> 	<!-- we don't show the domain, as it is always Action -->
- <a property="http://schema.org/range" href="http://schema.org/Person">Person</a>, 	<!-- but we do show the range, as expected value varies with each property -->
- <a property="http://schema.org/range" href="http://schema.org/Organization">Organization</a>
-</td>
-<td property="rdfs:comment">The direct performer or driver of the action (animate or inanimate). E.g. *John* wrote a book.</td>
-</tr>
-
-
-
-<tr typeof="rdf:Property" href="http://schema.org/participant">
-<th property="rdfs:label">participant</th>
-<td>
- <link property="http://schema.org/domain" href="http://schema.org/Action"></link> 	<!-- we don't show the domain, as it is always Action -->
- <a property="http://schema.org/range" href="http://schema.org/Person">Person</a>, 	<!-- but we do show the range, as expected value varies with each property -->
- <a property="http://schema.org/range" href="http://schema.org/Organization">Organization</a>
-</td>
-<td property="rdfs:comment">Other co-agents that participated in the action indirectly. E.g. John wrote a book with *Steve*.</td>
-</tr>
-
-
-
-<tr typeof="rdf:Property" resource="http://schema.org/object">
-<th property="rdfs:label">object</th>
-<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<a property="http://schema.org/range" href="http://schema.org/Thing">Thing</a>
-</td>
-<td property="rdfs:comment">The object upon the action is carried out, whose state is kept intact or changed. Also known as the semantic roles patient, affected or undergoer (which change their state) or theme (which doesnt).</td>
-</tr>
-
-
-<tr typeof="rdf:Property" resource="http://schema.org/result">
-<th property="rdfs:label">result</th>
-<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<a property="http://schema.org/range" href="http://schema.org/Thing">Thing</a>
-</td>
-<td property="rdfs:comment">The result produced in the action. E.g. John wrote *a book*.</td>
-</tr>
-
-<tr typeof="rdf:Property" resource="http://schema.org/instrument">
-<th property="rdfs:label">instrument</th>
-<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<a property="http://schema.org/range" href="http://schema.org/Thing">Thing</a>
-</td>
-<td property="rdfs:comment">The object that helped the agent perform the action. E.g. John wrote a book with *a pen*.</td>
-</tr>
-
-
-<tr typeof="rdf:Property" resource="http://schema.org/startTime">
-<th property="rdfs:label">startTime</th>
-<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link> 	<!-- todo: relationship to event ? -->
-<a property="http://schema.org/range" href="http://schema.org/DateTime">DateTime</a>
-</td>
-<td property="rdfs:comment">When the Action was performed: start time. This is for actions that span a period of time.</td>
-</tr>
-
-<tr typeof="rdf:Property" resource="http://schema.org/endTime">
-<th property="rdfs:label">endTime</th>
-<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<a property="http://schema.org/range" href="http://schema.org/DateTime">DateTime</a>
-</td>
-<td property="rdfs:comment">When the Action was performed: end time. This is for actions that span a period of time.</td>
-</tr>
-
-<tr typeof="rdf:Property" resource="http://schema.org/location">
-<th property="rdfs:label">location</th>
-<td>
-<link property="http://schema.org/domain" href="http://schema.org/Action"></link>
-<a property="http://schema.org/range" href="http://schema.org/Place">Place</a>, 
-<a property="http://schema.org/range" href="http://schema.org/PostalAddress">PostalAddress</a>
-</td>
-<td property="rdfs:comment">The location of an event, action or organization.</td>
-</tr>
-
-</tbody></table>
-
-
-</div>
-
-
-</body>
-</html>
--- a/schema.org/ext/action.html	Wed Oct 02 18:06:33 2013 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,219 +0,0 @@
-<!DOCTYPE html>
-<html>
-  <head>
-    <title>RDFa Lite Reflection</title>
-    <meta charset="utf-8" />
-    <style type="text/css">
-      span.h {
-        padding-left: 0px;
-        font-weight: bold;
-      }
-      span {
-        display: block;
-        padding-left: 10px;
-      }
-    </style>
-  </head>
-  <body>
-
-    <h1>Action Vocabulary</h1>
-
-    <p>See <a href="http://www.w3.org/wiki/WebSchemas/ActivityActions">wiki</a> and <a href="http://www.w3.org/wiki/images/7/79/Schema.orgActionsMinimaldraft.pdf">minimal draft doc</a> for details.</p>
-
-<h2>Types</h2>
-	
-	<!-- TODO: ul/li -->
-	
-	<div typeof="rdfs:Class" resource="http://schema.org/Action">
-      <span class="h" property="rdfs:label">Action</span>
-      <span property="rdfs:comment">An action that may be carried out by some 'performer' such as a Person or Organization.</span>
-      <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/Intangible">Intangible</a></span>
-    </div>
- 
-<div typeof="rdfs:Class" resource="http://schema.org/ActionStatusValue">
-  <span class="h" property="rdfs:label">ActionStatusValue</span>
-  <span property="rdfs:comment">Enumeration of values for use with actionStatus property.</span>
-  <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/Enumeration">Enumeration</a></span>
-</div>
-
-<div typeof="rdfs:Class" resource="http://schema.org/ActionHandler">
-  <span class="h" property="rdfs:label">ActionHandler</span>
-  <span property="rdfs:comment">An application or service that allows an Action to be performed.</span>
-  <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/Intangible">Intangible</a></span>
-  <span>Notes: User Agents may invoke ActionHandlers in order to perform an action. An 
-ActionHandler is typically passed a description of the Action instance as input"</span>
-</div>
-
-<!-- This could be dropped from the core -->
-<div typeof="rdfs:Class" resource="http://schema.org/ActionType">
-  <span class="h" property="rdfs:label">ActionType</span>
-  <span property="rdfs:comment">ActionType represents those subtypes of Action that are intended to be usefully actionable according to the schema.org Action-description machinery. This allows for other subtypes of Action to be declared for other descriptive purposes.</span>
-  <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/Class">Class</a></span>
-<span>Notes: ActionType can be used to indicate specific sub-types of Action which are 
-designed to participate in the Action-description machinery described here. While 
-not essential, this allows other useful sub-types of Action to be defined for other 
-purposes without confusion.</span>
-</div>
-
-
-<h2>Enumerations</h2>
-
-<div>We introduce an 'actionStatus' property, which relates an Action to one of several enumerated ActionStatusValue options.</div>
-
-<ul>
- <li>
-  <div typeof="schema:ActionStatusValue" resource="http://schema.org/PossibleAction">
-   <span class="h" property="rdfs:label">PossibleAction</span>
-   <span property="rdfs:comment">PossibleAction - The action has not been performed yet.</span>
-  </div>
- </li>
- <li>
-  <div typeof="schema:ActionStatusValue" resource="http://schema.org/PendingAction">
-  <span class="h" property="rdfs:label">PendingAction</span>
-  <span property="rdfs:comment">PendingAction - The action is in the process of being performed.</span>
-  </div>
- </li>
- <li>
-  <div typeof="schema:ActionStatusValue" resource="http://schema.org/CancelledAction">
-  <span class="h" property="rdfs:label">CancelledAction</span>
-  <span property="rdfs:comment">CancelledAction - The action was cancelled.</span>
-  </div>
- </li>
- <li>
-  <div typeof="schema:ActionStatusValue" resource="http://schema.org/CompletedAction">
-  <span class="h" property="rdfs:label">CompletedAction</span>
-  <span property="rdfs:comment">CompletedAction - The action was completed.</span>
-  </div>
- </li>
-</ul>
-
-<h2>Other Changes</h2>
-
-<div>
-Note: 'Action' is a sibling type to '<a href="http://schema.org/Event">Event</a>', sharing some of its properties, such as 'performer' and spatial/temporal information. Applicable properties include: ‘performer’, ‘duration’, ‘startDate’, ‘endDate’ … (these would have domainIncludes amended to mention Action). <!-- TODO. -->
-</div>
-
-
-<h2>Properties</h2>
-
-    <div typeof="rdf:Property" resource="http://schema.org/actionStatus">
-      <span class="h" property="rdfs:label">actionStatus</span>
-      <span property="rdfs:comment">relates an Action to one of several enumerated ActionStatusValue</span>
-      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Action">Action</a></span>
-      <span>Range: <a property="http://schema.org/range" href="http://schema.org/ActionStatusValue">ActionStatusValue</a></span>
-    </div>
-
-    <div typeof="rdf:Property" resource="http://schema.org/possibleAction">
-      <span class="h" property="rdfs:label">possibleAction</span>
-      <span property="rdfs:comment">An action that might be performed with this Thing.</span>
-      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Thing">Thing</a></span>
-      <span>Range: <a property="http://schema.org/range" href="http://schema.org/Action">Action.</a></span>
-    </div>
-
-<!-- todo: Optionally, we introduce a parallel property “eventStatus”, Enumeration type, 
-EventStatusValue ... -->
-
-    <div typeof="rdf:Property" resource="http://schema.org/possibleActionType">
-      <span class="h" property="rdfs:label">possibleActionType</span>
-      <span property="rdfs:comment">A (sub)type of Action that might be performed with this type of Thing.</span>
-      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Class">Class</a></span>
-      <span>Range: <a property="http://schema.org/range" href="http://schema.org/ActionType">ActionType</a></span>
-    </div>
-
-    <div typeof="rdf:Property" resource="http://schema.org/handler">
-      <span class="h" property="rdfs:label">handler</span>
-      <span property="rdfs:comment">Associates a specific Action instance with a specific ActionHandler.</span>
-      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Action">Action</a></span>
-      <span>Range: <a property="http://schema.org/range" href="http://schema.org/ActionHandler">ActionHandler</a></span>
-    </div>
-
-
-    <div typeof="rdf:Property" resource="http://schema.org/optionalProperty">
-      <span class="h" property="rdfs:label">optionalProperty</span>
-      <span property="rdfs:comment">Property that can be specified on the Action that the handler supports.</span>
-      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/ActionHandler">ActionHandler</a></span>
-      <span>Range: <a property="http://schema.org/range" href="http://schema.org/Property">Property</a></span>
-    </div>
-
-
-    <div typeof="rdf:Property" resource="http://schema.org/requiredProperty">
-      <span class="h" property="rdfs:label">requiredProperty</span>
-      <span property="rdfs:comment">Property that must be given in an Action description, for it to be handled by its ActionHandler.</span>
-      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/ActionHandler">ActionHandler</a></span>
-      <span>Range: <a property="http://schema.org/range" href="http://schema.org/Property">Property</a></span>
-    </div>
-
-    <div typeof="rdf:Property" resource="http://schema.org/handledActionType">
-      <span class="h" property="rdfs:label">handledActionType</span>
-      <span property="rdfs:comment">Indicates the general type(s) of action that some handler can accept. (previous draft called this 'actionType').</span>
-      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/ActionHandler">ActionHandler</a></span>
-      <span>Range: <a property="http://schema.org/range" href="http://schema.org/ActionType">ActionType</a></span>
-    </div>
-
-<h2>Specific Handler types</h2>
-
-<div typeof="rdfs:Class" resource="http://schema.org/WebActionHandler">
-  <span class="h" property="rdfs:label">WebActionHandler</span>
-  <span property="rdfs:comment">Any action which can be carried out by simply following an url (property of the Action) is handled by a WebActionHandler.</span>
-  <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/ActionHandler">ActionHandler</a></span>
-</div>
-
-<div typeof="rdfs:Class" resource="http://schema.org/HTTPActionHandler">
-  <span class="h" property="rdfs:label">HTTPActionHandler</span>
-  <span property="rdfs:comment">Any action which can be carried out by simple HTTP transaction.</span>
-  <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/ActionHandler">ActionHandler</a></span>
-</div>
-
-<!-- todo: detail here? more properties over time...
-HTTPActionHandler, with properties ‘url’ (inherited from Thing), ‘method’, 
-‘encoding’, ‘authorization’. We introduce a type ‘HTTPRequestMethod’ as a sub-type of  Enumeration. We enumerate two instances of it: HTTPGET, HTTPPOST. -->
-
-<h2>Example Action Schemas</h2>
-
-<p>A few example Action types are provided as built-ins; others can be modeled in the same style.</p>
-
-<ul>
- <li>
-
-<!--  <div typeof="rdfs:Class schema:ActionType" resource="http://schema.org/AcceptAction"> -->
-  <div typeof="rdfs:Class" resource="http://schema.org/AcceptAction">
-
-   <span class="h" property="rdfs:label">AcceptAction</span>
-   <span property="rdfs:comment">Action for confirming something, e.g. an invitation, an offer.</span>
-   <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/Action">Action</a></span>
-  </div>
-  <div typeof="rdf:Property" resource="http://schema.org/accepted">
-    <span class="h" property="rdfs:label">accepted</span>
-    <span property="rdfs:comment">The thing that is accepted in an AcceptAction.</span>
-    <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/AcceptAction">AcceptAction</a></span>
-    <span>Range: <a property="http://schema.org/range" href="http://schema.org/Thing">Thing.</a></span>
-  </div>
- </li>
-
- <li>
-<!--  <div typeof="rdfs:Class schema:ActionType" resource="http://schema.org/AddAction"> -->
-  <div typeof="rdfs:Class" resource="http://schema.org/AddAction">
-   <span class="h" property="rdfs:label">AddAction</span>
-   <span property="rdfs:comment">Action for adding something (e.g. a product to a shopping cart, a friend to a 
-friend list).</span>
-   <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/Action">Action</a></span>
-  </div>
-  <div typeof="rdf:Property" resource="http://schema.org/added">
-    <span class="h" property="rdfs:label">added</span>
-    <span property="rdfs:comment">The thing that is added in an AddAction.</span>
-    <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/AddAction">AddAction</a></span>
-    <span>Range: <a property="http://schema.org/range" href="http://schema.org/Thing">Thing.</a></span>
-  </div>
- </li>
-</ul>
-
-<div>More Action types can be added later.</div>
-
-
-<br/>
-<br/>
-<br/>
-<br/>
-
-  </body>
-</html>