XMLRésuméLibrary: User Guide

Installing and Configuring the Software

XML Résumé Library

The XML Résumé Library comes in a tarball (or zip archive aimed at Windows users) that includes:

  • The DTD

  • XSL stylesheets, for converting your XML résumé to plain text, HTML, or XSL Formatting Objects (XSL-FO). (XSL-FO can then be rendered to PDF by an FO processor like FOP.)

  • Some sample résumés in XML format

  • A Makefile, for generating résumé formats with a simple make command

  • A few CSS stylesheets that can be used to fine-tune the appearance of the HTML version of your résumé.

The most straightforward way to make use of these resources is to recursively copy the "examples" directory to where you want to work with your résumé. For instance:

[resume-1_5_1]$ cp -a examples ~/resume

The Makefile uses the filename resume.xml by default. If this is unacceptable you will need to edit the line resume = resume to match the filename you use, such as resume = myresume if your résumé is myresume.xml.

Tip

You can also indicate your résumé filename on the command line when you build your résumé, e.g.:

[resume]$ make resume=myresume

Note

The DTD and XSL files you've downloaded to your computer aren't used by default when building your résumé. Instead, the versions on the XML Résumé Library web site are used. This ensures that you're always using the most recent version; however, it also means that builds take longer (since file have to be downloaded each time you build your résumé) and that you can't build a résumé offline.

If you'd like to use your local copy of the XSL stylesheets, edit the xsl_base variable in the example Makefile to point to your local XSL directory. For example:

xsl_base = ~/resume-1_5_1/xsl

To use your local copy of the DTD, change the DOCTYPE declaration at the top of your resume to look like this:

<!DOCTYPE resume PUBLIC "-//Sean Kelly//DTD Resume 1.5.1//EN"
  "~/resume-1_5_1/dtd/resume.dtd">

Xerces, Xalan, and FOP

Each of these three packages need to be untarred and their jar files copied to your JRE's ext/ directory. This is typically /usr/java/jdk1.3.1_02/jre/lib/ext/, but may vary depending on who packaged your JRE. We will simply refer to it as the ext/ directory.

Xerces consists of the jars xmlParserAPIs.jar, xercesSamples.jar, and xercesImpl.jar, which are in the top directory of the Xerces zip archive.

Xalan consists of the jars runtime.jar, xalanservlet.jar, xalansamples.jar, regexp.jar, JLex.jar, java_cup.jar, bsf.jar, xml-apis.jar, BCEL.jar, xsltc.jar, xalan.jar, and xercesImpl.jar in the bin/ directory. All of these need to be copied to the ext/ directory.