Omni Systems, Inc.

  

Mif2Go User's Guide, Version 33u53

  

Valid HTML 4.01!

 

Made with Mif2Go

> Contents


Contents

Figures

Tables

About this guide

1 Getting started with Mif2Go

1.1 Quick start

1.1.1 For first-time users of Mif2Go

1.1.2 For Mif2Go updaters

1.1.3 Create or replace the Mif2Go installation script

1.1.4 Install updates to Mif2Go

1.2 What you need to know

1.2.1 For successful conversions

1.2.2 How the conversion process works

1.2.3 Output formats you can specify

1.2.4 Languages and character sets supported by Mif2Go

1.3 What you need to have

1.4 What you need to do

1.4.1 Install Mif2Go

1.4.2 Start Mif2Go

1.4.3 Try a conversion

1.4.4 Download the Mif2Go User's Guide

1.4.5 Obtain third-party tools for Help systems

1.5 How Mif2Go works

1.6 How to stop Mif2Go

1.7 How to update Mif2Go

1.8 How to uninstall Mif2Go

2 Planning a conversion project

2.1 Naming files, folders, and paths

2.2 Naming FrameMaker formats

2.3 Working with Mif2Go configuration files

2.4 Importing formats from a conversion template

2.5 Preparing documents for conversion

2.5.1 Updating your document in FrameMaker

2.5.2 Planning for graphics processing

2.5.3 Replacing embedded graphics with referenced graphics

2.5.4 Setting up cross references to and from text insets

2.5.5 Creating hotspots for hypertext links

2.5.6 Excluding files from a book conversion

2.5.7 Preparing a structured document for conversion

2.6 Establishing a conversion environment

2.7 Setting up multiple interlinked HTML projects

2.8 Preparing deliverables after conversion

3 Converting a book or document

3.1 Checking set-up and conversion requirements

3.2 Starting Mif2Go

3.3 Setting up a Mif2Go project

3.4 Choosing project set-up options

3.4.1 Importing formats from a FrameMaker template

3.4.2 Converting FrameMaker system variables to text

3.4.3 Generating and updating your document

3.4.4 Including FrameMaker-generated files

3.4.5 Understanding configuration settings for general set-up options

3.4.6 Choosing format-specific set-up options

3.5 Specifying conversion settings

3.6 Converting documents

3.7 Choosing final conversion options

3.7.1 Understanding how export options work

3.7.2 Specifying output format and file extension

3.7.3 Choosing input source and disposition

3.7.4 Figuring out graphics export options

3.7.5 Choosing postprocessing options

4 Setting configuration options

4.1 Editing a Mif2Go configuration file

4.1.1 Understanding what settings are available

4.1.2 Understanding default configuration values

4.1.3 Editing the correct configuration file

4.1.4 Understanding the rules for configuration settings

4.1.5 Specifying file paths in configuration settings

4.1.6 Using wildcards in configuration settings

4.2 Specifying operating settings

4.2.1 Specifying an output format

4.2.2 Specifying the output file extension

4.2.3 Reusing or discarding MIF files

4.2.4 Reusing ASCII DCL files

4.2.5 Checking for broken links in HTML or XML output

4.2.6 Using Conversion Designer for RTF output (deprecated)

4.2.7 Skipping the Mif2Go Export and Finished dialogs

4.2.8 Specifying how to treat cases, spaces, and wildcards

4.2.9 Reordering text flows

4.2.10 Converting system variables to text

4.2.11 Eliminating Word-generated cross-reference markers

4.3 Logging conversion events

4.4 Identifying files and objects

4.4.1 Understanding how Mif2Go creates identifiers

4.4.2 Working with FrameMaker ObjectIDs

4.4.3 Working with FrameMaker cross-reference IDs

4.4.4 Working with Mif2Go FileIDs

4.5 Using Mif2Go configuration templates

4.6 Applying FrameMaker conversion templates

4.6.1 Specifying conversion-template settings

4.6.2 Applying alternate conversion templates

4.6.3 Changing template options

4.6.4 Avoiding template-related disasters

4.6.5 Troubleshooting template import problems

4.7 Applying FrameMaker conditions and variables

4.7.1 Applying condition Show/Hide settings

4.7.2 Replacing values of FrameMaker user variables

4.8 Converting FrameMaker-generated files

4.8.1 Converting FrameMaker TOC and IX files

4.8.2 Preventing conversion of other generated files

4.8.3 Activating hypertext links in a converted index

4.8.4 Making See and See also index entries into useful links

4.9 Generating/updating before converting

4.10 Processing graphics

4.10.1 Understanding which graphics are included

4.10.2 Choosing how to convert graphics

4.10.3 Choosing when to convert graphics

4.10.4 Identifying graphics files

4.11 Converting equations

4.11.1 Understanding how equations are processed

4.11.2 Specifying equation size and DPI

4.11.3 Specifying equation output format

4.11.4 Positioning equations in RTF output

4.12 Creating hotspots for hypertext links

4.12.1 Delimiting a hotspot with a character format

4.12.2 Making an entire paragraph into a hotspot

4.12.3 Delimiting a hotspot with a color

4.13 Repurposing FrameMaker markers

5 Converting to print RTF

5.1 Converting to Word: a one-way street

5.1.1 Understanding differences in implementation

5.1.2 Understanding differences in file sizes

5.1.3 Understanding why round-tripping is not an option

5.1.4 Migrating a document from FrameMaker to Word

5.1.5 Developing a workflow using Word for reviews

5.1.6 Supporting more than one version of Word for review

5.2 Setting up a print RTF project

5.2.1 Creating a print RTF project

5.2.2 Choosing set-up options for a print RTF project

5.2.3 Specifying output type and file extension

5.2.4 Specifying the default output language

5.2.5 Adjusting for different versions of Word

5.2.6 Importing a Word template

5.3 Converting a FrameMaker book to print RTF

5.3.1 Understanding why Mif2Go produces separate RTF files

5.3.2 Producing a single RTF file from a FrameMaker book

5.4 Specifying document layout options for print RTF

5.4.1 Understanding document layout restrictions

5.4.2 Eliminating large top or bottom margins

5.4.3 Using text frames to solve spacing problems

5.4.4 Maintaining pagination in Word

5.4.5 Keeping or removing page breaks

5.4.6 Specifying columns and gaps

5.4.7 Adjusting sidehead width for Word

5.4.8 Converting footnotes

5.4.9 Converting headers and footers

5.4.10 Converting special text flows for RTF output

5.4.11 Handling different page size or orientation

5.4.12 Converting system variables to text for RTF

5.5 Converting paragraph and character formats

5.5.1 Mapping paragraph formats to RTF styles

5.5.2 Merging paragraph formats

5.5.3 Converting sidehead formats

5.5.4 Converting run-in headings

5.5.5 Converting autonumbered formats

5.5.6 Converting bulleted formats

5.5.7 Converting reference frames for Word

5.5.8 Converting character formats

5.5.9 Removing unused formats

5.6 Converting tabs and spaces

5.6.1 Understanding differences in tab behavior

5.6.2 Understanding differences in spaces

5.6.3 Altering tab behavior

5.6.4 Altering font metrics to adjust tabs

5.7 Specifying font usage

5.7.1 Setting default font parameters

5.7.2 Remapping fonts

5.7.3 Specifying font types

5.7.4 Specifying font encoding for non-Western characters

5.7.5 Specifying font encoding for FrameMaker 8 Unicode

5.7.6 Removing unused fonts

5.8 Modifying text appearance

5.8.1 Adjusting line spacing

5.8.2 Adjusting paragraph spacing

5.8.3 Adjusting small caps

5.8.4 Specifying a style for quotes

5.8.5 Mapping high ASCII characters for RTF output

5.8.6 Specifying text color

5.8.7 Hiding white text

5.8.8 Hiding content in Word

5.8.9 Omitting content from RTF output

5.8.10 Replacing content in RTF output

5.9 Converting cross references and hypertext links

5.9.1 Including ObjectIDs for Word links and cross references

5.9.2 Converting cross references to Word

5.9.3 Converting hypertext links to Word

5.9.4 Locking hypertext links to allow revision tracking

5.9.5 Enabling interfile cross references and hypertext links

5.9.6 Replacing building blocks in master-page references

5.10 Converting generated files to print RTF

5.10.1 Specifying which generated files to convert

5.10.2 Activating links in converted index and list files

5.10.3 Making the entire text of each list entry an active link

5.10.4 Ensuring link targets are present in RTF output

5.10.5 Correcting <$nopage> index links

5.11 Converting tables to print RTF

5.12 Converting graphics for print RTF

5.12.1 Understanding graphics requirements for Word

5.12.2 Converting referenced graphics

5.12.3 Converting embedded graphics

5.12.4 Limiting bitmap resolution and color depth

5.12.5 Managing callouts added to graphics

5.12.6 Positioning graphics and wrapping text

5.12.7 Preserving graphics scale in Word

5.12.8 Accommodating graphics in multiple versions of Word

5.12.9 Including file names of referenced graphics in Word

5.12.10 Linking instead of embedding referenced graphics

5.12.11 Embedding graphics in converted RTF files

5.13 Turning on revision tracking in Word

5.14 Modifying Word output after conversion

5.14.1 Generating an index in Word

5.14.2 Combining RTF files into a Word master document

5.14.3 Checking print RTF output files for Mif2Go version

5.15 Converting to OpenOffice or StarOffice

6 Producing on-line Help

6.1 Weighing Help-system alternatives

6.1.1 Considering Help-system features

6.1.2 Evaluating Microsoft Windows Help (WinHelp)

6.1.3 Evaluating Microsoft HTML Help

6.1.4 Evaluating WebHelp

6.1.5 Evaluating OmniHelp

6.1.6 Evaluating JavaHelp and Oracle Help for Java

6.1.7 Evaluating Eclipse Help

6.2 Setting up a Help system project

6.2.1 Checking automatic Help topic assignments

6.2.2 Configuring run-in paragraphs

6.2.3 Specifying additional processing after conversion

6.2.4 Compiling and distributing Help systems

6.3 Producing contents and index for Help systems

6.3.1 Understanding how Mif2Go produces contents and index

6.3.2 Including FrameMaker TOC and IX in Help systems

6.3.3 Modifying contents or index production for HTML-based Help

6.3.4 Modifying contents or index production for WinHelp

6.4 Configuring contents entries for Help systems

6.4.1 Understanding how contents levels are assigned

6.4.2 Setting contents levels for WinHelp

6.4.3 Including contents entries in HTML-based Help

6.4.4 Setting contents levels for HTML-based Help

6.5 Configuring index entries for Help systems

6.5.1 Understanding how Mif2Go creates Help index entries

6.5.2 Limiting length of index entries for HTML Help or WinHelp

6.5.3 Omitting intermediate index-range entries

6.5.4 Treating commas as potential index level separators

6.5.5 Combining index levels for HTML-based Help

6.5.6 Configuring See and See also entries for HTML-based Help

6.5.7 Specifying index link destinations for HTML-based Help

6.5.8 Customizing index sort order for HTML-based Help

6.6 Providing related-topic links for Help systems

6.6.1 Understanding related-topic links

6.6.2 Understanding how ALinks work

6.6.3 Understanding how KLinks work

6.6.4 Adding related-topic link keywords in FrameMaker

6.6.5 Adding ALink and KLink jumps in FrameMaker

6.6.6 Creating target-and-jump ALinks for HTML-based Help

6.6.7 Specifying ALink and KLink list-link destinations

6.7 Jumping to secondary windows in Help systems

6.7.1 Assigning secondary windows for WinHelp

6.7.2 Assigning secondary windows for HTML-based Help

6.8 Creating pop-up topics for Help systems

6.8.1 Understanding pop-up hotspots, links, and topics

6.8.2 Defining a pop-up hotspot

6.8.3 Displaying a topic in a pop-up window

6.9 Including expandable sections in Help topics

6.9.1 Understanding Mif2Go expandable drop-down sections

6.9.2 Setting up expandable sections for your document

6.9.3 Delimiting expandable drop-down sections

6.9.4 Configuring drop-down links

6.9.5 Configuring drop-down blocks

6.9.6 Providing CSS for drop-down links and blocks

6.9.7 Deploying JavaScript code for drop-down sections

6.9.8 Emulating Web Works Publisher drop-down hotspots

6.10 Setting up Context Sensitive Help (CSH)

6.10.1 Understanding how CSH works

6.10.2 Specifying CSH mappings

6.11 Setting up a dynamic modular Help system

7 Generating WinHelp

7.1 Setting up a WinHelp project

7.1.1 Creating a WinHelp project

7.1.2 Choosing set-up options for a WinHelp project

7.1.3 Preparing a document for conversion to WinHelp

7.1.4 Understanding initial set-up requirements

7.1.5 Accommodating platform differences

7.1.6 Setting basic options in the configuration file

7.1.7 Including ObjectIDs in WinHelp

7.1.8 Handling page breaks and section breaks

7.1.9 Providing multiple .hlp files

7.1.10 Integrating WinHelp from RoboHelp

7.1.11 Compiling a WinHelp project

7.1.12 Checking WinHelp RTF files for Mif2Go version

7.2 Converting FrameMaker text

7.2.1 Converting formats for WinHelp

7.2.2 Converting special characters

7.2.3 Removing unused formats and fonts

7.2.4 Replacing paragraph or character content

7.2.5 Specifying text color

7.2.6 Converting footnotes

7.3 Converting cross references

7.3.1 Creating help context markers

7.3.2 Specifying cross-reference destination files

7.3.3 Specifying cross-reference jump destinations

7.3.4 Specifying options for selected cross-reference formats

7.3.5 Limiting cross-reference marker text

7.4 Converting tables for WinHelp

7.4.1 Positioning tables and table titles

7.4.2 Adjusting table appearance

7.4.3 Converting table rows to topics and table cells to pop-ups

7.5 Converting graphics for WinHelp

7.5.1 Choosing a graphics format for WinHelp

7.5.2 Avoiding the GDI resource leak

7.5.3 Positioning graphics in WinHelp

7.5.4 Displaying graphics in pop-ups for WinHelp

7.6 Converting generated files for WinHelp

7.6.1 Converting lists of paragraph references

7.6.2 Converting indexes and lists of marker references

7.7 Configuring WinHelp topics

7.7.1 Creating WinHelp topics

7.7.2 Assigning properties to formats for topics and hotspots

7.7.3 Configuring topic titles for WinHelp

7.8 Creating jumps and pop-ups for WinHelp

7.8.1 Identifying WinHelp jump destinations with FileIDs

7.8.2 Configuring pop-up topics

7.8.3 Creating hotspots for jumps and pop-ups in WinHelp

7.8.4 Using cross references for jumps and pop-ups

7.8.5 Using hypertext links for jumps and pop-ups

7.8.6 Disallowing hypertext links for jumps and pop-ups

7.8.7 Specifying jumps to secondary windows in WinHelp

7.8.8 Specifying jumps to external files

7.8.9 Using the same content for both normal topics and pop-ups

7.8.10 Creating a glossary pop-up: an example

7.8.11 Configuring alternative jumps and pop-ups

7.8.12 Specifying the scope of alternative jumps and pop-ups

7.9 Invoking WinHelp macros

7.9.1 Using a hypertext marker to invoke a macro

7.9.2 Assigning a hotspot property to invoke a macro

7.10 Creating related-topic links in WinHelp

7.10.1 Understanding KLink limitations

7.10.2 Adding ALinks and KLinks with markers

7.10.3 Adding related-topic keywords with formats

7.10.4 Inserting WinHelp macros for ALink jumps

7.11 Configuring index entries for WinHelp

7.11.1 Designating index level separators

7.11.2 Eliminating duplicate keywords

7.11.3 Keeping or discarding "See also" entries

7.11.4 Using FrameMaker Index markers

7.12 Configuring contents for WinHelp

7.12.1 Naming and configuring Help files and titles

7.12.2 Specifying heading formats and levels for contents

7.12.3 Assembling WinHelp contents from the command line

7.13 Creating browse sequences

7.13.1 Setting up an automatic browse sequence

7.13.2 Specifying browse numbers

7.13.3 Setting up multi-file browse sequences

7.13.4 Setting up branching browse sequences

8 Generating Microsoft HTML Help

8.1 Understanding how Mif2Go produces HTML Help

8.2 Setting up an HTML Help project

8.2.1 Creating an HTML Help project

8.2.2 Choosing set-up options for an MS HTML Help project

8.2.3 Organizing files for HTML Help

8.2.4 Specifying a project title for HTML Help

8.2.5 Naming project and compiled files for HTML Help

8.2.6 Specifying a starting topic file for HTML Help

8.2.7 Specifying help-file language for HTML Help

8.2.8 Regenerating the HTML Help project file

8.2.9 Locating graphics files for HTML Help

8.2.10 Compiling and testing an HTML Help project

8.2.11 Registering an HTML Help system for network use

8.3 Customizing HTML Help display features

8.3.1 Using CSS and font tags with HTML Help

8.3.2 Eliminating graphic and table indents from HTML Help

8.3.3 Adding tabs and toolbar buttons to HTML Help

8.3.4 Adding expandable sections to HTML Help

8.4 Creating pop-ups for HTML Help

8.4.1 Using HTML Help for pop-ups

8.4.2 Using KeyHelp for pop-ups

8.4.3 Using WinHelp for pop-ups

8.5 Creating links and hypertext jumps in HTML Help

8.5.1 Creating hypertext jumps to other CHM files

8.5.2 Specifying href link syntax for HTML Help

8.5.3 Linking to external files from compiled HTML Help

8.6 Creating related-topic links for HTML Help

8.6.1 Adding ALink keywords for HTML Help

8.6.2 Adding ALink and KLink jumps for HTML Help

8.6.3 Configuring ALink and KLink jumps for HTML Help

8.6.4 Rolling your own macros for ALink jumps in HTML Help

8.6.5 Using the same format or marker for ALink keywords and jumps

8.6.6 Creating buttons for other types of related-topic links

8.7 Using secondary windows in HTML Help

8.7.1 Defining secondary windows for HTML Help

8.7.2 Jumping from a topic to a secondary window

8.7.3 Jumping from contents or index to a secondary window

8.8 Generating contents and index for HTML Help

8.8.1 Choosing how to generate HTML Help contents and index

8.8.2 Generating contents and index with HTML Help Workshop

8.8.3 Generating contents and index with Mif2Go

8.8.4 Configuring contents entries for HTML Help

8.8.5 Providing mid-topic contents links in HTML Help

8.8.6 Making the TOC track index links in HTML Help

8.8.7 Comparing HHW settings for stand-alone vs. merged CHMs

8.8.8 Customizing contents and index for HTML Help

8.9 Converting generated files for HTML Help

8.9.1 Converting lists of paragraph references

8.9.2 Converting lists of marker references

8.10 Providing full-text search (FTS) for HTML Help

8.11 Setting up CSH for HTML Help

8.11.1 Inserting CSH destinations in your document

8.11.2 Determining whether you need map and alias files

8.11.3 Specifying a map file for CSH links

8.11.4 Creating an alias file for CSH links

8.11.5 Understanding alias-file entries

8.11.6 Producing a list of aliases and associated topic titles

8.12 Mapping and merging CHM files

8.12.1 Interlinking multiple CHM files

8.12.2 Synchronizing TOC references to slave CHM files

8.12.3 Merging CHM files

9 Generating OmniHelp

9.1 Understanding how OmniHelp works

9.2 Setting up OmniHelp viewer control files

9.2.1 Choosing XHTML vs. HTML OmniHelp control files

9.2.2 Making OmniHelp viewer control files available

9.2.3 Customizing OmniHelp viewer control files

9.2.4 Examining generated control and data files

9.3 Setting up an OmniHelp project

9.3.1 Creating an OmniHelp project

9.3.2 Choosing set-up options for an OmniHelp project

9.3.3 Specifying the OmniHelp output format

9.3.4 Naming your OmniHelp project

9.3.5 Giving your OmniHelp project a title

9.3.6 Specifying the starting topic

9.3.7 Specifying the start-up file type

9.3.8 Specifying memory requirements

9.3.9 Removing paths from interfile links for OmniHelp

9.3.10 Getting OmniHelp supporting files in the right place

9.4 Using CSS with OmniHelp

9.4.1 Specifying CSS for topics in OmniHelp

9.4.2 Understanding how CSS works in OmniHelp topics

9.4.3 Specifying CSS for OmniHelp navigation frames

9.5 Customizing OmniHelp display features

9.5.1 Configuring OmniHelp window usage and frameset dimensions

9.5.2 Altering OmniHelp top navigation frame content

9.5.3 Modifying OmniHelp navigation aids

9.5.4 Choosing whether to use cookies for OmniHelp

9.5.5 Localizing the OmniHelp interface

9.5.6 Modifying OmniHelp CSS classes

9.5.7 Modifying the OmniHelp template

9.6 Choosing navigation features for OmniHelp

9.7 Configuring contents and index for OmniHelp

9.7.1 Understanding OmniHelp contents and index creation

9.7.2 Choosing whether to use expanding contents or index

9.7.3 Choosing how to expand contents and index subentries

9.7.4 Providing alternate expansion icons for contents or index

9.7.5 Excluding Open All and Close All buttons

9.7.6 Redirecting See and See also index entries

9.8 Providing related-topic links in OmniHelp

9.9 Jumping to secondary windows in OmniHelp

9.10 Configuring full-text search for OmniHelp

9.10.1 Generating search data

9.10.2 Specifying length of search terms

9.10.3 Excluding search terms

9.10.4 Using regular expressions in search

9.10.5 Highlighting search terms found in topics

9.11 Setting up CSH for OmniHelp

9.11.1 Specifying alias prefixes for OmniHelp CSH calls

9.11.2 Referencing OmniHelp topic IDs from an application

9.11.3 Using redirect pages for OmniHelp CSH calls

9.11.4 Executing browser commands for OmniHelp CSH calls

9.12 Merging OmniHelp projects

9.12.1 Understanding the OmniHelp merge process

9.12.2 Listing and mapping OmniHelp subprojects

9.12.3 Providing TOC placeholders for OmniHelp subprojects

9.12.4 Deciding when to merge OmniHelp subprojects

9.13 Assembling OmniHelp files for viewing

9.14 Launching OmniHelp

9.14.1 Starting with the default topic or a specified topic

9.14.2 Restarting where you left off

9.14.3 Coping with browser quirks

10 Generating JavaHelp or Oracle Help

10.1 Choosing which Java Help system to use

10.2 Setting up a JavaHelp or Oracle Help project

10.2.1 Creating a JavaHelp or Oracle Help for Java project

10.2.2 Choosing set-up options for a JavaHelp or Oracle Help project

10.2.3 Specifying output options for JavaHelp

10.2.4 Specifying output options for Oracle Help for Java

10.2.5 Establishing a JavaHelp environment

10.2.6 Establishing an Oracle Help environment

10.2.7 Creating a folder structure for JavaHelp / Oracle Help

10.2.8 Configuring the helpset file

10.2.9 Coping with JavaHelp / Oracle Help viewer limitations

10.2.10 Compiling JavaHelp with Helen

10.3 Generating contents and index

10.3.1 Configuring contents entries for JavaHelp or Oracle Help

10.3.2 Assigning TOC images and expansion levels in JavaHelp 2

10.3.3 Configuring index entries for JavaHelp or Oracle Help

10.3.4 Eliminating index-marker artifacts from text

10.3.5 Locating JavaHelp or Oracle Help contents and index files

10.4 Providing full-text search for JavaHelp / Oracle Help

10.4.1 Including a search-index link in the helpset file

10.4.2 Creating a search index for JavaHelp

10.4.3 Creating a search index for Oracle Help

10.5 Creating and viewing a Java Archive (JAR) file

10.5.1 Creating a JAR file

10.5.2 Viewing a JAR file

10.6 Converting a glossary to JavaHelp 2

10.6.1 Evaluating glossary usability

10.6.2 Assigning glossary properties

10.6.3 Configuring glossary IDs

10.6.4 Eliminating glossary entries from the JavaHelp TOC

10.7 Defining windows for JavaHelp or Oracle Help

10.7.1 Specifying window parameters for JavaHelp 2

10.7.2 Specifying window parameters for Oracle Help

10.7.3 Jumping to secondary windows in JavaHelp or Oracle Help

10.8 Linking to destinations within topics

10.9 Creating ALinks for Oracle Help

10.10 Merging JavaHelp or Oracle Help systems

10.11 Setting up CSH for JavaHelp or Oracle Help

11 Generating Eclipse Help

11.1 Understanding how Eclipse Help works

11.2 Setting up an Eclipse Help project

11.2.1 Creating an Eclipse Help project

11.2.2 Choosing set-up options for an Eclipse Help project

11.2.3 Specifying Eclipse Help output options

11.2.4 Making sure links work in Eclipse Help

11.2.5 Disabling breadcrumb trails in Eclipse Help

11.3 Configuring Eclipse Help manifest files

11.3.1 Specifying a Java manifest file for Eclipse Help

11.3.2 Specifying Eclipse Help plug-in properties

11.3.3 Configuring the Java manifest file for Eclipse Help

11.3.4 Configuring the plug-in manifest file for Eclipse Help

11.4 Configuring contents and index for Eclipse Help

11.4.1 Choosing contents and index methods for Eclipse Help

11.4.2 Supplying path information for contents and index links

11.4.3 Encoding special characters for contents and index entries

11.4.4 Configuring contents properties for Eclipse Help

11.4.5 Configuring index properties for Eclipse Help

11.5 Configuring search properties for Eclipse Help

11.6 Merging Eclipse Help projects

11.6.1 Linking primary content to secondary TOCs

11.6.2 Linking secondary TOCs to primary content (deprecated)

11.7 Setting up CSH for Eclipse Help

11.7.1 Understanding how Mif2Go generates context links

11.7.2 Naming context file and attribute for secondary plug-ins

11.7.3 Configuring context IDs and context anchors

11.7.4 Configuring context descriptions

11.7.5 Locating context information

11.8 Packaging Eclipse Help files

11.8.1 Specifying a ZIP command for doc.zip

11.8.2 Specifying ZIP command parameters

11.8.3 Specifying a JAR command for doc.jar

11.8.4 Archiving Eclipse Help files

12 Converting to HTML

12.1 Setting up an HTML or XML project

12.1.1 Creating an HTML or XML project

12.1.2 Choosing set-up options for an HTML or XML project

12.1.3 Preparing a document for conversion to HTML or XML

12.1.4 Specifying output type and file extension

12.1.5 Checking automatic settings for HTML or XML split files

12.1.6 Establishing a conversion workflow for HTML

12.1.7 Checking HTML output files for broken links

12.1.8 Checking HTML or XML output files for Mif2Go version

12.1.9 Using XHTML tagging rules for HTML

12.2 Including starting code and entity references

12.3 Supplying values for the <head> element

12.3.1 Specifying HTML/XML version, DocType, and DTD

12.3.2 Specifying namespace and language

12.3.3 Specifying character encoding for HTML

12.3.4 Specifying the HTML generator

12.3.5 Specifying page titles for HTML output files

12.3.6 Supplying content for the <meta> tag

12.3.7 Specifying nonstandard values for declarations

12.4 Specifying HTML <body> attributes

12.5 Specifying document-wide properties for HTML

12.5.1 Specifying a default DPI setting

12.5.2 Converting system variables to text for HTML

12.5.3 Suppressing closing </p> tags for HTML

12.5.4 Suppressing line breaks in HTML and XML output

12.6 Defining and mapping colors

12.6.1 Converting colors

12.6.2 Mapping FrameMaker colors to new values

12.6.3 Defining new colors

12.6.4 Using Web-safe colors

12.6.5 Redefining colors via conversion template

12.6.6 Understanding CMYK-to-RGB conversion anomalies

12.7 Converting generated files for HTML

12.7.1 Converting FrameMaker IX and other marker lists

12.7.2 Converting FrameMaker TOC and other paragraph lists

12.8 Importing HTML files as insets

12.9 Converting structured documents to HTML

12.10 Converting conditions to HTML attributes

12.11 Exporting content for database input

12.12 Using framesets

12.13 Adding a "Made with Mif2Go" label or button

12.14 Passing W3C validation tests

12.14.1 Understanding limitations of W3C validation

12.14.2 Replacing high ASCII characters for W3C validation

12.14.3 Eliminating <nobr> tags

12.14.4 Removing full-row straddles from tables

12.14.5 Avoiding redundant attribute assignments in tables

12.14.6 Eliminating duplicate ObjectIDs

13 Converting to generic XML

13.1 Understanding how Mif2Go generates XML output

13.1.1 Accommodating HTML features in XML output

13.1.2 Introducing structure with Mif2Go

13.1.3 Introducing structure with XSLT

13.1.4 Creating structure in FrameMaker

13.1.5 Producing SGML with Mif2Go and XSLT

13.2 Setting up a generic XML project

13.3 Specifying generic XML output settings

13.3.1 Specifying output type, version, and file extension

13.3.2 Specifying character encoding for XML

13.3.3 Specifying the root element and content type

13.3.4 Preventing arbitrary line breaks in XML text elements

13.4 Providing XML tags and structure

13.4.1 Generating XML from an unstructured document

13.4.2 Deriving XML tags from format and class names

13.4.3 Eliminating HTML attributes and tags

13.4.4 Including or excluding FrameMaker autonumbers

13.4.5 Configuring forced returns for XML

13.5 Converting FrameMaker lists to generic XML

13.6 Configuring links for generic XML

13.7 Converting graphics for generic XML

13.8 Converting index entries to generic XML

13.8.1 Configuring index markers for conversion to XML

13.8.2 Defining macros to process index content

14 Producing DITA XML

14.1 Generating DITA XML with Mif2Go

14.1.1 Understanding what you need to know about DITA

14.1.2 Clarifying your purpose for creating DITA output

14.1.3 Converting from structured vs. unstructured FrameMaker

14.1.4 Understanding what information you must supply

14.1.5 Understanding how Mif2Go generates DITA output

14.1.6 Creating valid DITA XML output

14.2 Setting up a DITA XML project

14.2.1 Creating a DITA XML project

14.2.2 Choosing set-up options for a DITA XML project

14.2.3 Specifying DITA output options

14.2.4 Specifying DITA version

14.2.5 Configuring the DITA DTD SYSTEM identifier

14.2.6 Ensuring FrameMaker 8 import compatibility

14.2.7 Substituting document format names for default names

14.3 Specifying general options for DITA

14.4 Configuring DITA elements

14.4.1 Understanding how Mif2Go delimits DITA elements

14.4.2 Treating FrameMaker format names as DITA element names

14.4.3 Mapping paragraph formats to DITA elements

14.4.4 Mapping character formats to DITA elements

14.4.5 Assigning multiple typographic elements to a format

14.4.6 Assigning attributes to DITA elements

14.4.7 Preserving whitespace in block elements

14.4.8 Including processing instructions for line or page breaks

14.4.9 Providing a <shortdesc> element for a DITA topic

14.4.10 Converting index markers to <indexterm> elements

14.5 Nesting DITA block elements

14.5.1 Understanding how Mif2Go determines element nesting

14.5.2 Designating DITA ancestor elements

14.5.3 Fixing up interpolated ancestries

14.5.4 Deciding when to fully specify ancestry

14.5.5 Specifying alternate ancestries for the same element

14.5.6 Specifying first-child status for nested elements

14.5.7 Closing DITA ancestor elements

14.5.8 Opening DITA ancestor elements

14.5.9 Configuring multi-paragraph list items

14.5.10 Splitting a paragraph into separate DITA elements

14.5.11 Specifying DITA element levels

14.6 Converting tables to DITA XML

14.6.1 Working with Mif2Go DITA table types

14.6.2 Designating ancestors for <table> elements

14.6.3 Applying attributes to DITA tables

14.6.4 Configuring DITA table components

14.6.5 Converting tables used only as image containers

14.6.6 Omitting table coding entirely

14.7 Converting images to DITA XML

14.7.1 Designating ancestors for <image> and <fig> elements

14.7.2 Specifying what to include in a <fig> wrapper

14.7.3 Providing alternate text for images

14.7.4 Understanding why images might look incorrectly scaled

14.8 Organizing DITA topics

14.8.1 Understanding when to split, nest, or wrap DITA topics

14.8.2 Splitting FrameMaker files into DITA topic files

14.8.3 Prefixing split-file names to identify DITA topic type

14.8.4 Nesting DITA topics in unsplit files

14.8.5 Wrapping DITA topics in a top-level <dita> element

14.9 Configuring DITA topics

14.9.1 Designating starting points for DITA topics

14.9.2 Specifying the DITA topic type

14.9.3 Specifying the ID for a DITA topic

14.9.4 Adjusting DITA topic IDs generated from file names

14.9.5 Specifying alternate titles for a DITA topic

14.10 Configuring links for DITA XML

14.10.1 Linking to elements below topic level

14.10.2 Retaining cross-reference content in <xref> elements

14.10.3 Omitting <xref> elements from footnotes

14.10.4 Overriding <xref> attribute values

14.11 Exporting FrameMaker variables to DITA XML

14.11.1 Understanding how Mif2Go represents variables in DITA

14.11.2 Specifying a treatment for FrameMaker variables

14.11.3 Retaining format properties of user variables in DITA

14.12 Converting conditions to DITA attributes

14.13 Marking FrameMaker text insets in DITA

14.14 Overriding DITA settings with markers

15 Configuring DITA maps

15.1 Understanding how Mif2Go generates DITA maps

15.2 Configuring DITA ditamaps

15.2.1 Specifying options for ditamaps

15.2.2 Specifying topic levels in ditamaps

15.2.3 Specifying roles for topics in ditamaps

15.2.4 Adding relationship tables to ditamaps

15.2.5 Providing navigation aids in ditamaps

15.3 Constructing a DITA bookmap

15.3.1 Specifying the type of map for a book

15.3.2 Specifying <booktitle> information

15.3.3 Specifying <bookmeta> information

15.3.4 Mapping FrameMaker files to bookmap components

15.3.5 Changing the sequence of file entries in a bookmap

15.3.6 Choosing whether a bookmap references maps or topics

15.3.7 Providing attributes for bookmap wrapper elements

15.4 Overriding DITA map settings with markers

16 Producing DocBook XML

16.1 Generating DocBook XML with Mif2Go

16.1.1 Understanding what you need to know about DocBook

16.1.2 Clarifying your purpose for creating DocBook output

16.1.3 Understanding what information you must supply

16.2 Setting up a DocBook XML project

16.2.1 Creating a DocBook project

16.2.2 Choosing set-up options for a DocBook project

16.2.3 Specifying DocBook output options

16.3 Specifying general options for DocBook

16.3.1 Configuring styles for DocBook XML

16.3.2 Configuring entity information for DocBook XML

16.3.3 Configuring links for DocBook XML

16.3.4 Configuring tables for DocBook XML

16.3.5 Retaining empty paragraph tags in DocBook table cells

16.3.6 Configuring footnotes for DocBook XML

16.4 Configuring DocBook elements

16.4.1 Treating FrameMaker format names as element names

16.4.2 Mapping paragraph formats to DocBook elements

16.4.3 Mapping character formats to DocBook elements

16.4.4 Assigning ID attributes to DocBook block elements

16.4.5 Assigning attributes other than ID to DocBook elements

16.5 Nesting DocBook block elements

16.5.1 Understanding how Mif2Go determines element nesting

16.5.2 Designating DocBook ancestor elements

16.5.3 Fixing up interpolated ancestries

16.5.4 Deciding when to fully specify ancestry

16.5.5 Specifying alternate ancestries for the same element

16.5.6 Specifying first-child status for nested elements

16.5.7 Specifying full ancestry for nested sections

16.5.8 Closing DocBook ancestor elements

16.5.9 Opening DocBook ancestor elements

16.5.10 Configuring multi-paragraph list items

16.5.11 Specifying DocBook element levels

16.6 Designating ancestors for table elements

16.7 Designating ancestors for image elements

16.8 Overriding DocBook settings with markers

17 Splitting and extracting files

17.1 Splitting versus extracting

17.2 Splitting files

17.2.1 Designating split points

17.2.2 Managing split points

17.2.3 Combining instead of splitting files

17.3 Extracting files

17.3.1 Enabling and disabling extract processing

17.3.2 Delimiting material to extract

17.4 Identifying split and extract files

17.4.1 Understanding how split and extract files are named

17.4.2 Specifying page titles for split or extract files

17.4.3 Supplying <meta> text for split or extract files

17.5 Inserting HTML code in split and extract files

17.5.1 Choosing how to insert code in extracts

17.5.2 Assigning code to [Inserts] keywords for splits and extracts

17.5.3 Using special sections to insert code in extracts

17.6 Referencing split and extract files

17.7 Customizing and replacing extracts

17.7.1 Using custom markers for extract processing

17.7.2 Customizing title text for extracts

17.7.3 Replacing extracts with links in the parent file

17.7.4 Specifying extracts: an example

18 Creating HTML links

18.1 Understanding sources of links

18.2 Specifying link appearance

18.2.1 Specifying link colors

18.2.2 Specifying link class

18.2.3 Using markers to assign link attributes

18.2.4 Using a macro to specify link properties

18.2.5 Replacing problem characters in links

18.2.6 Forcing link text to lowercase

18.3 Specifying link destination

18.3.1 Forcing links to top-of-page for selected paragraph formats

18.3.2 Forcing all links to top-of-page

18.3.3 Linking to an arbitrary location

18.3.4 Providing alternate link destinations

18.4 Creating jumps to particular windows for HTML

18.5 Converting FrameMaker links to HTML

18.5.1 Converting cross-reference links

18.5.2 Converting FrameMaker hypertext links to HTML

18.5.3 Including ObjectID anchors as link targets

18.5.4 Checking for broken interfile links in HTML

18.6 Linking to other files and other Mif2Go projects

18.6.1 Identifying HTML link destinations with FileIDs

18.6.2 Specifying a file extension for interfile links

18.6.3 Retaining FrameMaker file paths in interfile links

18.6.4 Enabling links to renamed or relocated files

18.6.5 Enabling links to files in other projects

18.6.6 Updating links between files in different projects

18.6.7 Mapping links to text insets

18.7 Linking to external destinations

19 Providing navigation in HTML

19.1 Understanding how navigation links work

19.2 Generating trails of links

19.2.1 Understanding trails of links

19.2.2 Specifying whether to include trails of links

19.2.3 Specifying what to include in trails of links

19.2.4 Specifying heading levels for trails of links

19.2.5 Specifying where to display trails of links

19.3 Including local TOCs

19.3.1 Directing Mif2Go to generate local TOCs

19.3.2 Configuring local TOCs

19.3.3 Positioning local TOCs in HTML topics

19.3.4 Creating local TOCs in FrameMaker

19.4 Creating a browse sequence

19.4.1 Understanding how browse macros work

19.4.2 Choosing buttons versus text links for a browse sequence

19.4.3 Formatting browse-link labels

19.4.4 Modifying macros <$_prev>, <$_next>, and <$_top>

19.4.5 Understanding browse keyword scope and default values

19.4.6 Specifying where to invoke a browse macro

19.4.7 Considering an example of browse navigation

19.4.8 Specifying an alternate file sequence for browse links

20 Mapping text formats to HTML

20.1 Understanding how Mif2Go converts text

20.2 Choosing how to map formats

20.3 Mapping paragraph formats

20.3.1 Assigning HTML tags and attributes to paragraph formats

20.3.2 Converting sidehead and run-in paragraph formats

20.3.3 Converting paragraph formats with autonumbers

20.3.4 Including text-frame content in line

20.3.5 Designating script paragraph formats

20.3.6 Overriding paragraph properties

20.3.7 Stripping paragraph properties

20.3.8 Keeping or removing reference frames

20.3.9 Deciding how to treat forced returns

20.3.10 Providing content for empty paragraphs

20.3.11 Eliminating empty paragraphs in text

20.3.12 Eliminating invisible paragraphs

20.3.13 Eliminating unwanted paragraphs

20.4 Mapping character formats

20.4.1 Assigning HTML tags and attributes to character formats

20.4.2 Overriding character properties

20.5 Mapping special characters

20.5.1 Understanding how Mif2Go represents characters

20.5.2 Understanding how Mif2Go treats tabs in HTML/XML

20.5.3 Understanding Mif2Go support for FrameMaker 8 Unicode

20.5.4 Converting Western European accented characters

20.5.5 Mapping individual special characters

20.5.6 Mapping characters in a special font

20.5.7 Avoiding use of special characters in URIs

20.5.8 Preventing character mapping

20.6 Mapping fonts

20.6.1 Specifying a default font and size

20.6.2 Remapping fonts

20.6.3 Mapping font sizes

20.6.4 Excluding font tags

20.6.5 Accommodating browser font-rendering differences

20.7 Suppressing typographic elements

20.8 Specifying text colors

20.9 Configuring preformatted text for HTML/XML

20.9.1 Eliminating line wraps in preformatted text

20.9.2 Replacing tabs with spaces in preformatted text

20.10 Converting footnotes to HTML or XML

20.10.1 Configuring and placing footnotes

20.10.2 Eliminating links to jump footnotes

20.10.3 Using list tags or <div> and <p> tags for jump footnotes

20.10.4 Formatting jump footnote text with macros

20.11 Converting list formats to HTML or XML

20.11.1 Converting list formats to HTML/XML paragraphs

20.11.2 Converting list formats to HTML list styles

20.11.3 Indenting list items

21 Setting up CSS for HTML

21.1 Deciding whether to use CSS

21.2 Understanding how to use CSS

21.3 Understanding how Mif2Go generates CSS

21.4 Specifying CSS file and link options

21.4.1 Specifying CSS options at project set-up time

21.4.2 Specifying CSS options in the configuration file

21.4.3 Designating and locating a CSS file

21.4.4 Directing Mif2Go to generate a CSS file

21.4.5 Understanding effects of the older Stylesheet setting

21.5 Understanding how CSS affects other options

21.6 Linking to alternate CSS files

21.6.1 Selecting a CSS file at run time

21.6.2 Changing CSS files in the middle of a document

21.6.3 Customizing the CSS link tag

21.6.4 Using an alternate CSS link tag for Netscape 4

21.7 Assigning CSS classes

21.7.1 Working with CSS class name restrictions

21.7.2 Mapping paragraph formats to CSS classes

21.7.3 Mapping character formats to tags or span classes

21.7.4 Assigning CSS classes to text and table footnotes

21.7.5 Using link format names as CSS class names

21.7.6 Using CSS class names as tags for XML

21.7.7 Overriding CSS class for selected paragraphs

21.8 Customizing CSS properties

21.8.1 Assigning a CSS generic font family

21.8.2 Specifying CSS <body> tag properties

21.8.3 Specifying CSS size values and units of measurement

21.8.4 Overriding styles in Mif2Go-generated CSS files

21.8.5 Adjusting leading (line spacing) in CSS

21.8.6 Preventing <font> tags from overriding CSS properties

22 Including graphics in HTML

22.1 Starting with default graphics options

22.2 Understanding graphics processing for HTML

22.3 Locating graphics files for HTML

22.4 Specifying options for HTML graphics

22.4.1 Using referenced graphics without converting

22.4.2 Specifying formats of replacement graphics

22.4.3 Choosing a graphics conversion method

22.4.4 Using referenced, embedded, and compound graphics

22.4.5 Omitting graphics from HTML or XML output

22.5 Selecting and modifying graphics

22.5.1 Assigning properties to sets of graphics

22.5.2 Replacing or surrounding a graphic with macro code

22.5.3 Converting only the visible portion of a graphic

22.5.4 Converting reference-page graphics for HTML

22.5.5 Eliminating graphics in unanchored frames

22.5.6 Omitting paragraph tags around graphics

22.6 Positioning graphics in HTML output

22.6.1 Positioning unanchored inline graphics

22.6.2 Aligning anchored graphics

22.6.3 Indenting images

22.6.4 Locating, replacing, or omitting the indent spacer graphic

22.6.5 Adding space before a graphic

22.6.6 Eliminating space above or below graphics in table cells

22.7 Specifying HTML image attributes

22.8 Providing alternate text for images

22.9 Scaling images for HTML

22.9.1 Excluding image size attributes from HTML

22.9.2 Adjusting image size for selected graphics

22.9.3 Specifying image resolution

22.9.4 Specifying px units for graphics sized in pixels

22.10 Creating image maps for HTML

22.10.1 Creating hotspots for image maps

22.10.2 Providing alternate text for a hotspot in an image map

22.10.3 Specifying jumps from image maps in framesets

22.11 Supplying a background image or watermark

22.12 Converting equations for HTML

23 Converting tables to HTML

23.1 Assigning properties to tables

23.1.1 Understanding which table features can be converted

23.1.2 Understanding precedence of assignment methods

23.1.3 Overriding default table and cell properties and attributes

23.2 Defining sets of tables

23.2.1 Determining the TableID

23.2.2 Creating table groups

23.2.3 Using wildcards to specify table sets

23.3 Specifying table structure

23.3.1 Choosing the table structure model

23.3.2 Identifying row and column groups and header cells

23.3.3 Identifying table headers and footers

23.4 Specifying table attributes

23.4.1 Specifying attributes for all tables

23.4.2 Overriding attributes for selected tables

23.4.3 Assigning a CSS class to a table

23.4.4 Using markers to assign attributes to tables, rows, or cells

23.4.5 Specifying attributes for table rows

23.4.6 Specifying attributes for table cells

23.4.7 Eliminating automatically generated attributes

23.4.8 Adjusting borders, cell spacing, and cell padding

23.4.9 Determining the width of table columns

23.4.10 Deciding what to do with empty paragraphs in table cells

23.4.11 Using shading and color in tables

23.5 Positioning tables, table titles, and table footnotes

23.5.1 Indenting tables

23.5.2 Configuring and positioning table titles

23.5.3 Eliminating FrameMaker table title variables

23.5.4 Positioning table footnotes

23.6 Using macros to control table properties

23.6.1 Adding space before tables

23.6.2 Adjusting space after tables

23.6.3 Invoking macros around tables

23.6.4 Specifying row-group, row, and cell attributes with macros

23.6.5 Capturing table row and column counts with variables

23.6.6 Selectively modifying table text with macros: an example

23.7 Converting tables to paragraphs

24 Generating WAI markup for HTML

24.1 Comparing Mif2Go markup methods for WAI

24.1.1 Choosing a markup method for WAI attributes

24.1.2 Using paragraph formats for WAI attributes

24.1.3 Creating custom markers for WAI attributes

24.2 Applying WAI markup to images

24.2.1 Following WAI guidelines for images

24.2.2 Using special paragraphs to assign WAI image attributes

24.2.3 Using a custom marker to assign WAI image attributes

24.2.4 Assigning WAI image attributes via the Object Attributes dialog

24.3 Applying WAI markup to links

24.3.1 Following WAI guidelines for links

24.3.2 Using special paragraphs to assign WAI link attributes

24.3.3 Using a custom marker to assign WAI link attributes

24.4 Applying WAI markup to tables

24.4.1 Following WAI guidelines for tables

24.4.2 Choosing a WAI markup method for tables

24.4.3 Providing table summary and title information

24.4.4 Identifying table row and column information

25 Identifying HTML table structure for WAI

25.1 Identifying table rows and columns

25.1.1 Developing a strategy for row and column markup

25.1.2 Comparing scope and id/headers accessibility methods

25.1.3 Specifying a default accessibility method

25.1.4 Overriding the default accessibility method

25.2 Associating table cells with header cells

25.2.1 Specifying group properties for header cells

25.2.2 Using paragraph formats for table-cell attributes

25.2.3 Using special paragraphs for table-cell attributes

25.2.4 Using custom markers for table-cell attributes

26 Marking HTML table cells for WAI

26.1 Understanding table cell settings

26.2 Using the scope method to identify table cells

26.3 Using the id/headers method to identify table cells

26.3.1 Choosing an id/headers level

26.3.2 Specifying id/headers attributes for table cells

26.3.3 Grouping header cells for identification

26.3.4 Column-group and row-group extent

26.3.5 Choosing a different row-group method

26.3.6 Using span attributes to identify rows and columns

26.3.7 Column-span and row-span extent

26.3.8 Identifying individual table cells by row and column

26.3.9 Column and row extent

26.3.10 Using span IDs with row or column IDs

26.4 Overriding default table-cell settings

26.5 Using ColGroup and RowGroup cells

26.5.1 Understanding how the ColGroup property works

26.5.2 Understanding how the RowGroup property works

27 Working with Mif2Go macros

27.1 Defining and invoking macros

27.1.1 Defining macros

27.1.2 Invoking a macro

27.1.3 Nesting macros

27.1.4 Using predefined macros

27.1.5 Modifying Mif2Go-supplied macro definitions

27.1.6 Storing a macro definition in a separate file

27.1.7 Including macro definitions in a library

27.2 Using macro variables

27.2.1 Creating and invoking macro variables

27.2.2 Assigning values to macro variables

27.2.3 Incrementing and decrementing macro variables

27.2.4 Using predefined macro variables

27.2.5 Treating FrameMaker user variables as macro variables

27.2.6 Using FrameMaker system variables as macro variables

27.2.7 Creating macro variables from paragraph content

27.3 Using multiple-value list variables

27.3.1 Understanding list-variable syntax

27.3.2 Assigning a value to a list-variable item

27.3.3 Initializing list variables

27.3.4 Using macros to process lists

27.3.5 Using pointers to process lists

27.3.6 Using a list instead of a conditional expression

27.4 Capturing settings with configuration variables

27.5 Using expressions in macros

27.5.1 Understanding macro expressions

27.5.2 Understanding operands and operators

27.5.3 Displaying expression results in output

27.5.4 Using control structures in expressions

27.5.5 Specifying substrings in expressions

27.5.6 Using list variables in expressions

27.5.7 Using indirection in expressions

27.5.8 Removing spaces from strings: an example

27.6 Debugging macros

27.7 Deploying macros and macro variables

27.7.1 Understanding where to use macros and macro variables

27.7.2 Inserting macros at predetermined points in output

27.7.3 Surrounding or replacing text with code or macros

27.7.4 Converting a dictionary-style list to an HTML table

27.7.5 Assigning macros to graphics or tables for HTML

27.7.6 Redefining navigation macros in HTML

27.7.7 Using HTML Macro markers to invoke macros

27.7.8 Implementing drop-down text with Mif2Go macros

27.8 Using macros to fine-tune HTML or XML output

28 Working with FrameMaker markers

28.1 Using custom FrameMaker markers

28.2 Adding custom marker types

28.2.1 Identifying dedicated custom marker types

28.2.2 Naming new custom marker types

28.2.3 Understanding attribute markers

28.2.4 Using attribute markers for HTML or XML

28.3 Remapping marker types and hypertext commands

28.3.1 Remapping and cloning marker types

28.3.2 Understanding when to remap marker types

28.3.3 Remapping FrameMaker hypertext commands

28.4 Defining and redefining marker behavior

28.4.1 Assigning properties to marker types

28.4.2 Observing restrictions on redefining marker behavior

28.4.3 Understanding examples of marker redefinition

28.5 Suppressing markers

28.6 Using marker property names for marker types

28.7 Using markers to insert code or text

28.7.1 Inserting marker content in output

28.7.2 Surrounding marker content with code

28.7.3 Surrounding attribute markers with code

28.8 Identifying markers with variable <$$_objectid>

29 Working with graphics

29.1 Choosing an appropriate graphics format

29.1.1 Graphics formats for Word documents

29.1.2 Graphics formats for WinHelp

29.1.3 WMF format limitations

29.1.4 Graphics formats for HTML

29.2 Converting and exporting graphics

29.2.1 Converting bitmap graphics

29.2.2 Converting vector graphics

29.2.3 Exporting and converting embedded graphics

29.2.4 Exporting images and creating files from OLE objects

29.2.5 Converting graphics with FrameMaker export filters

29.2.6 Embedding bitmap graphics in WMF for WinHelp

29.3 Replacing and relocating graphics files

29.3.1 Changing graphics files for HTML output

29.3.2 Changing graphics files for RTF output

29.4 Specifying custom settings for individual graphics

29.4.1 Overriding graphics settings with custom markers

29.4.2 Overriding graphics settings with FrameMaker object attributes

29.5 Controlling image appearance in RTF output

29.5.1 Rescaling bitmap graphics

29.5.2 Reorienting bitmap graphics

29.5.3 Compressing bitmap graphics

29.5.4 Positioning borders around inline graphics

29.5.5 Mapping FrameMaker pen style patterns

29.5.6 Converting graphic text

29.5.7 Specifying transparency for WinHelp 4

29.6 Last-resort graphics conversion methods for RTF

29.6.1 Using Microsoft Word filters

29.6.2 Using the Mif2Go exwmf utility

30 Working with content models

30.1 Understanding Mif2Go content models

30.2 Modifying or replacing a content model

30.2.1 Obtaining a copy of a built-in content-model

30.2.2 Generating a content model from a DTD

30.3 Preparing a content model for use with Mif2Go

30.4 Understanding content-model configurations

30.4.1 Content model [Topic] settings

30.4.2 Content model [ElementSets] settings

30.4.3 Content model [TopicParents] settings

30.4.4 Content model [TopicFirst] settings

30.4.5 Content model [TopicLevels] settings

30.5 Understanding how Mif2Go uses content models

30.6 Inspecting and correcting element types

30.7 Specializing or modifying DITA topic types

30.7.1 Creating a content model for a specialized topic type

30.7.2 Overriding settings in a DITA content model

30.7.3 Eliminating elements from a DITA content model

30.7.4 Overriding declarations in a DITA map content model

30.7.5 Listing DITA topic type configuration files

30.7.6 Locating DITA topic type configuration files

30.7.7 Providing table structure information for DITA topic types

30.8 Extracting content-model debug information

31 Overriding configuration settings

31.1 Using a different configuration for selected files

31.1.1 Providing configuration files for individual chapters

31.1.2 Understanding precedence of configuration settings

31.1.3 Updating a single chapter of a FrameMaker book

31.2 Overriding settings with markers or macros

31.2.1 Determining the extent of a configuration override

31.2.2 Using configuration markers to override settings

31.2.3 Using macros to override configuration settings

31.2.4 Assigning values to configuration variables

31.2.5 Assigning a macro or variable to a configuration variable

31.2.6 Understanding fixed-key vs. variable-key settings

31.2.7 Overriding fixed-key configuration settings

31.2.8 Overriding variable-key configuration settings

31.2.9 Assigning HTML table and graphic groups with overrides

31.3 Overriding configuration settings with text

31.4 Using older directive markers for RTF

32 Automating Mif2Go conversions

32.1 Preparing documents for single-sourcing

32.1.1 Using character formats to identify Help elements

32.1.2 Using markers to add links and instructions

32.1.3 Using conditional text to differentiate output

32.1.4 Importing formats from a conversion template

32.2 Importing settings from configuration templates

32.2.1 Deciding what to include in a configuration template

32.2.2 Creating and referencing a configuration template

32.2.3 Chaining configuration templates

32.3 Converting a single chapter of a book

32.4 Automating conversion workflow

32.4.1 Considering ways to automate conversions

32.4.2 Executing system commands before and after conversion

32.4.3 Supplying run-time values for user variables

32.5 Supporting document review in Word

32.6 Converting autonumbers for database systems

32.7 Renaming HTML files for automated systems

32.7.1 Understanding which files can be renamed

32.7.2 Renaming individual split files

32.7.3 Using custom markers to name split and extract files

32.7.4 Using paragraph formats to name split files

32.7.5 Including identifiers and sequence numbers in file names

33 Producing deliverable results

33.1 Understanding Mif2Go pre- and post-processing

33.2 Activating and logging production of deliverables

33.3 Clearing out old files before converting

33.3.1 Specifying when to delete old files from the project folder

33.3.2 Specifying which files to delete from the project folder

33.3.3 Understanding when not to delete .ref and .htm files

33.3.4 Deleting MIF files from the project folder

33.4 Assembling files for distribution

33.4.1 Specifying an assembly folder

33.4.2 Listing files to copy to the assembly folder

33.4.3 Understanding when to use other file copy settings

33.4.4 Understanding which files are copied from where

33.4.5 Emptying the assembly folder before copying

33.5 Placing graphics files for distribution

33.5.1 Copying graphics files to the assembly folder or subfolder

33.5.2 Deleting prior contents of the graphics destination folder

33.5.3 Synchronizing graphics settings for HTML output

33.5.4 Synchronizing graphics settings for RTF output

33.6 Placing CSS or XSL files for assembly

33.7 Gathering files for an HTML project: an example

33.8 Gathering and compiling Help-system files

33.9 Archiving deliverables

33.9.1 Specifying an archiving command

33.9.2 Supplying parameters for the archiving command

33.9.3 Specifying archive file name and optional version

33.10 Placing deliverables in a shipping folder

33.10.1 Specifying a shipping folder for deliverables

33.10.2 Understanding which files are placed in the shipping folder

33.10.3 Choosing whether to copy or move deliverables

33.11 Understanding set-up values for deliverables

33.12 Postprocessing separately from converting

34 Converting via runfm

34.1 Designing a project for unattended operation

34.2 Setting up FrameMaker for unattended operation

34.3 Understanding runfm command-line syntax

34.4 Using runfm for Mif2Go conversions

34.4.1 Locating FrameMaker executable and files

34.4.2 Identifying your Mif2Go project

34.4.3 Configuring runfm output

34.4.4 Closing FrameMaker files after conversion

34.5 Troubleshooting runfm processes

34.5.1 Increasing console diagnostics: runfm -diag option

34.5.2 Capturing console diagnostics: runfm -log option

34.5.3 Reviewing FrameMaker console messages after runfm

34.5.4 Troubleshooting failed runfm processes

34.5.5 Running a single Mif2Go conversion or print job

34.5.6 Running a series of Mif2Go conversions

34.5.7 Including runfm in a multi-step or scheduled process

34.6 Comparing runfm with the DCL command-line filter

34.7 Operating runfm across a network

34.8 Using runfm for other FrameMaker plug-ins

35 Converting via DCL

35.1 How the DCL filter works

35.2 Using the DCL filter

35.2.1 Understanding where to run DCL

35.2.2 Preparing for conversion

35.2.3 Converting a single MIF or DCL file

35.2.4 Converting a group of MIF or DCL files

35.3 DCL command-line syntax

35.4 Command-line examples

35.4.1 Creating a document information file

35.4.2 Writing converted files to a different folder

35.4.3 Converting a group of files to RTF

35.4.4 Converting a file to HTML

35.4.5 Converting from one DCL format to another

35.4.6 Generating DITA output via command line

35.5 Converting in multiple steps via DCL

35.6 Specifying output file paths and names

35.7 About DCL technology

35.7.1 DCL file structure

35.7.2 Writing DCL conversion modules

36 Generating MIF or ASCII DCL output

36.1 Producing MIF with Mif2Go vs. FrameMaker

36.2 Generating MIF output

36.2.1 Understanding how MIF files are generated

36.2.2 Setting up a FrameMaker MIF project

36.2.3 Specifying MIF as the output format

36.2.4 Specifying which files to include in MIF output

36.2.5 Saving FrameMaker 8 files as FrameMaker 8 MIF

36.2.6 Saving FrameMaker 9 files as FrameMaker 7 MIF

36.2.7 Specifying file extensions for MIF output

36.3 Converting to ASCII DCL

36.3.1 Setting up an ASCII DCL project

36.4 Generating ASCII DCL output

36.4.1 Including generated files in ASCII DCL output

36.4.2 Specifying a file extension for ASCII DCL output

36.4.3 Exporting embedded graphics via ASCII DCL output

A WAI marker library for HTML

B Distribution files

C Document and conversion files

D Technical support for Mif2Go

E RTF configuration

F HTML/XML configuration

G DITA/DocBook configuration

H DITA <bookmeta> template

I Content model configuration

RTF keyword index

HTML/XML keyword index

Subject index



> Contents