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 De Anza; 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 j2re-1_3_1_03-linux-i386.bin file. This will install the Java runtime environment 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_1_0

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

crimson-1.1.3

Another XML parser. We don't use it in this course.

msv

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

jing.jar

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

xalan-j_2_3_0

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

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 computers at De Anza.

Xerlin

A not-very-sophisticated XML editor. To run the editor under Linux, go into the directory (/usr/local/xmljar/Xerlin) and run the Xerlin.sh file.

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

fop-0.20.4

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.

The linux directory

j2re-1_3_1_03-linux-i386.bin

The Java Runtime Environment (JRE). All of the files whose names begin with install-linux are part of the JRE.

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

Mozilla 1.0. 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.