Machine- and human-readable formats


Cite Permalink:
1
General
Cite Permalink:
2
1. When a URI is resolved and a document returned a variety of formats may be used. The following is guidance as to what format to use in what circumstance.
Cite Permalink:
3
Formats for Representation URIs
Cite Permalink:
4
2. Documents may be available in multiple formats. Each possible representation of the Document should have a distinct representation URI. For example:
Cite Permalink:
5
Cite Permalink:
6
3. Having distinct representation URIs for each possible representation makes it possible to access a particular representation without changing the headers that are sent with a request, which is useful for certain clients. Each document should also include pointers to the other available formats, and lists of resources should also include lists of possible representations. For example:
Cite Permalink:
7
  • In HTML, use the element with a suitable type attribute
  • In RDF, use a dct:hasFormat property
  • In Atom, use the element with a suitable type attribute
Cite Permalink:
8
4. At least one representation must be machine-readable in a way that enables the construction of an RDF graph. It is recommended that this representation is one of:
Cite Permalink:
9
  • RDF/XML[1] (preferred, as this is supported by the largest number of tools)
  • XHTML with a GRDDL[2] transformation
  • XHTML with embedded RDFa[3]
Cite Permalink:
10
5. It is also acceptable to provide the following formats for the construction of an RDF graph:
Cite Permalink:
11
Cite Permalink:
12
6. Other formats are also useful. In particular, it is useful to provide other machine-readable formats such as:
Cite Permalink:
13
  • JSON
  • CSV
Cite Permalink:
14
7. It is also useful to provide human-readable versions of the documents in HTML, if appropriate.
Cite Permalink:
15
8. The community of practice will provide further examples to illustrate how information can be returned from looking up a Representation URI.
Cite Permalink:
16
[1] http://www.w3.org/TR/rdf-syntax-grammar/
Cite Permalink:
17
[2] http://www.w3.org/TR/grddl/
Cite Permalink:
18
[3] http://www.w3.org/TR/rdfa-syntax/
Cite Permalink:
19
[4] http://www.w3.org/TeamSubmission/turtle/
Cite Permalink:
20
[5] http://www.w3.org/DesignIssues/Notation3

Tags: ,

Total comments on this page:

One Response to “Machine- and human-readable formats”

[...] (Some of them have nice URLs, some don’t; if you think they should, how does this sound? Designing URI Sets for the UK Public Sector: Machine- and human-readable formats. Most of the data is public too – it’s just the meta-sit – data.gov.uk – [...]