Difference between revisions of "Folders and Files"

From Wenlin Guide
Jump to navigation Jump to search
(Where Is The Tushuguan (under construction))
Line 73: Line 73:
 
==Where Is The Tushuguan==
 
==Where Is The Tushuguan==
  
When Wenlin is running normally, you can see where the Tushuguan is by choosing "Open Files in Wenlin Folder..." from the File menu.
+
When Wenlin is running normally, you can see where the Tushuguan is by choosing '''Open Files in Wenlin Folder...''' from the '''File''' menu.
  
 
The location of the Tushuguan folder is determined when you install Wenlin. We recommend that you use the default location (as described in [[Installation]]) unless you have a good reason to do otherwise. If you change your mind after installation, you may be able to move the Tushuguan to a different location, or change its name, provided that you read this documentation carefully to understand the consequences. It may be necessary to reconfigure Wenlin so that it can find the Tushuguan with its new location or name.
 
The location of the Tushuguan folder is determined when you install Wenlin. We recommend that you use the default location (as described in [[Installation]]) unless you have a good reason to do otherwise. If you change your mind after installation, you may be able to move the Tushuguan to a different location, or change its name, provided that you read this documentation carefully to understand the consequences. It may be necessary to reconfigure Wenlin so that it can find the Tushuguan with its new location or name.
Line 79: Line 79:
 
Compared with earlier versions, Wenlin 4.1 has increased flexibility in the location of the Tushuguan. For example, different users of the same computer might each have their own Tushuguan, including changes to the dictionaries, text files, flashcards, etc. A single user might have two Tushuguans: one that is a copy of the original version received from Wenlin Institute, and another that has customizations to the dictionaries, etc.
 
Compared with earlier versions, Wenlin 4.1 has increased flexibility in the location of the Tushuguan. For example, different users of the same computer might each have their own Tushuguan, including changes to the dictionaries, text files, flashcards, etc. A single user might have two Tushuguans: one that is a copy of the original version received from Wenlin Institute, and another that has customizations to the dictionaries, etc.
  
Also, unlike earlier versions, Wenlin 4.1 has the ability to run (with limited functionality) even if the Tushuguan isn't found.
+
Also, unlike earlier versions, Wenlin 4.1 has the ability to run (with limited functionality) even if a Tushuguan isn't found.
  
When Wenlin starts up, it searches for the Tushuguan by various methods. Some of these methods are different depending on the operating system, MS-Windows or Macintosh.
+
When Wenlin starts up, by default it looks first in the same location as the Wenlin application (executable) to see if it contains a folder named “WenlinTushuguan”; Wenlin uses this Tushuguan if it exists and appears to be valid. (This is the case on a Wenlin CD-ROM, for example.) (There is a way to prevent Wenlin from doing this: under '''Advanced Options''', '''File''', and '''Tushuguan Options''', uncheck the checkbox labeled “Use WenlinTushuguan if found in the same location as the application on start-up”.)
  
When Wenlin starts up, by default it looks first in the same location as the Wenlin application (executable) to see if it contains a folder named "WenlinTushuguan", and if so, Wenlin uses this Tushuguan (if it appears to be valid). (This is the case on a Wenlin CD-ROM, for example.) (There is a way to prevent Wenlin from doing this: under Advanced Options, File, and Tushuguan Options, uncheck the checkbox labeled "Use WenlinTushuguan if found in the same location as the application on start-up".)
+
(Note: to decide whether a potential Tushuguan appears to be “valid”, Wenlin only checks whether it contains a folder named “W4DB”, and does not check the contents of the W4DB folder or check for other folders such as “Text” which also belong inside the Tushuguan. However, if any such folders or files are missing, Wenlin may report an error or may not perform correctly.)
  
(Note: to decide whether a potential Tushuguan appears to be "valid", Wenlin only checks whether it contains a folder named "W4DB", and does not check the contents of the W4DB folder or check for other folders such as "Text" which also belong inside the Tushuguan. However, if any such folders or files are missing, Wenlin may report an error or may not perform correctly.)
+
If Wenlin doesn't find “WenlinTushuguan” in the application's location, it looks at the preferences (for the current user) to see if a Tushuguan location was remembered at the end of the previous session. If the Tushuguan was remembered, and appears to be valid, Wenlin uses it.
 
 
If Wenlin doesn't find WenlinTushuguan in the application's location, it looks at the preferences (for the current user) to see if a Tushuguan location was remembered at the end of the previous session. If the Tushuguan was remembered, and appears to be valid, Wenlin uses it.
 
  
 
Otherwise, if  Wenlin still hasn't found a valid Tushuguan, it looks in several more-or-less standard locations, some of which are different depending on the operating system, MS-Windows or Macintosh.
 
Otherwise, if  Wenlin still hasn't found a valid Tushuguan, it looks in several more-or-less standard locations, some of which are different depending on the operating system, MS-Windows or Macintosh.
  
On Macintosh, it looks inside the user's home folder for a folder named WenlinTushuguan or Wenlin4; ...
+
On MS-Windows, it looks ...
  
...
+
On Macintosh, it looks inside the user's home folder for a folder named “WenlinTushuguan” or “Wenlin4”; ...
  
On Macintosh, Wenlin first examines the folder in which the Wenlin application itself is located, and uses it as the Tushuguan if it contains a "W4DB" folder. Otherwise Wenlin ...
+
(Under construction!)
  
If WenlinTushuguan is not found in the Applications folder, Wenlin looks for it in the home folder. If it is not found, the program complains but does not quit. It is possible to search for the folder and get some diagnostics from within Wenlin. No matter where it is, if you find it from within Wenlin and open a file in it, then Wenlin stores the location in the preferences, from which point on it will be remembered. This new flexibility may help people who have multiple users on the same machine and want to keep their data files separate, or have permissions problems with the Applications folder, etc.
+
If it is not found, the program complains but does not quit. It is possible to search for the folder and get some diagnostics from within Wenlin. No matter where it is, if you find it from within Wenlin and open a file in it, then Wenlin stores the location in the preferences, from which point on it will be remembered. This new flexibility may help people who have multiple users on the same machine and want to keep their data files separate, or have permissions problems with the Program Files or Applications folder, etc.
  
 
<center>
 
<center>

Revision as of 13:58, 14 March 2012

Wenlin 216x93.png Appendix C of the Wenlin User’s Guide

Wenlin requires the presence of numerous files for correct operation. These files are located in required data folders named “Fonts”, “Grades”, “Help”, “Pictures”, “Text”, and “W4DB”. There are also some optional (but recommended) folders: “Flashcards”, “Text2”, and “W3Sound”. Each of these required and optional folders is described briefly below.

The required data folders must all be located inside one main data folder, whose default name is “WenlinTushuguan” (for Wenlin 4.1) or “Wenlin4” (for Wenlin 4.0). In this documentation, we call Wenlin's main data folder the Tushuguan (regardless of what its actual name is). If Wenlin is installed normally (according to the instructions), it should be able to find the Tushuguan when it starts up. If Wenlin is not installed correctly, or if its files get moved from their original locations, it will report an error when starting up and many of its features won't work. Details are in the section below,Where Is The Tushuguan.

Folders

Flashcards

The “Flashcards” folder contains some ready-made flashcards, described in Chapter 13.

Fonts

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.

Grades

The “Grades” folder contains graded word lists, described in Chapter 6.

Help

The “Help” folder contains the documentation accessible by the Help menu.

Pictures

The “Pictures” folder contains image files used as toolbar decorations.

Text

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.

Text2

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.

W3Sound

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.

Winlogo 24x24.jpg 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”.)

Applelogo 24x24.jpg 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.

W4DB

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.

Where Is The Tushuguan

When Wenlin is running normally, you can see where the Tushuguan is by choosing Open Files in Wenlin Folder... from the File menu.

The location of the Tushuguan folder is determined when you install Wenlin. We recommend that you use the default location (as described in Installation) unless you have a good reason to do otherwise. If you change your mind after installation, you may be able to move the Tushuguan to a different location, or change its name, provided that you read this documentation carefully to understand the consequences. It may be necessary to reconfigure Wenlin so that it can find the Tushuguan with its new location or name.

Compared with earlier versions, Wenlin 4.1 has increased flexibility in the location of the Tushuguan. For example, different users of the same computer might each have their own Tushuguan, including changes to the dictionaries, text files, flashcards, etc. A single user might have two Tushuguans: one that is a copy of the original version received from Wenlin Institute, and another that has customizations to the dictionaries, etc.

Also, unlike earlier versions, Wenlin 4.1 has the ability to run (with limited functionality) even if a Tushuguan isn't found.

When Wenlin starts up, by default it looks first in the same location as the Wenlin application (executable) to see if it contains a folder named “WenlinTushuguan”; Wenlin uses this Tushuguan if it exists and appears to be valid. (This is the case on a Wenlin CD-ROM, for example.) (There is a way to prevent Wenlin from doing this: under Advanced Options, File, and Tushuguan Options, uncheck the checkbox labeled “Use WenlinTushuguan if found in the same location as the application on start-up”.)

(Note: to decide whether a potential Tushuguan appears to be “valid”, Wenlin only checks whether it contains a folder named “W4DB”, and does not check the contents of the W4DB folder or check for other folders such as “Text” which also belong inside the Tushuguan. However, if any such folders or files are missing, Wenlin may report an error or may not perform correctly.)

If Wenlin doesn't find “WenlinTushuguan” in the application's location, it looks at the preferences (for the current user) to see if a Tushuguan location was remembered at the end of the previous session. If the Tushuguan was remembered, and appears to be valid, Wenlin uses it.

Otherwise, if Wenlin still hasn't found a valid Tushuguan, it looks in several more-or-less standard locations, some of which are different depending on the operating system, MS-Windows or Macintosh.

On MS-Windows, it looks ...

On Macintosh, it looks inside the user's home folder for a folder named “WenlinTushuguan” or “Wenlin4”; ...

(Under construction!)

If it is not found, the program complains but does not quit. It is possible to search for the folder and get some diagnostics from within Wenlin. No matter where it is, if you find it from within Wenlin and open a file in it, then Wenlin stores the location in the preferences, from which point on it will be remembered. This new flexibility may help people who have multiple users on the same machine and want to keep their data files separate, or have permissions problems with the Program Files or Applications folder, etc.

Wenjian.png

文件 wénjiàn ‘file’

Wenjianjia.png

文件夹 wénjiànjiā ‘folder’


Mouse pointer finger right.jpg | Previous: App. B. Keyboard Shortcuts | Next: App. D. Wenlin Software License | Contents |