Internal References

Any @xml:id within the file can be pointed to with an element <ref> with a @target attribute. oXygen will not let you enter a double ID, and will pull up a list of @xml:id when you attempt to enter @target or @corresp.

<ref target="#p1"></ref>

Example 1

This example will point to the <msPart xml:id="p1">. You can also use this with content, especially where the text of the link is different from the standard label of the node you want to link to, e.g.

<p>this happens also in <ref target="#q14">the final quire</ref></p>

Example 2

This second method preserves your text and creates a link. However, please note that multiple references will be splitted in several links, so having something like

<p>this happens also in <ref target="#q14 #q15">the final quires</ref></p>

Example 3

will not return the text in the element, but the values of the targets. You can split that reference like

<p>this happens also in <ref target="#q14 #q15"></ref>, the final quires</p>

Example 4

References to other entities in BM

If you are adding a reference, please simply mark it up using <placeName>, <persName>, etc. If you want to refer to another entity in the project but you don’t want to mark up the entity you can use <ref> with @corresp as follows (see also the summary on ref and corresp). This is intended to be useful especially for pointing directly to a particular part of a manuscript description, e.g. a hand or a quire or a part. This should also be used to refer to specific works.

<ref type="mss" corresp="ESap001">AP-001</ref>
<ref type="work" corresp="LIT4018Mashafa"></ref>

Example 5

In @corresp, don’t start with a # but use it if you are referring to a specific part of the quoted manuscript:

This manuscript is in the same hand as <ref type="hand" corresp="ESap002#h2"></ref>

Example 6

Please specify the @type for each reference. Allowed values are encoded in the schema.

External links

You can also use @target to point to external resources. In this case, please enter the full URL, starting with http.

To link to a manuscript in vHMML, please, use the provided permalink in the metadata.

 <ref type="mss" target=""></ref>

Example 7

Canonical text citations and quotations in text

For citations like Matthew 14, 3, use <ref> with a @cRef containing the URN which you can get from the Perseus catalogue searching for the passage. This will link to the Greek text and should therefore only be used when it is actually the Greek text that is intended.

 <ref cRef="urn:cts:greekLit:tlg0031.tlg001.perseus-grc1:14.3">Matthew 14, 3</ref>

Example 8

You can also point to our texts, for example the Ethiopic text of Numbers 21, 8 like this:

 <ref cRef="urn:dts:betmas:LIT2075Number:21.8">Numbers 21:8</ref>

Example 9

To mark up a passage in the text which is a literal quotation of another text you might use a <cit> containing a <quote> and the above <ref>

please note the difference! In this case we say that the passage marked is a quotation of another text, whilest ref is used here and there only to encode the actual canonical reference.

    <quote xml:lang="gez">
         ለሙሴ᎓ ግበር᎓ ለከ᎓ አርዌ᎓ ምድር᎓ ዘብረት᎓ ኵሉ᎓ ዘነሰኮ᎓ ይርአይ᎓ ኪያሁ᎓ ወይሕየው᎓ ኪዮስ᎓
    <ref cRef="urn:dts:betmas:LIT2075Number:21.8">Numbers 21:8</ref>

Example 10

The following example of markup is confusing and should be avoided as it claims that the content of the ref element is a reference, while it is a quote.

ለሙሴ᎓ <ref cRef="urn:dts:betmas:LIT2075Number:21.8">ግበር᎓ ለከ᎓ አርዌ᎓ ምድር᎓ ዘብረት᎓ ኵሉ᎓ ዘነሰኮ᎓ ይርአይ᎓ ኪያሁ᎓ ወይሕየው</ref>᎓ ኪዮስ

Example 11

This page is referred to in the following pages

Revisions of this page

  • Pietro Maria Liuzzo on 2018-04-30: first version of guidelines from Wiki