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.
[Menu Proxy — Headings — Online — Depth3 ]
Files That You Can Add
Following are the types of files that you can add from the Add File dialog:
- Alias File Read 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.
SeeAdding Alias Files .
- Auto Suggestion List File Read 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.
SeeAdding Auto Suggestion List Files .
- Auto-index Phrase Set Read 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.
SeeCreating Auto-Indexes .
- Batch Target Read 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.
SeeBuilding Output Using a Batch Target .
- Browse Sequence Read 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.
SeeAdding a Browse Sequence File .
- Condition Tag Set Read 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.
SeeAdding Condition Tag Set Files .
- Confluence Import File Read more… You can add a Confluence import file, which is used to import Atlassian Confluence pages into a project.
SeeAdding a Confluence Import File .
- Destination Read 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.
SeeAdding Destination Files .
- DITA Import File Read more… You can add a DITA import file, which is used to import DITA file content into a project.
SeeAdding a DITA Import File .
- Export Project File Read more… You can add an export project file, which is used to export Flare projects, or parts of them, to another location.
SeeAdding an Export Project File .
- File Tag Set Read 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.
SeeAdding File Tag Sets .
- Flare Import File Read 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.
SeeAdding Project Import Files .
- FrameMaker Import File Read more… You can add a FrameMaker import file, which is used to import FrameMaker documents into a project.
SeeAdding a FrameMaker Import File .
- Glossary Read 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.
SeeAdding a Glossary File .
- Header File Read 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.
SeeAdding Header Files .
- HTML Import File Read more… You can add an HTML import file, which is used to import HTML files into a project.
SeeAdding an HTML Import File .
- Image Read 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.
SeeAdding Images to Projects .
- Index Link Set Read 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."
SeeCreating Index Links .
- Language Skins Read 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 Read more… You can create master pages for use in both online and Word output.
SeeCreating Master Pages .
- Micro Content Read 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 Read more… You can add an MS Word import file, which is used to import Word documents into a project.
SeeAdding a Word Import File .
- Multimedia Read 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. SeeAdding Multimedia Files to Projects .
- Page Layout Read 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. SeeAdding Page Layout Files .
- Relationship Table Read more… A relationship table is an element used to link related topics together. It is similar to concept links or 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 Inserting Concept Links and Inserting Related Topics Links) SeeAdding Relationship Table Files .
- Report Read 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).
SeeAdding Report Files .
- Search Filter Set Read 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.
SeeAdding Search Filter Set Files to Projects .
- Skin Read 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.
SeeAdding Skin Files .
- Snippet Read 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.
SeeAdding Snippet Files .
- Stylesheet Read 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.
SeeCreating Stylesheets .
- Synonyms File Read 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.
SeeAdding Synonym Files .
- Table Style Read more… You can add a new .css file specifically designed to design the look of tables.
SeeCreating Table Stylesheets .
- Target Read 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.
SeeAdding Targets .
- TOC Read 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.
SeeAdding a TOC File .
- Topic Read 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.
SeeCreating Topics .
- Variable Set Read 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. SeeAdding 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.
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
Resources > Images
Resources > MasterPages
Resources > MicroContent
Resources > Multimedia
Resources > PageLayouts
Resources > Snippets
Resources > Stylesheets
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.
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 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.