Citations with added RDFa: Difference between revisions

From The Digital Classicist Wiki
Jump to navigation Jump to search
mNo edit summary
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
The page [[Citation_in_digital_scholarship]] describes a convention for making citations that relies on the 'class' and 'title' attributes when implemented in (x)html. This page further elaborates that convention by describing how to add RDFa to conformant citations.
The page [[Citation in digital scholarship]] describes a convention for making citations that relies on the 'class' and 'title' attributes when implemented in (x)html. This page further elaborates that convention by describing how to add RDFa to conformant citations.


Sample sentences:  
Sample sentences:  
*Ephesus demonstrates the potential complexity of ancient Mediterranean urban centers.
* Ephesus demonstrates the potential complexity of ancient Mediterranean urban centers.
*The first chapter of Herodotus is an early example of Greek historical writing.
* The first chapter of Herodotus is an early example of Greek historical writing.
*Herodotus (1.78) gives a brief characterization of the city of Babylon
* Herodotus (1.78) gives a brief characterization of the city of Babylon
* Millar (2001) stresses the polyglot nature of the Roman near east.
* Millar (2001) stresses the polyglot nature of the Roman near east.


With citation markup added:  
With citation markup added:  
*<a class="citation" href="http://pleiades.stoa.org/places/599612">Ephesus</a> ...
* <a class="citation" href="http://pleiades.stoa.org/places/599612">Ephesus</a> ...
* The <a class="citation" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1" title="Herodotus Histories Book 1 Chapter 1">first chapter of Herodotus</a>...
* The <a class="citation" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1" title="Herodotus Histories Book 1 Chapter 1">first chapter of Herodotus</a>...
* <a class="citation" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a> gives a brief ...
* <a class="citation" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a> gives a brief ...
Line 21: Line 21:
The representation of these three types of information can be explored by way of example using the sample sentences defined above.
The representation of these three types of information can be explored by way of example using the sample sentences defined above.
* <a class="citation" rel="dc:references" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a> gives a brief ...
* <a class="citation" rel="dc:references" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a> gives a brief ...
* <a class="citation" rel="skos:definition" href="http://pleiades.stoa.org/places/599612">Ephesus</a> ...
* <a class="citation" rel="dc:references skos:definition" href="http://pleiades.stoa.org/places/599612">Ephesus</a> ...
 
In the second RDFa example, the use of 'skos:definition' makes clear that the resource at 'http://pleiades.stoa.org/places/599612' is not Ephesus itself, but a definition thereof.


==RDFa Pattern 1==
==RDFa Pattern 1==
Line 52: Line 54:
Adding some hierarchy allows for more expressive RDFa
Adding some hierarchy allows for more expressive RDFa
  <nowiki>&lt;span class="citation" rel="dc:references">
  <nowiki>&lt;span class="citation" rel="dc:references">
   <a typeof="dctype:Location"
   <a typeof="dc:Location"
       rel="skos:definition"
       rel="skos:definition"
       href="http://pleiades.stoa.org/places/599612"
       href="http://pleiades.stoa.org/places/599612"

Latest revision as of 12:21, 24 November 2021

The page Citation in digital scholarship describes a convention for making citations that relies on the 'class' and 'title' attributes when implemented in (x)html. This page further elaborates that convention by describing how to add RDFa to conformant citations.

Sample sentences:

  • Ephesus demonstrates the potential complexity of ancient Mediterranean urban centers.
  • The first chapter of Herodotus is an early example of Greek historical writing.
  • Herodotus (1.78) gives a brief characterization of the city of Babylon
  • Millar (2001) stresses the polyglot nature of the Roman near east.

With citation markup added:

Discussion

The 'Citation with added RDFa' convention allows three basic types of information to be added to a citation:

  • The nature of the entity being cited (@typeof). Dublin Core is the default typology. Authors can add their own typology as needed.
  • The reason the entity is being cited (@rel).
  • The relationship of the web-based resource being cited to the underlying concept being invoked (@rel).

The representation of these three types of information can be explored by way of example using the sample sentences defined above.

In the second RDFa example, the use of 'skos:definition' makes clear that the resource at 'http://pleiades.stoa.org/places/599612' is not Ephesus itself, but a definition thereof.

RDFa Pattern 1

Focusing just on the 'a' element, the following RDFa provides additional levels of detail:

 <a class="citation"
    typeof="dc:Text"
    rel="dc:references"
    href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a>

Assuming this snippet is found with a document with the URI http://example.org/article01 that contains the necessary prefix declaration, it produces the following RDF in Turtle format:

<http://example.org/article01>
 []
    a dc:Text ;
    dc:references <hhttp://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78> .

RDFa Pattern 2

If it is clear that an internet-based resource (aka a "web page") provides a description or definition of a cited entity, use:

  <a typeof="dctype:Location"
     rel="dc:references skos:definition"
     href="http://pleiades.stoa.org/places/599612"
      >Ephesus</a>

This produces:

<http://example.org/article01>
 []
    a dc:Location ;
    dc:references <http://pleiades.stoa.org/places/599612>;
    skos:definition <http://pleiades.stoa.org/places/599612> .

RDFa Pattern 3

Adding some hierarchy allows for more expressive RDFa

<span class="citation" rel="dc:references">
  <a typeof="dc:Location"
      rel="skos:definition"
      href="http://pleiades.stoa.org/places/599612"
       >Ephesus</a>
 </span>

Which produces the following RDF/Turtle:

 @prefix dc: <http://purl.org/dc/terms/> .
 @prefix skos: <http://www.w3.org/2004/02/skos/core#> .
 <http://example.org/article01>
    dc:references [
        a dc:Location ;
        skos:definition <http://pleiades.stoa.org/places/599612>
    ] ;

The RDF can be read as saying, "There is a document at http://example.org/article01 that references a location that is defined at http://pleiades.stoa.org/places/599612 ." This is the preferred markup of conformant citations that rely on RDFa to add further information.