User Help File for Reading HXWZ on the Mac ========================================== Compiled By: Jack Z. Sun GR4486@SIUCVMB Last Modification: Feb 24, 1992. TABLE OF CONTENTS ------------------------------------------------------------------------ 1. What do you need to read HXWZ on the Mac 2. Transferring HXWZ files to your Mac 3. Reading/editing/printing 4. APPENDIXES A1. Decoding UUEcoded HXWZ files A2. Where to get the Chinese Operating System A3. Getting the program A4. A sample session of reading HXWZ A5. 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, 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. 1.4. QRead DA, or Clipboard Magician DA, or MacWrite 4.x. 1.5. Programs "UUTool" or "Clipboard Magician" for decoding HXWZ files on the Mac. ------------------------------------------------------------------------ 2. Transferring HXWZ files to your computer ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 2.1. Transfer HXWZ files to your mainframe account If you are not subscribing to CCMAN-L, you need to transfer the HXWZ files to your mainframe computer. On your Mainframe terminal, do the following (words inside <...> indicate command): , wait for "User" prompt; , wait for password prompt. Type your Mainframe ID (userid), , change directories to GB file subdirectory. , change directory to HXWZ. , list the files. , set the transfer mode to binary. , , copy a file to your acct. , end ftp session. Note: 1. The first pair of file identifiers (fn.ft) are the remote file name and file type, such as "cm9201d.gb", must be EXACTLY the same with what you see on the list. 2. Local file name file type are optional if the remote files have two-part identifiers, such as README.TXT; 3. Make sure you have enough space on your local account when you want multiple files. Note 2: Use binary mode if you get files from /gb/cnd-cm directory; 2.2. Transfer files from Mainframe to your Mac 2.2.1 If your Mac is connected DIRECTLY (not through phone line) to internet network, you should be able to get the files directly from the HXWZ site using MacTCP program to your Mac. If your Mac only has 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 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 most Mainframe computers use to transfer files. Instructions are usually available @ your local computing facilities. Make sure is that you download HXWZ files in BINARY mode, save as TEXT file in DATA fork. ....................................................................... 3. Reading/Editing/Printing HXWZ files ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 3.1 Read/print with MacHanzi MacHanzi is a small programs with its own Ziku (dictionary) file to read/print GB/BIG5 files without running a Chinese Operating 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. Remove the one that you don't need from the Folder. 2. Display size and vertical/horizontal orientation can be configured through their corresponding menu commands. 3. The best way to avoid screen blank-out is to configure the screen orientation first, that is, do the configurations before you start reading a file. If the screen goes blank (it happens), hold down command key and press 0 should display the first page again. Note 2. Make sure that the file TYPE of the HXWZ packages are TEXT for MacHanzi to recognize them in the Open File dialog box. 3.2 Read/print/edit HXWZ files with MacWrite 4.x. MacWrite 4.5/4.6 are capable of reading/printing Chinese files at default font size (12pt), if you have a Chinese Operating System Startup the Mac with the Chinese OS Open MacWrite 4.x CLOSE the untitled window OPEN the HXWZ TEXT file (Click "Paragraph" button for carriage return prompt) Select the whole document (click at the very beginning 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 font for the text Note: The default font size is 12pt. Attempting to change the size could mess up the display. The text can also be printed in 12pt without any editing. Editing with MacWrite is not very pleasant. 3.3 Using QRead DA (Desk Accessory under the Apple menu) This Desk Accessory 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 menu; Open the HXWZ file; If the display is not in Chinese, choose "Beijing" font; Print the file if you want to. Note: QRead can read files larger than 32k. However, you need to decide if you want the file be truncateed 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. Chinese OS is required for QRead DA. 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 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 Accessory files. You need Font/DA Mover to install them to the Chinese 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. Decoding UUEcoded HXWZ files A2. Where to get the Chinese Operating System A3. Getting the program A4. A sample session of reading HXWZ A5. Acknowledgement A1: Decoding UUEcoded HXWZ files ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Read this section only if you FTP HXWZ files from the directory /cnd-cm, instead of /gb/cnd-cm (files in /gb/cnd-cm are not UUEncoded). However, files in /cnd-cm directory are copies from the ccman-l, and they need to be UUDecoded. All files distributed by ccman-l are uuencoded; all files in /cnd-cm are encoded. Files in this directory need to be transferred in ASCII mode, not Binary mode. A1.1 UUdecoding on the Mac with UUTool 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. A1.2 UUdecoding with Clipboard Magician: Put "Magic Wand" file to your Chinese System Folder; Install "Alchemist" DA; Pull down 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 directly. ....................................................................... A2: Getting the Chinese Operating System for the Mac ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ A2.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: dev.subs@applelink.apple.com 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 has Taipei 6.0.6 and Beijing 6.0.7, and can be purchased separately. A2.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 A2.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 A2.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. ...................................................................... A3: Getting the programs for reading/decoding HXWZ files ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ All programs - Clipboard Magician, QRead, UUTools have been made available at the HXWZ utility directory for anonymous FTP. Directory: src/mac. All programs are in ascii text form (for this section) therefore need to be BinHex decoded and to be "Unstuff"ed. A3.1 Downline is THE program that you need to get most of the programs in usable form: user pass Note: Check to make sure the exact name for Downline, including the case of each letter in the name. Download this file to your Mac in Macbinary form. It should be an auto-extractable Application (program). To use Downline: double click on its icon pull down "Options" from FILE menu configure the input/output directory and other preferences click "Do It" button If you have .hqx files in your "input directory", downline would un-hqx them and unstuff them. Next time when you run Downline, it would do the operations automatically if you have files in the input-directory. "Bad" files are kept in a separate directory for further manipulation. A3.2 StuffIt is another widely used program for files compression / decompression, as well as conversion of .hqx files. To get it: FTP GET it from /src/mac directory in ASCII mode, Decode with Downline. It should be a usable program now. Follow the same route with all the other .hqx files in the same directory. Note: All .hqx files should be transferred in ASCII mode (TEXT). ........................................................................ A4: 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. A4.1 From HXWZ site to SIU FTP 192.55.187.25 User anonymous Pass gr4486@siucvmb cd gb cd cnd-cm ls binary get cm9204b.gb quit A4.2 From CMS to DOS disk FTP 131.230.1.2 User GR4486 Pass (mypasswd) Acct (myacct) Binary get cm9204b.gb A:cm9104b.gb quit A4.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. (AFE stands for AppleFileExchange). ....................................................................... A5: 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 (mings@cs.uoregon.edu), Mac expert. Petter Bryder Weng (Peter.Bryder@teol.lu.se), Mac expert. Jiuhuai Lu (jiuhuai@eleazar.dartmouth.edu), Mac expert. Ed Lai (lai@apple.com), Mac developer, author of ClipboardMagician. MINGHUI YAO (YAOM@ASUCPS), HXWZ editor. Huangxin Wang (wang@penn.physics.edu), Mac expert, author of QRead. Rupert Zhu (RZHU@Watmath.waterloo.edu), HXWZ editor, computer guru. Xing Li (xli@mcs.drexel.edu), Mac developer, author of MacHanzi. 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, if nobody else helps. UUTool is written by Bernie Wieser of Octavian Micro Development Group. MacHanzi is a contribution from Xing Li of Drexel. All programs are copyrighted by their respective authors. Some are free some of them may requires shareware fees. Please support shareware so we all can benefit from it. *********************************************************************** 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 or ***********************************************************************