Navigation:  Basic Working Procedures > Importing Data >

Settings for importing data

Print this Topic Previous pageReturn to chapter overviewNext page
Show/Hide Hidden Text

Generally the interactive wizard displayed when you select Import in the Application Menu provides most of the information you need. However, the information below will help you to choose the settings that will produce the best results with the individual import formats.

HTML files and compiled HTML Help files (.chm)

The importer needs to know how to deal with the different parts of HTML topic pages. You can improve the import performance with the settings in the HTML Import Options page of the wizard.

Topic header:
Getting the header information from the <title> tag will usually work. If your topics have a separate header block you may need to specify a different tag. If in doubt display the CHM file, right-click on one of its pages and examine the source code with View Source.

Topic body:
Specify a <table> or <div> tag with a specific ID only if you know that is used to identify your body content. Otherwise use the default setting.

Ignore internal folders:
Help & Manual does not use internal folders in CHM files, all files are stored on the same level. If the CHM file contains internal folders the folder names will normally be prefixed to the topic IDs of the imported topics to prevent name conflicts. You can turn this option off if you are sure that there are no name conflicts caused by files with the same names stored in different folders.

Single-column tables:
Some topic pages are enclosed in single-cell/single-column tables, which can cause undesirable results when you import them. You can solve this problem with the option for converting such tables to single paragraphs.

Popup topics file:
In CHM help popup topics are stored in a special plain-text file inside the CHM. Normally this has a standard name (CSHelp.txt) but if you know that the file you are importing uses a different name you can enter it here.

Winhelp files (compiled and project files)

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.

Word RTF files

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 RTF files with Word before importing

If you experience problems with RTF files not created with Word try loading them into Word and then re-saving them before importing.

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:
If your RTF file uses the standard Word Heading 1 ... Heading 9 styles each heading with one of these styles will start a new topic. Subtopics will be created automatically on the basis of the heading levels. Each heading must be followed by at least one paragraph of text, otherwise it will be ignored.

Hard page breaks:
If your file does not use Heading 1 .. Heading 9 styles new topics are created at hard page breaks. No subtopics are created with this method.

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. This means that if you import two RTF files to separate projects their graphics will have identical names. This will cause conflicts if you ever want to use both projects in a modular project.

Solution 1: Import all RTF files to the same folder:
If you select the same output folder for all new projects created from RTF files the names of the imported images will be incremented automatically. You must use the compressed format (.hmxz) for saving your new projects when you use this method. A message will be displayed warning you that the folder you are saving to is not empty – this is OK.

Solution 2: Import all RTF files to a single project:
After importing the first RTF file to a new project with New, click on the Application Button and select Import for the next files. The topics will be inserted at the current position in the TOC and the image file names will be incremented automatically.

RoboHelp X5 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 settings in the HTML Import Options page of the wizard.

Topic header:
Getting the header information from the <title> tag will usually work. If your topics have a separate header block you may need to specify a different tag. If in doubt check the HTML source code of the files in your RoboHelp project.

Single-column tables:
Some topic pages are enclosed in single-cell/single-column tables, which can cause undesirable results when you import them. You can solve these problems with the option for converting such tables to single paragraphs.

Graphics files:
The graphics files from the RoboHelp project are not imported to the new project directory. Instead, Help & Manual adds the current location(s) of the graphics files to the image folders list in the Configuration > Common Properties section of your project. You can move the image files after importing if you want just change the folder entries in the Image Folders list accordingly after doing so and Help & Manual will then be able to find them.

Integrating imported formatting in your H&M stylesheet

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.

 


Page url: http://www.helpandmanual.com/help/index.html?hm_working_project_importsettings.htm