Generally the interactive screens displayed when you select Import in the File menu provide most of the information you need. However, the additional tips below will help you to choose the settings that will produce the best results with the individual import formats.
The importer needs to know how to deal with the different parts of HTML topic pages. You can improve the import performance with the import options settings.
Ignore internal folders:
Import tags and labeled elements as anchors:
Import invisible block elements (and make them visible):
Ignore HTML styles and use default styles (except margins, bold, italic, underline):
Overwrite existing topics:
Popup topics file:
There are no special settings for importing Winhelp files.
You will get much better results if you import Winhelp project source files (.hpj project file and other accompanying files). Compiled .hlp files do not contain all the information needed for recreating Winhelp projects.
There are no special settings in the import wizard for importing RTF files. However, you do need to plan the content of your RTF files in order to get the best results.
Save your Word files in the RTF format with Word before importing
If you have RTF files that were not created with Word, always re-save them to RTF with Word before importing them to Help+Manual.
Automatic topic generation
The importer splits the contents of RTF files into topics automatically if possible, using one of two methods:
Standard Word Heading1 - Heading 9 styles:
Hard page breaks:
Styles in RTF files
Styles used in RTF files are imported to your Help+Manual project. They remain attached to the text they were applied to in the RTF document and they are also added to your project styles list. If the RTF you are importing to an existing project contains styles that conflict with existing styles in the project a dialog will be displayed asking you whether you want to keep the old styles, the new styles or add a second version of the style with a different name.
You can start using your styles immediately after importing and you can also edit them in Write > Edit Styles.
Map styles to imported styles:
Hyperlinks in RTF files
Most hyperlinks in RTF files will be converted correctly but in some cases it may not be possible to resolve their targets with 100% certainty. In these cases the links will be shown highlighted in red in the Help+Manual editor so that you can check them and make the necessary correctly.
Graphics in RTF files
Graphics embedded in RTF files do not have names, they only have sequential numbers, starting with 1 in every RTF file. Help+Manual automatically generates sequential names for the graphics files combined with the first 8 letters of the RTF name, or of the project name if it is a WinHelp HPJ project. This ensures that you don't get duplicate file names for different graphics when you import RTF files to different projects.
About AuthorIT importing:
Help+Manual does a very thorough conversion and import of your AuthorIT project. All the following items are imported:
•All topics and snippets
•All "Books" (converted into H+M TOCs)
•Index keywords automatically created by AIT
•Text and paragraph styles (AIT Help styles)
•Hyperlinks to topics and web pages
•Variables (3 predefined variables and all user-defined variables)
•Topic status (converted to H+M topic status)
•Build tags (AIT Help, Web and Print tags converted to H+M build tags)
•Graphics with original file names
•"See Also" link lists in topics
Publish your AuthorIT project to XML for importing:
To import an AuthorIT project you first need to publish it to XML. You can then import the XML project created by AuthorIT to Help+Manual. See these instructions in the AuthorIT documentation to learn how to create your XML project. You may need to use Internet Explorer to get the AuthorIT documentation to display correctly.
Options you must set in AuthorIT:
These two options must be set as follows in your AuthorIT configuration when you export XML for importing to Help+Manual:
•Export embedded pictures as files: YES
•Export linked pictures as files: YES
The following option can be activated, but is not required:
•Include preview of file objects: optional
AuthorIT import options in Help+Manual:
•Create topic IDs from titles
•Import snippets as separate topics
•Add a list of related topics
You can import RoboHelp X5, X6, 7, 8 and 9 projects.
Here too, the importer needs to know how to deal with the different parts of the HTML topic pages. You can improve the import performance with the import options settings.
With the exception of RTF files (see above), text imported from external sources is all tagged as "manually formatted" with inline formatting, not with styles. You can integrate this formatting into your Help+Manual stylesheet with the Create Style from Selection and Replace Styles functions.
For instructions see Replacing Formatting and Styles.