Trang chủ Khám phá Trợ giúp
Đăng nhập
bn
/
se
2
0
Fork 0
Các tập tin Các vấn đề 0 Yêu cầu khéo về 0 Wiki
Tree: 23a803db8e
Branches Tags
se
/
SE
/
schema
/
WPS_Functions
/
dita-ot
/
dita-ot-3.0.4
/
doc
/
topics
/
pdf-customization-resources.html

pdf-customization-resources.html 8.7 KB
Lịch sử Raw

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980 
  1. <!DOCTYPE html
    2. 

  2.   SYSTEM "about:legacy-compat">
    3. 

  3. <html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="UTF-8"><meta name="copyright" content="(C) Copyright 2018"><meta name="DC.rights.owner" content="(C) Copyright 2018"><meta name="DC.Type" content="reference"><meta name="description" content="There are several external resources that can help you generate and refine custom PDF plug-ins for the DITA Open Toolkit."><meta name="DC.Relation" scheme="URI" content="../topics/pdf-customization.html"><meta name="DC.Format" content="HTML5"><meta name="DC.Identifier" content="ID"><link rel="stylesheet" type="text/css" href="../css/commonltr.css"><link rel="stylesheet" type="text/css" href="../css/dita-ot-doc.css"><title>Resources for custom PDF plug-ins</title></head><body id="ID"><header role="banner"><div class="header">
    4. 

  4.   <p>DITA Open Toolkit</p>
    5. 

  5.   <hr>
    6. 

  6. </div></header><nav role="toc"><ul><li><a href="../index.html">DITA Open Toolkit 3.0</a></li><li><a href="../release-notes/index.html">Release Notes</a></li><li><a href="../topics/installing-client.html">Installing DITA-OT</a></li><li><a href="../topics/alternative-input-formats.html">Authoring formats</a></li><li><a href="../topics/building-output.html">Building output</a></li><li><a href="../parameters/index.html">Setting parameters</a></li><li><a href="../topics/extending-the-ot.html">Customizing DITA-OT</a><ul><li><a href="../topics/html-customization.html">Customizing HTML</a></li><li><a href="../topics/pdf-customization.html">Customizing PDF</a><ul><li><a href="../topics/pdf-customization-approaches.html">PDF customization approaches</a></li><li><a href="../topics/pdf-customization-plugin-types.html">Types of custom PDF plug-ins</a></li><li><a href="../topics/pdf-plugin-structure.html">PDF plug-in structure</a></li><li><a href="../topics/pdf-customization-example.html">Simple PDF plug-in example</a></li><li class="active"><a href="../topics/pdf-customization-resources.html">Custom PDF plug-in resources</a></li><li><a href="../topics/pdf2-creating-change-bars.html">Generating revision bars</a></li></ul></li><li><a href="../topics/globalization.html">Globalizing DITA content</a></li><li><a href="../topics/custom-plugins.html">Custom plug-ins</a></li><li><a href="../extension-points/plugin-extension-points.html">Extension points</a></li><li><a href="../topics/migration.html">Migrating customizations</a></li><li><a href="../topics/rebuilding-the-dita-ot-documentation.html">Rebuilding documentation</a></li></ul></li><li><a href="../topics/troubleshooting-overview.html">Troubleshooting</a></li><li><a href="../reference/index.html">Reference</a></li><li><a href="../topics/dita-and-dita-ot-resources.html">Resources</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1">
    7. 

  7.   <h1 class="title topictitle1" id="ariaid-title1">Resources for custom PDF plug-ins</h1>
    8. 

  8.   
    9. 

  9.   
    10. 

  10. 

  11.   <div class="body refbody"><p class="shortdesc">There are several external resources that can help you generate and refine custom PDF plug-ins for the DITA
    12. 

  12.     Open Toolkit.</p>
    13. 

  13.     <section class="section" id="ID__pdf-plugin-generator"><h2 class="title sectiontitle">PDF Plugin Generator</h2>
    14. 

  14.       
    15. 

  15.       <p class="p">This online tool, developed and maintained by Jarno Elovirta, enables you to generate a PDF customization
    16. 

  16.         plug-in automatically.</p>
    17. 

  17.       <p class="p">The application at
    18. 

  18.         <a class="xref" href="http://dita-generator.elovirta.com/" target="_blank">dita-generator.elovirta.com</a> walks you through the process of creating a custom PDF plug-in and allows
    19. 

  19.         you to adjust a variety of settings for your PDF output. For example, you can:</p>
    20. 

  20.       <ul class="ul">
    21. 

  21.         <li class="li">Define the target environment, selecting from the most current and two previous versions of the DITA-OT</li>
    22. 

  22.         <li class="li">Select the XSL formatting engine (FOP, Antenna House Formatter, or RenderX XEP)</li>
    23. 

  23.         <li class="li">Specify page size, columns, and margins</li>
    24. 

  24.         <li class="li">Select from (limited) options for headers and footers</li>
    25. 

  25.         <li class="li">Specify layout options for chapters</li>
    26. 

  26.         <li class="li">Select formatting for the following publication components:
    27. 

  27.           <ul class="ul">
    28. 

  28.             <li class="li">Normal text</li>
    29. 

  29.             <li class="li">Headings (levels one through four)</li>
    30. 

  30.             <li class="li">Titles for sections and examples</li>
    31. 

  31.             <li class="li">Tables and figures</li>
    32. 

  32.             <li class="li">Notes and examples</li>
    33. 

  33.             <li class="li">Lists (unordered, ordered, and definition)</li>
    34. 

  34.             <li class="li">Code blocks and pre-formatted text</li>
    35. 

  35.             <li class="li">Inline elements such as links and trademarks</li>
    36. 

  36.           </ul>
    37. 

  37.           <p class="p">For each component, you can specify: </p>
    38. 

  38.           <ul class="ul">
    39. 

  39.             <li class="li">Font family, size, weight, and style</li>
    40. 

  40.             <li class="li">Color and background color</li>
    41. 

  41.             <li class="li">Alignment, indentation, spacing, and padding</li>
    42. 

  42.           </ul></li>
    43. 

  43.       </ul>
    44. 

  44.       <div class="note tip note_tip"><span class="note__title">Tip:</span> The PDF Plugin Generator should be your first stop as you start developing a brand-new PDF
    45. 

  45.         customization plug-in.</div>
    46. 

  46.     </section>
    47. 

  47. 

  48.     <section class="section" id="ID__dita-for-print"><h2 class="title sectiontitle"><cite class="cite">DITA for Print: A DITA Open Toolkit Workbook</cite> (Second Edition, 2017)</h2>
    49. 

  49.       
    50. 

  50.       <p class="p">Authored by Leigh W. White, DITA Specialist at IXIASOFT, and published by XML Press, <cite class="cite">DITA for
    51. 

  51.           Print</cite> walks readers through developing a PDF customization from scratch. </p>
    52. 

  52.       <p class="p">Here is an excerpt from the back cover:</p>
    53. 

  53.       <blockquote class="lq"><cite class="cite">DITA for Print</cite> is for anyone who wants to learn how to create PDFs using the DITA Open Toolkit
    54. 

  54.         without learning everything there is to know about XSL-FO, XSLT, or XPath, or even about the DITA Open Toolkit
    55. 

  55.         itself. <cite class="cite">DITA for Print</cite> is written for non-programmers, by a non-programmer, and although it is
    56. 

  56.         written for people who have a good understanding of the DITA standard, you don't need a technical background to
    57. 

  57.         get custom PDFs up and running quickly.</blockquote>
    58. 

  58.       <p class="p">This is an excellent, long-needed resource that was initially developed in 2013 for DITA-OT 1.8.</p>
    59. 

  59.       <p class="p">The second edition has been revised to cover DITA Open Toolkit Version 2, including customizing the DITA 1.3
    60. 

  60.         troubleshooting topic type, localization strings, bookmarks, and the new back-cover functionality.</p>
    61. 

  61.       <div class="note important note_important"><span class="note__title">Important:</span> 
    62. 

  62.         <p class="p">The first edition of <cite class="cite">DITA for Print</cite> recommended copying entire files from the PDF2 plug-in to
    63. 

  63.           your custom plug-in. The DITA-OT project — and the second edition of the book — do not recommend this
    64. 

  64.           practice.</p>
    65. 

  65.         <p class="p">Instead, you should copy only the specific attribute sets and templates that you want to override. Following
    66. 

  66.           this practice will more cleanly isolate your customizations from the DITA-OT code, which will make it easier
    67. 

  67.           for you to update your plug-ins to work with future versions of the DITA-OT.</p></div>
    68. 

  68.     </section>
    69. 

  69. 

  70.     <section class="section" id="ID__dita-for-practitioners"><h2 class="title sectiontitle"><cite class="cite">DITA for Practitioners: Volume 1, Architecture and Technology</cite> (2012)</h2>
    71. 

  71.       
    72. 

  72.       <p class="p">Authored by Eliot Kimber and published by XML Press, this seminal resource contains a chapter dedicated to the
    73. 

  73.         DITA Open Toolkit: “Running, Configuring, and Customizing the Open Toolkit”. In addition to a robust overview of
    74. 

  74.         DITA-OT customization and extension, the chapter contains a detailed example of customizing a PDF plug-in to
    75. 

  75.         specify 7" × 10" paper size and custom fonts for body text and headers.</p>
    76. 

  76.       <p class="p">The DITA-OT chapter in <cite class="cite">DITA for Practitioners: Volume 1</cite> was written for DITA-OT 1.5.4, which was
    77. 

  77.         the latest stable version at the time it was written.</p>
    78. 

  78.     </section>
    79. 

  79.   </div>
    80. 

  80. <nav role="navigation" class="related-links"><div class="familylinks"><div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../topics/pdf-customization.html" title="You can create custom DITA-OT plug-ins that build on the default DITA to PDF transformation. Plug-ins can customize covers and page layouts, modify formatting, override logic of the default PDF plug-in, and much more.">Customizing PDF output</a></div></div></nav></article></main></body></html>
    81.