<< USFM Documentation Contents
Recent Changes
Marker Addition (June 2006) - 2.05
- Add \rq for marking inline quotation references.
October 2005 - USFM 2.04
Marker Additions
- Add \toc3 for providing the standard abbreviation for a book.
August 2005 - USFM 2.03
Marker Additions
- Add \toc1, \toc2 for providing and marking long and short Table of Contents texts.
- Add \fl for marking footnote "label" text items.
- Add \fp for marking footnote additional paragraphs.
October 2004 - USFM 2.0
The following sections outline changes in USFM from 1.53 to 2.0.
Marker Changes/Adjustments
- Remove \pdi and \pde, and substitute with embedded text markup (under additions, below)
- Remove \wr ...\wr*. This was really a duplicate of \w ...\w* used for marking words in the scripture text which are included in the wordlist.
- Remove \ps. This is used in conjunction with \nb to indicate that the paragraph spans the chapter boundary. It should be sufficient to just start the new chapter with \nb and use the appropriate paragraph marker for the previous chapter (\p, \m etc.)
Marker Additions
- Add character style \em ...\em* for 'emphasis'.
- In Peripheral Materials:
- Add \intro section to Front Matter (in addition to Preface).
- Add \maps (Maps Index) section to Back Matter.
- Paratext will be adjusted to include predefined "standard" books for FRT, BAK, and OTH rather than using the book names XXA, XXB, and XXC for these materials.
- Add \sr for marking the text references range listed under a section heading \s.
- Add the following markers for "embedded text" (see example references – not all versions mark these items the same).
- \pm - Embedded text paragraph
- \pmo - Embedded text opening
- \pmc - Embedded text closing
- \pmr - Embedded text refrain
- \qm# - Embedded text poetic line
- Add character style \pro ...\pro* for indicating pronunciation (in CJK texts).
- Add character style \wj ...\wj* for marking words of Jesus.
Marker Definition Clarifications
- When using \fm ...\fm* (footnote mark) to reference footnote text used earlier in the current book, specify chapter and verse within the markup when markers have not been predefined (i.e. when the \f + format is being used). Please note that \fm ...\fm* is really only appropriate for duplicate notes occurring very nearby to the original note text (likely on the same page) – otherwise the footnote text should be repeated.
- \<xx># (representing any USFM marker which includes a number option).
In USFM the number indicates:
- A portion of a complete element, or relative weighting of the "pieces", such as \mt1, \mt2, \mt3 which are all parts of a major title.
- The level of division (hierarchy).
- The level of indentation relative to other like elements, as in poetry (\q#) or lists (\li#) or outlines (\io#).
- # should not be used to indicate a specific occurrence in scripture of the element type.