$Id: WQY_WhiteDragon_INSTALL 0.6 Rev. 0 2005/8/8 23:59:12 qianqianfang Exp$

========================================================== 

               Wen Quan Yi Bitmap Song 

                  Installation Guide

----------------------------------------------------------

The WenQuanYi Bitmap Song font (medium and bold weight) was
packaged into two equivalent formats: BDF (Bitmap Distribution 
Format) and PCF (Portable Compiled Format). Both formats are
supported by most modern X-window systems. You can choose 
either format based on your preference.

For Debian (or its variants) users, in order to use this bitmap 
font, you need first to unlink "no-bitmaps.conf" located 
under /etc/fonts/conf.d/ directory.


1. download

You need first to download the installation package from
our sourceforge download site at

http://sourceforge.net/project/showfiles.php?group_id=128192&package_id=156288

choose the latest release and select font format, save the
installation package to a temporary directory, for example /tmp.

2. decompress

The package is compressed with tar and gzip, use the following 
command

  gunzip wqy-bitmapfont*.tar.gz
  tar xvf wqy-bitmapfont*.tar

or 

  tar zxvf wqy-bitmapfont*.tar.gz

3. relocate

All files will be extracted to a directory: ./WenQuanYi, you 
need to move this directory to the location where you want 
to install the font, a good place is 
/usr/share/fonts/Chinese/WenQuanYi .

To move the directory, you need to use "su" or "sudo" to obtain
root privilege. (If you don't have root privilege, please
refer to Section II.6)

4. font path setup

Now you need to tell X-window to find the installed font. 
Assuming you have installed the package to 
/usr/share/fonts/Chinese/WenQuanYi/

you need to use the following commands:

   cd /usr/share/fonts/Chinese/WenQuanYi/Bitmap/
   rm fonts*
   mkfontdir
   cp fonts.dir fonts.scale
   xset +fp /usr/share/fonts/Chinese/WenQuanYi/Bitmap/

the last command adds the font path to the X-window font path
list. To permanently add this path, you need to add 
"/usr/share/fonts/Chinese/WenQuanYi/Bitmap," to /etc/X11/fs/config
under the line "catalogue =/usr/lib/X11/fonts/misc/,". 

Most recent versions of Linux X programs support fontconfig, to
inform fontconfig of this bitmap font, you need to type

   fc-cache -f -v

If you have already installed True-Type Chinese fonts on your system,
the new font may not be used instantly. You need either choose
this font from preference\font options or temporarily remove
the True-Type font in order to activate this bitmap font. 
We are working on a fontconfig solution to use the bitmap font 
while keeping the existing True-Type fonts.

5. test

To test if the font is successfully installed, the following 
command

   xset q

should correctly display the path of the font. And

   /usr/X11R6/bin/xlsfont | grep 'wenquanyi'

would print something like followings

   -wenquanyi-wenquanyi bitmap song-bold-r-normal--0-0-75-75-p-0-iso10646-1
   -wenquanyi-wenquanyi bitmap song-bold-r-normal--12-120-75-75-p-80-iso10646-1
   -wenquanyi-wenquanyi bitmap song-bold-r-normal--13-130-75-75-p-80-iso10646-1
   -wenquanyi-wenquanyi bitmap song-bold-r-normal--15-150-75-75-p-80-iso10646-1
   -wenquanyi-wenquanyi bitmap song-bold-r-normal--16-160-75-75-p-80-iso10646-1
   -wenquanyi-wenquanyi bitmap song-medium-r-normal--0-0-75-75-p-0-iso10646-1
   -wenquanyi-wenquanyi bitmap song-medium-r-normal--12-120-75-75-p-80-iso10646-1
   -wenquanyi-wenquanyi bitmap song-medium-r-normal--13-130-75-75-p-80-iso10646-1
   -wenquanyi-wenquanyi bitmap song-medium-r-normal--15-150-75-75-p-80-iso10646-1
   -wenquanyi-wenquanyi bitmap song-medium-r-normal--16-160-75-75-p-80-iso10646-1

for fontconfig, you need 

   fc-list | grep 'WenQuanYi'

you should be able to see two lines started with 
"WenQuanYi Bitmap Song" printed.

6. installation as a normal user

If you do not have root privilege, for example, you are using 
public machine, to install this font is also very simple. 
If you are using KDE, find "Control Center" from the K-menu, 
choose "System Administration" and click on "Font Installer", 
right click on the middle panel, choose "add font", locate the 
extracted fonts (bdf/pcf.gz) files.

If you are using Gnome environment, double click on "Computer",
type "fonts:/" on the address bar, and type enter. Open another
file browser and select the bdf/pcf.gz font files, drag or 
copy/paste to the fonts:/ folder.

If you do not have X-window started, you can also install the 
font by extracting the files to ~/.fonts directory (if it does 
not exist, create one after confirming you have installed 

fontconfig).

7. Turn on Chinese language support on your system

To correctly display use this font, your system should
support Chinese language. You can put the following line

 LC_CTYPE=zh_CN.UTF-8

into ~/.i18n and reboot your system (you can also use other 
locales in the output list of "ls -d /usr/lib/locale/zh_*"). 
To enable command line Chinese 
message, replace "LC_CTYPE" by "LC_ALL". If you want all menu displayed
with Chinese language, on KDE, goto "Control center", expand "Region and
Assistance", find "Country/Region and Language", choose "Chinese" from 
"Add language"; if you are using Gnome, you need to select "Preference"
and select "Language", then add "Chinese". Restart your X or system
if necessary to enable this setting.

========================================================== 
$Id: WQY_WhiteDragon_INSTALL 0.6 Rev. 0 2005/8/8 23:59:12 qianqianfang Exp$
