Install or update the term checker for ASD-STE100

Optionally, after you install the term checker, install add-ons and plug-ins to integrate LanguageTool with other software.

Installation

The design of the term checker for ASD-STE100 shows 4 files. In the remote files version of the term checker, the files disambiguation-ste7.xml and grammar-ste7.xml are on the TechScribe website. When you install the term checker, you automatically agree to the legal conditions.

After you install the term checker, you will have this directory structure:

ste-term-checker
    \data-files
        disambiguation-projectterms.xml
        grammar-projectterms.xml
    \LanguageTool-4.8
        languagetool.jar
        \org\languagetool\resource\en\disambiguation.xml
        \org\languagetool\rules\en\grammar.xml

The installation is not easy. Be careful. If a problem occurs, refer to Troubleshooting.

1. Before you start the installation

Before you start the installation, ask TechScribe for a free trial. We will send you a small compressed file (.zip) that contains disambiguation.xml and grammar.xml. These XML files let LanguageTool access the data that is on the TechScribe website.
During the installation, you will edit XML files. Thus, use an XML editor or a text editor that has syntax highlighting (https://en.wikipedia.org/wiki/Syntax_highlighting).
If you have an IT department, contact the IT department:
- Make sure that firewall settings will not prevent access to password-protected files on a website.
- Make sure that the Java security manager does not forbid Authenticator.setDefault(), because LanguageTool cannot access the external files that are on the TechScribe website if it does.
If Java 8 is not on your computer, install Java 8 (www.java.com/).

2. Create the directories and install LanguageTool

In a convenient location, create a directory ste-term-checker.
In ste-term-checker, create a directory data-files. (You will use this when you download the templates for your project terms.)
In ste-term-checker, download LanguageTool version 4.8 (www.languagetool.org/download/LanguageTool-4.8.zip) and extract it.
Double-click languagetool.jar and make sure that LanguageTool operates correctly. (If LanguageTool does not start, refer to https://languagetool.org/issues/.)
The screen shot shows English. You will see the default language for your operating system (you can change the language on the interface to English).

3. Optional. Change the language on the interface to English

Initially, LanguageTool uses the default language of your operating system for the text on the interface. Optionally, change the text to English. The example shows Russian to American English.

Click the equivalent of Text Checking>Options.
Change the GUI language.

4. Select American English for the STE checks

After the installation is completed, you can use British English for the STE checks (refer to Rule 1.14).

In Text Language, select English (American).
Optional step if the GUI language is not English. You will see many STE errors, because the default text is not English. Paste the default LanguageTool text into the term checker to see the default LanguageTool analysis of English text:
```
This is a example input to to show you how LanguageTool works.
```
Close LanguageTool. LanguageTool will keep the changes that you made to the GUI language and the text language.

5. Put the TechScribe files into LanguageTool and start the term checker

Replace LanguageTool-4.8\org\languagetool\resource\en\disambiguation.xml with disambiguation.xml that TechScribe sent to you.
Replace LanguageTool-4.8\org\languagetool\rules\en\grammar.xml with grammar.xml that TechScribe sent to you.
Double-click languagetool.jar.
If your internet connection is slow, you must wait 30 seconds (or more) for LanguageTool to start, because LanguageTool downloads many megabytes of data from the TechScribe website.
If LanguageTool does not automatically check the text, click Check Text.
The screen shot shows what you will see.
LanguageTool has default rules that are not in grammar-ste7.xml. Some default LanguageTool rules give unwanted error messages, as this example shows:

If you write 3 or more sentences that start with the same word, you can click 'deactivate'. Alternatively, to prevent the unwanted error, deactivate the LanguageTool rule in LanguageTool Options:
1. Click Text Checking>Options.
2. On the Style Rules tab, in the Style group, remove the check mark from: Successive sentences beginning with the same word
Optionally, to see the primary problems that the term checker identifies, use sample-text-for-ste-term-checker.txt.
Close LanguageTool.

6. Show error types in colour

The term checker maps many STE errors to Localization Quality Issue Types. Optionally, you can show these errors with a coloured background:
Some errors have a coloured background

To show error types in colour

Close LanguageTool.
Open .languagetool.cfg in a text editor. (In Windows, .languagetool.cfg is usually in the folder C:\Users\Your Name.)

Replace this line of code:

errorColors=

with this line of code:

errorColors=addition:#FBDEBB, characters:#FF80FF, grammar:#C0FFC0, misspelling:#D0E0D0, mistranslation:#FFFF80, non-conformance:#FFC0FF, omission:#C0C000, other:#FF9800, register:#C0FFFF, terminology:#FFC0C0, untranslated:#E0E0FF

Close .languagetool.cfg.
Double-click languagetool.jar. Warnings about possible errors have a coloured background:
Close LanguageTool.

7. Download the templates for your project terms

Although you can use the term checker if you do not do this procedure, you cannot add your technical terms to the term checker. Also, if TechScribe changes these templates when there is a new version of the term checker and if you use the files that are on the TechScribe website, errors can occur.

Close LanguageTool.
Download these files into the data-files directory:
- disambiguation-projectterms.xml
- grammar-projectterms.xml
In the LanguageTool stand-alone installation directory, edit ..\org\languagetool\resource\en\disambiguation.xml. In the line that contains ProjectTermsDisambiguationRules, change the path to the path of disambiguation-projectterms.xml on your computer.
For example, change:
<!ENTITY ProjectTermsDisambiguationRules SYSTEM "https://www.simplified-english.co.uk/disambiguation-projectterms.xml">
To:
<!ENTITY ProjectTermsDisambiguationRules SYSTEM "file:///D:/test/ste-term-checker/data-files/disambiguation-projectterms.xml">
In the LanguageTool stand-alone installation directory, edit ..\org\languagetool\rules\en\grammar.xml. Change the line that contains ProjectTermsGrammarRules to the path of grammar-projectterms.xml on your computer.

You can now customize the rules to include the technical names and the technical verbs that your organization uses.

7. Install the LanguageTool n-gram data

The term checker does not find all possible semantic errors or part-of-speech errors. For information about the errors that the term checker finds, refer to 'Rules'.

LanguageTool can use n-grams and a statistical method to find possible errors. The n-gram data is very large. Thus, the installation of the n-gram data is separate from the installation of the stand-alone version of LanguageTool. To install the n-gram data, refer to http://wiki.languagetool.org/finding-errors-using-n-gram-data.

The screen shot shows examples of errors that the statistical method can find:
Some errors have a coloured background

In the example sentences, all the words are approved in ASD-STE100, but they are used incorrectly:

Do the some tests again: some is an approved adjective, but the correct adjective is same.
Remove the waist from the hangar: waist is a technical name (noun, rule 1.5.12), but the correct noun is waste.
Use a week solution of water and disinfectant: week is a technical name (noun, rule 1.5.4), and week solution is a noun cluster (compare with oil filter). The correct word is weak (adjective).
Your manager will tell your to open the door: your is an approved adjective, but the correct word is you (pronoun).
It is there problem, not the manufacturer's problem: there is an approved pronoun, but the correct word is their (pronoun).

Update the term checker to the local files version

After you buy a licence for the local files version, TechScribe will send you term-checker-ste7-202n-nn-nn.zip, which contains the files disambiguation-ste7.xml and grammar-ste7.xml. (TechScribe will also send you subsequent updates. For a list of changes to the term checker rules, refer to changes.txt.)

To update the term checker to the local files version

Close LanguageTool.
Extract term-checker-ste7-202n-nn-nn.zip into the data-files directory.

In the LanguageTool stand-alone installation directory, edit the entity declarations in ..\org\languagetool\resource\en\disambiguation.xml to specify the location of the files for ASD-STE100 issue 7. Example:

<!ENTITY STE7DisambiguationRules SYSTEM "file:///D:/test/ste-term-checker/data-files/disambiguation-ste7.xml">
<!ENTITY ProjectTermsDisambiguationRules SYSTEM "file:///D:/test/ste-term-checker/data-files/disambiguation-projectterms.xml">

In the LanguageTool stand-alone installation directory, edit the entity declarations in ..\org\languagetool\rules\en\grammar.xml to specify the location of the files for ASD-STE100 issue 7. Example:

<!ENTITY STE7GrammarRules SYSTEM "file:///D:/test/ste-term-checker/data-files/grammar-ste7.xml">
<!ENTITY ProjectTermsGrammarRules SYSTEM "file:///D:/test/ste-term-checker/data-files/grammar-projectterms.xml">

Update LanguageTool and the local files version of the term checker

The term checker uses LanguageTool, which is released 4 times each year (http://wiki.languagetool.org/roadmap). If TechScribe supplies new rules for the term checker that operate only with the most recent version of LanguageTool, then to use the new rules, you must also update LanguageTool.

To update LanguageTool and the local files version of term checker

Download LanguageTool version 4.8 (www.languagetool.org/download/LanguageTool-4.8.zip) into the ste-term-checker directory and extract it. You will have this directory structure:

ste-term-checker
    \data-files
        disambiguation-projectterms.xml
        disambiguation-ste7.xml
        grammar-projectterms.xml
        grammar-ste7.xml
    \LanguageTool-4.7
        languagetool.jar
        \org\languagetool\resource\en\disambiguation.xml
        \org\languagetool\rules\en\grammar.xml
    \LanguageTool-4.8
        languagetool.jar
        \org\languagetool\resource\en\disambiguation.xml
        \org\languagetool\rules\en\grammar.xml

Copy disambiguation.xml from the old version of LanguageTool to the new version of LanguageTool.
Copy grammar.xml from the old version of LanguageTool to the new version of LanguageTool.
To be safe, move the current disambiguation-ste7.xml and grammar-ste7.xml files from the data-files directory to a backup location.
Extract term-checker-ste7-202n-nn-nn.zip into the data-files directory.
Because the disambiguation rules are better in this version of the term checker, an example in the rule PROJECT_NOT_APPROVED_EMAIL in the file data-files\grammar-projectterms.xml does not trigger an error if you use testrules. If you do not change the example, if you use testrules, you will see an error message because testrules expects an error. Change:
<example type="triggers_error">When the technician <marker>emails</marker> the manager...</example>
to
<example type="correct">When the technician <marker>emails</marker> the manager...</example>
Double-click languagetool.jar to start the term checker.
After you are sure that the new version of LanguageTool operates with the term checker rules, delete the old version of LanguageTool and the backup version of disambiguation-ste7.xml and grammar-ste7.xml.

Update LanguageTool and the remote files version of the term checker

The term checker uses LanguageTool, which is released 4 times each year (http://wiki.languagetool.org/roadmap). Usually, a new version of the term checker is available approximately 1 week after the LanguageTool release. We will tell you by e-mail and on the RSS feed.

To update LanguageTool and the remote files version of the term checker

Close LanguageTool.

Download LanguageTool version 4.8 (www.languagetool.org/download/LanguageTool-4.8.zip) into the ste-term-checker directory and extract it. You will have this directory structure:

ste-term-checker
    \data-files
        disambiguation-projectterms.xml
        grammar-projectterms.xml
    \LanguageTool-4.7
        languagetool.jar
        \org\languagetool\resource\en\disambiguation.xml
        \org\languagetool\rules\en\grammar.xml
    \LanguageTool-4.8
        languagetool.jar
        \org\languagetool\resource\en\disambiguation.xml
        \org\languagetool\rules\en\grammar.xml

In LanguageTool-4.7\org\languagetool\resource\en\, copy disambiguation.xml to the equivalent directory in LanguageTool-4.8.

Edit LanguageTool-4.8\org\languagetool\resource\en\disambiguation.xml to specify the new file disambiguation-ste7-2020-01-04.xml. Example:


<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<!DOCTYPE doc [
<!ENTITY STE7DisambiguationRules SYSTEM "https://user:password@www.techscribe.co.uk/ste-term-checker/disambiguation-ste7-2020-01-04.xml">

[code deleted]

In LanguageTool-4.7\org\languagetool\rules\en\, copy grammar.xml to the equivalent directory in LanguageTool-4.8.
Edit LanguageTool-4.8\org\languagetool\rules\en\grammar.xml to specify the new file grammar-ste7-2020-01-04.xml.
Because the disambiguation rules are better in this version of the term checker, an example in the rule PROJECT_NOT_APPROVED_EMAIL in the file data-files\grammar-projectterms.xml does not trigger an error if you use testrules. If you do not change the example, if you use testrules, you will see an error message because testrules expects an error. Change:
<example type="triggers_error">When the technician <marker>emails</marker> the manager...</example>
to
<example type="correct">When the technician <marker>emails</marker> the manager...</example>
Double-click languagetool.jar to start the term checker.
After you are sure that the new version of LanguageTool operates with the term checker rules, delete the old version of LanguageTool.

RSS feed