This page gives an overview of issues that occur in the XML (and should be avoided) and special points of attention.
Accessibility
Note that following the XML-instructions for both journals and books, it is obliged to add an alternative text to each illustration. This is required to meet relevant accessibility guidelines. As specified the <alt-text>-element should be used. The content of the element is either the caption-text or a dedicated text specified in the manuscript. If both are not present, the author or production editor should be asked to supply at least a caption text.
BOM-marker
Many XML processing applications (such as our Highwire Online platforms) do not process XML with the BOM Marker in place. Files including a BOM marker cannot be loaded. Existence of the marker should be avoided. XML-editors offer different options for avoiding the BOM-marker in the output. in Oxygen for example it is possible to set the in Preferences->"Encoding" the "UTF-8 BOM handling" to "Don't Write". In case of a file with a BOM-marker, the file should be saved again after making this change in the Preferences.
Contributor email addresses
See the dedicated page Contributor email address with samples. The contributor email address triggers the access to the article, chapter or book at the brill.com platform. It is therefore important to ALWAYS include the email address.
Open Access articles
Open access to an article is specified in the <permissions>-group in the XML. Relevant elements are:
- <copyright-statement>
- <copyright-year>
- <copyright-holder> - in general the name(s) of the author(s)
- <license> - to specify the type of open access license in the attributes @license-type, @xlink:href and @xlink:title. (see table below for the values)
- <license-p> - A textual description of the license information
The following table specified the values for the attributes in the <license>-element and the text for the <license-p> element.
| xlink:title | license-type | xlink:href | <license-p> |
|---|---|---|---|
| CC BY | open-access | https://creativecommons.org/licenses/by/4.0/ | This is an open access article distributed under the terms of the CC BY 4.0 license. |
| CC BY-NC | open-access | https://creativecommons.org/licenses/by-nc/4.0/ | This is an open access article distributed under the terms of the CC BY-NC 4.0 license. |
| CC BY-NC-ND | open-access | https://creativecommons.org/licenses/by-nc-nd/4.0/ | This is an open access article distributed under the terms of the CC BY-NC-ND 4.0 license. |
<permissions> <copyright-statement>Copyright 2021 by Shigeko Okamoto</copyright-statement> <copyright-year>2021</copyright-year> <copyright-holder>Shigeko Okamoto</copyright-holder> <license license-type="open-access" xlink:href="https://creativecommons.org/licenses/by/4.0/" xlink:title="CC BY"> <license-p>This is an open access article distributed under the terms of the CC BY 4.0 license.</license-p> </license> </permissions>
