Using the XML Disc - Linux

In this explanation, we will presume that you're putting everything in your /usr/local directory. If you don't have root privileges, or want to use a a different path like /home/username, that's fine; you'll just have to “translate” the path in these instructions.

Note also that the version numbers for some of the packages on the disc are greater than those installed at Evergreen Valley; your disc contains more recent versions.

First, copy the xmljar directory from the CD-ROM to your /usr/local directory.

All of the XML tools on this disc require Java 1.3 or above. If you don't have Java installed on your system, go to the linux directory on the CD-ROM and run the j2sdk-1_4_2-linux-i586.bin file. This will install the Java Software Development kit on your machine.

If you didn't copy xmljar to the /usr/local directory, you must modify the shell files to work on your system. As instructed on that page, you'll copy and paste the commands into a file that you'll save on your system. You'll then replace occurrences of /usr/local with the path to the directory where your xmljar directory lives.

What's On The Disc

This section is provided for those folks who just have to know what is on the disc. Thus, it's going to use a lot of terminology that hasn't been explained in the class yet. Don't worry; you don't have to read this section to use the tools.

The xmljar directory

xerces-2_5_0

The Xerces XML parser. This is the tool used to check for well-formedness and validity with DTDs

msv

Sun's Multi-Schema Validator. This is the tool used to check XML files for validity in conjunction with Relax NG grammars.

xalan-j_2_5_1

The Xalan transformation program. This is the tool that we will use to transform XML to XHTML.

fop-0.20.5

A tool for converting documents from XSL Formatting Objects (a page layout markup language) to PDF. See the “bonus lecture notes” for more information about XSL Formatting Objects.

xpath_visualizer_1_0_1

This utility lets you type XPath expressions and see which nodes in an XML document match that expression. The xpathvis.sh shell file is set up to run to the program on the Unix systems at Evergreen Valley.

batik-1.5

A set of tools for viewing and manipulating Scalable Vector Graphics (SVG) files. You can run it with this command on Linux:

java -jar /usr/local/xmljar/batik-1.5/batik-squiggle.jar

jeditsrc

A Java-based text editor, designed for writing programs, but will do great for XML documents.

jing.jar

Another tool used to validate XML files in conjunction with Relax NG. We don't use this one in the course.

jakarta-tomcat-4.1.10

A Java servlets implementation; we won't need it in this class.

The linux directory

j2sdk-1_4_2-linux-i586.bin

The Java Software Development Kit.

mozilla-i686-pc-linux-gnu-1.4-sea.tar.gz

Mozilla 1.4. Use this command:

tar xvzf mozilla-i686-pc-linux-gnu-1.0-sea.tar.gz

to un-gzip and un-tar the file. This will create a directory named mozilla-installer. Read the README file, then run the script mozilla-installer/mozilla-installer.