Regular issues / Points of attention

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.

Citations

The for reference section at the end of an article or chapter, the <mixed-citation> element is used. When properly tagged, a DOI to the cited publication will be added, resulting from a CrossRef search. The following guidelines should be taken into account for the tagging within the <mixed-citation>-element:

element

guideline

The volume tagging should only contain a volume number and NOT the complete title of the volume. A <volume>-element that contains the complete title will in general block the DOI registration of the publication. As described in the JATS/BITS description, the <volume>-element is for the number only. Below, a sample of correct tagging

Example of correct volume-tagging

<mixed-citation publication-type="book">
	<person-group person-group-type="author"><string-name><surname>Omobowale</surname>, 
		<given-names>Ayokunle Olumuyiwa</given-names></string-name>, and 
		<string-name><given-names>Olufikayo Kunle</given-names> <surname>Oyelade</surname></string-name>
	</person-group>. <date><year>2017</year></date>. 
	‘<chapter-title>Spiritual Embodiment in Yoruba Pentecostalism in Southwestern Nigeria</chapter-title>’. 
	In <person-group person-group-type="editor"><string-name><given-names>Michael</given-names> <surname>Wilkinson</surname></string-name> and 
	<string-name><given-names>Peter</given-names> <surname>Althouse</surname></string-name></person-group> (eds.), 
	<source>Annual Review of Sociology of Religion</source>, 
	vol. <volume>8</volume>: Pentecostals and the Body. 
	<publisher-loc>Leiden</publisher-loc>: <publisher-name>Brill</publisher-name>, <fpage>196</fpage>–<lpage>214</lpage>.
</mixed-citation>

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.

DOI information

The DOI information in a BITS or JATS XML file should only contain the DOI itself, NOT the full URL: For example in a JATS XML-file for an article:

<article-id pub-id-type="doi">10.1163/15685330-bja10082</article-id>

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.

See Article permissions for detailed XML and PDF instructions.

Page tree