Skip to content

Commit

Permalink
Update information on “DITA for Print” #108
Browse files Browse the repository at this point in the history
Signed-off-by: Roger Sheen <roger@infotexture.net>
  • Loading branch information
infotexture committed Feb 24, 2017
1 parent f9efb98 commit bf268f8
Showing 1 changed file with 18 additions and 14 deletions.
32 changes: 18 additions & 14 deletions dev_ref/pdf-customization-resources.dita
Original file line number Diff line number Diff line change
Expand Up @@ -48,29 +48,33 @@
</section>

<section>
<title><cite>DITA for Print: A DITA Open Toolkit Workbook</cite> (2013)</title>
<p>Authored by Leigh W. White, DITA Specialist at IXIASOFT, and published by XML Press, walks readers through
developing a PDF customization from scratch. Here is an excerpt from the back cover:</p>
<title><cite>DITA for Print: A DITA Open Toolkit Workbook</cite> (Second Edition, 2017)</title>
<p>Authored by Leigh W. White, DITA Specialist at IXIASOFT, and published by XML Press, <cite>DITA for
Print</cite> walks readers through developing a PDF customization from scratch. </p>
<p>Here is an excerpt from the back cover:</p>
<lq><cite>DITA for Print</cite> is for anyone who wants to learn how to create PDFs using the DITA Open Toolkit
without learning everything that there is to know about XSL-FO, XSLT, or XPath, or even about the DITA Open
Toolkit itself. <cite>DITA for Print</cite> is written for non-programmers, by a non-programmer, and although it
is written for people who have a good understanding of the DITA standard, you don't need a technical background
to get custom PDFs up and running quickly.</lq>
<p>This is an excellent, long-needed resource that was developed for DITA-OT 1.8.</p>
without learning everything there is to know about XSL-FO, XSLT, or XPath, or even about the DITA Open Toolkit
itself. <cite>DITA for Print</cite> is written for non-programmers, by a non-programmer, and although it is
written for people who have a good understanding of the DITA standard, you don't need a technical background to
get custom PDFs up and running quickly.</lq>
<p>This is an excellent, long-needed resource that was initially developed in 2013 for DITA-OT 1.8.</p>
<p>The second edition has been revised to cover DITA Open Toolkit Version 2, including customizing the DITA 1.3
troubleshooting topic type, localization strings, bookmarks, and the new back-cover functionality.</p>
<note type="important">
<cite>DITA for Print</cite> recommends copying entire files from the PDF2 plug-in to your custom plug-in. The
DITA-OT project does not recommend this practice. Instead, we suggest you copy only the specific attribute sets
and templates that you want to override. Following this practice will more cleanly isolate your customizations
from the DITA-OT code, which will make it easier for you to update your plug-ins to work with future versions of
the DITA-OT.</note>
<p>The first edition of <cite>DITA for Print</cite> recommended copying entire files from the PDF2 plug-in to
your custom plug-in. The DITA-OT project — and the second edition of the book — do not recommend this
practice.</p>
<p>Instead, you should copy only the specific attribute sets and templates that you want to override. Following
this practice will more cleanly isolate your customizations from the DITA-OT code, which will make it easier
for you to update your plug-ins to work with future versions of the DITA-OT.</p></note>
</section>

<section>
<title><cite>DITA for Practitioners: Volume 1, Architecture and Technology</cite> (2012)</title>
<p>Authored by Eliot Kimber and published by XML Press, this seminal resource contains a chapter dedicated to the
DITA Open Toolkit: “Running, Configuring, and Customizing the Open Toolkit”. In addition to a robust overview of
DITA-OT customization and extension, the chapter contains a detailed example of customizing a PDF plug-in to
specify 7" x 10" paper size and custom fonts for body text and headers.</p>
specify 7" × 10" paper size and custom fonts for body text and headers.</p>
<p>The DITA-OT chapter in <cite>DITA for Practitioners: Volume 1</cite> was written for DITA-OT 1.5.4, which was
the latest stable version at the time it was written.</p>
</section>
Expand Down

0 comments on commit bf268f8

Please sign in to comment.