For XML Résumé Library Version 1.5 - SourceForge

1 XML R sum Library User Guide for xml r sum Library Version by Bruce Christensen XML R sum Library User Guide: for xml r sum Library Version by Bruce Christensen Published 30 November 2002. Copyright 2002 Bruce ChristensenPeter HutnickMark Miller Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version or any later Version published by the Free Software Foundation; with no invariant sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled GNU Free Documentation License . Table of Contents Introduction .. What is the XML R sum Library ? .. 1. I. Getting Started .. 1. Setting up the XML R sum Library .. Prerequisites ..3. Getting the Software ..3. Installing and Configuring the Software .. 4. 2. Exploring the Features of XML R sum Library .. Formatting an example resume .. 6. Advanced Features of the XML R sum Library .

2 6. Writing your first XML R sum .. 8. Where to Go from Here .. 8. About this chapter ..8. II. Reference .. I. Element Reference .. academics ..13. achievement ..14. address ..16. annotation ..18. artTitle ..19. author ..20. awards ..23. birth ..24. bookTitle ..25. break ..26. citation ..27. city ..28. clearance ..29. clearances ..30. company ..31. contact ..32. copyright ..33. country ..34. county ..35. date ..36. dayOfMonth ..37. degree ..38. degrees ..40. description ..41. docpath ..42. email ..43. emphasis ..44. employer ..45. fax ..47. firstname ..48. from ..49. gpa ..50. head ..51. header ..52. history ..54. instantMessage ..56. iv XML R sum Library User Guide institution ..58. interest ..59. interests ..60. job ..62. jobtitle ..64. keyword ..65. keywords ..66. label ..67. lastModified ..68. legalnotice ..69. level ..70. link ..71. location ..72. major ..73. membership ..74. memberships ..75. middlenames ..76. minor.

3 77. misc ..78. month ..79. name ..80. node ..81. note ..82. objective ..83. organization ..84. pageNums ..85. pager ..86. para ..87. period ..88. possible ..90. postalCode ..91. prefecture ..92. present ..93. project ..94. projects ..95. province ..96. pub ..97. pubDate ..99. publisher ..100. pubs ..101. referee ..102. referees ..103. result ..104. resume ..105. resumes ..109. score ..111. skill ..112. skillarea ..113. skillareas ..115. skills ..117. skillset ..118. state ..119. street ..120. street2 ..121. subject ..122. subjects ..123. suburb ..124. v XML R sum Library User Guide suffix ..125. surname ..126. tail ..127. title ..128. to ..130. uri ..131. url ..132. ward ..134. year ..135. zip ..136. II. XSL Parameter Reference ..138..139..140..141..142..143..144..145 . 3. CSS Class Reference .. Glossary .. III. Appendixes .. A. GNU Free Documentation License .. PREAMBLE ..150. APPLICABILITY AND DEFINITIONS ..150. VERBATIM COPYING.

4 151. COPYING IN QUANTITY ..151. MODIFICATIONS ..152. COMBINING DOCUMENTS ..153. COLLECTIONS OF DOCUMENTS ..153. AGGREGATION WITH INDEPENDENT WORKS .. 153. TRANSLATION ..154. FUTURE REVISIONS OF THIS LICENSE .. 154. How to use this License for your documents .. 154. vi Introduction Table of Contents What is the XML R sum Library ? .. 1. What 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's idea 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.

5 I Part I. Getting Started Chapter 1. Setting up the XML R sum . Library Peter Hutnick Edited by Bruce ChristensenMark Miller Copyright 2002 Peter Hutnick Table of Contents Prerequisites ..3. Getting the Software ..3. Installing and Configuring the Software .. 4. This chapter explains how to install the XML R sum Library , an Open Source, XML based r sum management system, on UNIX systems. It is written based on the author's experience installing on a Red Hat Linux system. Other systems may vary somewhat. Prerequisites Java The resources in this document provide enough information to convert your XML r sum to HTML, PDF, and plain text. The programs to exploit these resources, however, are not included. Any capable XML parser, XSLT stylesheet processor and XSL formatting objects processor will get the job done. Many of the XML R sum Library develop- ers use the free tools produced by the Apache XML Project, and we recommend that you do as well.

6 These tools in- clude Xerces, Xalan, and FOP. For the purposes of this document a functioning JRE (Java Runtime Environment) is a requirement. Obtaining and installing a JRE is outside the scope of this document. However, you might find Sun's J2SE web site [ ] a good starting point. XML. A minimal understanding of XML is an asset for using the XML R sum Library . Most users find that they can get by 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 XML. R sum . For a reference on XML elements available in the XML R sum Library DTD, see Element Reference. Getting the Software XML R sum Library The XML R sum Library is available for download at and is linked from the main XML R sum Library page at Xerces Xerces is an XML parser, which is needed by the tools used in later steps of processing. It converts an XML docu- ment into a format that other computer programs can more easily use.

7 3. Chapter 1. Setting up the XML R sum Library The main Xerces for Java2 page is , with the download page at Xalan Xalan does the actual conversion of a r sum from XML to other formats. When combined with the XSL stylesheets provided by the XML R sum Library , it produces directly usable HTML and plain text. It also produces an inter- mediate format called XSL-FO (XSL Formatting Objects) that can be converted to PDF by an FO processor. The Xalan-Java project page is , with downloads at FOP. FOP is a print formatter for XSL formatting objects. It converts XSL-FO documents to PDF. The main FOP page is , and the download page is 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.)

8 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 by default. If this is unacceptable you will need to edit the line re- sume = resume to match the filename you use, such as resume = myresume if your r sum is Tip You can also indicate your r sum filename on the command line when you build your r sum , : [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 al- ways 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.

9 4. Chapter 1. Setting up the XML R sum Library 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 ". "~/resume-1_5_1/ ">. 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 typi- cally /usr/ , but may vary depending on who packaged your JRE. We will simply refer to it as the ext/ directory. Xerces consists of the jars , , and , which are in the top directory of the Xerces zip archive. Xalan consists of the jars , , , , , , , , , , , and in the bin/ directory. All of these need to be copied to the ext/ directory. 5. Chapter 2. Exploring the Features of XML.

10 R sum Library Peter Hutnick Mark Miller Edited by Bruce Christensen Copyright 2002 Peter Hutnick Table of Contents Formatting an example resume .. 6. Advanced Features of the XML R sum Library .. 6. Writing your first XML R sum .. 8. Where to Go from Here .. 8. About this chapter ..8. This chapter provides an overview of the features and usage of the XML R sum Library , an Open Source, XML. based r sum management system, on UNIX systems. Formatting an example resume Converting to other formats To get a feel for the power of the XML R sum Library you should run the example r sum s through their paces and see how they turn out after processing. You can do this by renaming the file to with the command mv Then simply issue the command gmake while connected to the internet. This should generate the files , , , and all versions of Alexis Kernighan's r sum . Advanced Features of the XML R sum Library Filtering to target your resume Filtering allows you to maintain a single, complete file that represents the entirety of your career/.