This page describes all Chinese Toolbox files. Each file falls into at least one of the following categories.
This page explains the purpose of each file and what you can (or can’t do) with each file.
If you accept the default location during installation, source Chinese Toolbox files are installed in a “Toolbox Coding” directory of your “Program Files” or “Program Files (x86)” directory. With the exception of cedict_ts.u8, these installed files must not be edited or removed. Chinese Toolbox will not run without these source files.
The first time you run Chinese Toolbox, four source Chinese Toolbox files (ChineseToolbox.dat, ChineseToolbox.cfg, ChineseToolboxLicense.txt, and readme.txt) are copied from the installation directory to a “Chinese Toolbox” directory in your main Documents folder. If this “Chinese Toolbox” folder doesn’t exist, the program creates it.
After running the program at least once, a few more files will exist in your Chinese Toolbox documents folder. These files, along with changes made by the program to ChineseToolbox.dat, represent your personal Chinese learning data.
Each of the three export commands of the File menu writes a file to your Chinese Toolbox documents folder:
Clicking on the “Analyze Document” button tab in the Reader will generate the file, DocumentAnalysis.utf8.
Pressing Ctrl-E in the Reader will exclude the current word from the word dictionary and WordDictionaryExclusions.txt will be written to your Chinese Toolbox documents folder.
All Chinese Toolbox files are either binary (machine readable) or text (human readable). Most Chinese Toolbox text files are written in UTF-8 format. Those with an extension of U8 are UTF-8 text files. These can be edited with a program that understands UTF-8 text files. Not all programs that read UTF-8 files can write them correctly. According to my brief testing of Microsoft Word 2010 and Notepad (Windows 7) with UTF-8 files, both read and write UTF-8 files. WordPad apparently does not read or write UTF-8 files. Earlier versions of Microsoft Word could read UTF-8 files, but would write them as UTF-16. When working with UTF-8 files, I recommend BabelPad, downloadable from http://www.babelstone.co.uk/Software/BabelPad.html.
Several files are created after you begin using the program. All files with a “dat” extension are binary files and cannot be edited apart from Chinese Toolbox.
Three files are export files. They are written by export commands on the File menu. These files can be edited in a text editor and re-imported back into Chinese Toolbox.