Authoring and Suite Naming Rules

  1. All XML names originating this Tag Set or in the Suite are to be in lower case. (Names include element names, attribute names, entity names, and IDs. Notation names are taken from elsewhere and may be in mixed case.)
  2. When two or more words are concatenated into an element name, a hyphen will be placed between the whole words (for example, <verse-group>, <article-title>, <page-count>).
  3. The typographic emphasis elements are spelled out in full — <bold>, <italic>, <underline>, etc. — not put in as values of an attribute on an element such as <emphasis>. (Superscript and subscript are not considered to be purely typographic, and each is a separate element: <sub> and <sup>.)
  4. The casing and interior punctuation of element type names and attribute names inherited from PUBLIC models (such as the XHTML table model or the MathML Tag Set) are unchanged. Thus, for example, the Horizontal Rule element is <hr>, and the table cell tags are <td>, <tr>, <tbody>, <thead>, etc.
  5. Abbreviations may be used when words are used in combination. When a word stands alone as a name, it is not abbreviated. Thus, the element Conference Information uses the full name <conference>, but the conference combinations (such as Conference Theme and Conference Number) use the abbreviation “conf” (<conf-theme> and <conf-num>).
    The following table contains a growing list of abbreviations to be used in combined tag names (element type names), attribute names, and Parameter Entity names. (Words in the list below that are not abbreviated are displayed in italics.)

ORIGINAL WORD ABBREVIATION/USAGE
acknowledgment ack
abstract abs
address addr
affiliation aff (common journal Tag Set usage)
alternate/alternative alt
article article
attribution attrib
author author
biography bio
chemical chem
communication communication
conference conf
contributor/contribution contrib
corresponding corresp
count count
cross x (no hyphen; well known)
definition def
description desc
display disp
editor editor
end end
equal equal
external ext
figure fig
first f (no hyphen; <fpage> well known)
footnote fn (traditional business abbreviation)
formula formula
government gov
graphic graphic
group/grouping group
heading/header head
identifier/ID id
inline inline
institution institution
item item
journal journal
keyword kwd
last l (no hyphen; <lpage> well known)
link link
list list
location loc
material material
metadata meta
number num
page page
paragraph p (well known)
prefix prefix
proceedings proceedings
publication pub
publisher publisher
quote quote
reference ref
related related
section sec
sequence/sequential seq
series series
size size
standard std
start start
statement statement
structure struct
subject subj
subscript sub (note: not inferior)
suffix suffix
superscript sup (note: not superior)
supplement supplement
supplementary supplementary
table table
title title
translated/translator trans
type type
underline underline
version version
volume vol
word word
wrapper wrap