β Paratext 8: Understanding USFMs

ParaTExt uses tags called USFMs to identify the different parts of the Biblical text. This module explains USFMs in detail.

Introduction

Video: Understanding USFMs

Watch the video:

Here is a link to the documentation on USFMs which was mentioned in the video.

 

Which of the following is a USFM tag used in ParaTExt?

  • <v>
  • \v
  • \v\
Click on the answer you think is correct.

Which of the following are true about USFMs?

  • USFM tags indicate the different parts of the Bible text.
  • ParaTExt uses USFMs to identity chapters and verses, which allow for navigation around the text.
  • All ParaTExt users should memorize the list of USFMs used in their project.
  • There are masses of markers in a typical ParaTExt project.
  • You can make up your own USFM tags.

USFM tags consist of

A USFM always starts with a . This is followed by the  which specify which marker it is. Finally there is either a  or, for a closing marker, a  which signal the end of the marker. 

How to add markers in different views

Watch the video

Learn about adding markers. The different views in ParaTExt provide different ways to view and add markers.

 

 

How do you add a paragraph marker?

  • Backslash key
  • Enter
When you want to add a paragraph type marker, what key should you press on the keyboard?

How do you apply a character marker to one word, such as a divine name?

  • Select the word.
  • Press backslash (\).
  • Select the marker you want to apply.
Imagine you are in Standard View. Put the following steps in the correct order to apply a character marker to a word:

Which view is recommended?

  • Preview
  • Basic
  • Formatted
  • Unformatted
  • Standard

Which of the views is recommended for everyday use when editing and drafting? Select the name of the view in the list below the screenshot.

The standard view is recommended for editing because...

  • You can see both the markers and the formatting.
  • The markers are visually distinct from the text.
  • There are tools which help you add markers.
  • All of the above.
(select the best answer)

Identify a closing marker

Find one of the closing markers in the following screenshot. Click it. 

Add closing marker

A closing marker is needed in the location indicated by the red arrow in the screenshot below. The backslash key (\) has been pressed at that location and the USFM pop-up menu is shown. 

What marker should be chosen? Click on the correct marker in the menu.

Which view would you select to see the scripture without USFMs but still be able to edit the text?

On the screenshot below, click on the option in the View menu that would load a view which hides the USFM tags but still allows you to edit the text.

Identify characteristics of a particular view

  • This is Basic View.
  • This view depends on someone having set up the markers needed for you ahead of time.
  • This view allows you to add markers.
  • This view allows you to add and edit the scripture text.

Look at the following screenshot. Then select all the statements below which you think are correct.

Facts about views

  • Once you are in a view you must use that view for the duration of your entire project.
  • Standard view and Formatted view provide tools to help you add USFMs.
  • Standard view and Formatted view show the effect of the USFMs on the formatting of the text.
  • Unformatted View does not include the tools to help you add USFMs.
Select all the statements you think are correct. 

Other useful things to know about USFMs when editing

Video: If your keyboard does not have a backslash key

 

Typing backslash

  • If your keyboard does not have a backslash key, hard luck.
  • If your keyboard does not have a backslash key, ParaTExt has a menu option and an alternative key to help you.
  • The menu option to type a backslash character is under the Insert menu.
  • The menu option to type a backslash character is under the Edit menu.
  • You can find out what the alternative key is on the menu.
Select all the statements below that you think are correct.

Video: How to insert a verse number

 

How to enter verse numbers

Match the sentence fragments below which specify the best time to use each way of entering verse numbers.
  • When you need to add many verse numbers through to the end of a chapter
    use Insert > Verse Number (or Ctrl+K).
  • When you need to add a one-off verse number in the middle of a chapter
    open the USFM pop-up menu with \, select v, and then type the appropriate verse number.

What is wrong?

  • The word has been typed in the wrong language.
  • The verse number is missing.
  • The spacing is wrong.

In the following screenshot, why is the word highlighted in the red box shown in small, superscript text? What is wrong?

What is wrong?

  • It is the wrong verse number.
  • The space is missing after the marker \v.
  • ParaTExt has detected that the verse marker and number are in the wrong place.

In the following screenshot, why is the verse marker and number shown  in red? What is wrong?

Video: Markers for non-Biblical text and how to remove a marker

 

Markers for introductions and headings

  • You use the same marker to mark paragraphs in an introduction as in the Bible text.
  • There are special, different markers which identify text in non-Biblical text such as introductions and sections headers.
  • Paragraphs in an introduction are marked with \ip instead of \p.
Select all the statements you think are correct.

Which approach is correct?

Examine the two screenshots below. Click on the magnifying glass icon to view each picture full size. 

Which picture shows the correct approach when using the Toolbar Marker menu to remove a set of markers? Click the correct picture.

Which approach is correct (hotspot experiment)

Examine the two screenshots below. Which picture shows the correct approach when using the Toolbar Marker menu to remove a set of markers? Click on the correct picture then click "Submit."