O'Reilly logo

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

DITA for Print, 2nd Edition

Book Description

The second edition of DITA for Print shows how to create a PDF plugin for theDITA Open Toolkit, version 2. Contains examples you can use to create a complete plugin.

Table of Contents

  1. DITA for Print: A DITA Open Toolkit Workbook, Second Edition
  2. List of Figures
  3. Preface
    1. Why this book?
    2. Who is this book for?
    3. Keepin’ it real
    4. About me
    5. Contact me
    6. Acknowledgements
  4. Chapter 1. Introduction
    1. What’s different in this edition?
    2. PDF changes in DITA OT 2.5
    3. What you’ll need
    4. Useful resources
    5. Some conventions
    6. Comment, comment, comment…test, test, test
  5. Chapter 2. Custom PDF plugin creation
    1. What is a PDF plugin and why do you need one?
    2. Upgrading existing plugins
    3. Organization of the org.dita.pdf2 plugin
    4. DITA Open Toolkit 1.5 and earlier
    5. DITA Open Toolkit post-2.0
    6. Download and install the DITA Open Toolkit
    7. Create your own PDF plugin
    8. Integrate your plugin into the DITA-OT
    9. Create an attribute set file in your plugin
    10. Add an attribute set to your plugin
    11. Create an XSLT stylesheet in your plugin
    12. Add a template to your plugin
    13. Why not use a single custom file for all your changes?
    14. Add a localization variables file to your plugin
    15. Add a localization strings file to your plugin
    16. Add a strings.xml file to your custom plugin
    17. Mapping strings files to xml:lang values in the strings.xml file
    18. Wrap-up
  6. Chapter 3. DITA Open Toolkit builds
    1. What is an ANT build file?
    2. Create an ANT build file
    3. Create a batch file to launch an ANT build (Windows)
    4. Create a shell file to launch an ANT build (Mac, Linux)
    5. Test your plugin
    6. Use a specific PDF renderer
    7. Other things you can do
  7. Chapter 4. Attribute sets
    1. What are attribute set files?
    2. How attribute set defaults work
    3. Special attributes for XEP, Antenna House, and FOP
    4. Which attribute set do you customize?
    5. The closest attribute set wins
    6. Attribute sets that call other attribute sets
    7. Basic-settings variables in attribute sets
    8. Other things you can do
  8. Chapter 5. Localization variables
    1. What are localization variables?
    2. Literal characters and numeric character references
    3. Exercises
    4. Other things you can do
  9. Chapter 6. Fonts
    1. About fonts in the PDF plugin
    2. Font specifications
    3. Files you need
    4. Specify fonts to use
    5. Other things you can do
  10. Chapter 7. Page masters
    1. Page masters and regions in the PDF plugin
    2. Default page masters, regions, and attribute sets
    3. Page specifications
    4. Files you need
    5. Do these exercises in order!
    6. Set up double-sided pagination
    7. Set page dimensions
    8. Set page margins
    9. Set up body regions
    10. Setting up header and footer regions
    11. Set margins for the front cover page
    12. Other things you can do
  11. Chapter 8. Page headers and footers
    1. About headers and footers
    2. PDF plugin defaults for headers and footers
    3. Where does header and footer information come from?
    4. Metadata variables for headers and footers
    5. Models to use for map metadata
    6. DITA element classes
    7. Header and footer specifications
    8. Files you need
    9. Complete these exercises in order!
    10. Header setup
    11. Footer setup
    12. Header and footer formatting
    13. Other things you can do
  12. Chapter 9. Cover pages
    1. Cover specifications
    2. Files you need
    3. Front cover customization
    4. Back cover creation and customization
    5. Other things you can do
  13. Chapter 10. Titles, body text, and notes
    1. General text formatting specifications
    2. Files you need
    3. Title formatting
    4. Text formatting
    5. Notes formatting
    6. Other things you can do
  14. Chapter 11. Lists
    1. Hints on working with list-related attribute sets
    2. List specifications
    3. Files you need
    4. Create multiple bullet formats for unordered lists
    5. Create multiple numbering formats for ordered lists
    6. Create a checklist
    7. Other things you can do
  15. Chapter 12. Task topics
    1. Task topic specifications
    2. Files you need
    3. Task step formatting tips
    4. Change the label for optional steps
    5. Using strings vs localization variables for task labels
    6. Change variables for task sections
    7. Format task section labels and text
    8. Format labels for the step section
    9. Format step and substep numbers
    10. Other things you can do
  16. Chapter 13. Tables
    1. Table specifications
    2. Files you need
    3. Fun with table rules
    4. Table border overrides
    5. Force table column widths to be respected
    6. Change or delete the label for a table title
    7. Format the table heading row
    8. Format table cell text
    9. Format table rules
    10. Format the table title
    11. Place titles below tables
    12. Add chapter, appendix or part numbers to table titles
    13. Other things you can do
  17. Chapter 14. Images
    1. Image specifications
    2. Files you need
    3. Change or delete the label for a figure title
    4. Format figure titles
    5. Add chapter, appendix or part numbers to figure titles
    6. Place titles above images
    7. Dynamically scale images to the page width
    8. Change the default alignment for all images
  18. Chapter 15. Related links, cross-references, and footnotes
    1. General link formatting specifications
    2. Files you need
    3. General links and cross-references
    4. Related links
    5. Footnotes
  19. Chapter 16. Table of Contents
    1. How TOC attribute sets interact
    2. Title levels in bookmaps and ditamaps
    3. TOC specifications
    4. Files you need
    5. Add a TOC to a PDF
    6. Change the title of the TOC
    7. Format the TOC title
    8. Add or remove entry levels from the TOC
    9. Apply different formatting to different TOC entry levels
    10. Format page numbers in the TOC
    11. Add chapter, appendix, or part numbers to TOC page numbers
    12. Change the leader in TOC entries
    13. Remove leaders from TOC entries
    14. Adjust indents for TOC entries
    15. Mini-TOC
    16. Other things you can do
  20. Chapter 17. Index
    1. This chapter is different…
    2. Index entry levels
    3. The curious case of page numbers on main index entries
    4. Index specifications
    5. Files you need
    6. Add an index to your PDF
    7. Change the title of the index
    8. Format the index title
    9. Format index letter headings
    10. Format index entries
    11. Format index page numbers (FOP)
    12. Format index page numbers (Antenna House, XEP)
    13. Adjust indents for index entries
    14. Other things you can do
  21. Chapter 18. List of Tables and List of Figures
    1. List of Tables and List of Figures specifications
    2. Files you need
    3. Add a List of Tables or List of Figures
    4. Format the List of Tables and List of Figures titles
    5. Change the title of the List of Tables and List of Figures
    6. Format page numbers in the List of Tables and Figures
    7. Format entries in the List of Tables and List of Figures
    8. Add chapter, appendix, or part numbers to table or figure numbers in the List of Tables or List of Figures
  22. Chapter 19. Bookmarks
    1. Files you need
    2. Add chapter, appendix or part numbers to bookmarks
    3. About TOC and index bookmarks
    4. Eliminate the Table of Contents bookmark (bookmap-based PDF)
    5. Eliminate the Index bookmark (bookmap-based PDF)
    6. Eliminate the List of Tables or List of Figures bookmarks (bookmap-based PDF)
    7. Other things you can do
  23. Specifications used in these exercises
  24. Attribute set lists and descriptions
    1. Attribute set file list
    2. Common attribute sets
    3. Domain attribute sets
    4. Frontmatter attribute sets
    5. Glossary attribute sets
    6. Index attribute sets
    7. Layout masters attribute sets
    8. Link attribute sets
    9. List attribute sets
    10. Lot-Lof attribute sets
    11. Map attribute sets
    12. Reference attribute sets
    13. Static content attribute sets
    14. Task element attribute sets
    15. Table attribute sets
    16. Table of Contents attribute sets
    17. Basic settings variables
  25. Localization variables list
  26. DITA OT changes for DITA 1.3
  27. Notable differences between the org.dita.pdf2 plugin in Open Toolkit 1.8.5 and 2.4
  28. Sample ANT build file
  29. GetChapterPrefix template
  30. GetChapterPrefixForIndex template
  31. Specialized element template creation
  32. Paragraph and character formatting: word processing applications to XSL-FO match-up
  33. Copyright notices