Folders and Files
From Wenlin Guide
Appendix C of the Wenlin User’s Guide
Wenlin requires the presence of numerous files for correct operation. The required files are located in folders named “Fonts”, “Grades”, “Help”, “Pictures”, “Text”, and “W4DB”. These folders must all be located inside the “Wenlin4” folder. There are also some optional (but recommended) folders: “Flashcards”, “Text2”, and “W3Sound”. Each of these folders is described briefly below.
The “Flashcards” folder contains some ready-made flashcards, described in Chapter 13.
The “Fonts” folder contains several fonts, described in Chapter 14. This might be a convenient place to put your own Chinese fonts, if you want.
The “Grades” folder contains graded word lists, described in Chapter 6.
The “Help” folder contains the documentation accessible by the Help menu.
The “Pictures” folder contains image files used as toolbar decorations.
The “Text” folder is briefly described at the end of Chapter 3. All the files in the “Text” folder are documents that you can open by choosing Sample Texts from the File menu. Some of these files, including “gua.wenlin”, “bopomofo.wenlin”, “s0.wenlin”, “mostused.wenlin”, and “newhanzi.wenlin”, are also accessed automatically by Wenlin, and their presence is essential.
Unlike the “Text” folder, the “Text2” folder is optional, since none of the files are needed for Wenlin’s basic functionality. It contains some texts for studying. If it is installed, you can access it either by choosing Sample Texts from the File menu and pressing a triangle button (at the end of the list) for the “Text2” folder, or by choosing Open Files in Wenlin Folder... from the File menu and navigating in the dialog box to the “Text2” folder.
The sound files here include pronunciations of all the Mandarin syllables. They are subdivided into folders “AE”, “FJ”, “KO”, “PS”, and “TZ”, alphabetically by the first letter.
The number 3 in the name “W3Sound” originates from Wenlin version 3. Since this folder has not changed in Wenlin 4.0, we have not changed the name. (Some new sound recordings are included in the “Text” folder.) If you upgrade from version 3 to version 4, you don't need to replace or duplicate the “W3Sound” folder. Version 4 will try to find and use the “W3Sound” folder that is installed with version 3.
For MS-Windows, the “W3Sound” folder should be installed in the location chosen for installing all Wenlin’s data files. You can conveniently find the “Wenlin4” folder by choosing Open Wenlin Folder in Explorer from the File menu. (If you have Wenlin 3 installed, then the “W3Sound” folder can also be located, for example, inside “C:\Program Files\Wenlin3”.)
For Macintosh, the “W3Sound” folder should be installed in the same location as the Wenlin application (that is, inside the “Wenlin4” folder), or it can be one level higher in the folder hierarchy (normally in the “Applications” folder). Wenlin will find it automatically in either of those two locations. (If you have Wenlin 3 installed, then the “W3Sound” folder can also be located, for example, inside “/Applications/Wenlin3”.) The Wenlin CD-ROM has “W3Sound” stored outside of the “Wenlin4” folder, so that you can install everything except the sound files simply by dragging the “Wenlin4” folder to your “Applications” folder.
The sound files take a relatively large amount of room on the hard drive. If you have the Wenlin CD-ROM, and if you have a small or very crowded hard drive, and don’t need the sounds all the time, it isn’t necessary to install the “W3Sound” folder on your hard drive. You’ll still be able to access the sounds, either by running Wenlin from the CD-ROM, or by inserting the CD-ROM and letting Wenlin know it’s there by the following method: choose Open... from the File menu, and open one of the sound files in the “W3Sound” folder just as you would open a document. After you’ve done this once, the mouth tool and other sound features will work normally for the remainder of the current session.
The “W4DB” folder contains various binary database/index files, for the dictionaries, etc. They are not meant to be opened directly as documents. Some of these files are described briefly at the end of Chapter 9, and also in Chapter 15.
Upgrading From Earlier Wenlin Versions
If you used a version of Wenlin before version 4, and you made changes to any of the dictionary files, you may want to preserve those changes, and be able to use them with Wenlin 4. Also you might like to share the “W3Sound” folder between the two versions.
It is possible to run Wenlin 3 and Wenlin 4 on the same computer without interference. You may find this convenient especially while making the transition. It is not necessary to uninstall Wenlin 3 before installing Wenlin 4, so don't be in too much of a hurry about uninstalling.
For the sound files, you can leave them where they were installed for Wenlin 3, and they should be found and used by Wenlin 4 as well. If and when you uninstall version 3, you might first want to move the “W3Sound” folder into the “Wenlin4” folder (which is easily located by choosing Open Wenlin Folder in Explorer/Finder from the File menu).
For your dictionary files, you can use the methods explained in Chapter 15, such as Choose Dictionary..., Show Dictionaries, and ▷analyse and ▷duplicate buttons. From within Wenlin 3, you can use the ▷duplicate buttons to save copies of your dictionary files to a safe location (not inside the “Wenlin3” folder). Then from within Wenlin 4, you can use Choose Dictionary... to use your old dictionaries. You can ▷analyse them and extract your modified entries, and import them into the new dictionaries.
Mysterious Behavior of the Program Files Folder
This section may concern you if you used a version of Wenlin before 4.0 on MS-Windows 7 or Vista, and you made changes to any of the dictionary files.
MS-Windows 7 and Vista prevent modification of files inside the “Program Files” folder, except under special circumstances (such as when installing a program or when the user has administrative privileges). That restriction sometimes applies to dictionary files for old versions of Wenlin. If you edited your dictionaries in Wenlin 3, for example, and they were located in “C:\Program Files\Wenlin3\W3DB”, then MS-Windows may have done something you didn't know about: it may have made copies of the dictionary files in another location, where modification was allowed, while providing the illusion that the modified files were still inside the “Program Files” folder. This feature is called “Virtual Store”. If this has happened to you, the modified versions of your dictionary files may be in this location:
- C:\Users\[USERNAME]\AppData\Local\VirtualStore\Program Files\Wenlin3
Wenlin 4.0 no longer stores its data in the “Program Files” folder, in order to avoid this mysterious situation.
文件 wénjiàn ‘file’
文件夹 wénjiànjiā ‘folder’