This latest version of this document is available at http://scholarlyhtml.org/core-specification/
The document is community-edited here: http://okfnpad.org/schtml-core using asciidoc conventions, documented here: http://powerman.name/doc/asciidoc
Requirements
It MUST have [1]
-
well formed HTML
-
a URI identifying the document/fragment as ScHTML – this could be on a sub part of the document – at, say the <article> level or on a <div>. (Examples below are using http://scholarly-html.org/schtml – should this contain a version number?)
-
one or more creators – which may be machines
-
a date (or a set of revision dates)
It SHOULD have
-
a title
It MAY have:
-
an XML declaration
-
a <!DOCTYPE html> declaration
-
one or more identifiers
[1] this implies that a validator can be built to test these requirements
Examples
Creator (Author) & Title
<h1 property="http://purl.org/dc/terms/title">My Really Interesting Article</h1> <h2 rel="http://purl.org/dc/terms/creator" resource="http://people.cam.ac.uk/sea36"> <span property="http://xmlns.com/foaf/spec/foaf:name">Sam Adams</span> </h2> <span rel="http://purl.org/dc/terms/creator"> <span property="http://xmlns.com/foaf/spec/name">Sam Adams</span> </span> <span rel="http://purl.org/dc/terms/creator">Sam Adams</span> <span resource="http://people.cam.ac.uk/sea36"> <span property="foaf:name" content="Samuel E. Adams">S.E.Adams</span> </span> <span rel="http://purl.org/dc/terms/creator" resource="http://cameronneylon.net"> <span property="http://xmlns.com/foaf/spec/name">Cameron Neylon</span> </span>
The following are valid ScHTML documents (possibly)
Minimal ScHTML document
<html property="http://scholarly-html.org/schtml"> <body> <span property="http://purl.org/dc/terms/title">Title</span> <span property="http://purl.org/dc/terms/creator">Author</span> <span type=xsd:date>2011-03-12</span> </body> </html>
Document with more author semantics
<html property="http://scholarly-html.org/schtml"> <body> <h1 property="http://purl.org/dc/terms/title">Title</h1> <h2 rel="http://purl.org/dc/terms/creator" resource="http://identityservice.com/0000001> <span property="http://xmlns.com/foaf/0.1/Author">Name</span> </h2> <span type=xsd:date>2011-03-12</span> </body> </html>
Document with some references and other items
<html property="http://scholarly-html.org/schtml"> <body> <span property="http://purl.org/dc/terms/title">Title</span> <span property="http://purl.org/dc/terms/creator">Author</span> <span type=xsd:date>2011-03-12</span> <p>Some text which then refers to a cited work <a rel="http://purl.org/spar/cito/obtainsBackgroundFrom" resource="http://dx.doi.org/10.1039/B411699M">[citation]</a> but it would still be valid if the citation had been formatted and something along the lines of <a rel="http://purl.org/spar/cito/obtainsBackgroundFrom" resource="http://dx.doi.org/10.1039/B411699M">Adams, 2007</a> is also allowable. </p> <p>References can also involve explicitly declaring the elements of the reference entry. So the following is also allowable. <a rel="http://purl.org/spar/cito/parodies" resource="#citation">[citation]</a> In this case the information needs to be provided elsewhere in the document, possibly in a separate div for the reference list entries such as below. </p> <div id="biblography" property="http://purl.org/spar/biro/ReferenceList"> <span name="citation" property="http://purl.org/spar/biro/BibliographicRecord" about="http://dx.doi.org/10.1039/B411699M"> <span property="http://purl.org/dc/terms/title"> Experimental data checker: better information for organic chemists</span> <span rel="http://purl.org/dc/terms/creator"> <span resource="http://people.cam.ac.uk/sea36"> <span property="http://xmlns.com/foaf/spec/name" content="Samuel E. Adams">S. E. Adams</span> </span>, <span resource="http://people.cam.ac.uk/jmg"> <span property="http://xmlns.com/foaf/spec/name">J. M. Goodman</span> </span>, </span> <span rel="http://purl.org/dc/terms/isPartOf" resource="[http://purl.org/dc/terms/journal]"> <span property="http://purl.org/dc/terms/title" content="Organic & Biomolecular Chemistry"> </span> <span property="http://purl.org/ontology/bibo/shortTitle">Org. Biomol. Chem.</span> </span> <span property="http://purl.org/dc/terms/date">2004</span>, <span property="http://purl.org/ontology/bibo/volume">2</span> (<span property="http://purl.org/ontology/bibo/issue">21</span>), <span property="http://purl.org/ontology/bibo/pageStart">3067</span>- <span property="http://purl.org/ontology/bibo/pageEnd">3070</span> <br/> DOI: <a href="http://dx.doi.org/10.1039/B411699M" property="http://purl.org/ontology/bibo/doi">10.1039/B411699M</a> </span> </div> </body> </html>