Flare's workspace is flexible, uses a modern Multiple Document Interface (MDI), and gives you several options to work the way that you want. This
The user interface consists of the following major sections:
Top—Ribbons or Tool Strip The top portion of the Flare interface displays either a ribbon view, or a tool strip view, which are used to access features.
Left—Explorers and Window Panes The left side of the Flare interface is the default location for many different explorers and window panes (e.g., Content Explorer, Project Organizer), which can be used to create, open, and view various elements in the project.
Middle—Editors and Start Page The large middle section of the Flare interface is the default location for the many editors in Flare (e.g., XML Editor, TOC Editor, Stylesheet Editor), which are used to enter and design the vast majority of the content for your project. It also displays some window panes (e.g., File List, Project Analysis) and the Start Page, which is used for quickly performing high-level tasks and accessing information.
Right—Window Panes The right side of the Flare interface (like the left side) is the default location for many different window panes (e.g., Dynamic Help, Styles window pane).
Bottom—Window Panes The bottom area of the Flare interface is the default location for yet more window panes (e.g., Builds window pane).
For the most part, the
The Start Page is a handy window pane that displays when you first launch Flare and remains open unless you close it. You can use the Start Page to open and create projects, access Getting Started resources for new users, select project templates, and more.
Flare has numerous window panes in the interface that are used for a variety of purposes. The three panes that you are likely to use most are the Project Organizer, Content Explorer, and Builds window pane. Some of these panes are located by default on the left side of the workspace, some on the right side, some in the middle, and some at the bottom. Some elements are contained in window panes as opposed to dialog windows because they contain features that you would want to have easy access to as you work in an editor. If more than one window pane is open on either side, the panes are organized in an accordion or tab structure. This means that they are stacked on top of each other, with the active window pane displayed "in front" of the other panes. You can click any accordion bar or tab to bring that particular window pane "in front" so that you can work in it.
The Content Explorer is used to hold all of your content-related files—such as topics, images, snippets, and stylesheets. In order to keep your topics organized and easier to find, you can create subfolders in the Content Explorer and move topics into them. Non-topic content files, such as images and stylesheets, are stored by default in the Resources folder, although you can place them anywhere else in the Content Explorer if you want. You can also create subfolders to organize the files in the Resources folder. See Content Explorer
You can open the File List window pane by selecting View>File List. See File List Window Pane.
This window pane lets you view all of the content files in your project. You can limit the files that are displayed by using the file type filter. For example, if you want to see only your snippet files, you could select the "Snippet Files" option from the Filter drop-down list.
You can also perform certain tasks from this window pane, such as opening files, applying condition tags, applying stylesheets, and dragging files to an editor (e.g., XML Editor). And because you can select multiple files from the list, you can perform some of these tasks for all of the selected files at the same time.
You can open the Styles window pane by selecting Home>Style Window. This window pane displays style classes and identifiers (IDs) contained in the stylesheets that are associated with the current content file. See Styles Window Pane, About Styles and Stylesheets, Classes, and Identifiers.
This window pane provides a common way to apply styles to areas of the content file you have open. You can also edit a particular style, create a new one, and pin styles that you use a lot so they stay at the top of the list.
You can use the Preview window pane to see a quick preview for a topic, snippet, or master page.
To access the Preview window pane, you can start by opening a topic, snippet, or master page. Then in the local toolbar of the XML Editor, click . If you click the down arrow, you can choose a target; otherwise, the preview opens according to the settings in the primary target (e.g., with the appropriate conditions already applied). You can also open this window pane by selecting View>Preview Window, or by right-clicking a file in the Content Explorer and selecting Preview. See Preview Window Pane.
The Preview window pane is dynamic, allowing you to keep the preview open while you work and see changes as you make them in the XML Editor. Initially, the window pane opens as a floating window. This can be quite useful if you are working with dual monitors, because you can drag the Preview window pane to one monitor while editing the topic in the other monitor. However, you always have the option of docking the Preview window pane to the interface. See Previewing Topics.
This window pane opens automatically when you generate targets. It shows the progress of each target as it compiles. Each row in the grid represents a target for which you have initiated a build. You can see information such as the status for each target—with background colors indicating what is going on—as well as any warnings or errors that may have occurred. You can also take action in the window pane, including viewing the finished output, opening the build log, and selecting other targets to build, even if they are located in a different project. See Builds Window Pane.
The large middle section of the workspace is typically used to display many different editors, depending on the type of element you are working on. You can have many editors open at the same time—even many different pages of the same editor. For example, you can have five different topics open, each one displayed in a different instance of the XML Editor. Some of the most important and commonly used editors are the XML Editor, Internal Text Editor, Stylesheet Editor, TOC Editor, Skin Editor, and Page Layout Editor.
The XML Editor is the primary editor. It displays when you open a content file from the Content Explorer, and provides access to the underlying XML structure of documents in a comfortable visual authoring environment. This editor is used to enter, modify, and format the content for topics that users see in the output. Not only is this editor used for topics, but it is also used for working with
This is a simple editor that you can use to view and modify the true code, including text, tags, and metadata. There is no requirement to use the Internal Text Editor at all. Those who are new to Flare will usually work in the regular user interface views, but those who are more advanced will probably find the Internal Text Editor to be quite useful.
The XML Editor and the Text Editor are closely synchronized with each other. They can be shown in a single window with options for viewing both at the same time and configuring their appearance.
You can take advantage of cascading stylesheets (CSS files) and the rules around them to control the look of your output in one place. This helps to keep the content separate from its presentation, which is very important when it comes to single-sourcing. CSS isn’t a MadCap Software idea. It’s an international standard for formatting web content, and it was developed by a group called the World Wide Web Consortium (or W3C). You can learn all about the W3C at w3.org.
The Stylesheet Editor
There are two views available in the Stylesheet Editor: Simplified and Advanced. You can toggle between these two views by clicking or in the local toolbar of the editor.
Simplified The Simplified view displays styles in a grid view and is often best for brand new users.More Information
This view provides an easy way to apply properties to styles, with format options available from a toolbar and dialogs (similar to the way one would use an interface such as Microsoft Word). In some cases, only the most common property options are available in the Simplified view (e.g., font, letter/word spacing, paragraph alignment/indentation, autonumbering format, borders, background). One advantage of the Simplified view is that you can apply a property to multiple styles at the same time. You can also click a check box to hide the properties in the editor, allowing you to see only the styles.
Advanced The Advanced view displays styles in a tree structure, and despite the name, is user friendly for authors of all levels.More Information
For the properties, you can toggle between a grouped display and an alphabetical display. The Advanced view of the Stylesheet Editor allows you to edit more settings than are available in the Simplified view. In addition, the Advanced view lets you see and apply settings to multiple mediums and media queries at the same time.
The TOC Editor displays when you open a table of contents file from the Project Organizer, and is used to create tables of contents manually. See TOC Editor, About Tables of Contents, and Creating a TOC Manually.
Creating a table of contents in Flare can be very easy to do for both online and print output. You can drag topics from the Content Explorer to the TOC Editor. You can also manually add TOC books and items, and then link them to other files. The links usually point to topics, but for online outputs they can also point to external files, other Help systems, and movies. You put all of these books and items in a structure that you think would be useful for the individual. In online output, end users browse through a TOC to find information. And in HTML5 Top Navigation output, the TOC items become links in menus.
You have the option to customize your TOCs in lots of ways, getting as fancy as you want. However, there are some things you should know. Most importantly, you need to understand that the TOC files you see in the Project Organizer work differently for online output than they do for print-based output. For online outputs, TOC files are exactly as their name suggests; they are files that create TOCs or menus in the output. But for print-based outputs, that same TOC file functions more like an outline. The element that actually generates a TOC in print-based output is called a "proxy," which is inserted into a topic. You can manually create that proxy yourself, or you can select an option in the Advanced tab of the Target Editor and let Flare do it all for you. There are pros and cons for both methods.
This editor displays when you open a skin file from the Project Organizer, and is used to develop a skin for one or more online targets in your project. A skin is a file that contains information about the appearance of the output window (such as its size and positioning, which buttons or tabs it should include, and style settings). The Skin Editor consists of several tabs, displaying only settings relevant to the selected skin type—HTML5 (the recommended online output type), Standard (for most online outputs), or WebHelp Mobile. You can also perform certain tasks for HTML5 skin components. See Skin Editor and About Skins.
The Page Layout Editor displays when you open a page layout file from the Content Explorer, and lets you edit page layouts, including individual pages and frames within them. See Page Layout Editor, About Page Layouts, and Editing Pages and Frames.
A page layout is an element that you can
Each open document in the workspace has a tab or accordion that lets you access it. The most recently opened document is in front, while other open documents are behind it. You can bring a document into view by clicking its tab.
You can also work with these document tabs in the following ways.
You can choose how to view window panes in the workspace.
- Accordion tabs Stacks the document tabs below the window pane or editor.
- Standard tabs on top Places the document tabs on the top of the window pane or editor.
- Standard tabs on bottom Places the document tabs on the bottom of the window pane or editor.
To switch between tabs, right-click the title bar of the window pane or editor and select a view.