XML Résumé Library

The XML Résumé Library is an XML Document Type Definition (DTD) and Extensible Stylesheet Language (XSL) file set for declaration, B2B exchange, and presentation of résumés.

This is version 1.2.4. For the latest version, please visit the website.

What's Included

The XML Résumé Library includes the following:

dtd/resume.dtd - An XML DTD for describing résumés. To make your own résumé, create an XML document that validates to this DTD.
xsl/us-html.xsl, xsl/us-text.xsl, xsl/us-letter.xsl - XSLT files for transforming XML résumés into HTML, plain text, and XSL Formatting Objects (FO) with letter-size paper, respectively, using terminology common to résumés in the United States. These files let you present your résumés on the web using HTML, in email or entry forms that require plain text, or (after formatting with a FO processor), as Portable Document Format (PDF) files suitable for printing.
xsl/uk-html.xsl, xsl/uk-text.xsl, xsl/uk-a4.xsl - As above, but using A4 size paper and terminology common to résumés in the United Kingdom (such as "CV" instead of "résumé").
xsl/fr-html.xsl, xsl/fr-text.xsl, xsl/fr-a4.xsl - As above with A4 size paper, but with terminology common to résumés in France (such as "objectif professionnel" instead of "professional objective").

In addition, there are two example résumés and a Makefile that automates production of HTML, plain text, and PDF output from an XML file using the Apache XML Project tools and/or RenderX's XEP. See the examples directory.

The following documents are available:

Copying conditions, license to use the library, and disclaimer. Definitely read this file.
A list of authors and contributors to the library.
News: user-visible changes to the library.
Change log: developer-level changes to the library.
The To-Do List, listing what needs to be done still to make this a world-class library.

Requirements

The XML Résumé Library uses the XML 1.0 DTD syntax. The XSL files are version 1.0. We have tested these files with the Apache XML Project's tools:

Xerces 1.2 XML parser
Xalan 1.1 and Xalan 2.0 XSL processors
FOP 0.20.1 Formatting Objects print processor (although you will see some harmless warning messages due to incomplete implementation of the XSL specification).

In addition, the library works quite well with RenderX's XEP Formatting Objects processor.

Creating Résumés Using the DTD

To create your own résumés using the XML Résumé DTD, use the following document type declaration in your XML file:

<!DOCTYPE resume PUBLIC "-//Sean Kelly//DTD Resume 1.2.4//EN"
                        "http://xmlresume.sourceforge.net/dtd/resume.dtd">

If you'd rather refer to a local copy of the DTD, change the system-part of the DOCTYPE to refer to it with a file URL, for example:

<!DOCTYPE resume PUBLIC "-//Sean Kelly//DTD Resume 1.2.4//EN"
                        "file:/usr/local/share/xml/dtd/resume.dtd">

Note that the iso-lat1.ent file is referenced by the resume.dtd file, so if you move one, be sure you move the other, too.

For an idea of how the tags work, see the comments in the resume.dtd file and the example résumé files.

Formatting Résumés

You can format the XML resume into HTML for online viewing, into XSL Formatting Objects (FO) for rendering into PDF for printing, or into plain text.

Creating an HTML Presentation

To create an HTML presentation of your résumé, run your XSLT engine on the XML file containing the résumé along with the one of the HTML stylesheet files:

us-html.xsl for US English résumés.
uk-html.xsl for UK English CVs.
fr-html.xsl for French résumés.

The stylesheet will turn your XML résumé into HTML using appropriate phrasing and terminology.

Customizing the HTML Output

The XSL stylesheet generates generic HTML output and abuses no special HTML tricks to create special formatting effects. You can use Cascading Stylesheets (CSS) to customize the output to your tastes. By default, the HTML output referencs a cascading stylesheet named resume.css. Create this file and publish it along with the HTML output to your web server to customize the output. You can find two sample CSS files under the css directory.

To specify a different stylesheet reference than resume.css, give your XSLT engine a value for the css.href parameter (how you do so depends on your XSLT engine).

The following table lists the element classes used in the HTML output for which you can specify styles.

Class	Where Used
`academicsHeading`	On the `h2` of the heading for your academics.
`bookTitle`	On the `cite` used to refer to a title of a book in one of your publications.
`citation`	On all HTML `cite`'s generated from all XML `citation`'s.
`contactHeading`	On the `h2` of the heading for the contact information.
`copyright`	On the `address` for copyright information.
`degree`	On the `li` for a single degree.
`degrees`	On the `ul` for the list of degrees you hold.
`emphasis`	On all HTML `strong`'s generated from all XML `emphasis`'s.
`employer`	Around all employer names.
`historyHeading`	On the `h2` of the heading for the employment history.
`job`	On the `p` of the paragraph generating a single employer entry.
`jobTitle`	On the `span` enclosing the title you held at job.
`level`	On the `acronym` for the level attained in a degree.
`miscHeading`	On the `h2` for the miscellany heading.
`nameHeading`	Around your name at the top of the résumé.
`note`	On the `div` used as the admonition below the list of held degrees.
`objectiveHeading`	On the `h2` of the heading for the professional objective.
`para`	On all HTML `p`'s generated from all XML `para`'s.
`pub`	On a single publication.
`pubs`	On the `ul` for the list of publications.
`pubsHeading`	On the `h2` heading the publications.
`resume`	On the `body` of the entire HTML output.
`skill`	On the `li` for a single skill.
`skillareaHeading`	On the `h2` for a skill area.
`skills`	On the `ul` for a list of skills.
`skillsetTitle`	On the `h3` for a title of a set of skills.
`urlA`	On the `a` of a generated hyperlink.
`urlCode`	On `code` sections used to mark up URLs.

Creating a PDF Presentation

To create a PDF presentation, follows these steps:

Run your XSLT engine on the résumé XML file along with one of the FO stylesheet files:
- us-letter.xsl for US English résumés on US-Letter size paper.
- uk-a4.xsl for UK English CVs on A4 size paper.
- fr-a4.xsl for French résumés on A4 size paper.
This will transform your XML file into another XML file that defines formatting objects (usually named with a .fo extension).
Run the formatting object output through your FO engine to render it to PDF.

Creating a Plain Text Presentation

To create a plain text presentation, run your XSLT engine on the résumé XML file and one of the following:

us-text.xsl for US English plain text résumés.
uk-text.xsl for UK English plain text CVs.
fr-text.xsl for French plain text résumés.

Automating Formatting

To automate formatting a résumé to all three output formats, consider using the Makefile. It uses the Java versions of the Apache XML tools Xerces/Xalan/FOP to create both web and print presentations of a résumé. Adjust the RESUME value inthe Makefile to point to the file name of the résumeé you want to format, without the .xml extension.