{"id":173,"date":"2014-04-24T08:10:16","date_gmt":"2014-04-24T08:10:16","guid":{"rendered":"http:\/\/uahost.uantwerpen.be\/bdmp\/EncodingManual\/?page_id=173"},"modified":"2015-05-18T09:46:27","modified_gmt":"2015-05-18T09:46:27","slug":"special-case-xmlid","status":"publish","type":"page","link":"https:\/\/bdmpmanual.uantwerpen.be\/index.php\/general-remarks\/special-case-xmlid\/","title":{"rendered":"Special Case: @xml:id"},"content":{"rendered":"<p style=\"text-align: justify;\"><span style=\"text-align: justify;\">Some tags will use an <\/span><code style=\"text-align: justify;\">@xml:id<\/code><span style=\"text-align: justify;\"> to refer to a single, specific element. For example, if we &#039;declare&#039; in the <\/span><a title=\"&lt;teiHeader&gt;\" href=\"https:\/\/bdmpmanual.uantwerpen.be\/index.php\/teiheader\/\"><code style=\"text-align: justify;\">&lt;teiHeader&gt;<\/code><\/a><span style=\"text-align: justify;\"> that Samuel Beckett is the author of the transcribed work by typing:<\/span><\/p>\n<div class=\"panel panel-info \"><div class=\"panel-body\"><\/p>\n<p>[xml]\n&lt;author xml:id=&quot;SB&quot;&gt;<br \/>\n\t&lt;name&gt;Samuel Beckett&lt;\/name&gt;<br \/>\n&lt;\/author&gt;[\/xml]<\/p>\n<p><\/div>\n<\/div>\n<p style=\"text-align: justify;\"><span style=\"text-align: justify;\">the computer will know that every time we mention the initials &#034;<strong>SB<\/strong>&#034; as an attribute&#039;s value<\/span><span style=\"text-align: justify;\">, we are referring to Samuel Beckett. To connect these initials back to the <code>@xml:id<\/code>, they have to be preceded by a hashtag (<strong>#<\/strong>). For example:<\/span><\/p>\n<div class=\"panel panel-info \"><div class=\"panel-body\"><\/p>\n<p>[xml]\n&lt;del hand=&quot;#SB&quot;&gt; = CORRECT<br \/>\n&lt;del hand=&quot;SB&quot;&gt;\u00a0= INCORRECT[\/xml]<\/p>\n<p><\/div>\n<\/div>\n<hr \/>\n<h3>Formal requirements:<\/h3>\n<p style=\"text-align: justify;\"><span style=\"text-align: justify;\">For this system to work, every <\/span><code style=\"text-align: justify;\">@xml:id<\/code><span style=\"text-align: justify;\">\u00a0has to be <\/span><strong style=\"text-align: justify;\">unique<\/strong><span style=\"text-align: justify;\">\u00a0(no two occurrences in the same XML-document), and has to start with a\u00a0<\/span><strong style=\"text-align: justify;\">letter<\/strong>. For example:<\/p>\n<div class=\"panel panel-info \"><div class=\"panel-body\"><\/p>\n<p>[xml]\n&lt;seg xml:id=&quot;qdfjkls&quot;&gt; = CORRECT<br \/>\n&lt;seg xml:id=&quot;1qfqdfjk&quot;&gt; = INCORRECT[\/xml]<\/p>\n<p><\/div>\n<\/div>\n<p style=\"text-align: justify;\"><span style=\"text-align: justify;\">The length of the <\/span><code style=\"text-align: justify;\">@xml:id<\/code><span style=\"text-align: justify;\">\u00a0may vary. Also, please do not use any spaces, and only use standard (<\/span><strong style=\"text-align: justify;\">ASCII<\/strong><span style=\"text-align: justify;\">) letters (<\/span><strong style=\"text-align: justify;\">a-z<\/strong><span style=\"text-align: justify;\">; <\/span><strong style=\"text-align: justify;\">A-Z<\/strong><span style=\"text-align: justify;\">), numbers (<\/span><strong style=\"text-align: justify;\">0-9<\/strong><span style=\"text-align: justify;\">), underscores (<\/span><strong style=\"text-align: justify;\">_<\/strong><span style=\"text-align: justify;\">) or dashes (<\/span><strong style=\"text-align: justify;\">&#8211;<\/strong><span style=\"text-align: justify;\">).\u00a0<\/span><\/p>\n<p style=\"text-align: justify;\"><div class=\"panel panel-danger \"><div class=\"panel-heading\">\nImportant!<\/div>\n<div class=\"panel-body\"><\/p>\n<p style=\"text-align: justify;\">While XML syntax demands <code style=\"text-align: justify;\">@xml:id<\/code>s to be unique in the document, the BDMP&#039;s cross-document functionalities require <code style=\"text-align: justify;\">@xml:id<\/code>s to be <strong>unique across\u00a0the entire module<\/strong>. A good way to achieve this is to start each value with a short code for the current document, such as &#039;ts1&#039;, &#039;ms1&#039;, &#039;ts2&#039;, and so on, followed by a random string of characters.<\/p>\n<p style=\"text-align: justify;\"><\/div>\n<\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Some tags will use an @xml:id to refer to a single, specific element. For example, if we &#039;declare&#039; in the &lt;teiHeader&gt; that Samuel Beckett is the author of the transcribed work by typing: the computer will know that every time we mention the initials &#034;SB&#034; as an attribute&#039;s value, we are referring to Samuel Beckett. [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":19,"menu_order":5,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"footnotes":""},"class_list":["post-173","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/bdmpmanual.uantwerpen.be\/index.php\/wp-json\/wp\/v2\/pages\/173","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/bdmpmanual.uantwerpen.be\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/bdmpmanual.uantwerpen.be\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/bdmpmanual.uantwerpen.be\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/bdmpmanual.uantwerpen.be\/index.php\/wp-json\/wp\/v2\/comments?post=173"}],"version-history":[{"count":5,"href":"https:\/\/bdmpmanual.uantwerpen.be\/index.php\/wp-json\/wp\/v2\/pages\/173\/revisions"}],"predecessor-version":[{"id":1383,"href":"https:\/\/bdmpmanual.uantwerpen.be\/index.php\/wp-json\/wp\/v2\/pages\/173\/revisions\/1383"}],"up":[{"embeddable":true,"href":"https:\/\/bdmpmanual.uantwerpen.be\/index.php\/wp-json\/wp\/v2\/pages\/19"}],"wp:attachment":[{"href":"https:\/\/bdmpmanual.uantwerpen.be\/index.php\/wp-json\/wp\/v2\/media?parent=173"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}