Updates, identifiers and versions

To update existing XML you must ensure that id values are maintained correctly.

Do not change id values when you update an XML file. Use the id attributes provided by the OUP. Do not alter them.

Additional id attribute rules for updates:

If a new version has been restructured so that sections change levels, for example a div2 or an item2 becomes a div3, then use new id values incorporating the changed element name.
When you add new elements to an existing file, assign the new elements a new unique id value from the next available number, regardless of where the new element is appearing in the file. This results in non-sequential numbers in the elements but this is not important. It is more important that the existing elements do not change id numbers from one version to the next.
If some id values become vacant, for example when an element is removed in a newer version, do not reuse these values for additional elements elsewhere in the document. Instead use the next available number which is higher than the highest number used in the previous version.
If a single section is split into multiple sections (with roughly the same text), use the old section id value for the first of the new sections (provided that the element name has not changed), and use new id values for the additional sections. Do not change the values of id attributes on elements within the sections (such as bibItems) if they correspond directly to elements in a previous version.

Example identifiers for small content change

Element in original:


      <bibItem id="law-iic-153-2001-bibItem-5" class="forDom" date="1988" idnumber="need full cite" linkType="mentioned only in headnote" title="1988 Moldavian law on Budget">
        <bibItemTitle id="law-iic-153-2001-bibItemTitle-5">1988 Moldavian law on
          Budget</bibItemTitle>
      </bibItem>

Element in revised version (id values unchanged even though content has changed):


      <bibItem id="law-iic-153-2001-bibItem-5" class="forDom" date="1988" idnumber="need full cite" linkType="mentioned only in headnote" title="Law on Budget">
        <bibItemTitle id="law-iic-153-2001-bibItemTitle-5">Law on Budget</bibItemTitle>, 1988
        (Moldova)</bibItem>

Example element identifiers for additional div2

Element and context in original chapter


      <chapter id="med-9780199204854-chapter-3" doi="10.1093/med/9780199204854.001.1">
        <textMatter><div1 id="med-9780199204854-chapter-3-div1-2">
 <titleGroup id="med-9780199204854-chapter-3-titleGroup-48">
   <title>
     <p>Essentials</p>
   </title>
 </titleGroup>
 <div2 id="med-9780199204854-chapter-3-div2-12">
   <titleGroup id="med-9780199204854-chapter-3-titleGroup-49">
     <title>
       <p>Functional anatomy of the cardiac myocyte</p>
     </title>
   </titleGroup>
   <p>Cardiac myocytes are the ...</p>
 </div2></div1>
        </textMatter>
      </chapter>

Element and context in revised version after a 2nd div2 is added


      <chapter id="med-9780199204854-chapter-3" doi="10.1093/med/9780199204854.001.1">
        <textMatter><div1 id="med-9780199204854-chapter-3-div1-2">
 <titleGroup id="med-9780199204854-chapter-3-titleGroup-48">
   <title>
     <p>Essentials</p>
   </title>
 </titleGroup>
 <div2 id="med-9780199204854-chapter-3-div2-12">
   <titleGroup id="med-9780199204854-chapter-3-titleGroup-49">
     <title>
       <p>Functional anatomy of the cardiac myocyte</p>
     </title>
   </titleGroup>
   <p>Cardiac myocytes are the ...</p>
 </div2>
 <div2 id="med-9780199204854-chapter-3-div2-13">
   <titleGroup id="med-9780199204854-chapter-3-titleGroup-50">
     <title>
       <p>Cardiac action potential</p>
     </title>
   </titleGroup>
   <p>There is a potential difference (the membrane ...</p>
 </div2></div1>
        </textMatter>
      </chapter>