Okapi Components
DNL List Editing Utility
|
|
- The utility set identifier for this utility is: oku_set04
- The utility identifier is: dnllistedit
The DNL List Editing utility allows you to create and modify Do-Not-Localize (DNL) lists. A DNL list is associate to an input file and enumerate strings that should not be localized but would be otherwise extracted. DNL lists should be the last resort to identify non-localizable text, you should try first to use the filter options or the localization directives to identify such text.
Note
Not all filters support DNL list, and among the ones which do, not all provide
visual context to edit the lists. Note also that the text highlighting in the
context window may not be exact all the time: the position information provided
by the filters are sometimes a bit incorrect because of various factors
(unwrapping, line-breaks handling, encodings, etc.)
The common parameters are the options specified from the application calling the utility rather than in the options dialog box of the utility itself. For this utility the common parameters you need to specify are the following:
| Files of the first input list | - Needed (the files to process) |
| Root for the first input list | - Not Needed |
| Files of the second input list | - Not Needed |
| Root for the second input list | - Not Needed |
| Files of the third input list | - Not Needed |
| Root for the third input list | - Not Needed |
| Input language | - Needed |
| Output language | - Not Needed |
| Input default encoding | - Needed |
| Output default encoding | - Not Needed |
| Location and names for output files | - Not Needed |
Instead of using a list of input files, you can also edit DNL list using a single session file as input. session file can be save when you are in the process of editing a DNL List. This way you can stop at any time and re-start the editing at the same place and with the same list of input files as in the prior session.
The DNL List Editor window is separated in two parts: The list of the entries in the current file at the top, the Context pane at the bottom. As you move the cursor from one entry to the next in the list, if available, the corresponding original text is highlighted in the Context pane. Note that not all filters provide enough information with the extracted items to be able to show the context.
The following commands are available:
File | Save DNL List -- Saves the current choices in a DNL file corresponding to the current input file. Shortcut: Ctrl+S
File | Previous File -- Moves to the previous input file. Shortcut: Ctrl+Left
File | Next File -- Moves to the next input file. Shortcut: Ctrl+Right
File | Reload File -- Reload the current input file.
File | Exit -- Exits the session.
Edit | Propagate -- Applies the flag of the current entry to all the entries that have the same text.
Edit | Edit File -- Edits the current input file with its associated editor. Shortcut: Ctrl+E
View | Context -- Displays or hides the Context panel
View | Resname Column -- Displays or hides the Resname column in the table.
View | Restype Column -- Displays or hides the Restype column in the table.
View | Input Files -- Opens the Input Files dialog box, to move to a specific input file. Shortcut: Ctrl+G
View | Log -- Shows the Log window. Shortcut: F9
Help | Help Content -- Opens the help page for the utility. Shortcut: F1