PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott...
Transcript of PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott...
![Page 1: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/1.jpg)
TC Camp 2013 - Santa Clara, CAScott Prentice, Leximation, Inc.
PDFs from DITA without Compromising
Quality and Control
![Page 2: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/2.jpg)
IntroductionScott Prentice, President of Leximation, Inc.
Specializing in FrameMaker plugin development as well as structured FrameMaker conversions, consulting, and development. FrameMaker user/developer since 1991.
Developed DITA‐FMx, a FrameMaker plugin for efficient DITA authoring and publishing.
Consulting for custom Help systems, creative/functional web applications, and EPUB solutions.
![Page 3: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/3.jpg)
Publishing from DITAContent authored in DITA can be easily published to various output formats
HTMLCHMWebHelpJavaHelp
Eclipse HelpEPUBPDFand more...
We’re here to talk about PDF publishing from DITA
![Page 4: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/4.jpg)
DITA to PDF Publishing ToolsXSL-FO processors
CSS processors
Proprietary rendering engines
How does the DITA-OT fit in?
Automation component aggregates the DITA topics and resolves references
Sends files to many of these tools for PDF creation
![Page 5: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/5.jpg)
XSL-FO ProcessorsApache FOP - free; all platforms
Renderex XEP - $400/$4750/up; all platforms
Antenna House Formatter - $560/$2800/up; all platforms
Quadralay ePublisher - $795 (?); Windows-only
![Page 6: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/6.jpg)
CSS ProcessorsPrince - $495/$3800; all platforms
others ?
![Page 7: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/7.jpg)
Proprietary Rendering EnginesSDL XPP - $50K and up; Windows, Solaris, Linux
DITA Exchange OpenXML Publishing - $?; Windows-only
MadCap Flare - $999; Windows-only
Adobe FrameMaker - $999; Windows-only
Leximation DITA-FMx - $235; Windows-only
![Page 8: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/8.jpg)
XSL‐FO BenefitsLow entry cost
XSL-FO is an XML language for formatting XML documents
Typically used for generating PDFs
Part of the W3C’s XSL specification (with XSLT and XPath)
FO markup language is largely based on CSS
Designed to work for all written human languages
![Page 9: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/9.jpg)
XSL‐FO LimitationsXSL-FO development (coding) is expensive and complicated
Tables that span pages may not break as expected
No way to render elements on one page in relation to another page
Difficult to apply balanced vertical spacing on a page
Processors may use extensions to implement features, so the FO stylesheets may not be portable between processors
![Page 10: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/10.jpg)
CSS Benefits/LimitationsCSS developers are readily available
Limitations similar to FO
Not enough info at this point
![Page 11: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/11.jpg)
Proprietary Tools Pro/ConPotential for higher quality output
Limited interoperability
Tied to one vendor
??
![Page 12: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/12.jpg)
Determine your PDF NeedsOnline and/or print PDF deliverable?
One layout or many?
Frequent changes to formatting/layout?
Need to make minor adjustments to the output?
High quality typographic requirements?
Large output volume?
![Page 13: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/13.jpg)
Assess Available ResourcesDo you have an XSL-FO developer on staff?
Do you have in-house expertise with FM template/EDD development?
Available contract developers?
![Page 14: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/14.jpg)
Why FrameMaker?FM is both an authoring and publishing tool
Relatively easy to define the layout and formatting
Easy to make minor adjustments as needed
Likely to have in-house expertise
May already have FM licenses in-house
Likely to be less expensive in the long run
![Page 15: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/15.jpg)
Additional Benefits of FMAbility to modify the pagination/formatting after composition but before PDF creation
Easily set up templates for multiple languages
Can use FM for PDF generation even if you're using another tool for DITA authoring
Save time and ensure consistent output with DITA-FMx
![Page 16: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/16.jpg)
Adobe FrameMakerProprietary layout/formatting through template and EDD
Native PDF export or through Adobe Distiller
Automated publishing using FM Server and scripting or FDK development
Requires a considerable amount of work to get it all working
![Page 17: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/17.jpg)
FrameMaker “build” processDevelop templates and EDDs
Save DITA map to FM book and chapter files
Set up generated lists (toc, index, etc.)
Apply formatting and pagination properties to each component
Save book to PDF
![Page 18: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/18.jpg)
FrameMaker + DITA-FMxSupports FrameMaker versions 7.2, 8, 9, 10, and 11
Proprietary layout/formatting through template and EDD
Native PDF export or through Adobe Distiller
Automated publishing through FMx-Auto and FM Server
Can be integrated into publishing process of most CMSes
“One-click” publishing to PDF is possible
![Page 19: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/19.jpg)
DITA-FMx “build” processDevelop templates and EDDs
Configure for automated creation of generated lists (toc, index, etc.) and component formatting / properties
Set up additional automation
Run “book-build” to generate FM book and chapter files from DITA map
Save book to PDF
![Page 20: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/20.jpg)
Demo timeLet’s see how it all works...
![Page 21: PDFs from DITA without Compromising Quality and Control · 2018-06-21 · Introduction Scott Prentice, President of Leximation, Inc. Specializing in FrameMaker plugin development](https://reader034.fdocuments.us/reader034/viewer/2022042419/5f36420443b36c335d3d168e/html5/thumbnails/21.jpg)
Thanks!Questions?
Scott Prentice <scott AT leximation.com>
Leximation, Inc. - www.leximation.com