Peripherals

Top  Previous  Next

Introduction

The following represents a strategy for applying USFM markup to various peripheral content elements which may be prepared for publication in addition to the scripture body text. Peripheral content markup is accomplished through re-purposing the most appropriate existing USFM marker for the current content type.

 

As with scripture text books, an \id marker is used for identifying the content of the peripheral file. Content should be created in separate book files according to the following general groupings. Within each book, divisions (sub-sections) of content are denoted using the marker \periph followed by an additional division argument/title. In practice we find that some back matter content is large enough to require storing it in its own book file (Concordance, Glossary, Topical Index, Names Index).

 

information

USFM 2.0x defined a unique marker for each peripheral content division. USFM 2.1 uses a single \periph marker. Where relevant, the previous 2.0x division marker is listed below in parentheses, following the 2.1 syntax.

Peripheral Books and Content Divisions

Front Matter \id FRT

Introductions \id INT

Back Matter \id BAK

Divisions

Divisions

Divisions

\periph Title Page

\periph Bible Introduction

\periph Chronology

    (USFM 2.0 = \chron)

\periph Half Title Page

\periph Old Testament Introduction

\periph Weights and Measures

    (USFM 2.0 = \wm)

\periph Promotional Page

\periph Pentateuch Introduction

\periph Map Index

    (USFM 2.0 = \maps)

\periph Imprimatur

\periph History Introduction

Additional Back Matter Books

\periph Publication Data

    (USFM 2.0 = \pub)

\periph Poetry Introduction

Concordance \id CNC

\periph Foreword

\periph Prophecy Introduction

Glossary \id GLO

\periph Preface

    (USFM 2.0 = \intro)

\periph New Testament Introduction

Topical Index \id TDX

\periph Table of Contents

    (USFM 2.0 = \toc)

\periph Gospels Introduction

Names Index \id NDX

\periph Alphabetical Contents

\periph Epistles Introduction

Other \id OTH

\periph Table of Abbreviations

\periph Deuterocanon Introduction

Division


 

\periph Cover

    (USFM 2.0 = \cov)


 

\periph Spine

    (USFM 2.0 = \spine)

 

User defined peripheral content divisions:

As needed, a user may add peripheral content for a division not defined in the list above. The new division should begin with \periph, plus a division argument/title. However, USFM compliant publishing applications should use the list presented here as a reference for content to support.

USFM Markup for Peripherals

In the following topics there is a recommendation and a brief description of the USFM markers which will be most appropriate for use in each peripheral content division. The recommended markup is sufficient for most projects and should be used as a first option. However, in general, any of the existing USFM standard markers may be used in addition to the recommended markers, if the required content cannot be adequately encoded.

 

Any non-standard markers used in these books will need to be added to the stylesheet associated with the project.

Authoring peripheral materials within Paratext 6

Paratext 6.1 will include the named peripheral books FRT, INT, BAK, CNC, GLO, TDX, NDX, and OTH in addition to the XXA-XXG set.

 

Paratext 6 supports a set of non-Biblical books, named XXA-XXG. These appear at the end of a project's list of books, and may be used to author non-biblical text for Front Matter (titles, preface etc.), Back Matter (glossary, concordance etc.), or any other kind of text which should logically be stored as part of the translation project.