Subject: Re: help request

From: Pu Jieming <[email-masked]>
Date: Tue, 8 Oct 1991 09:34:30 EST

----------------------------Original message----------------------------
To answer your request on the CCnet, I am sending you the help files ftped from
ahkcus.org.  To make it work you need binhex to decode it, since only ascii
files could be sent through network safely.

Tao

Date: Thu, 13 Jun 91 17:05:54 EDT
From: [email-masked] (Xing Li)

                 The Guidelines for Using MacHanzi
                 =================================

Basic:

* MacHanzi runs on any Macintosh (MacPlus and above).

* The Chinese Macintosh Operation System is NOT required.

* Put the font libraries in the same folder with the MacHanzi application,
  retain the font names (cclib.16 for the GB format and chinese.16 for the
  BIG5 format). If you were able to download MacHanzi from the anonymous
  ftp site and successfully uncompress the MacHanzi package, everything
  should be in the correct place.

* On opening MacHanzi, a standard Mac file list should appear, choose the
  Chinese Article you want to read. If strange characters appear on the screen,
  go to the Ziku menu [Guess, what Ziku stands for (-:], and choose the correct
  format. GB is the correct choice for the readers of "Hua Xia Wen Zhia",
  while BIG5 is the correct choice for the readers of "Chinese Articles
  from HKU".

* When you finish reading the current page, go to the Page menu and select
  Next, control-F is its short cut. This can also be done by clicking the
  mouse button.

* You can use the Page menu to choose the display size and the display format
  [horizontal - the modern way or vertical - the traditional way].

* There remains some bugs for updating the window, if the window becomes empty,
  you can  go to the Page menu and select First (control-0).  The first page
  of the current article will show on the screen.

* If you want to print the article, go to the File menu.  You can use the
  Page Setup and Print items.

* When the current article is finished, you can go to the File menu,
  Close the article and Open another one, or select Quit to go to the Finder.

Advanced:

* The Edit menu is currently disabled.  I think most of the users who use
  Chinese in the United States just want to be able to view and print Chinese
  articles.  If someone wants to type in and edit Chinese, he/she should
  switch to the Mac Chinese System. Apple has pretty good international
  systems.

* The Ziku menu is designed as follows: If only cclib.16 is found in the
  current folder, GB is enabled and BIG5 is disabled.  If only chinese.16 is
  found in the current folder, BIG5 is enabled and GB is disabled.  If both are
  present in the current folder, GB is the default choice, however, you can
  switch to the BIG5 format. Therefore, if you want to use GB and BIG5 at the
  same time, duplicate MacHanzi application (only 10 K), put it into another
  folder and move one of the font libraries into that folder. Then you can
  use multifinder to launch two MacHanzi applications. This can serve as
  a good previewer, if you are using HanziConverter 1.5.

* One of the features of MacHanzi is that it is not 'What You See Is What
  You Get'.  I hate to do this, but I think the current display technology
  is not satisfactory for Chinese text. I always feel that the
  Chinese characters printed on paper are too big, even if they are the
  same size as that displayed on the computer screen. Hence, when
  you want to print, choose 75% or 50%, the page will be reformatted and
  fill the whole page.

The MacHanzi is now available from two anonymous ftp sites.

ahkcus.org   [192.55.187.25] at /src/Mac
-rw-r--r--  1 yaom     source     672042 Jun 13 03:35 MacHanzi.hqx
-rw-r--r--  1 yaom     source       1356 Jun 13 03:34 MacHanzi.readme

crl.nmsu.edu [128.123.1.14]  at /pub/chinese
-rw-rw-r--  1 1145     other        1317 Jun 13 04:14 MacHanzi.README
-rw-rw-r--  1 1145     other      672042 Jun 13 04:15 MacHanzi.hqx

Please send comments about MacHanzi to:

Xing Li

xli\@king.mcs.drexel.edu
xing\@cbis.ece.drexel.edu

            User Help File for Reading HXWZ on the Mac
            ==========================================

                    Compiled By: Jack Sun
                       GR4486@SIUCVMB
              Last Modification: June 17th, 1991.

                      TABLE OF CONTENTS
------------------------------------------------------------------------
1.  What do you need to read HXWZ files on the Mac
2.  Transferring HXWZ files to your Mac
3.  Reading/editing/printing
4.  APPENDIXES

A1.  Reading HXWZ files with Beijing 4.3 System
A2.  Decoding UUEcoded HXWZ files
A3.  Where to get the Chinese Operating System files
A4.  How to get the programs needed for decoding/converting the files
A5.  A sample session of reading HXWZ files
A6.  Acknowledgement
------------------------------------------------------------------------

1.  What do you need: System Requirement
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  1.1.  A Macintosh Plus or above (Classic, SE, SE/30 ...) with at least
        2048k of RAM (chip memory capacity, not disk storage space).
  1.2.  Read and print: MacHanzi package;
  1.3.  Read/print/edit: ChineseTalk (The Chinese Operating System for the
        Mac)  "Beijing" version for GB files and "Taipei" version for Big5
        files.  Versions 6.0.x are required. Older versions like 4.3 can
        also be used with Clipboard Magician. (see Appendixes).
  1.4.  QRead 2.5, or Clipboard Magician 0.65, or MacWrite 4.x.
  1.5.  Programs "UUTool" or "Clipboard Magician" for decoding HXWZ
        files on the Mac; MacBinary for files conversion.
------------------------------------------------------------------------

2.  Transferring HXWZ files to your computer
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  2.1.  Transfer HXWZ files to your mainframe account

  On your Mainframe terminal, do the following (words inside <...>
  indicate command):

      <ftp 192.55.187.25> <Enter>, wait for "User" prompt;
      <ANONYMOUS> <Enter>, wait for password prompt.
       Type your Mainframe ID (userid), <Enter>
      <CD gb> <Enter>, change directories to GB file subdirectory.
      <CD cnd-cm> <Enter>, change directory to HXWZ.
      <LS> <Enter>, list the files.
      <BINARY> <Enter>, set the transfer mode to binary.
      <GET fn.ft fn.ft>, <Enter>, copy a file to your acct.
      <QUIT> <Enter>, end ftp session.

Note: 1. The first pair of file identifiers (fn.ft) are the remote file
name and file type, and they are case sensitive.  Therefore they have to
be EXACTLY the same with what you see on the file list.
2. Local file name file type are optional if the remote files have a
two-part identifier, such as README.TXT; 3. Make sure you have enough
space on your local minidisk when you want multiple files. 4. Type
HELP for available commands.

Note #2:  Use binary mode if you get files from /gb directory; use ascii
mode if you get files from /cnd-cm directory.  BIG5 files are in another
directory and there's a separated instruction there.  Files in /cnd-cm
are uuencoded therefore need to be uudecoded; files in /gb are not.
See related sections below.

2.2.  Transfer files from Mainframe to your Mac

2.2.1  If your Mac is connected DIRECTLY (not through phone line) to
    the Mainframe network, you may be able to get the files directly
    from the HXWZ site using MacTCP program.  If your Mac only has the
    local TCP capability, FTP the files from the Mainframe to your Mac,
    in binary mode.  The procedure is the same with 2.1.

2.2.2  If you have access to a DOS machine (IBM PC) that has the TCP
    program, AND your Mac is equipped with a High Density drive that can
    read DOS disks, you might want to FTP the file to the DOS disks first
    (either directly from HXWZ site or from local Mainframe), and then
    translate the files with AppleFileExchange.  To do so, follow these
    steps: (This would be much faster than through a modem)

      FTP the HXWZ files in binary mode to your 3.5 inch DOS disk;
      Open AppleFileExchange on your Mac;
      Select DOS-to-Mac translation;
      Select DEFAULT translation, deselect anything else;
      Select the file on the DOS disk and click TRANSLATE button.
      Use MacBinary to convert the file to readable form.

  Note: If MacBinery does not recognize the file, just change the
      TYPE to TEXT then it should be readable by TEXT editors.
      MacTool, ResEdit, DiskTop DA, DeskZap DA etc, all do the trick.

2.2.3  If you have to use a modem for transmission, it's up to you
    to decide the program suitable for your Mainframe connection.
    MacKermit, MicroPhone, Versaterm, RedRider etc. all have Kermit
    compatibility that the Mainframe uses to transfer files.
    Instructions are usally availabe at your local computing facilities.
.......................................................................

3.  Reading/Editing/Printing HXWZ files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3.1  Read/print with MacHanzi
  MacHanzi is a small programs with its own Ziku (dictioanry) file to
  read/print GB/BIG5 files without running a Chinese System.

     Open MacHanzi;
     Pull down OPEN from File menu;
     Open your HXWZ file;
     Click the mouse to read the next page;
     Print or close the file when you're done.

 Note: 1. You need only one of the Ziku files in your MacHanzi Folder:
 cclib.16 for GB files (simplifies characters) and chinese.16 for BIG5
 (traditional characters) files, depending on the source of your HXWZ
 files.  Remove the one that you don't need from the Folder.  2. Display
 size and vertical/horizontal orientation can be configured through
 their coresponding menu commands.  3. There are still bugs in screen
 refresh.  The best way to avoid screen blank-out is to do the
 configurations before you start reading a file.  If the screen goes
 blank (it happens), hold down command kay and press 0 should display
 the first page again.

3.2  Read/print HXWZ files with MacWrite 4.x.
  MacWrite 4.5/4.6 are capable of reading/printing Chinese files
  at default font size:

      Open MacWrite 4.x
      CLOSE the untitled window
      OPEN the HXWZ TEXT file
        (Click "Paragraph" button for cariage return prompt)
      Select the whole document (click at the very begining of the text,
        hold down the shift key, drag the scroll bar to the bottom of
        the text, click at the end of the text without releasing the
        shift key - this would "blacken" the whole thing)
      Select Beijing/Taipei font for the text

Note: The default font size is 12pt.  Don't attempt to change the size
- doing so would scrable the display.  The text can also be printed in
12pt without any editing.  Editing with MacWrite is not recommended.

3.3  Using QRead 2.5
  This Desk Accesory is a TEXT editor in nature.  It can edit/print
  files larger than 32k (most TEXT editors won't).

  To read/print a Chinese file, do this:

      Install the DA to your System file;
      Pull down QRead from <Apple> menu;
      Open the HXWZ file;
      If the display is not in Chinese, choose "Beijing/Taipei" font;
      Print the file if you want to.

Note:  QRead can read files larger than 32k.  However, it gives you
two options in case the file is large: truncate or "read only".
Select "read only" would not allow any editing (probably this is
just enough for most of us).  Truncate would cut the file to display
the first 32k of the file.

3.4  Using Clipboard Magician

  Clipboard Magician is a DA that can be used to view a Chinese
  file, and to "paste" the Chinese file to a TEXT editor.  It can also
  be used to read TEXT files within 32k limit, besides many other
  functions to manipulate the clipboard contents.

  To view/print a Chinese file, do this:

      Pull down Clipboard Magician from <Apple> menu;
      Click at the BLANK area at the left side panel;
         (to DESELECT TEXT/PICT whatever is in there)
      Double click at "Read TEXT files" on the main panel;
      Open your HXWZ file;Click at the main panel once;
      Hold down Option key and click at EDIT IT;
      Select Beijing/Taipei font as the default display font;
      View the first 32k of the file in Chinese.

Note: Clipboard Magician is a very powerful utility, naturally it is
also quite complicated.  If you don't feel very comfortable with it,
use QRead instead.

Note #2:  Both QRead and Clipboard Magician are Desk Accesory files.
You need Font/DA Mover to install them to the System file or Suitcase
to activate them.  You also need to put the Magic Wand file to the
System Folder in order to use Clipboard Magician.

.......................................................................
================   APPENDIXES   =================

A1.  Reading HXWZ files with Beijing 4.3 System
A2.  Decoding UUEcoded HXWZ files
A3.  Where to get the Chinese Operating System files
A4.  How to get the programs needed for decoding/converting the files
A5.  A sample session of reading HXWZ files
A6.  Acknowledgement

A1:  Reading HXWZ with Beijing 4.3 system
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  Beijing 4.3 System can not be used directly for HXWZ files.  Convertion
  is needed for HXWZ files to be displayed on Beijing 4.3 environment.
  If you only have Beijing 4.x, you need the following convertion:

      Activate Clipboard Magician
      Select "Read TEXT file..."
      Open the HXWZ file
      Click on the main panel
      Double click at "HGB to SGB"
      Paste the clipboard content to a TEXT editor and save it.

*** Note: Clipboard Magician doesn't seem to like System version 4.x.
So you need to do the convertion when a newer System is running (6.x).
Clipboard Magician can convert files between Beijing 6.0 and Beijing 4.0
(SGB -> HGB for 4.0 to 6.0, HGB -> SGB for 6.0 to 4.0).

A2: Decoding UUEcoded HXWZ files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    This item only applies to those who FTP HXWZ files from the directory
/cnd-cm, instead of /gb/cnd-cm.  Files in /gb/cnd-cm are not UUEncoded,
therefore no UUDecoding is needed.  However, files in /cnd-cm directory
are copies from the ccman-l, and they need to be UUDecoded.

Note: All files received from ccman-l are uuencoded;  all files in
/cnd-cm are encded.  Files in this directory need to be transferred
in ASCII mode, not Binary mode.

 A2.1  UUdecoding on UNIX Mainframe
    If your Mainframe is Unix based, the best way to decode the files
    is to do it at the Mainframe stage. Uudecode is a built-in function
    on unix.  Command:

        <uudecode filename> <Enter>, this would do the job.

 A2.2  UUdecoding on the Mac
  This one should works for most of us.

      FTP the program "UUTools" from the HXWZ utility directory;
      Transfer the HXWZ files in ASCII mode from /cnd-cm to your Mac;
      Decode the files with UUTools.

  UUTool is VERY easy to use:

      Launch the program;
      Pull down "File" menu;
      Select "Decode...";
      Select source file and save output file.

  You can also do uudecoding with Clipboard Magician:

      Put "Magic Wand" file to your Chinese System Folder;
      Install "Alchemist" DA;
      Pull down <Apple> menu to activate "Clipboard Magician";
      Double-Click "Read TEXT file" in the main panel;
      Select the source HXWZ file;
      Click at the main panel;
      Double-Click "uudecode" in the main panel;
      Paste the clipboard content to a TEXT editor.

Note: 1.  The instruction file that comes with the Magician package has
more detailed information.  Please read the instruction file for
other operations.  2.  HXWZ files in gb/cnd-cm directory are in straight
GB format that can be read by TEXT editors.
.......................................................................

A3: Getting the Chinese Operating System for the Mac
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A3.1  ChineseTalk from D E V E L O P magazine.

      Phone orders (have your credit card ready):
      USA:             800-545-9364
      Other countries: 815-734-6309
      Fax orders:      815-734-4205

      AppleLink orders (credit card numbers ready)
      E-mail Address:  [email-masked]

Note: D E V E L O P magazine delivers the software on its CD.  You
will have to get hold of a CD drive to copy the files to your floppy.
The Magazine cost about $30 a year.  Issue #6 with the new versions
of ChineseTalk on CD can be purchased seperately.

A3.2  ChineseTalk from Pacific Rim company

  The System and a Chinese WP program TurboWriter can also be
  purchased from Pacific Rim company in package form.  They sell
  TurboWrtor with either Beijing or Taipei System.  Each package
  costs about $400.

      Phone: 1-800-745-0911

A3.3  ChineseTalk from Linguists Software

  They have it available for $100 (much cheaper for the second copy
  in case you want to have both version).

      P.O.Box 580
      Edmonds, WA 98020-0580
      (206)775-1130

A3.4 The last and probably the best way to get it is to get hold of
   a developer friend.  This would cost the least if you are fully
   aware of the related legal issues.
......................................................................

A4: Getting the programs for reading/decoding HXWZ files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    All programs - Clipboard Magician, QRead, UUTools are available at
    the HXWZ utility directory for anonymous FTP.  Directory: src/mac.
    All programs are in ascii text form therefore need to be BinHex
    decoded.  Also they need to be "Unstuff"ed:

      <ftp 192.55.187.25>
      user  <anonymous>
      pass <your userid>
      <ascii>
      <get src/mac/QRead-25.hqx>

  After you have got this file in ASCII mode to your Mac:

      Open StuffIt 1.5
      Pull down "OTHER" menu, activate item "Decoding BinHex..."
      Select file QRead-25.hqx, click "Open" button
      Save the output file "QRead2.5.sit"
      Pull down "File" menu, activate item "Open Archive..."
      Select QRead-25.sit, click "Open" button
      Click QRead2.5 on the list window
      Click the "Unstuff" Icon
      Save the output file.

  Follow the same way for UUTool-12.hqx, Clipboard-Magician-065.hqx,
  MacBinary.hqx, and MacHanzi.hqx, etc.

Note: If you don't have StuffIt, you will have to find help from a
friend.  Leave me a note if you can't find help locally.
........................................................................

A5: A sample session of reading HXWZ files
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    Here at SIU we use IBM 3081 Mainframe running VM/CMS
    system.  There are many IBM PS/2 connected in a TokenRing
    network in the lab with IBM TCP program, which is VERY fast
    in file transfer.  I use a SE/30 with FDHD and 5 meg of RAM.

Here's how I read the HXWZ files in this environment:

A5.1  From HXWZ site to SIU

      FTP 192.55.187.25
      User anonymous
      Pass gr4486@siucvmb
      cd gb
      cd cnd-cm
      ls
      binary
      get cm9104b.gb
      quit

A5.2  From CMS to DOS disk

      FTP 131.230.1.2
      User GR4486
      Pass (mypasswd)
      Acct (myacct)
      Binary
      get cm9104b.gb A:cm9104b.gb
      quit

A5.3  From DOS format to Mac format

      Open AFE; use default translation to translate the DOS file to my
      HD; Change the file Type to TEXT; Use MacWrite to read it.

.......................................................................

A6: Acknowledgement
^^^^^^^^^^^^^^^^^^^
This Help file has been compiled with information from all over
the world.  The process has been: People send their pieces to Rupert,
and Rupert forward them to me, and I extract the information and
put it into the orderly manner. Credits ought to be given to the
following individuals:

Ming Yau So ([email-masked])
Petter Bryder Weng ([email-masked])
Jiuhuai Lu ([email-masked])
Ed Lai ([email-masked])
MINGHUI YAO (YAOM@ASUCPS)
Huangxin Wang ([email-masked])
Rupert Zhu ([email-masked])
Xing Li ([email-masked])

and many other individuals that I don't have their names handy.
Without their input this file would not have been possible even after
the long delay.

Clipboard Magician is Written by Ed Lai at Apple Computer Inc.,
dedicated to the fighters for democracy in China;
QRead is written by Huangxin Wang of University of Pennsylvania, who
has decided to sell his Mac Plus for some beer now.
UUTool is written by Bernie Wieser of Octavian Micro Development
Group.  MacHanzi is a contribution from Xing Li of Drexel.
All programs are free, but are copyrighted by their respective authors.

***********************************************************************
Disclaimer:  I have no connection with any of the companies
mentioned in this file.  As a Behavior Psychologist and MBA student,
I cannot live without my Mac, so I am happy to help other Chinese
Mac users to make their lives easier.

All opinions expressed in the software or the HXWZ magazine are
their authors or their publishers, not mine.

This file is meant to be updated to cover new information.  Please
feel free to send your feedback/comment to me for future revision.

Jack Sun <GR4486@SIUCVMB> or <[email-masked]>

***********************************************************************