comparing dita support in xmetal and framemaker
DESCRIPTION
TRANSCRIPT
Comparing DITA support in XMetaL and FrameMaker
Simon BateScriptorium
Publishingwww.scriptorium.co
m
Agenda
Authoring Conditional processingGenerating outputCross-references and conrefsMap filesSpecializationConsider your needs
About the presenter
Based in Research Triangle, North Carolina
Senior Technical Consultant at Scriptorium
30+ years experience in Technical Publications
Long-time FrameMaker user
Instructor for Scriptorium classes:XMetaL DITA XSL in Publications
A note about Scriptorium
Affiliated with Adobe as Adobe Authorized Training CenterAffiliated with JustSystems as a Certified Services PartnerNonetheless, I think you'll find this presentation quite candid about each tool's strengths and weaknesses.
Questions
Please ask questions.I may defer some questions to the end of the presentation.
FrameMaker highlights
High-quality print/PDF outputFormatting control is built inAbility to "tweak" formatting, such as page breaksWYSIWYG for print/PDF
XMetaL highlights
Ability to edit XML directlyIntegration with DITA Open ToolkitNot WYSIWYG for printSpecialization supportDITA 1.1 support
XMetaL Authoring highlights
Code ("plain text") viewStructure view (block only)Format-neutral WYSIOO presentationNo invalid content allowedElements grouped by type (Insert menu)
FrameMaker authoring highlights
WYSIWYG for print/PDFStructure view is completeDocument window/structure view combinationInvalid content allowed
Conditional processing in FrameMaker
Traditional FrameMaker conditions In 8.0, allows expressionsFM information is saved in XML outputBut the information is not DITA
Use attributesSpecial > Filter by attributes
ditaval files
FrameMaker: only when using DITA Open Toolkit
XMetaL: hidden by conditional GUIUse Export to createditaval file
Generating output in XMetaL
Open ToolkitRenderX for PDF via Open ToolkitHTML-based help
Generating output in FrameMaker
PDFOpen Toolkit (install plug-in)FrameMaker book from DITA mapHTML-based help
Cross-references in FrameMaker
FrameMaker <fm-xref> elementOnly reference a selected set of elementsCreates active links in PDF files
DITA <xref> elementsCan reference any element in any topicCan contain alternate text (not just the title)Does not create active links in PDF files
Cross-references in XMetaL
Insert > LinkCross-referenceFile referenceWeb link
Can change text in <xref> elementConverted correctly in Open Toolkit
conrefs in XMetaL
conrefs in FrameMaker
Map files in FrameMaker
Map files in XMetaL
Specialization
XMetaLMany hooks for specialization
FrameMakerNothing built-inCould modify EDD
Which has better DITA support?
For print/PDF output: FrameMakerFor DITA authoring: XMetaLFor print WYSIWYG: FrameMakerFor output-neutral formatting: XMetaL
No clear winner.
How important is print publishing?
It's much easier to produce high-end print/PDF from FrameMaker.Print/PDF publishing through Open Toolkit is not satisfactory.WYSIWYG presentation in FrameMaker is a plus for print-centric workflows.WYSIOO presentation in XMetaL is a plus for authoring without focusing on print.
How much control should authors have?
Because FrameMaker combines authoring and publishing, authors have more control
Can create and publish with invalid content
XMetaL enables DITA authoring; separates out publishing
Does not allow invalid content in normal authoring.Think workflow and sharing topics
Do you need cross-browser, cross-platform help?
HTMLHelp (CHM)Not cross-platformXMetaL and FrameMaker (3rd-party or OT)
XHTML-based HelpFrameMaker and 3rd-party converters
Eclipse HelpXMetaL and FrameMaker (via OT)Requires Eclipse infrastructure
Transition issues
Current unstructured FrameMaker users will find structured FrameMaker easier than XMetaL (mostly).Developer types may prefer XMetaL.FrameMaker includes conversion utility. (Of course, you could convert in FrameMaker and then use the converted content in another XML tool.)
Do you need to specialize?
You will have to implement FrameMaker support yourself.XMetaL supports use of specialized DTDs.
Graphics
Many more formats supported in FrameMaker.In XMetaL, PDF output with EPS images requires Acrobat Distiller.Callouts a problem in either:
Layers in graphic file?FrameMaker callouts are flattened on export to XML.
Attributes
Attributes Inspector (XMetaL) is easier to use than Attributes Editor (FrameMaker).But...attributes show up in FrameMaker structure view and not in XMetaL structure view.
Summary
Your priorities will dictate which tool is a better fit for your organization.Each application has significant strengths and weaknesses.Authoring paradigms are significantly different.
Resources
DITA @ OASIShttp://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita
White papersAvailable on CD at our boothwww.scriptorium.com/papers.html
Please leave a business card or your email address if you want the handouts.
Contact information
Simon BateScriptorium Publishing [email protected] 481-2701 x106
Questions