JChm User Guide

Thank you for   your using JChm, which is released under the terms of  CDDL v1.0 or higher version. (You should be able to find a copy cddl.htm in this package. If it doesn't exist, you can always find it at http://www.sun.com/cddl/cddl.html). Any other rights not stated in CDDL is reserved for wrighter. All programs and documents are provided "AS IS" without warranty of any kind. If you have any questions, you can contact with me:)yfbio@hotmail.com.

JChm is a reader for chm format files, which have an extensive name *.chm on Microsoft Window OS(you are very familiar with it Urh:). Anyway, it's easy to view CHM file on Windows yet not on other OS like Solaris or Linux. But now, you can use  JChm, which is a java program and can run on any operating systems if JVM is installed. Now you can see snapshots of screen when JChm run on Windows XP, Debian Linux and Solaris. So, it really RUN ANYWHERE, and you can read *.Chm file on any OS.

Hopefully, JChm will support many languages listed below: 

Arabic
Brazilian
Bulgarian
Catalan
Chinese (Simplified)
Chinese (Traditional)
Chinese (Hong Kong)
Croatian
Czech
Danish
Dutch
English
Estonian
Finnish
French
German
Greek
Hebrew
Hungarian
Italian
Japanese
Korean
Latvian
Lithuanian
Norwegian
Polish
Portuguese
Romanian
Russian
Slovak
Slovenian
Spanish
Swedish
Thai
Turkish

    Installation and running of JChm are very easy, here are steps£º

    1¡¢Before you run JChm you should have already installed JVM(Java Virtual Machine).If not, you can download installation special packages for your OS from SUN site http://java.sun.com/j2se/1.4.2/download.html¡£JChm is developed on j2sdk1.4.2_10, and not tested on previoud version, so J2SE v 1.4.2_10  JRE  are recommended. You can download and install the JVM according to its user guide. Ok, now you set CLASSPATH and environment variations correctly.

    2¡¢Now, we uncompress our JChm package into your destinated directory.

On windows, double click on JChm.bat, which is under JChm directory, will run it¡£

On linux or solaris, you should make it executable before your first time by executing the following command in console:

chmod +x JChm.bat

then you can run JChm by double clicking JChm.bat at any time.

If you'd like to run JChm in console,you should set current directory path to the directory which have the package and execute the following command: 

java org.yufeng.jchmviewer.JChmWindow

just like the following picture£º

¡¢

    If you want to run the jar file£¬you should enter into that directory and run:

java -jar jchmlib.jar

like below picture

 

  3¡¢When you run the JChm, the main window will appear with left part and right part. You can click the File menu and select the Open item, and an file-opening dialog will pop out. Browse and select the Chm file you want to read (like following picture) and click the OK button, the directory of this file will be listed in left window like a tree. 

  3¡¢Double click of the branch will expand the directory branch and that of the leaf will make the file shown in the right window. It seems like the following picture:

   4¡¢The super link in the web page displayed in right window is also able to be clicked and it will jump to the page, or even the website, you want to go just like an IE or Mozilla.

   5¡¢If you need to save the current page you are reading, click File menu and select item "Extract Page..." and a file-saving dialog will appear. Input the file name and click the OK button will made it saved.

   6¡¢If you want to save all files compressed in this Chm file, click File menu and select item "Extract All Page" ,  navigate to your destinated directory and click OK button will save all these files with their original hierarchic directory kept.

   7¡¢If you need help, please click Help menu and select item "Content" item, this help file will display in the right window.

   8¡¢If you want to know the author( I'm honored:) and version message, click Help menu and select item "About"¡£

   9¡¢Want to exit? Hmm, you can click File menu and select item "Exit", or simply click the close button in the right-up of the main window.

   10¡¢If you want...£¬other functions doesn't come out still.

If you have any good idea or problems, please don't hesitate to contact me£º£©yfbio@hotmail.com

  Many thanks to Jed Wing for the decoding of chm format¡£

                                                             replicon  2006.02.16

Appendix£º

Snapshot of JChm on windowsXP£º

Snapshot of JChm on Debian linux£º

Snapshot of JChm on Solaris10.0£º