 User Manual: For epcEdit Release 1.2.1 | ||
|---|---|---|
| Prev | Chapter 15. Menu structure | Next |
The command invokes a spell checker for your document. epcEdit uses an external spell checker for checking your document:
On Linux and Unix systems, the ispell or aspell programs are used as spell checkers.
On Windows systems, the aspell utility must be installed as a spell checker.
Neither ispell nor aspell are bundled with epcEdit. Both applications are freely available on the internet or from the epcEdit web site.
A screenshot of the spell checker dialog is shown below. This dialog appears when a word in the current document is not recognized by the spell checker program. If your document contains no misspelled words, only an information message is shown that tells you that no spelling errors were detected in your document.
The misspelled word is shown in the Word field and highlighted in the document window.The Replace by field contains the replacement for the word. Pressing the button will replace the selected word with the contents of this field. The Suggestions list contains alternative replacements that have been suggested by the spell checker. Selecting an entry in this list will copy the selected entry into the Replace field.
The Language combo box contains the list of all available languages on the system. This list is constructed from the names of the files in the dictionary directory and depends on the installed dictionaries.
Apart from replacing a misspelled word, the word can be ignored just once by pressing the button. Pressing the button will tell the spell checker to ignore all occurrences of the misspelled word in the current document.
Correctly spelled words that were not recognized by the spell checker can be entered into a personal dictionary by pressing the button.
Pressing the button will terminate the spell checker. If the personal dictionary has been modified, a dialog will be displayed that asks whether the modified dictionary should be saved or not.
The configuration dialog can be opened by pressing the button in the spell checker dialog. The command automatically opens the configuration dialog if it detects invalid configuration settings.
The configuration dialog (as shown below) contains four entry fields for the name of the ispell program, the location of the ispell (or aspell) dictionaries, the default language, and for the dictionary encoding.
The Spell program field contains the name of the executable program that is invoked by the script. On Unix, this is normally /usr/bin/ispell; on Windows systems, the default is c:\aspell\aspell.exe.
The Dictionary directory is the location where the dictionaries for the spell checker program are stored. On Unix systems, the default is /usr/lib/ispell, on Windows, the dictionaries are normally stored in the c:\aspell\dict directory.
The Default Language field contains the name of default dictionary that is used by the spell checker.
The Dictionary Encoding contains the name of the encoding used for the spell checker dictionaries. The script will convert any data into this encoding before sending it to the spell checker program. The default setting of ISO-8859-1 should work for most environments.
When the button is pressed, epcEdit will check the configuration parameters and display an appropriate information message if configuration errors are encountered.
The command lets you insert a comment into your document.
When the command is invoked while text is selected, epcEdit will try to enclose the currently selected part of your document in a comment. If this is not possible without violating the document integrity or if no text is selected, an empty comment will be created at the location of the insertion cursor.
The command tries to remove the comment delimiters around the text of an existing comment while retaining the content of the comment. Any textual markup within the comment text will be re-interpreted and the corresponding tags will be created.
If a comment can not be removed because the content of the comment can not occur at the location of the comment, the comment and it's content will be deleted instead. (It is always possible to invoke the Undo command to revert the remove operation unless the Undo function has been disabled in the preferences dialog).
This operation is also available by right-clicking on one of the comment tags and selecting from the context menu.
The command deletes the comment containing the insertion cursor including the content of the comment.
This operation is also available by right-clicking on one of the comment tags and selecting from the context menu.
The command lets you insert a processing instruction into your document.
When the command is invoked, epcEdit displays a dialog for inserting the text of the PI.
Simply type the PI text into the entry filed of the dialog, then press the button to insert the PI at the location of the insertion cursor.
The command lets you edit the text of an existing processing instruction in your document.
To edit the text of a PI, simply place the insertion cursor between the start and end tags of the PI before selecting ->
When the command is invoked, epcEdit displays a dialog containing the current text of the PI. After modifying the PI text, then press the button to update the PI at the location of the insertion cursor.
The command lets you insert a marked section into your document.
When the command is invoked while editing an SGML document, epcEdit displays a dialog for selecting the type of the marked section that you want to insert.
In SGML documents, you can choose from the available marked section types IGNORE, INCLUDE, CDATA, RCDATA and TEMP by selecting the appropriate entry from the list in the dialog.
After selecting the marked section type, click on the button to insert a new marked section at the location of the insertion cursor.
In XML documents, only CDATA marked sections are allowed and no dialog is shown for selecting the type of the marked section.
The command tries to remove the marked section delimiters around the text of an existing marked section while retaining the content of the marked section. Any textual markup within the comment text will be re-interpreted and the corresponding tags will be created.
If a marked section can not be removed because the content of the marked section can not occur at the location of the comment, the marked section and it's content will be deleted instead. (It is always possible to invoke the Undo command to revert the remove operation unless the Undo function has been disabled in the preferences dialog).
This operation is also available by right-clicking on one of the marked section tags and selecting from the context menu.
The command deletes the marked section containing the insertion cursor (including the content of the marked section).
This operation is also available by right-clicking on one of the marked section tags and selecting from the context menu.
The command is used to run a user-defined script.
When you select the command, epcEdit displays a dialog with a list of known scripts.
You can select the name of the script from the list of available scripts and click on the button to run the script. Please refer to Extensions and Scripts for more details about scripts.
