For XML Résumé Library Version 1.5

XML Résumé Library User GuideFor XML Résumé Library Version 1.5.1by Bruce Christensen

XML Résumé Library User Guide: For XML Résumé Library Version1.5.1by Bruce ChristensenPublished 30 November 2002Copyright 2002 Bruce ChristensenPeter HutnickMark MillerPermission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 orany later version published by the Free Software Foundation; with no invariant sections, with no Front-Cover Texts, and with no Back-CoverTexts. A copy of the license is included in the section entitled “GNU Free Documentation License”.

Table of ContentsIntroduction .What is the XML Résumé Library? . 1I. Getting Started .1. Setting up the XML Résumé Library .Prerequisites .3Getting the Software .3Installing and Configuring the Software . 42. Exploring the Features of XML Résumé Library .Formatting an example resume . 6Advanced Features of the XML Résumé Library . 6Writing your first XML Résumé . 8Where to Go from Here . 8About this chapter .8II. Reference .I. Element Reference .academics .13achievement .14achievements.15address .16annotation .18artTitle .19author .20award.22awards .23birth .24bookTitle .25break .26citation .27city .28clearance .29clearances .30company .31contact .32copyright .33country .34county .35date .36dayOfMonth .37degree .38degrees .40description .41docpath .42email .43emphasis .44employer .45fax .47firstname .48from .49gpa .50head .51header .52history .54instantMessage .56iv

XML Résumé Library User Guideinstitution .58interest .59interests .60job .62jobtitle .64keyword .65keywords .66label .67lastModified .68legalnotice .69level .70link .71location .72major .73membership .74memberships .75middlenames .76minor .77misc .78month .79name .80node .81note .82objective .83organization .84pageNums .85pager .86para .87period .88phone.89possible .90postalCode .91prefecture .92present .93project .94projects .95province .96pub .97pubDate .99publisher .100pubs .101referee .102referees .103result .104resume .105resumes .109score .111skill .112skillarea .113skillareas .115skills .117skillset .118state .119street .120street2 .121subject .122subjects .123suburb .124v

XML Résumé Library User Guidesuffix .125surname .126tail .127title .128to .130uri .131url .132ward .134year .135zip .136II. XSL Parameter Reference .address.format .138css.href .139header.format .140interest.description.format .141referees.display .142skills.format .143skills.level.display .144subjects.format .1453. CSS Class Reference .Overview.146Glossary .III. Appendixes .A. GNU Free Documentation License .PREAMBLE .150APPLICABILITY AND DEFINITIONS .150VERBATIM COPYING .151COPYING IN QUANTITY .151MODIFICATIONS .152COMBINING DOCUMENTS .153COLLECTIONS OF DOCUMENTS .153AGGREGATION WITH INDEPENDENT WORKS . 153TRANSLATION .154TERMINATION.154FUTURE REVISIONS OF THIS LICENSE . 154How to use this License for your documents . 154vi

IntroductionTable of ContentsWhat is the XML Résumé Library? . 1What is the XML Résumé Library?The XML Résumé Library is, at its heart, a DTD, a Document Type Definition. That means it is really someone'sidea of how a résumé should, or at least could, be structured in XML. Beyond that, it comes with Several XSLT style sheets (used to convert the XML version of a résumé to other formats such as plaintext,HTML, PDF, and if you're lucky, RTF). A Java-based filter to help you target your résumé(s) toward a particular industry, employer, or job. CSS stylesheets, used to control the presentation of the HTML version. A helpful Makefile that you can customize for your own purposes.i

Part I. Getting Started

Chapter 1. Setting up the XML RésuméLibraryPeter HutnickEdited by Bruce ChristensenMark MillerCopyright 2002 Peter HutnickTable of ContentsPrerequisites .3Getting the Software .3Installing and Configuring the Software . 4This chapter explains how to install the XML Résumé Library, an Open Source, XML based résumé managementsystem, on UNIX systems. It is written based on the author's experience installing on a Red Hat Linux system. Othersystems may vary somewhat.PrerequisitesJavaThe resources in this document provide enough information to convert your XML résumé to HTML, PDF, and plaintext. The programs to exploit these resources, however, are not included. Any capable XML parser, XSLT stylesheetprocessor and XSL formatting objects processor will get the job done. Many of the XML Résumé Library developers use the free tools produced by the Apache XML Project, and we recommend that you do as well. These tools include Xerces, Xalan, and FOP.For the purposes of this document a functioning JRE (Java Runtime Environment) is a requirement. Obtaining andinstalling a JRE is outside the scope of this document. However, you might find Sun's J2SE web site[http://java.sun.com/j2se/] a good starting point.XMLA minimal understanding of XML is an asset for using the XML Résumé Library. Most users find that they can getby following the examples in the absence of XML experience.For a more in-depth tutorial on authoring a résumé in XML, see the section called “Writing your first XMLRésumé”. For a reference on XML elements available in the XML Résumé Library DTD, see Element Reference.Getting the SoftwareXML Résumé LibraryThe XML Résumé Library is available for download up id 29512 and is linked from the main XML Résumé Librarypage at http://xmlresume.sourceforge.net/.XercesXerces is an XML parser, which is needed by the tools used in later steps of processing. It converts an XML document into a format that other computer programs can more easily use.3

Chapter 1. Setting up the XML Résumé LibraryThe main Xerces for Java2 page is http://xml.apache.org/xerces2-j/, with the download page athttp://xml.apache.org/dist/xerces2-j/.XalanXalan does the actual conversion of a résumé from XML to other formats. When combined with the XSL stylesheetsprovided by the XML Résumé Library, it produces directly usable HTML and plain text. It also produces an intermediate format called XSL-FO (XSL Formatting Objects) that can be converted to PDF by an FO processor.The Xalan-Java project page is http://xml.apache.org/xalan-j/, with downloads at http://xml.apache.org/dist/xalan-j/.FOPFOP is a print formatter for XSL formatting objects. It converts XSL-FO documents to PDF.The main FOP page is http://xml.apache.org/fop/, and the download page ng and Configuring the SoftwareXML Résumé LibraryThe 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 towhere you want to work with your résumé. For instance:[resume-1 5 1] cp -a examples /resumeThe 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.TipYou can also indicate your résumé filename on the command line when you build your résumé, e.g.:[resume] make resume myresumeNoteThe DTD and XSL files you've downloaded to your computer aren't used by default when building yourré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 bedownloaded each time you build your résumé) and that you can't build a résumé offline.4

Chapter 1. Setting up the XML Résumé LibraryIf you'd like to use your local copy of the XSL stylesheets, edit the xsl base variable in the exampleMakefile to point to your local XSL directory. For example:xsl base /resume-1 5 1/xslTo use your local copy of the DTD, change the DOCTYPE declaration at the top of your resume to look likethis: !DOCTYPE resume PUBLIC "-//Sean Kelly//DTD Resume 1.5.1//EN"" /resume-1 5 1/dtd/resume.dtd" Xerces, Xalan, and FOPEach 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 willsimply refer to it as the ext/ directory.Xerces consists of the jars xmlParserAPIs.jar, xercesSamples.jar, and xercesImpl.jar, which are in thetop 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 thebin/ directory. All of these need to be copied to the ext/ directory.5

Chapter 2. Exploring the Features of XMLRésumé LibraryPeter HutnickMark MillerEdited by Bruce ChristensenCopyright 2002 Peter HutnickTable of ContentsFormatting an example resume . 6Advanced Features of the XML Résumé Library . 6Writing your first XML Résumé . 8Where to Go from Here . 8About this chapter .8This chapter provides an overview of the features and usage of the XML Résumé Library, an Open Source, XMLbased résumé management system, on UNIX systems.Formatting an example resumeConverting to other formatsTo get a feel for the power of the XML Résumé Library you should run the example résumés through their pacesand see how they turn out after processing. You can do this by renaming the file example2.xml to resume.xmlwith the command mv example2.xml resume.xml. Then simply issue the command gmake while connected to theinternet. This should generate the files resume.txt, resume.html, resume.fo, and resume.pdf — all versionsof Alexis Kernighan's résumé.Advanced Features of the XML Résumé LibraryFiltering to target your resumeFiltering allows you to maintain a single, complete resume.xml file that represents the entirety of your career/academic record, while allowing for the simple creation of targeted résumés. In other words, you can start to think ofyour XML Résumé as a database of your every skill, every accomplishment, every without worrying aboutcluttering up the résumé your employer sees. Read on to find out how.Consider the following snippet of Jane Doe's resume: skillset skill Carpentry /skill skill Welding /skill skill Java Programming /skill skill XML /skill skill C /skill skill Good communicator /skill skill Gourmet Pastry Creation /skill skill Cooking for construction workers /skill /skillset The problem here is that Jane needs to maintain a record of all her skills, but she doesn't need to tell a potential employer about all of those skills. Sure, Jane could selectively comment out portions of her résumé, but this can be te6