Más contenido relacionado La actualidad más candente (20) Similar a Managing optimizingunstructured to-structuredconversions (20) Managing optimizingunstructured to-structuredconversions2. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.2
Prerequisites
3. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.3
Prerequisites
Need to convert from unstructured FrameMaker or Word
Have a well-designed structured authoring environment
Have a large amount of content to convert, or…
Need to continuously converting unstructured content
Determined that ROI for moving to structured authoring is positive
This presentation is for you if you…
4. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.4
Prerequisites
Have tools to create required outputs: PDF, HTML, Help, etc.
Have output tools that work with translated files, if required
Have content that uses templates
This presentation is for you if you…
5. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.5
The Conversion Process
6. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.6
The Conversion Process
Plan &
Prepare
Develop Convert Clean up
7. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.7
The Conversion Process
Stages
8. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.8
The Conversion Process
Stages
Prepare
9. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.9
The Conversion Process
Stages
Prepare Develop
10. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.10
The Conversion Process
Stages
Prepare Develop Convert
11. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.11
The Conversion Process
Stages
Prepare Develop Convert Clean Up
13. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.13
Prepare
Estimate Conversion Time – Issues to Consider
Assess Your Resources
Prepare for a Different Authoring Model
Develop a Preconversion Plan
Identify Preconversion Tasks
14. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.14
Prepare
Volume
Complexity
Variety
Format adherence
Similarity/Differences compared to proposed DTD/Schema
Estimate Conversion Time – Issues to Consider
15. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.15
Prepare
Internal/external cross-references
Embedded graphics
Conditional text
File naming
File sharing
Estimate Conversion Time – Issues to Consider
16. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.16
Prepare
You will likely need a developer
You may require on-going support and adjustments to your
conversions over time
Consider support you may need if you acquire new and different
content to convert
An in-house developer may be able to create various utilities and plug-
ins that turn hours-long repetitive work into quick fixes
Identify those performing the actual conversions
Assess Your Resources
17. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.17
Prepare
"Pre-structure" content
– Adjust heading levels
– Flatten or increase hierarchy
– Add missing content to heading levels
Add or delete formats
– Add and apply formats to achieve good element mappings
– Delete format instances that will not be mapped (ex. Chapter-only number)
Prepare for a Different Authoring Model
18. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.18
Prepare
Review and adjust list formats
– Nest lists correctly
– Ensure that list subsequent paragraphs have assigned formats
– Limit list nesting in table cells
– Edit numbered lists that span headings
– Remove visual indents, apply proper formats
– Edit lists that nest too deeply
Prepare for a Different Authoring Model
19. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.19
Prepare
One month minimum
Analyze your current content
Plan your migration so you do not miss important release dates
Create format map or maps
Develop tools/templates which may include third-party tools
Develop conversion utilities
Develop the Conversion Plan and Tools
20. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.20
Prepare
Start with small or non-critical projects
Test your process before entering a full-scale conversion
Document your process from preconversion to post-conversion tasks
Identify those performing the conversion processes
Average time per 200 pages: 1-5 days
Develop the Conversion Plan and Tools
21. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.21
Prepare
Correct irregular template usage
– Remove format overrides or ad hoc formatting
– Use well-defined format styles in Word
– Correct one-off formats
– Ensure heading hierarchy is correct
– Fix broken cross-references
– Edit landscape or non-flow pages
Identify Pre-Conversion Tasks
22. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.22
Prepare
Address one-to-many format mappings
– Single formats in multiple situations may not convert well because typical
conversion mappings allow only a small amount of context
Ensure you are not cross-referencing files outside of your book or that
will not be converted
Convert file insets or develop an inset plan
Identify Pre-Conversion Tasks
23. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.23
Prepare
Supply or remove boilerplate text
Use required naming conventions for files, directories, variables
– Follow XML file-naming conventions for content and graphic files
– Ensure graphic files use browser-recognizable file extensions, if required
– Change directory names and structures prior to conversion, if required
– Change variable names (text entities) to follow XML conventions
– Change variable definitions that have inline formatting
Identify Pre-Conversion Tasks
24. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.24
Prepare
Use generated list files to optimize results
– Cross-Ref
– Hypertext
– Index
– TargetMarkerNames
– Other user-defined markers
Identify Pre-Conversion Tasks
25. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.25
Prepare
Identify Pre-Conversion Tasks
26. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.26
Develop
Conversion Methods
Tools
27. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.27
Develop Conversion Methods
FrameMaker Conversions
– Two-Step Process
– One-Step Process
– Unstructured FrameMaker to HTML to XML
Word Conversions
– Word-to-FrameMaker-to-Structured FrameMaker
– Word-to-HTML-to-XML
28. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.28
Develop Conversion Methods
FrameMaker Two-Step Process
Use Your Structured Mapping Table
Import Structured Template Formats
Import EDD, Generate
Validate
Round-Trip Your Files
Create Unstructured Form of New Templates
Perform Preconversion Steps
Remove All Generated Files
Use TemplateMapper Tool
Perform Unstructured
Inspection/Adjustment
Unstructured to Unstructured Unstructured to Structured
29. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.29
Develop Conversion Methods
FrameMaker One-Step Process
Unstructured Directly to Structured
Perform Preconversion Steps
Remove All Generated Files
Use Your Structured Mapping Table
Import Structured Template Formats
Import EDD, Generate
Validate
Round-Trip Your Files
30. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.30
Develop Conversion Methods
FrameMaker Unstructured to HTML to XML
Create XSL Transformation, HTML to XML
Open XML Files in FrameMaker
Import Structured Template Formats
Import EDD, Generate
Validate
Round-Trip Your Files
Perform Preconversion Steps
Remove All Generated Files
Use FrameMaker's HTML Setup Utility
Save File as Template for More Conversions
Save as HTML
Unstructured to HTML HTML to XML
31. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.31
Develop Conversion Methods
Word-to-FrameMaker-to-Structured FrameMaker
Use Your Structured Mapping Table
Import Structured Template Formats
Import EDD, Generate
Validate
Round-Trip Your Files
Open Word Document in FrameMaker
Adjust or Add Formats
Use Word Styles to Write a FrameMaker
Structured Mapping Table
Word to Unstructured FrameMaker Unstructured to Structured
32. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.32
Develop Conversion Methods
Word-to-HTML-to-XML
Remove Overall Table Wrapper, if needed
Save Word as HTML
View/Check HTML Code for Good
Formatting
Word to HTML HTML to Structured
Create XSL Transformation, HTML to XML
Open XML resulting Files in FrameMaker
Import EDD, Generate
Validate
Round-Trip Your Files
33. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.33
Develop Tools
Preconversion utilities
– Strip unused variables
– Remove unused color definitions
Format-to-Format mappings
– Use third-party tools: TemplateMapper, Silicon Prairie
– Use mapping tools to conflate many-to-one mappings
34. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.34
Develop Tools
Structured mapping table
– Ensure that you have enough formats to achieve contextual mappings
– Use qualifiers to help assign container element
– Assign element mappings to untagged formats
– Choose to flag character format overrides
– Indicate attributes and values in mappings
35. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.35
Develop Tools
HTML Mapping Table
– Use FrameMaker's HTML Setup to map Paragraph, Character, Cross-Reference
formats, save as template
– Use HTML Options to create referenceable graphic files
HTML-to-XML Transformation
– Use XSL to create a transformation to your DTD/Schema
36. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.36
Develop Tools
Post-conversion clean-up utilities
– "Assist" FrameMaker in structuring cross-references
– Strip Cross-Ref markers
– Add Table Continuation elements
– Resized graphic frames
Post-conversion XML-to-XML transformations
– Transform content from tables to lists or reverse
38. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.38
Convert
Choose a method or methods
Handle embedded graphics
Run your processes
Replace title page with structured boilerplate file
Import the EDD
Import template formats
Generate
Add Contents, Index, Other Generated Files
39. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.39
Convert
Choosing a Method or Methods
Method Best for. . .
FM Two-Step Very large, complex conversions, unstructured content
is dissimilar to DTD/Schema, many nested lists
FM One-Step Unstructured content is similar in structure to the
DTD/Schema
FM-to-HTML-XML Multiple templates, poor template adherence, smaller
conversions
Word-to-Unstructured FM-
to-Structured FM
Smaller conversions whose content is similar in
structure to the DTD/Schema
Word-to-HTML-to-XML On-going conversions, perhaps content from
developers
41. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.41
Clean Up
Run post-conversion utilities
Validate, fix, assign elements to untagged content
Edit content as necessary
Clear overrides
Round-trip files to clear previous formatting
Run any post-conversion XML-to-XML transformations
42. Copyright © 2013, Oracle and/or its affiliates. All rights reserved.42
Contact/Request
Contact: edna.elle@oracle.com
Request: Sample complete conversion instructions (50+ pages)
Notas del editor This is what I will cover today(then briefly talk through the bullet points)(I don’t really like “Learning Objectives” as a title. – Maybe something like “What You Need to Do” or “Considerations” or something like that.)