Navigating Rules and Macros in the Tree
When text link analysis is performed during extraction, the text link rules stored in the library selected in the Text Link Rules tab will be used.
Unlike the other advanced resources, TLA rules are library-specific; therefore, you can only use the TLA rules from one library at a time. From within the Template Editor or Resource Editor, go to the Text Link Rules tab. In this tab, you can specify the library in your template that contains the TLA rules you want to use or edit. For this reason, we strongly recommend that you store all your rules in one library unless there is a strong or specific reason this isn't desired.
You can specify in which library you want to work in the Text Link Rules tab by selecting that library in the Use and store text link analysis rules in: dropdown list in this tab. When text link analysis is performed during extraction, the text link rules stored in the library selected in the Text Link Rules tab will be used. Therefore, if you defined text link rules (TLA rules) in more than one library, only the first library in which TLA rules are found will be used for text link analysis. For this reason, we strongly recommend that you store all your rules in one library unless there is a very specific reason this isn't desired.
When you select a macro or rule in the tree, its contents are displayed in the editor pane to the right. If you right-click on any item in the tree, a context menu will open to show you what other tasks are possible, such as:
- Create a new macro in the tree and open it in the editor to the right.
- Create a new rule in the tree and open it in the editor to the right.
- Create a new rule set in the tree.
- Cut, copy, and paste items to simplify editing.
- Delete macros, rules, and rule sets to remove them from the resources.
- Disable macros, rules, and rule sets to indicate that they should be ignored during processing.
- Move rules up or down to affect processing order.
Warnings in the tree
Warnings are displayed with a yellow triangle in the tree and are there to inform you that there may be a problem. Hover the mouse pointer over the faulty macro or rule to display a pop-up explanation. In most cases, you will see something such as: Warning: No example provided; Enter an example so you need to enter an example.
If you're missing an example, or if the example doesn't match the rule, you will not be able to use the Get Tokens feature so we recommend you enter just one example per rule.
When the rule is highlighted in yellow it means that a type or macro is
unknown to the TLA editor. The message will be similar to: Warning: Unknown type or
macro. This is to inform you that an item that would be defined by
$something
in the source view, for instance $myType
, is not a
legacy type in your library, nor is it a macro.
To update the syntax checker you need to switch to another rule or macro;
there is no need to recompile anything. So, for example, if rule A
displays a
warning because the example is missing, you need to add an example, click on either an upper or
lower rule, and then go back to rule A
to check that it is now correct.