search

dcmi / vocabtool

Source and scripts for generating DCMI Metadata Terms documentation
http://dublincore.org/documents/dcmi-terms/
Other
32 stars 16 forks source link

Add autodiscovery links for the RDF files to the HTML #10

Open jonphipps opened 12 years ago

jonphipps commented 12 years ago

per: http://patterns.dataincubator.org/book/autodiscovery.html

<link rel="meta" type="application/rdf+xml" title="RDF XML data for dc:type Vocabulary" href="http://dublincore.org/2012/06/14/dctype.rdf"/>

<link rel="meta" type="text/turtle" title="RDF Turtle data for dc:type Vocabulary" href="http://dublincore.org/2012/06/14/dctype.ttl"/>
gkellogg commented 12 years ago

I'd go beyond having elements to the documents to making them visible to the reader. This could duplicate some of the link information using something like the following:

<p resource="">Alternative representations of DCMI Terms are available in
  <a href="http://dublincore.org/2012/06/14/dctterms.ttl" property="alternate">Turtle</a>
  and
  <a href="http://dublincore.org/2012/06/14/dctterms.rdf" property="alternate">RDF/XML</a>
</p>

This will make it easier for the developer trying to find an alternate representation by simply looking at the text.

tombaker commented 9 years ago

The header of http://dublincore.org/documents/dcmi-terms/ currently shows links to:

Identifier: http://dublincore.org/documents/2012/06/14/dcmi-terms/
Latest Version: http://dublincore.org/documents/dcmi-terms/
Replaces: http://dublincore.org/documents/2010/10/11/dcmi-terms/
Translations: http://dublincore.org/resources/translations/

In addition, the headers should directly link to:

http://dublincore.org/2012/06/14/dctype.rdf
http://dublincore.org/2012/06/14/dcam.rdf
http://dublincore.org/2012/06/14/dcterms.rdf
http://dublincore.org/2012/06/14/dcelements.rdf

http://dublincore.org/2012/06/14/dctype.ttl
http://dublincore.org/2012/06/14/dcam.ttl
http://dublincore.org/2012/06/14/dcterms.ttl
http://dublincore.org/2012/06/14/dcelements.ttl

Alternatively, the DCMIMT document could perhaps handle this the way it is done in, for example, the namespace spec for VOID vocabulary [1] -- i.e., with clickable icons that lead to the representations in Turtle and RDF/XML [2,3]. As far as I know, those icons were created by DERI, but perhaps we could use them with permission.

[1] http://vocab.deri.ie/void [2] http://vocab.deri.ie/sites/all/modules/neologism/images/icons/turtle-40.png [3] http://vocab.deri.ie/sites/all/modules/neologism/images/icons/rdf-xml-40.png