Re-importing HTML source files with topic-to-topic links - Cloud

Import content

When you import an HTML source file, Author checks if that file has links to any other files. If the original file does have links to other files Author imports those files as well, adding them to the book under a Related Topics section. As a further step in the import analysis phase, Author looks at the "related files" to see if they have link relationships to other files. If they do, Author imports those files as well.

Link references and locations of HTML source files

When importing the HTML source files, topic-to-topic links are created when all of the associated HTML source files are added to the import job. Author uses the information in the link to find the target topic. So long as the link contains sufficient information, you can store the HTML source files in the same folder or in different folders.

Using the same folder

Your link format might look something like this when the anchor source file and the target source file are in the same folder:

<a href="Accessories.ProtektCase.html">

Using different folders

Alternatively, anchor source file and the target source file are located in different folders ensure any links in the "anchor" source files reference the location of the folder containing the "target" source file. For example, your link format might look something like this:

<a href="../Teleporters/Accessories.ProtektCase.html">

Important: If an associated file cannot be found during the import, the target topic will not be included in the import, and the hyperlink to the target will not be created.

Let's look at an example of how the links between topics affect the importing process:

Analyzing files with links to other files 1 to 2

During the import Author analyzes File 1 and discovers that it has a link targeting File 2. As a result, File 2 is imported and added to the book as a "related topic."

Analyzing files with links to other files

As Author continues to analyze the files it discovers that File 2 has a link targeting File 3. As a result, File 3 is also imported and added to the book as a "related topic."

Analyzing files with links to other files 3 only

However in a separate import, only File 3 is selected. During the import, Author finds that File 3 does not have links targeting other files. As a result, no additional files are included in the import.