8. Internal Linking
Internal links are cross-links within the article. In jTEI, you can point to other text structures that can have labels, namely
div,
figure (containing either graphics or code examples), or
table. You can link to those structures either with an unlabeled cross-reference in
ptr, or with a labeled link in
ref. Both must have a
type attribute with value
crossref, and a
target attribute, whose value should start with the
‘#’ sign, followed by the
xml:id value of the element it addresses:
<p>
<ref type="crossref" target="#figure2">The following figure</ref> shows a typical example of such a tag document.
<figure xml:id="figure2">
<graphic url="img/tagdoc-p2.png"
width="642px" height="716px"/>
<head type="legend">Tagdoc for <gi>resp</gi> element in P2.</head>
</figure>
</p>
For unlabeled cross-links, the
<ptr type="crossref" xml:id="#link-target"> is replaced with an appropriate label for the link target at rendering time:
<p>
<ptr target="#table2" type="crossref"/> shows allowable <att>rend</att> values and
their equivalent meanings.
</p>
<table xml:id="table2">
<head>Allowable <att>rend</att> attribute values in <ident>tei_corset</ident>
customization</head>
<row role="label">
<cell>
<att>rend</att>
<lb/>(renamed <att>r</att>) <lb/>attribute value</cell>
<cell>Meaning</cell>
</row>
</table>
In the generated ODT and OpenEdition version, the cross-reference is is rendered as:
‘Table X shows allowable @rend values and their equivalent meanings.’Note how internal links are rendered as plain text instead of hyperlinks in the ODT version and the final version in revues.org.
Another type of internal linking consists of bibliographic references, pointing to entries in the bibliography. This should be done with a specific type of
ref element, with value
bibl for the
type attribute. The value of the
target attribute for bibliographic references must point to a
bibl element in the bibliography:
<p>Thomas notes numerous additional developments in the use of computers in historical
study, both in the United States and elsewhere between the 1940s and the early
twenty-first century (<ref type="bibl" target="#thomas04">Thomas 2004</ref>).</p>
<back>
<div type="bibliography">
<listBibl>
<bibl xml:id="thomas04">
<author>Thomas, William G., III</author>. <date>2004</date>.
<title level="a">Computing and the Historical Imagination</title>:
<title level="m">A Companion to Digital Humanities</title>, edited by
<editor>Susan Schreibman</editor>, <editor>Ray Siemens</editor>, and
<editor>John Unsworth</editor>. <pubPlace>Oxford</pubPlace>:
<publisher>Blackwell Publishing</publisher>.</bibl>
</listBibl>
</div>
</back>
Note, how all characters surrounding bibliographic references have to be hard-coded in the text; they are not generated automatically at rendering time. For linking bibliographic references with quotations, see
4.4. Quotations, Inline and Block.