To set or change the Standard Format Marker set used by Adapt It do the following steps:
Select Preferences… from the Edit menu. (You must have a document open).
The Preferences dialog appears (see an illustration of the Preferences dialog).
Select the USFM tab.
The USFM page appears (see an illustration of the USFM tab).
The USFM page displays three groups of settings:
Settings for the current document on the left
Default settings for the current project in the middle
Default factory settings on the right
You can change the current document's settings and the current project defaults, but you cannot change the factory defaults.
The remaining steps assume you want to change the SFM set for the current document (the left set of buttons), but the steps apply equally well to the project defaults (middle set of buttons).
Do one of the following:
Click on UBS USFM 2.0 Set Only to use the USFM set of markers exclusively.
Click on SILPNG 1998 Set Only to use the older SIL Papua New Guinea set of markers exclusively.
Click on Both UBS and SILPNG to use both the USFM set and the older SIL PNG set of markers. (not recommended)
Click OK to make any SFM set change effective, or Cancel to quit without making any changes.
If you change the SFM set, Adapt It automatically rebuilds the document so that the new set of markers is recognized and laid out appropriately for adaptation.
An arbitrary change in SFM set may result in a number of standard format markers in the document being unrecognized or unknown to the newly selected SFM set. Unknown markers will appear between question marks (?\xx?) in the navigation text line, the text associated with unknown markers will appear in a red colored font in the source text, and all unknown markers appear in the document's filter settings list with [UNKNOWN MARKER] as their description.
If by accident or while testing, you switch the SFM set to a selection that causes many markers to be unrecognized, simply return to the Preferences USFM tab again and select the more appropriate SFM set of markers.
You may use the Both UBS and SILPNG setting as a temporary measure if you want Adapt It to recognize markers from both sets. This might be helpful if an input text was only partly converted during a changeover from the SILPNG set to the UBS USFM set. Be aware, however, that there are a half dozen or so markers which conflict with each other, notably the \fe marker which means "begin endnote" in the UBS USFM 2.0 set, but means "end of footnote" in the SILPNG set. Adapt It resolves conflicts in favor of the UBS USFM 2.0 marker set, but the result may not be what you expected. For this reason it is advisable to create documents that use one set of markers throughout, and avoid using the Both UBS and SILPNG setting.
If the text has footnotes or endnotes, you should ensure that all instances of footnotes and endnotes are marked correctly according to the USFM standard before using the data to create an Adapt It document.
If you've been using the SILPNG set of markers but choose to switch to USFM 2.0 with new documents you create, you can change the SFM set at any time to UBS USFM 2.0 Set Only to recognize and fully utilize those markers.
Version 3 of Adapt It uses the newer USFM set by default for new projects and new documents. See USFM Overview for more information.
If you have upgraded Adapt It from version 2 to version 3, the first time you open the old version 2 files (files with an .adt extension) using version 3, Adapt It assumes your documents were created with version 2 which only supported the PNG SFM set. You can continue using the PNG SFM set with version 3.
Changes involving the Standard Format Marker (SFM) set should be made here in the USFM page before making any Filtering changes in the Filtering page.
Normally the SFM set will be the same for all documents in your project, so This Document's Settings (the left set of buttons) will normally have the same button selected for its SFM set as the selection in the Project Defaults (the middle set of buttons). You may make the current document's SFM set different if you wish, but you should eventually insure that all documents in a project use the same SFM set that the overall project uses.