Understanding how the Labeler works with your project

Core Concepts

  • A project’s Term Renderings is where the Labeler will look for text to use in labels.
  • Wherever possible, it looks for the term ID as used in Paratext’s Major Biblical Terms list, generally a single Greek or Hebrew word. E.g. Ναζαρά for Nazareth.
  • In some cases, a label such as “Mediterranean Sea” does not have a corresponding word in the source texts, and so a term ID like “mediterranean_sea” is used instead. This is fairly transparent to the user.
  • You store your labels in the Term Renderings so that they will be automatically available on other maps and diagrams. The color-coded statuses will help to ensure that you’ve done this consistently. However, you are free to export and use labels no matter what status they have. You may have valid reasons not to match the label used for the same location on a different map. E.g. A place is labeled “Mizpah” on one map, but “Mizpah of Moab” on another. But the status will at least make you aware of the difference.

Saving Your Work

There are two ways that you can save diagram labels for later use:

Method 1: IDML Data Merge Files

You can export all the labels for a diagram into an IDML data merge file, which is the format from which you could merge them into an IDML diagram. It is recommended that you save these in the shared\labeler folder within your project folder, so that they are included in your send/receive.

Method 2: USFM Representation

You can save the USFM representation of the diagram in any appropriate location in your Paratext project, just like you do with \fig fields to store illustration information. (It is not tied to chapters and verses in an XX book, as was the case with the Scripture Map Labeler.) For this, you must currently copy and paste between the USFM in/out control and your Paratext project. (For the Paratext 10 extension, this would be automatic.) However, the USFM representation has not been finalized, and may change, so it’s recommended that for the time being, you store your diagram labels in IDML data merge files.

Map Collections

Multiple organizations may distribute collections of maps and other diagrams, and the Labeler will be able to work with any of them, as well as with custom, private collections.