XML representation of Unified Standard Format Markup Scripture files. This schema is intended for use with Holy Bible files only. This schema is copyright 2005-2006 EBT and SIL; released under the Gnu Lesser Public License or the Common Public License, as explained in LICENSING.txt.

Three-letter Ethnologue code or two-letter ISO language code, optionally followed by a dialect indicator.

Remark or comment, not for publication.

This element contains one book of the Bible or optionally some front or back matter. The id attribute is for the three-letter code for this book of the Bible (or FRT for front matter and BAK for back matter).

From the \id marker line. The first three characters of the contents of this element MUST be the three-letter code for this book of the Bible (or FRT for front matter and BAK for back matter).

Encoding of the corresponding USFM file. (Encoding of this XML file is given in the XML header.)

Remark or comment, not for publication, such as notes about translation status.

Short book name for a running header, like "Matthew".

Chapter label, like "Chapter" or "Psalm" in the target language. If used, this label should be placed before any chapter start labels.

The p element contains not only the \p marker's contents, but also every kind of paragraph and heading or title. If this is used for something other than \p, then the sfm attribute MUST be set to indicate which kind of paragraph, or heading is intended. Headings, and paragraphs are in the same group because they all correspond to paragraphs in a word processing document. This element includes \ps, \psi, and \nb. Note that some common paragraph elements (q, d, and s) could have been included in this element, too, but have their own element tags for convenience in manual editing of the XML.

Poetry line "paragraph"

The main title of a book of the Bible, such as "The Good News According to Matthew"

Descriptive title of a Psalm (Hebrew title)

Section heading (not part of the Scripture text).

This marker is a place to encode proposed markers such as \pub, \toc, \pref, \conc, \glo, \idx, \cov, \spine, \and environment markers. 

Blank line between stanzas of poetry; not to be used before or after a section header. This element should be empty.

This element surrounds content generated from other elements. This tag and its contents is discarded when converting back to USFM.

Chapter starting point. It contains the chapter number, possibly with a chapter name designator, NOT the whole chapter. The chapter number itself should be specified in the id attribute, and is used to generate the contents of the tag, which are optional and may be discarded.

This type consists of the mixed text and tags that can appear inside any paragraph.

This element contains the chapter starting point MARKER, NOT the chapter itself. The chapter is assumed to end at the beginning of the next chapter or at the end of the book element. The marker is normally generated from the id attribute, overwriting whatever this element contained before.

The v element contains the verse starting point, NOT the verse itself. The contents of this element are generated automatically from the id attribute, and may be just a verse number or verse range, possibly with formatting information (like bold and superscript).

Quoted text; Old Testament quotes in the New Testament or other quoted text, such as Jesus' direct quotes. The who attribute may be used to distinguish between these, but USFM makes no distinction. This markup may result in a different character formatting.

Name of Diety: used only to mark God's proper name or a translation of this Name. This may result in special character formatting, such as small caps.

Transliterated or foreign words.

This marker can be used to encode any standard format marker not corresponding to a specific element with its own name. This should only be used if there is no other suitable element to use for your application within this schema.

Alternate chapter numbering scheme chapter start marker

Published chapter marker, which may be used to override the numeric marker generated from the c element.

Alternate verse number (starting point).

Published verse marker (starting point); overrides marker generated from v id attribute.

Special marking for "Selah." in the target language. This may cause right alignment of this word or phrase in an otherwise left-aligned or fully justified paragraph, or may have no effect.

This is intended to mark the first character of a line of acrostic poetry, which may result in the letter being rendered in bold face or may have no effect.

Table (i. e. for tables of weights and measures in helps).

Row

Table column heading

Table column heading, right aligned

Table column entry within this row. The level attribute gives the position of the column.

Table column entry, right justified. The level attribute gives the position of the column.

This element contains material that was automatically generated from another marker, such as drop cap actual implementation at the start of verse 1 from an earlier \c tag.

Footnote

Footnote reference: the chapter and verse that this note refers to, to be printed (normally at the beginning of the note).

Footnote keyword; the specified word(s) for which the footnote is being provided.

Quotation from the Scripture text; the current and/or alternative translation of a portion of the Scripture.

Alternative translation (may be rendered differently than fq to distinguish between current and alternative readings, if desired).

Footnote verse number; a verse number in the text of the footnote.

The actual text of the footnote. This is equivalent to text not enclosed in an element within f.

The text within this element is to be omitted in editions not containing the Deuterocanon.

Manually designated footnote mark -- NOT RECOMMENDED FOR USE.

Crossreference: a footnote used just to indicate a crossreference. It may be positioned differently than footnotes designated with f, and it may use different calling sequences than f does.

Cross reference origin; the chapter and verse location the target references refer to.

Cross reference keyword

Quotation from the Scripture text.

Target references; a list of the target cross references for the origin reference.

Omit for editions not containing the Deuterocanon.

Passage of text based on a secondary language source. For example, places where the source text is in Aramaic and not Hebrew could be optionally rendered with a different type style.

Omit in editions not containing the Deuterocanon. Deuterocanonical/LXX additions or insertions in the Protocanonical text. May optionally be rendered differently.

Quoted book title; may toggle italics setting in introductory material.

Proper name; may map to a character style or be ignored.

Keyword-- may map to a character style or be ignored.

Ordinal number ending; may be superscripted and underlined.

Additional material; supplied words to make sense in a target language when the translation style is very literal. This would be used to mark the italics in the KJV, for example.

Signature of the author of an epistle, such as "Greetings from Paul." This may or may not be rendered differently.

Bold; not recommended for use.

Italic; not recommended for use.

Bold Italic; not recommended for use. Note that character styles do not stack. Only one may apply at a time.

Smallcap text; not recommended for use. Use nd or other appropriate element instead.

Normal text within other formatting: not recommended for use.

Figure suggestion for illustrations, figures, and maps. The subelements of this element must appear in the order given, as they appear in this order within one \fig ... \fig* container, separated with vertical bars (|).

Picture description in English.  This material does not show up on the printed page.

Picture catolog identification or file name. This material does not show up on the printed page.

Picture size for calculation only (not printed).

Picture location/range Book, chapter, and verse (not printed).

Picture copyright info (printed)

Picture caption to be printed.

Picture reference (book, chapter, and verse) to be printed.

Index entry-- not printed as part of the text.

Word list entry-- not printed as part of the text.

Hebrew word list entry-- not printed as part of the text.

Greek word list entry-- not printed as part of the text.

Worldlist/glossary/dictionary reference. This word is to appear in the word list.

This element does not map to any USFM element directly, but its contents do. Its purpose is to facilitate conversion to/from OSIS, XSEM, or similar markup. This corresponds to an OSIS q element with an sID attribute, except that this element contains exactly the quotation punctuation intended by the translator, and which is copied directly into USFM text. It is used in combination with quoteEnd and quoteRemind. All conformant USFX readers are expected to simply use the contents of this element (normally a quotation mark) as part of the text, unless that reader is part of a process to generate or regenerate quotation marks from markup. When converting from OSIS or XSEM, it is the duty of the converting process to supply the correct quotation punctuation, if any, and put it in the contents of this element. When generating or regenerating quotation punctuation from markup, the existing contents of this element are discarded and replaced with the correct punctuation. If the who attribute is set to "Jesus" the import process may optionally generate \wj markup, as well.

This element contains automatically generated open quote reminders at paragraph beginnings. It would normally be generated automatically from quoteStart and quoteEnd elements.

This element ends the most recent un-ended quotation started with quoteStart. This is not a USFM equivalent code, but exists to facilitate conversion to/from OSIS. See the comments for quoteStart for usage.

Introduction outline references range character style

Words of Jesus

Character style

Footnote hyperlink start-- not part of USFM, but equivalent to the GBF RB tag.

This is a milestone (normally empty) element that indicates that the previous word (usually "you" or a verb with an implied "you") is addressed to more than one person. Not in USFM. Equivalent to GBF WTP.

Milestone marker to indicate that the immediately previously mentioned person (name or pronoun) is being addressed directly (first person). Used for some semiautomatic translation applications. Not in USFX; equivalent to GBF WTf.

Chapter label, like "Chapter" or "Psalm" in the target language. If used, this label should be placed before any chapter start labels.