Importing HTML Files

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 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 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 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.
   	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.