Importing HTML Files

You can import XHTML and HTML files (automatically converting them to XHTML).

How to Import HTML Files

  1. Select Project > Import > HTML File Set.
  2. In the wizard, choose either Import into a new project (and complete the fields below) or Import into this project. However, if you do not have a project currently open, the file(s) will automatically be imported into a new project.

    • Project name Type a name for the new Flare project that will be created after you perform the import.
    • Project folder Accept the default location for the new project or click The browse ellipsis button opens to more options. to find and select a folder.
    • Output type Select the primary target for your project.

      A target is a file that generates output from your project. You want your output to look and behave in a certain way, but not all authors have the same audience or work for the same company with the same needs and the same computer networking setup. Therefore, Flare lets you choose the best type of output(s) for your needs. A target file is used for each instance of an output type. And you can have many targets in your project (e.g., eight targets using PDF, two targets using HTML5). See Determining the Output Type and Step 4: Developing Targets.

      This page of the wizard lets you select a primary target as you get your project off the ground. This means that—although you can use more than one target for your project—you might use one target most of the time. By selecting a primary target, you will be able to use shortcut buttons to build, view, and publish its output more quickly. Also, when you open topics in the XML Editor, they will be displayed by default with the styles and other specifications associated with the primary target. However, you can use the Layout and Medium drop-downs in the local toolbar of the XML Editor to view topics with other settings.

      Do not worry if you're not yet sure of the best output type for your project. No matter which output type you select now, you can always change the primary target later.

  3. Click Next.
  4. Click to choose HTML files. You can also click New Folder button to find and select a folder containing HTML files you want to import. When you select a folder to import, the wizard imports all files within that folder that have an .htm, .html, or .xhtml extension. If you later reimport HTML files into the project, Flare checks to see if any of the files in the source folder have changed. It also determines whether files have been deleted or added, and it updates the source files list accordingly. When you are finished, click Open.

  5. (Optional) You can use the other options on the page if necessary.

    Option

    Description

    This opens the file that is selected in the list.

    This opens the HTML to XHTML Conversion dialog, which lets you see how the selected file looks in HTML and how it will look after its conversion to XHTML.

    Link Generated Files to Source Files

    This creates a connection between the original files and the files that are created as a result of the import. This is useful if you want to continue editing the content outside of Flare, instead of editing in the Flare project. Flare recognizes when changes have been made to the source documents and reminds you to reimport the documents to ensure the Flare project also reflects the changes. If you use this option, a link icon Linked File icon is added to the top of a linked file in the Flare interface. This lets you know that you need to edit the source file, rather than editing this file. If you remove the connection to the source file, this icon no longer displays on the file. Please note that if you have bound the project to source control, the icons used for source control take precedence over the link icon.

    Use delete to empty contents.

    This removes the selected file(s) from the list.

    This moves the selected file higher in the list (if you have more than one file to import). The file at the top is used for the name of the content folder holding the imported topics in Flare. Also, the order determines how the imported files are arranged in the Flare TOC that is created as a result.

    This moves the selected file lower in the list (if you have more than one file to import).

  6. Click Next.
  7. (Optional) You can use more import options as necessary.

    • Import linked HTML files Select this option if you want to automatically bring in other files that are linked to those you selected on the previous page. For example, if you import Doc1.htm, which contains a hyperlink to Doc2.htm, this option imports Doc2.htm as well.
    • Import resources Select this option if you want to include any supporting resource files (e.g., stylesheets, images, multimedia files) in the import. Then select one of the following:

      • Keep existing structure The supporting resources files will be copied into folders with the same names and hierarchy as those used in the source.
      • To project resources folder The supporting files will be placed in the Resources folder in your Flare project.
    • Auto-reimport before 'Generate Output' If you selected “Link Generated Files to Source Files” earlier in the wizard, you will likely make future content changes in the source files. When you make such changes, the source files need to be reimported into the project so that they can be included in the output. You have the option of reimporting the files manually. However, you can also tell Flare to do this for you automatically, so that you do not have to. Select this option if you want Flare to automatically reimport files when you attempt to build output.
  8. Click Finish. The Accept Imported Documents dialog opens. The files that will be created as a result of the import are listed on the left. A preview of each file can be seen to the right when you click the file.
  9. When you are finished previewing the files to be created, click Accept.

Import Editor—Import and Re-Import

If you add an HTML import file (see Adding an HTML Import File) or if you have previously imported HTML files using the wizard, a file is added to the Imports folder in the Project Organizer.

When you double-click this file, it opens in the Import Editor. This editor contains most of the same fields and options as the Import HTML Files Wizard.

After completing or changing any of these fields, you can click Reimport in the toolbar.

What’s Noteworthy?

Note The Imported Files tab in the Import Editor displays the files that have been imported previously.

Note A link icon Linked File icon displays on tabs in the XML Editor next to file names that are imported from and linked to another file or Flare project. However, if you are also using the built-in source control technology, the source control icons have a higher precedence and will therefore be displayed instead.

What’s Next?

Now you can move on to any of the other basic steps:

Note You do not necessarily need to follow all of the above steps (and their substeps) in the exact order given. For example, as you add topics to a project, you may want to start applying styles and formatting to them right away, before adding other features to the project, such as a glossary. However, the above sequence probably makes the most overall logical sense. For example, you must start a project before adding content and features (i.e., topics, content, cross-references, etc.) to it.