Preferences

Several aspects of NuGram IDE can be customized using Eclipse Preference pages.

The main page essentially displays a logo and the version number of NuGram IDE.

Conversion tool preferences

The Conversion Tool page provides preferences that affect the behavior of the grammar conversion tool.

These preferences include:

• Formatting options, to control whether generated grammars must be pretty-printed or not.
• The default output format for the grammar converter, either GrXML, GSL or both format. (Profession Edition only)

Editor preferences

The Editor page provides preferences that affect the creation and editing of ABNF source grammars:

These preferences include:

• The handling of TAB characters, whether they should be replaced with spaces (and how many such spaces) or left as is;
• The UI mode for the refactoring tools (linked mode shows as small boxes around elements that must have the same name, like rule names), and the default keyword for rules created by the refactoring tools;
• Default values for some properties of newly-created ABNF grammars: language, file encoding, mode (dtmf or voice), and tag format.
• A flag indicating whether a coverage file is automatically created when creating a new ABNF file.

Note that the default tag format is also used when interpreting sentences with grammars that do not specify an explicit tag format.

Editor appearance

The Appearance page provides preferences that affect the appearance of the ABNF source grammars:

These preferences include:

• The color of the delimiter matcher, which appears as a small box around the matching delimiter of the delimiter at the left or right of the cursor position;
• The background color of the editor;
• The color and style (bold, italic) of the various elements of an source grammar (keywords, quoted words, semantic tags, etc.).

Contexts synchronization

The Synchronization page provides preferences that affect the way the coverage contexts are updated when an ABNF grammar is saved:

The two options are:

• Automatically synchronize variables when saving the ABNF grammar - the contexts in the coverage editor are updated automatically when the corresponding ABNF grammar is saved, removing unused variables from the context and adding global variables referenced in the grammar that are not already in the context;
• Manually synchronize variables via the coverage editor - the contexts are synchronized using the coverage editor only when requested by the developer.

Validations

The Validations page provides preferences that affect the level of feedback for a number of validations offered by the ABNF editor.

These preferences include:

• Tag-format header not specified - feedback given when a grammar does not specify the tag-format header (one of ignore, warning, or error).
• Grammar resource does not exist - feedback given when an external rule reference points to an non-existent resource (one of ignore, warning, or error)
• Lexicon resourse does not exist - feedback given when a lexicon header referenced a resource that does not exist in the project (one of ignore, warning, or error)
• Root rule is private - feedback given when a grammar specifies a root rule that is declared as private (one of ignore or warning)
• Private rule not used - feedback given when a private rule is not referenced elsewhere in the grammar (one of ignore or warning).

Changes to these preferences are only effective when a new grammar is opened or an already opened grammar is modified.

Grammar Content

The Crammar Content page provides an interface to configure the grammar types associated with specific grammar extensions.

To associate an extension with a grammar type, press the Add... button and enter the extension:

Then select the appropriate content type in the Content column:

Language Extensions

The Language extensions page provides preferences that affect a number of extensions to the standard SRGS/SISR languages.

These preferences include:

• Target ASR Engine - use to enable features for a specific speech recognition engine. The current values are:
  • none - to disable all ASR-specific features.
  • LumenVox - to enable LumenVox phonetic spellings inlined in the grammar (of the form {phonemes:Word}).
  • Loquendo - to enable the various word separators supported by the Loquendo ASR engine (essentially used at grammar conversion time).
  • OSR - to enable some OSR-specific rules when converting grammars to GrXML.
• Enable Nuance 9 SWI objects - checking this option enables the use of SWI objects in SISR mode, as defined by the Nuance 9 documentation.
• Enable pre-SISR compability mode - checking this option enables an alternate syntax for referring to rule variables and meta information, as defined in the 2004 Working Draft of the SISR specification.

The Licensing page provides preferences to manage the license needed to run NuGram IDE.

Set the directory where the provided license resides using the License directory field.

Professional Edition only: To request a new license, press the Generate Request File button, enter the name and location of the file containing the license request, then send the request at nugram-support@nuecho.com.

The Publishing page provides preferences that affect the publishing of grammars on the Grammar Server:

The main preferences are:

• The base URL of the Grammar Server (its address).
• A valid username on the Grammar Server.
• The password associated with the username.

There are also three other preferences that affect the folder publishing tool:

• Use the project name containing the base folder as the default application name - when publishing a folder hierarchy within a specific application folder, the default application name can be set to the containing project name.
• Insert the base folder before the published grammar hierarchy - the name of the folder selected when the publishing tool is started can be inserted between the application name and the root of the grammar hierarchy (if these are to be incorporated in the grammar name) within the grammar names published on the server (this is not the case by default).
• Flatten grammar hierarchy when publishing - the folder name can be omitted from the published grammar name. Note that this is generally undesirable when grammars refer to each other.

Sentence Generator

The Sentence Generator page provides preferences that affect the generation of sentences:

These preferences include:

• The number of sentences that are generated simultaneously.
• The maximum number of repetitions for grammar items specifying and unbounded number of repeats.