Add File Dialog

This dialog is used to add the various files to a project. You can choose the kind of file from the File Type at the top of the dialog. When you do this, the dialog changes to display only the fields pertinent to adding that specific element.

Files That You Can Add

Following are the types of files that you can add from the Add File dialog:

  • Alias File ClosedRead more… An alias file is used to populate a header file with the information necessary for producing context-sensitive Help (CSH). In Flare, you can open an alias file and use the Alias Editor to create and assign identifiers for the header file. See Adding Alias Files.
  • Auto Suggestion List File ClosedRead more… In addition to snippets, variables, and several common system suggestions (e.g., date, time), you can create a custom auto suggestions list and add your own words and phrases to it. The first step to doing this is to add an auto suggestions list file to your project. See Adding Auto Suggestion List Files.
  • Auto-index Phrase Set ClosedRead more… An auto-index lets you automatically add words in your project to a generated index, rather than inserting all of the index markers manually. To do this, you can add phrases and corresponding index entries to an auto-index file. When you generate the output, Flare scans the auto-index file and adds the words it finds to the generated index. See Creating Auto-Indexes.
  • Batch Target ClosedRead more… You can add a batch target file, which can be used to generate and/or publish one or multiple targets in a batch from the user interface, perhaps scheduled to run at a specific time. See Building Output Using a Batch Target.
  • Browse Sequence ClosedRead more… A browse sequence is like an alternative table of contents (TOC) for online output. For example, if you have several topics that you think end users should read in order, you can create a browse sequence. Another way to use a browse sequence is to create an alphabetical list of all of the topics. So readers can use your regular TOC for a structured method of navigation (with folders and subfolders), or they can use the browse sequence for a more flattened, alphabetical way to find topics. See Adding a Browse Sequence File.
  • Condition Tag Set ClosedRead more… A condition is a single-sourcing feature that you can apply to files or to different areas of your content, so that some information displays in some outputs but not in others, or it displays only when viewed on a certain device or screen size. It is just one of the many single-sourcing features that you can use in Flare. See Adding Condition Tag Set Files.
  • Confluence Import File ClosedRead more… You can add a Confluence import file, which is used to import Atlassian Confluence pages into a project. See Adding a Confluence Import File.
  • Destination ClosedRead more… The first step to setting up your project for publishing output is to create a publishing destination. You can create as many publishing destinations in your project as necessary, depending on how many locations you need to send your output files. See Adding Destination Files.
  • DITA Import File ClosedRead more… You can add a DITA import file, which is used to import DITA file content into a project. See Adding a DITA Import File.
  • Export Project File ClosedRead more… You can add an export project file, which is used to export Flare projects, or parts of them, to another location. See Adding an Export Project File.
  • File Tag Set ClosedRead more… You can assign "tags" to files in Flare, even folders. You can use file tags for many different purposes, such as assigning authors or milestones to topics. See Adding File Tag Sets.
  • Flare Import File ClosedRead more… The first step to importing files from another project is to add an import project file. After you create this file, it will be stored in the Imports folder in the Project Organizer. If you want to manually reimport files from the project in the future, you can open this file (with an .flimpfl extension). Your settings are saved in the file, and you can simply initiate a reimport. See Adding Project Import Files.
  • FrameMaker Import File  ClosedRead more… You can add a FrameMaker import file, which is used to import FrameMaker documents into a project. See Adding a FrameMaker Import File.
  • Glossary  ClosedRead more… Flare may provide you with an initial glossary called "MyGlossary," to which you add terms and definitions using the Glossary Editor. You can use this initial glossary, but you can also add more glossaries if you want. See Adding a Glossary File.
  • Header File ClosedRead more… A header file is a simple text file that contains basic information about connecting the dialogs or windows in a software application to the corresponding topics in the Help system. Both you and the software developer need access to this file. See Adding Header Files.
  • HTML Import File ClosedRead more… You can add an HTML import file, which is used to import HTML files into a project. See Adding an HTML Import File.
  • Image ClosedRead more… You can add an image to your project, without inserting it into a content file. If you follow the steps for inserting an image, the image file is added to the project as well. See Adding Images to Projects.
  • Index Link Set ClosedRead more… In addition to creating regular index entries that point to a specific place in your project, you can also create index links. An index link is an entry in a generated index that points to another entry. There are three kinds of index links—"See," "See Also," and "Sort As." See Creating Index Links.
  • Language Skins ClosedRead more… Flare provides language skins for certain languages, such as French, German, and Spanish (i.e., many values are already translated). These languages are identified as being "localized" skins. You can edit these default translations by creating a language skin for the language. For languages that do not provide default translations, you can create language skins so they can be applied to the output too. If you have a legacy language skin in your AppData folder, you can use it as a template to create new language skins. See Adding Language Skins and Editing Language Skins.
  • Master Page ClosedRead more… You can create master pages for use in both online and Word output. See Creating Master Pages.
  • Micro Content ClosedRead more… You can create micro content phrases and responses, which can be used for featured snippets in HTML5 search results, or for other uses (e.g., chatbots). See Creating Micro Content.
  • MS Word Import File ClosedRead more… You can add an MS Word import file, which is used to import Word documents into a project. See Adding a Word Import File.
  • Multimedia ClosedRead more… You can add many types of multimedia files (both video and audio) to your project, which can then be inserted into topics or snippets. See Adding Multimedia Files to Projects.
  • Page Layout ClosedRead more… A page layout is used for page specifications (e.g., size, margins) and to apply certain content (e.g., headers, footers, page numbers) to many (or all) topics in print-based output. It allows for easy configuration through the use of content frames, bleeds, crop marks, registration marks, margins, padding, alignment features, and more. Page layouts are similar to master pages, but are more flexible and easier to use. The general rule is that page layouts are recommended for print-based output, and master pages continue to be the best method for automatically adding headers, footers, and breadcrumbs in multiple topics for online output. Another difference between page layouts and master pages is that page layouts can be used for either Adobe PDF or Microsoft Word), whereas master pages can be used only for Microsoft Word when creating print-based output. See Adding Page Layout Files.
  • Relationship Table ClosedRead more… A relationship table is an element used to link related topics together. It is similar to concept links or related topics links (see Inserting Concept Links and Inserting Related Topics Links). Although a relationship table is a common feature in DITA, you do not need to be using DITA or know anything about DITA in order to take advantage of relationship tables. See Adding Relationship Table Files.
  • Report ClosedRead more… From the Reports folder in the Project Organizer, you can generate custom reports based on information contained in your project. In addition, you can design the look and feel of reports, save them for future access, and open them in a browser window (where you can print them). See Adding Report Files.
  • Search Filter Set ClosedRead more… A search filter lets users narrow their search based on concepts. Concepts are simply keyword markers that you insert into topics that have some kind of relationship with each other. They are also used for inserting concept links into topics. See Adding Search Filter Set Files to Projects.
  • Skin ClosedRead more… A skin is a file that contains information about the appearance of an online output window. There are three kinds of skins: Standard, HTML5, and Mobile. See Adding Skin Files.
  • Snippet ClosedRead more… A snippet is a chunk of formatted content that is heavily used in single-sourcing. Snippets can include text, tables, images, and whatever else can be included in a normal topic. You can insert snippets into one or more topics throughout your project, thus allowing you to reuse content that is maintained in one place. You can even insert them into other snippets, creating nested snippets. Snippets are not usually intended for single words or very short phrases. In those cases, you probably want to use variables instead. See Adding Snippet Files.
  • Stylesheet ClosedRead more… Stylesheets are files with a .css extension. They are used to hold many styles, as well as information about how each style looks or behaves. Whenever you need to create new styles or change their properties, you accomplish this in a stylesheet, via the Stylesheet Editor. See Creating Stylesheets.
  • Synonyms File ClosedRead more… If users enter search phrases in your online output and those phrases are not returning results, you can make improvements to your output so that, in the future, users are able to find the search results they need. One way to enhance your output is to create synonyms for search phrases. See Adding Synonym Files.
  • Table Style ClosedRead more… You can add a new .css file specifically designed to design the look of tables. See Creating Table Stylesheets.
  • Target ClosedRead more… It is easy to confuse output types with targets, but they are two different (although related) concepts. A target is one instance of an output type. It is the engine that takes all of your files and settings, and brings them together to produce the end result. When you build your final output, you are essentially building one or more of the targets in your project. See Adding Targets.
  • TOC ClosedRead more… A table of contents (TOC) is a method that end users can use to find information easily in your output. A TOC in Flare works much like a TOC in a printed book. It provides an outline of contents in your Help system so that end users can easily and quickly navigate to the information they need. You create a TOC, adding books, topic links, and links to external files in a structure that you think would be useful for the user. End users then browse through a TOC to find information. For print-based (Adobe PDF, Microsoft Word) and EPUB output, you need to use the TOC Editor to create a TOC just as you would create one for online output (HTML5, Eclipse Help, Microsoft HTML Help, WebHelp, WebHelp Plus). However, there is a fundamental difference. Performing this task for online output creates an actual TOC in the output, which people use to navigate from topic to topic. This is not the case for print-based output. Performing this task for print-based output lets you indicate which topics will be included in the output and in what order. In that sense, this TOC functions more as an outline for print-based output. Therefore, for print-based output, you can think of it as an "outline TOC." If you want to include a generated TOC in print-based output, you need to use a TOC proxy in a topic instead. See Adding a TOC File.
  • Topic ClosedRead more… A topic is a file containing information about a particular subject. Topics might be the most important part of a Flare project. Everything else is contained within topics (e.g., cross-references, text, images) or points toward topics (e.g., tables of contents, indexes, browse sequences). The very reason end users open a Help system or manual is to find information, a little direction. They find that help within individual topics. See Creating Topics.
  • Variable Set ClosedRead more… A variable is a brief, non-formatted piece of content that can be edited in one place but used in many places throughout your project. They're especially good for text that might change frequently, such as version numbers and dates. Variables are stored in variable sets, which can hold multiple variables. Depending on the template you select when creating a project, Flare may provide you with an initial variable set, but you can add as many additional variable sets and variables as you like. See Adding Variable Sets to Projects.

Applying Conditions and File Tags to New Files

When you create new files, you can apply conditions and file tags to them directly from the Add File dialog. This saves you the time of having to locate the file in the Content Explorer or Project Organizer after you create the file. To do this, expand the Attributes area at the bottom. Then next to the Condition Tags and File Tags fields, click and select the relevant conditions and file tags.

See Applying Conditions to Content and Associating Tags With Files.

Content Files and the Folder Location

If you are adding a content file (e.g., topic, image, master page, multimedia, page layout, snippet, stylesheet, table stylesheet), the Folder field is automatically populated based on whatever has focus in the Content Explorer. Flare does not try to direct you to a particular folder (such as the recommended default folders for non-topic files). Instead, it assumes that you want to place the file in the folder that has focus in the Content Explorer, with the option to place it anywhere else if you like.

Recommended Folders for Non-Topic File Types

Non-Topic File Type

Recommended Default Folder in Content Explorer

Image

Resources > Images

Master Page

Resources > MasterPages

Micro Content

Resources > MicroContent

Multimedia

Resources > Multimedia

Page Layout

Resources > PageLayouts

Snippet

Resources > Snippets

Stylesheet

Resources > Stylesheets

Table Stylesheet

Resources > TableStyles

Note If you want to place non-topic files in a recommended folder, you must first make sure that folder exists in the Content Explorer. If it does not exist, you can easily add it. See Creating Subfolders.

Tip When adding a new file to the Content Explorer, the recommended method is to right-click on the folder in the Content Explorer and use the New menu option. This is the most efficient way to direct the new file to the folder where you want to store it.

Example

Example The last place you clicked in the Content Explorer was a random topic in a custom folder called "B_Extra Topics" that you created.

You then select the Project ribbon, click New, and select Page Layout.

The Add File dialog populates the Folder field with "B_Extra Topics," because that is the folder that had focus when you opened the Add File dialog.