How To Handle Graphics When Transitioning To DITA XML
How To Handle Graphics When Transitioning To DITA XML
If using Microsoft Word:
- Extract image & XML data
- Understand where images are stored & how they are named
- Learn to use captions or alt text to create filenames
- Confirm caption markup appears in XML
- Mock cropping effects using properly sized & positioned viewboxes
If using FrameMaker:
- Convert all graphics to SVGs
- Determine if the SVG will have linked or embedded images
- If embedding images, convert the image to a supported format
- Recreate images with callouts by parsing the .mif file for graphical information
In many cases, moving to DITA can be an overwhelming task, especially if your content is image-heavy. So learning how to properly handle images will not only save you time and energy, but also provide reassurance that your images are correctly transitioned. In this talk, we will look at many scenarios that you may encounter when moving your images over to DITA.
Free Conversion Offer
Upload your sample document (20-30 pages) and we will convert it to DITA free of charge!
We review the conversion results with you, and let you retain the output for your own testing purposes.
Automatic, Exact Topic Deduplication (available in Migrate 4.0+)
Easy Automation
Migrate now identifies and eliminates redundant topics as part of the process of converting content to DITA.
You can put converted files into a collection and have the system compare each topic in the collection with the others. Migrate will identify exact-matches, select a canonical version, automatically eliminate redundant copies, and then update all topics & associated maps accordingly.
Quickly Deduplicate Topics
Use the power of automation to quickly detect & deduplicate exact-match DITA topics.
To learn more about Migrate, please visit the Migrate product page or the Users’ Guide.
Free Conversion Offer
Upload your sample document (20-30 pages) and we will convert it to DITA free of charge!
We review the conversion results with you, and let you retain the output for your own testing purposes.
How to Convert Multilingual Content To DITA XML
When Converting Multilingual Content, Follow These Steps:
- Prepare your multilingual input file in one of the following formats: FrameMaker®, MS Word, RoboHelp®, InDesign®, Flare, XML
- Upload the input file to Migrate
- Specify the DITA target
- Prepare a Migrate Rule set
- Convert your content to DITA XML
- Review your DITA using an XML editor
- Refine the DITA conversion by updating the rule set if necessary
How to Convert RoboHelp To DITA XML
When Converting RoboHelp Files, Follow These Steps:
- Prepare your Robohelp® project
- Prepare your zip file for upload (Option 1: zip the entire Robohelp project folder; Option 2: zip all HTML, XPJ, HHC, GLO and CSS files)
- Specify the DITA target
- Prepare a Migrate Rule set
- Convert your content to DITA XML
- Review your DITA using an XML editor
- Refine the DITA conversion by updating the rule set if necessary
Converting a RoboHelp® project to DITA is easier than you might think. Tasks, troubleshooting topics, cross references, reusable content, glossaries, conditional text, and folder structures are all accurately converted. Using rules to leverage the visual cues in the document to discern its implicit structure, Migrate will produce valid DITA XML output within a few minutes. The same set of rules can convert similar documents, and an online rules editor lets you modify the conversion so that little to no pre- or post-conversion cleanup is required.
Migrate can handle a large range of source formats including Word, FrameMaker, RoboHelp, DocBook, InDesign, Flare, and XML/SGML/HTML.
How to Convert HTML To DITA XML
When Converting HTML Files, Follow These Steps:
- Prepare each document in HTML format
- Prepare an “index.html” file containing links to all the HTML files that need to be converted
- Zip the index file, the other HTML files, and the image folder together and upload the zip file to Migrate to be analyzed
- Specify the DITA target
- Prepare a Migrate Rule set
- Convert your content to DITA XML
- Review your DITA using an XML editor
- Refine the DITA conversion by updating the rule set if necessary
Converting HTML files to DITA XML can be a simple process with Stilo. This can be achieved by applying built in annotations and adding rules to leverage the visual cues in the document to discern the implicit structure. Then with little or no preprocessing and postprocessing, Migrate will produce a valid DITA XML output within a couple minutes. The same set of rules can convert all documents that follow a similar template.
Migrate can handle a large range of source formats including Word, FrameMaker, RoboHelp, DocBook, InDesign, Flare, and XML/SGML/HTML.
How to Convert FrameMaker To DITA XML
When Converting FrameMaker Files, Follow These Steps:
- Prepare your document in FrameMaker MIF format
- Upload your document to Migrate for analyzing
- Specify the DITA target
- Prepare the Migrate Rule set
- Convert your content to DITA XML
- Review your DITA using an XML editor
- Refine the DITA conversion by updating the rule set if necessary
FrameMaker is widely used for writing and editing complex structured or unstructured documents. At Stilo, by applying built in annotations and adding rules to leverage the visual cues in the document to discern the implicit structure, without preprocessing and postprocessing, Migrate will produce a valid DITA XML output within a few minutes. The same set of rules can convert all documents that follow a similar template.
Migrate can handle a large range of source formats including Word, FrameMaker, RoboHelp, DocBook, InDesign, Flare, and XML/SGML/HTML.
How to Convert Word To DITA XML
When Converting Word Files, Follow These Steps:
- Prepare your document in MS Word format
- Upload your document to Migrate for analyze
- Specify the DITA target
- Prepare a Migrate Rule set
- Convert your content to DITA XML
- Review your DITA using an XML editor
- Refine the DITA conversion by updating the rule set if necessary
One of the things authors love about Microsoft Word is that it’s easy to make your content look just the way you want it. This does not always lend itself to a straightforward conversion to DITA XML. Fortunately, at Stilo, we can leverage the visual cues in the document to discern the implicit structure of the content with rules. The same rules can convert all documents that follow a similar template. Without preprocessing and postprocessing, Migrate will produce a valid DITA XML output within a few minutes.
Migrate can handle a large range of source formats including Word, FrameMaker, RoboHelp, DocBook, InDesign, Flare, and XML/SGML/HTML.
How to Convert Complex Table Structures To DITA XML
When Converting Complex Tables, Follow These Steps:
- Prepare your document with tables in one of the following formats: MS Word, FrameMaker, Robohelp, InDesign, HTML, XML, Flare, etc.
- Upload your document to Migrate for analyze
- Specify the DITA target
- Prepare a Migrate Rule set
- Convert your content to DITA XML
- Review your DITA using an XML editor
- Refine the DITA conversion by updating the rule set if necessary
Converting complex table structures to DITA XML can be challenging. Fortunately, it is easy to convert complex tables automatically using Stilo’s Migrate.
Tables are often used to represent tabular information or used to lay out content on a page in a way that makes it easier for the reader to understand. This can create table representation that is very complex.
Examples of tables Migrate can convert include:
- Complex tables with merged cells
- Tables with steps or notes
- Definition tables or tab separated tables
- Tables need to switch columns or need to be stripped