Difference between revisions of "Folders and Files"

From Wenlin Guide
Jump to navigation Jump to search
(Move New Features For Wenlin 4.1 to bottom, mark as Under Construction; some of this draft is only correct for Macintosh...)
(tushuguan stuff)
Line 71: Line 71:
 
===New Features For Wenlin 4.1 (Under Construction)===
 
===New Features For Wenlin 4.1 (Under Construction)===
  
[[Image:New_4_1_s.png|top]] The required data folders must all be located inside the “Wenlin4” folder, or as of Wenlin 4.1, in the “WenlinTushuguan” folder. 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.
+
[[Image:New_4_1_s.png|top]] The required data folders must all be located inside the “Wenlin4” folder, or as of Wenlin 4.1, in the “WenlinTushuguan” folder.  
 +
 
 +
==Where Is The Tushuguan==
 +
 
 +
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 really good reason to do otherwise.
 +
 
 +
When Wenlin is running normally, you can see where the Tushuguan is by choosing '''Open Files in Wenlin Folder...''' from the '''File''' menu.
 +
 
 +
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 still find the Tushuguan with its new location or name.
 +
 
 +
One of the new features of Wenlin 4.1 is increased flexibility in the location of the Tushuguan, along with the ability to run (with limited functionality) even if the Tushuguan isn't found.
 +
 
 +
When Wenlin starts up, it searches for the Tushuguan by various methods until it finds it or gives up. Some of these methods are different depending on the operating system, MS-Windows or Macintosh.
 +
 
 +
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 ... (incomplete...)
 +
 
 +
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.
  
 
<center>
 
<center>

Revision as of 16:04, 11 January 2012

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

Wenlin requires the presence of numerous files for correct operation. The required 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.

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.

New Features For Wenlin 4.1 (Under Construction)

New 4 1 s.png The required data folders must all be located inside the “Wenlin4” folder, or as of Wenlin 4.1, in the “WenlinTushuguan” folder.

Where Is The Tushuguan

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 really good reason to do otherwise.

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

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 still find the Tushuguan with its new location or name.

One of the new features of Wenlin 4.1 is increased flexibility in the location of the Tushuguan, along with the ability to run (with limited functionality) even if the Tushuguan isn't found.

When Wenlin starts up, it searches for the Tushuguan by various methods until it finds it or gives up. Some of these methods are different depending on the operating system, MS-Windows or Macintosh.

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 ... (incomplete...)

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.

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 |