STGuru User's Guide
A.1
Accelerator Keys Contents A.3 Command Line Guide (Only for STGuru Standard Edition)
Appendix
A.2
Word Adjustment Engine Customization Walkthroughs
A2.1 Why We Need Custom Word Adjustment Packs?
A2.2 How to Make a Custom Word Adjustment Pack
/ Custom Word Adjustment Library?
A2.3 How to Merge Two or More Libraries?
A2.4 How to Add, Delete, Modify, Import or Export Word
Adjustment Pairs in Bulk?
A2.5
The Capitalizations of Some English Words in the Library Are Not Correct. Is
There Any Easy Way to Correct Them?
View
Video Demonstration
(in Simplified Chinese)
A2.1 Why We Need Custom Word Adjustment Packs?
Providing Special Word Adjustment Solutions for Important
Projects
If you have one or several (and different) important long-term projects to be
converted by STGuru, you are suggested to make a word adjustment pack for each
of them based on a preinstalled pack (or another
existing custom pack) of a similar topic. In your pack, you can add one or multiple custom word adjustment
libraries at the bottom of the library list. If you tune this pack for Simplified
Chinese to Traditional Chinese conversions, you can select "Big5 libraries"
at the bottom left of the "Advanced Word Adjustment" dialog box (Pic UG-A2-3);
if you tune this pack for Traditional Chinese to Simplified Chinese
conversion, you can select the other option - "GBK libraries".
The word adjustment by STGuru is based on the libraries, from top to bottom, in the current pack. So the adjustments by the custom libraries you add at
the bottom of the library list will be final.
Except for adjusting Simplified/Traditional Chinese
conversions, you can also revise any other text information in the target
files, such as the paths of files or directories. So the word adjustment
system can also be used as a batch-replace tool. STGuru even supports the
adjustment of a whole multi-line text block in a time.
Glossary Management
If you are a translator or an editor, you can maintain
the glossaries for your projects with STGuru's custom pack and custom
library feature. Here are what you can expect:
1) Our libraries supports terms (words
before adjustment), explanations (words after adjustment) and notes in multiple lines.
2) You can make both Simplified Chinese
(GBK) libraries and Traditional Chinese (Big5) libraries.
3) The system checks repetitive entries automatically to make sure you can only
input non-repetitive terms into a library from the UI of the word adjustment
entry dialog
box. Besides, it also provides validation checks for existing repetitive
entries in the library (they can be entered into the library by glossary
mergence or human editing in the text source file) and provides a
wizard to help you merge repetitive entries.
4) Whether you enter an entry into the
glossary within the standard UI, or you export the glossary into a text
file, the results are the glossary is automatically ordered in the UI and in
the exported file.
5) If you have multiple glossaries, you
can merge them by simply pasting the entries of all candidate libraries into
the text file for the final library, or by the library mergence function (please refer to
A2.3).
6) Library-level and pack-level searches
are supported in this system to help you find required entries quickly.
7) The system supports source text
editing, so you can edit, import and export library entries in
batch.
8) The system features fine-quality
glossary pack management. You can quickly select the pack you need in the
pack list, and can move the pack file and library files conveniently to
another system where STGuru is installed, and open the pack by simply
double-clicking the pack file (.stcp).
A2.2 How to Make a Custom Word Adjustment Pack / Custom Word Adjustment Library?
Steps to make a custom word adjustment pack (for the steps to make a word
adjustment library, please refer to those after step 5):
1) Open the "Advanced Word Adjustment" dialog box
Menu command: "Code Conversion" -> "Advanced Word
Adjustment".
2) Select a reference pack
There is a "Word Adjustment Pack" function group at the top of the "Advanced
Word Adjustment" dialog box, within which, many preinstalled packs and
existing custom packs are in the list to the right of "Pack title:".
Carefully decide and select a pack (preinstalled or custom) from this list
that matches your topic best. This is the initial reference pack based on
which to make your custom word adjustment pack.
3) Save it as a custom pack
After you have decided the reference pack ("IT" pack in this
walkthrough), click the button in the second circle in the picture below to
save the reference pack as your own custom pack.
Pic UG-A2-1
Word Adjustment Pack function group
4) Configure custom pack
After you click the above button, the following dialog box pops up. You can
set the title, description, pack file (path) in this dialog box. After the
path is decided, the pack folder (upper directory of the pack file) is
automatically displayed. If you want to adjust the library configuration
within this pack, you can click the button "Edit Library Configurations" at
the bottom left of the dialog box to set it. Generally, there is no need to
click this button. After you have completed these settings, you can click
the OK button at the bottom right to return.
Pic UG-A2-2 Configure
word adjustment pack
So far, the preliminary frame of a custom word adjustment pack has been
completed. The steps to add and make custom word adjustment libraries are as
below:
5) Select the conversion direction for the custom library
(Simplified Chinese into Traditional Chinese, or Traditional Chinese into
Simplified Chinese)
If the pack is for conversions from Simplified Chinese into
Traditional Chinese, you should select the option "Big5 libraries" in the
following dialog box, else you should select the option "GBK libraries".
Big5 libraries and GBK libraries are two groups of different libraries for
different conversion directions. It is necessary to make a decision at this
point.
6) Add a new library
Double-click the text "Double-click to add a custom final fix
library" at the bottom of the library list to add a custom final fix
library. Besides, you can also add the library by clicking this text, and
then clicking the "Add" image button below (the button in the middle circle
at the bottom of the dialog box). Actually, by the second method, you can
add more than one custom library. If you click the button in the second
circle, you can edit the selected library.
Pic UG-A2-3 Add a custom
word adjustment library
Pic UG-A2-4
After performing the "Add" command, you can see this small dialog box
7) Edit and manage word adjustment library
You can edit a library in the list by double-clicking the library in the
list, or by selecting the library and clicking the pencil icon at the bottom
right of Pic UG-A2-3. Please
refer to the following picture for the editing UI. You can set the title,
description, and path at the top of this dialog box. With the two buttons in
the circle below, you can add and edit entries. If you click the "file"
image button on the top of the "Add" button, you can open another instance
of STGuru, and edit the current library in the form of a text file in it.
Please click
A2.4 How to Add, Delete, Modify, Import or Export Word
Adjustment Pairs in Bulk? for the usage of this button.
Pic UG-A2-5 Edit custom
word adjustment library
8) Add, edit and delete entries
By clicking the Add, Delete and Edit image buttons in the picture above (UG-A2-5),
you can add, delete and edit an entry. Within these operations, you need to
select an entry in the glossary list before you can delete or edit the
selected entry.
When you click the add or edit button, the following dialog box will
appear. You can add/edit the word within this dialog box. The library in
this example is a Big5 library, so the entries in this library are also in
Big5 encoding. If you work on a Simplified Chinese system and cannot input
characters in Big5, please launch another instance of STGuru, and make Big5
entries by editing/pasting/conversion, and paste the result in Big5 back into
this system.
If you want to add or edit in batch, please refer to
A2.4 How to Add, Delete, Modify, Import or Export Word
Adjustment Pairs in Bulk?.
Pic UG-A2-6 Add/Edit an
entry
A2.3 How to Merge Two or More Libraries?
You need two steps in order to merge two or more libraries. The first step
is to merge libraries. The second step is to merge repeating entries.
1) Merging libraries
There are two methods to merge two or more libraries. You can merge
libraries with the "Merge Word Adjustment Libraries" dialog box, or you
can open the source files of various libraries as plain text files and merge entries into
one of them directly.
Method 1: Merge with the "Merge Word Adjustment Libraries" dialog box
1) Click the library mergence image button at the bottom left
of the "Advanced Word Adjustment" dialog box (Pic UG-A2-7).
The "Merge Word Adjustment Libraries" dialog box
will pop up (Pic UG-A2-8).
2) In the "Merge Word Adjustment Libraries" dialog box, add
the several source libraries to be merged based on tips, set a target
library (it can be an existing library, or a new library to be created) and
set its properties. After you have finished the configuration, click the arrow
button at the bottom right to start mergence.
Pic UG-A2-7 The library
mergence button
Pic UG-A2-8 The library
mergence (Merge Word Adjustment Libraries) dialog box
Method 2: Open the library file and merge in plain text directly
1) Open the source files in plain text for the several source libraries with
STGuru respectively.
2) Copy the entries in these libraries into the target
library file, and close them all.
The structure/syntax of a library file is as below:
;[T]{Title}
;{Description. It can be of multiple lines.}
{Entries. They can be of multiple lines.}
The simplest way in mergence is to copy the entries of the several source
libraries from their library files directly into the source text file of the
target library. There is no special requirement for the order of libraries
in copying/pasting. You can decide the title and description of the target file
by yourself. After you have finished, you can close and save the target
file.
For more details, please refer to
A2.4 How to Add, Delete, Modify, Import or Export Word
Adjustment Pairs in Bulk?.
2) Merge repeating entries
After you complete merging the libraries with one of the
above methods, there may be multiple repetitive entries in the target
library. Now you may need to merge these repetitive entries.
Please refer to Pic UG-A2-9 and UG-A2-10. You can merge all possible repeating entries from within the "Advanced Word
Adjustment" dialog box, or from the "Edit Word Adjustment Library" dialog
box. If you click the button at left, STGuru will only check for repeating
entries. It will prompt you for the results, but will not merge them
without your acknowledgement. If you click the button with a check in the
right, STGuru will merge repeating entries directly after the check, or it
will guide you through the mergence procedure:
1) For entries where the word before adjustment and the word after
adjustment are both identical ("Word before adjustment 1" = "Word
before adjustment 2" and "Word after adjustment 1" = "Word after adjustment
2"), they will be merged directly;
2) For those with the same words before adjustment, but with different words
after adjustment, the "Correcting Repeating Items" dialog box will pop up to
help you merge these entries.
This ends the steps for library mergence.
Pic UG-A2-9
Merge potential repeating entries in all libraries in the "Advanced Word
Adjustment" dialog box
Pic UG-A2-10 Merge
potential repeating entries in the current library in the
"Edit Word Adjustment Library" dialog box
Pic UG-A2-11
Merge entries with the same "word before adjustment" in the "Correcting
Repeating Items" dialog box
A2.4 How to Add, Delete, Modify, Import or Export Word Adjustment Pairs in Bulk?
Bulk Add, Delete and Edit
Besides adding, deleting or editing entries with the corresponding button
commands in the "Edit Word Adjustment Library" dialog box (refer to
Pic UG-A2-5) one by one, you
can also launch another instance of STGuru to open a temporary plain text
file for the current library and edit the entries in batch.
Pic UG-A2-12
With the add, delete and edit buttons in the "Edit Word Adjustment Library"
dialog box, you can process entries one by one; by clicking the "View Source
File" button, you can open a temporary text file for the current library in
a new instance of STGuru and edit entries there in batch.
1) As shown in Pic UG-A2-12,
you can click the "View Source File" button in the "Edit Word Adjustment
Library" dialog box. The result is the entries in the current library will
be saved at its current status into a temporary text file, and be opened by
another instance of STGuru.
2) Please refer to UG-A2-13
for the syntax of the library file. Its first line is started with
;[T], where T means title. The second line starts with
;, but there is no [T] - this is the
description of the library. There may be multiple lines of description.
After that, you can see the list of entries, each in a line. The part of an
entry before the first comma is the word before adjustment; the part after
that but before the second comma (if there is one) is the word after
adjustment; the part after the second comma is the notes. You can handle
entries based on this syntax.
3) If you see “{{_AS_MLE_WA_COMMA_}}” or “{{_AS_MLE_WA_RETURN_}}”
in the library file, they are English commas and carriage returns within the
entries.
4) After you complete editing, save this file and exit.
5) If you change the content of the library file in the above
steps, when you come back to the "Edit Word Adjustment Library", you will
see a prompt dialog box (refer to Pic UG-A2-14)
which asks you whether to save changes. When you click "Yes", all changes you
made before will be saved and updated to the library.
6) If there are repeating entries after you edit the text
file, please refer to the part "2) Merge repeating
entries" in the above section to merge repeating
entries.
Pic UG-A2-13 Syntax
of the library file
Pic UG-A2-14 Prompted
to save changes by your modification
Import and Export
Import and export work the same. You can open the file for the library to
import and paste its entries directly into the library file of the target
library, and save and update. This is import. If you save the source text
file of a library into a new file, this is export.
A2.5 The Capitalizations of Some English Words in
a Library Are Not Correct. Is There Any Easy Way to Correct Them?
Our product MLEditor provides a professional English case conversion
function (MLEditor menu command: Tools -> Professional English Case
Conversion).
To revise the capitalizations of the English words involved
in an STGuru library, you can open the problem library in a text file (refer
to the above section) and revise incorrect cases with the help of MLEditor.
After you complete, save changes and close the file.
The quality of MLEditor's case conversion function is
professional. It works similar to the word adjustment system by STGuru, so
if you need further tuning on MLEditor's case conversion system, you can
edit the custom library for the proper nouns against this walkthrough.
http://www.speedy7.com/mleditor
|