<html><head> <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> <title>Installing and Configuring the Software</title><link rel="stylesheet" href="manual.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.57.0"><link rel="home" href="index.html" title="XML Résumé Library User Guide"><link rel="up" href="getting-started.setup.html" title="Chapter 1. Setting up the XML Résumé Library"><link rel="previous" href="getting-started.setup.software.html" title="Getting the Software"><link rel="next" href="getting-started.explore.html" title="Chapter 2. Exploring the Features of XML Résumé Library"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><h1 class="pageTitle"><a href="../../index.html"><span style="color: red;">XML</span><span style="font-weight: bold;">Résumé</span><span style="color: red;">Library</span></a>: <a href="index.html">User Guide</a></h1><div class="navheader"><table width="100%" summary="Navigation header"><tr><td align="left" width="33%"><a accesskey="p" href="getting-started.setup.software.html"><img src="caret-l.gif" width="11" height="7" border="0" alt="Previous">Getting the Software</a> </td><td align="center" width="34%"><a accesskey="u" href="getting-started.setup.html"><img src="caret-u.gif" width="11" height="7" border="0" alt="Up">Setting up the XML Résumé Library</a></td><td align="right" width="33%"> <a accesskey="n" href="getting-started.explore.html">Exploring the Features of XML Résumé Library<img src="caret-r.gif" width="11" height="7" border="0" alt="Next"></a></td></tr></table></div><div class="section" lang="en"><div class="titlepage"><div><h2 class="title" style="clear: both"><a name="getting-started.setup.install"></a>Installing and Configuring the Software</h2></div></div><div class="section" lang="en"><div class="titlepage"><div><h3 class="title"><a name="getting-started.setup.install.xmlresume"></a>XML Résumé Library</h3></div></div><p> The XML Résumé Library comes in a tarball (or zip archive aimed at Windows users) that includes: </p><div class="itemizedlist"><ul type="disc"><li><p>The DTD</p></li><li><p> 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.) </p></li><li><p>Some sample résumés in XML format</p></li><li><p> A Makefile, for generating résumé formats with a simple <b>make</b> command </p></li><li><p> A few CSS stylesheets that can be used to fine-tune the appearance of the HTML version of your résumé. </p></li></ul></div><p> </p><p> 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: </p><div class="informalexample"><pre class="screen">[resume-1_5_1]$ cp -a examples ~/resume</pre></div><p> </p><p> The Makefile uses the filename <tt>resume.xml</tt> by default. If this is unacceptable you will need to edit the line <tt>resume = resume</tt> to match the filename you use, such as <tt>resume = myresume</tt> if your résumé is <tt>myresume.xml</tt>. </p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>You can also indicate your résumé filename on the command line when you build your résumé, e.g.: </p><div class="informalexample"><pre class="screen">[resume]$ make resume=myresume</pre></div><p> </p></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p> 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. </p><p> If you'd like to use your local copy of the XSL stylesheets, edit the <tt>xsl_base</tt> variable in the example Makefile to point to your local XSL directory. For example: </p><div class="informalexample"><pre class="programlisting">xsl_base = ~/resume-1_5_1/xsl</pre></div><p> </p><p> To use your local copy of the DTD, change the <tt>DOCTYPE</tt> declaration at the top of your resume to look like this: </p><div class="informalexample"><pre class="programlisting"><!DOCTYPE resume PUBLIC "-//Sean Kelly//DTD Resume 1.5.1//EN" "~/resume-1_5_1/dtd/resume.dtd"></pre></div><p> </p></div></div><div class="section" lang="en"><div class="titlepage"><div><h3 class="title"><a name="getting-started.setup.install.xml-tools"></a>Xerces, Xalan, and FOP</h3></div></div><p> Each of these three packages need to be untarred and their jar files copied to your JRE's <tt>ext/</tt> directory. This is typically <tt>/usr/java/jdk1.3.1_02/jre/lib/ext/</tt>, but may vary depending on who packaged your JRE. We will simply refer to it as the <tt>ext/</tt> directory. </p><p> Xerces consists of the jars <tt>xmlParserAPIs.jar</tt>, <tt>xercesSamples.jar</tt>, and <tt>xercesImpl.jar</tt>, which are in the top directory of the Xerces zip archive. </p><p> Xalan consists of the jars <tt>runtime.jar</tt>, <tt>xalanservlet.jar</tt>, <tt>xalansamples.jar</tt>, <tt>regexp.jar</tt>, <tt>JLex.jar</tt>, <tt>java_cup.jar</tt>, <tt>bsf.jar</tt>, <tt>xml-apis.jar</tt>, <tt>BCEL.jar</tt>, <tt>xsltc.jar</tt>, <tt>xalan.jar</tt>, and <tt>xercesImpl.jar</tt> in the <tt>bin/</tt> directory. All of these need to be copied to the <tt>ext/</tt> directory. </p></div></div><div class="navheader"><table width="100%" summary="Navigation header"><tr><td align="left" width="33%"><a accesskey="p" href="getting-started.setup.software.html"><img src="caret-l.gif" width="11" height="7" border="0" alt="Previous">Getting the Software</a> </td><td align="center" width="34%"><a accesskey="u" href="getting-started.setup.html"><img src="caret-u.gif" width="11" height="7" border="0" alt="Up">Setting up the XML Résumé Library</a></td><td align="right" width="33%"> <a accesskey="n" href="getting-started.explore.html">Exploring the Features of XML Résumé Library<img src="caret-r.gif" width="11" height="7" border="0" alt="Next"></a></td></tr></table></div></body></html>