About Styles and Style Sheets

Using styles instead of local (or "inline") formatting helps you work more efficiently and with more consistency in your topics. If you need to make changes to the formatting in the future, you do not need to change the formatting in each topic (as you would with local formatting). Instead, you only need to change the formatting properties for that style in the appropriate style sheet.

 

  Best Practice: Use styles instead of local formatting.

 

Flare lets you create and use two kinds of style sheets—topic and table style sheets.

• Topic style sheets This type of style sheet lets you store styles for general content in your project. You can have as many styles as you want within one topic style sheet, and you can create as many style sheets as you need (although one style sheet is often sufficient for most authors and most projects). After you add a topic style sheet to a project, it is stored in the Resources\Stylesheets subfolder of the Content Explorer.

  Note: If you would like to access the same style sheet that is used for the Flare documentation, you can download it from this location:

  http://www.madcapsoftware.com/support/files/documentation/Styles/styles.css

  Note: You cannot use multiple style sheets per topic for native Adobe PDF, Microsoft XPS, and XHTML outputs.

• Table style sheets This type of style sheet lets you create a unique look for tables that you insert throughout your project. This is a great way to create tables that have different patterns (e.g., every other row might have a green background). After you add a table style sheet to a project, it is stored in the Resources\TableStyles subfolder of the Content Explorer.

  example

  You might use two different types of tables in your project—a "basic" one (with simple borders and no shading) and a "fancy" one (with customized borders and colored shading in certain rows and columns). So you create one table style sheet (let's say it's called "basic.css") and format it the way you want, and then you create a second table style sheet (let's say it's called "fancy.css") and format it. Then, as you insert tables into your topics, you can associate the new table with one of these two table style sheets.

  Note: Even though you can create a table style sheet to affect the look of your tables, you can also use a topic style sheet to modify standard HTML table tags (e.g., <th>, <td>) that are used to dictate the look of different parts of a table (e.g., heading text, table cell text). If you like, you can use both kinds of style sheets to change the look of tables.

  Note: If you are importing Adobe FrameMaker documents and have tables that you have formatted in a certain way, you can create matching table styles as a result of the import. This can be specified on the Options page of the Import FrameMaker Wizard. In the Flare project, the new table styles will be named after the format named applied to the table in FrameMaker (e.g., "Format_A.css," "Format_B.css," and so on). You can rename these table style sheets in Flare after the import. Even if you do not use this mapping feature, the table formatting still comes across when you import the files. The only difference is that table style sheets make it easier to maintain the formatting of your tables within Flare. See Creating a Project by Importing FrameMaker Documents and Creating Topics by Importing FrameMaker Documents.

When you open a topic style sheet, it is displayed in the Stylesheet Editor. When you open a table style sheet, it is displayed in the Table Style Editor.

Stylesheet Editor—For Topic Style Sheets

The Stylesheet Editor allows you to use either an "Advanced" view or a "Simplified" view when working with topic styles.

• Simplified The Simplified view is better for new users. It provides an easier way to apply properties to styles, with format options available from a toolbar (similar to the way one would use the Text Format toolbar to change the look topic content without a style). In many cases, only the most common property options are available in the Simplified view (e.g., font, letter/word spacing, paragraph alignment/indentation, auto-numbering 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 style classes and properties in hierarchical tree structures. It is not as quick as using the Simplified view, but it allows you to edit a great deal more settings than are available in the Simplified view.

Table Style Editor—For Table Style Sheets

The Table Style Editor contains multiple tabs and fields for specifying settings such as patterns, borders, backgrounds, alignment, and margins.

When working with styles, there are some unique terms that you will encounter, especially in topic style sheets.

Tags

In the Stylesheet Editor, you will notice several elements in the Styles section that already exist for your use. These are called "tags." You also might hear them referred to simply as "styles" or as "selectors." A tag is an element to which you assign a look and feel. You can then apply that style to your content, so that the content takes on the look and feel associated with the style. Different kinds of tags are available in a style sheet, to be used for various purposes in your content.

example

<p> is a tag, which can be used to affect the look of paragraphs in your content. Another tag is <h2>, which can be used to affect the look of second-level headings in your content. Yet another tag is <span>, which can be used to affect the look of character-level content (e.g., a portion of a paragraph, but not the entire paragraph).

Classes

You can think of tags as parent styles, because they can have children. A child of a tag is called a "class." Some of these classes might already be included in your style sheet when you first add it to a project. You also have the option of creating classes of parent tags.

Note: Although you can create new style classes, you cannot create new parent tags.

When you create a class, it automatically takes on all of the same qualities (or "attributes") from the parent tag (e.g., color, alignment, size). However, you can change some of those attributes for the class as necessary so that it is different from the parent tag in some ways.

example

Let's say you want to create a special look for paragraph notes in order to provide additional information in a topic. In addition, you might want yet another special kind of paragraph to be used for tips. Perhaps you want a blue background for your note paragraphs, and you want a yellow background for your tip paragraphs. Meanwhile, for your regular paragraphs, you do not want any colored background.

Therefore, you could create a class of your parent <p> tag and name it "Note." Then you might create another class of your <p> tag and name it "Tip." For the Note class, you could change the background property to display in blue, and you could change the same property for the Tip class to display in yellow. But you would leave the background property for the parent <p> tag as it is, without a color. In the end, both the Note and Tip classes would take on all of the style settings from its parent tag—<p>—with the exception of the background color that you have specified for each.

How can you distinguish between parent tags and style classes? In the Simplified view of the Stylesheet Editor, style classes are listed after the parent tags, and a period is added between the name of the parent tag and the name of the class (e.g., p.Tip).

In the Advanced view of the Stylesheet editor, parent tags and style classes are shown in a tree view. You can click the plus button next to a parent tag to see its style classes.

Properties and Values

Every tag and style class has certain attributes that contribute to its look and feel. The elements used to control these attributes are known as "properties," which can be organized into property groups (in the Advanced view of the Stylesheet Editor). The precise information within a property is known as a "value."

example

Returning to the example of a note for a paragraph tag (p.Note), let's say we want the background to be blue. That particular quality can be controlled in a property called "background-color." In the Advanced view of the Stylesheet Editor, this property can be found in the property group named "Background." For our p.Note style, we would assign a value of "blue" to that property.

There are hundreds of basic properties that you can use to change various aspects of a style.

example

Let's say that you plan to create several bulleted lists in your topics, and you want to be able to change the look of bullet items using a style. Perhaps you want to do this for bullet items that are indented to the second level in a list (i.e., they are sub-bullets of first-level items in the list). Suppose you want those bullet items to be displayed in a blue, 10-point Verdana font. Like this:

In order to do this, you might first select the <li> tag in the Stylesheet Editor and create a class for it named "Indented2" (li.Indented2). Then you could select this class, open the Font property group, and change the "color," "font-family," and "font-size" properties.

Therefore, in a situation such as this, you would have set the following in the Stylesheet Editor:

Style class: li.Indented2

Property: color (value=blue)

Property: font-family (value=Verdana)

Property: font-size (value=10 pt)

Here is how it would look when you are finished (in the Simplified view of the style sheet).

Here is how it would look when you are finished (in the Advanced view of the style sheet).

The vast majority of the styles and style properties in Flare were developed by the World Wide Web Consortium (W3C). There are additional styles and properties that are specific to Flare to support the unique features in the application.

The Simplified view of the Stylesheet Editor allows you to set only some of the more common properties. The Advanced view allows you to set all of the properties.

W3C Styles and Properties

For more thorough information about each W3C style and property, refer to http://www.w3.org and use the search feature on the website. Also, the following additional resources are highly recommended:

• http://www.w3schools.com/css/css_intro.asp

• Cascading Style Sheets: Designing for the Web

  by Hakon Wium Lie and Bert Bos

  http://tinyurl.com/2sk8xs

• HTML, XHTML, and CSS, Sixth Edition (Visual Quickstart Guide)

  by Elizabeth Castro

  http://tinyurl.com/2pblde

• CSS: The Definitive Guide

  by Eric Meyer

  http://tinyurl.com/37bp8w

Also, when you select a property in the Stylesheet Editor, a short description of the property is displayed at the bottom of the editor.

MadCap-Specific Styles and Properties

In addition to the many standard styles from W3C, you might notice several unique-looking styles that begin with the word "MadCap" (e.g., <MadCap|footnote>, <MadCap|variable>). There are also many MadCap-specific properties. You will recognize these properties because they always start with "mc" (e.g., mc-footnote-format, mc-language).

These special styles and properties have been added to style sheets in order to support some of the unique features available only in MadCap Software products.

There are several categories of styles that you can apply to content. To filter the list of styles shown, use the drop-down list in the Show Styles section of the Stylesheet Editor.

For steps on applying each type of style to content in your project, see Applying Styles to Topic Content. Following are explanations of the basic types of styles.

• Auto-numbered styles These are styles to which an auto-number format has been applied. Therefore, an auto-number format style is not technically a unique type of style, because an auto-number format can actually be applied to other types of styles (such as paragraphs and headings). If you apply an auto-number format to a style, that style will be listed in the Stylesheet Editor if you select Show Auto-numbered Styles.

  example

  You might select the <h1> style tag and modify its "mc-auto-number-format" property, choosing a format such as {n+}. If you then select Show Auto-numbered Styles from the drop-down in the Stylesheet Editor, the <h1> style will be listed.

  See About Auto-Numbers.

• Topic styles This lists the <html> style, which is used to affect entire topics. This is especially useful for applying different master pages to different topics.

  example

  You might want most topics in your project to use the same master page (to display the same text at the bottom of each topic). However, maybe you want a select few other topics to use a different master page. For the majority of the topics, you can simply apply the main master page to the target. But for the other topics, you can use a topic style. For example, you can create a class for the <html> tag in your style sheet, naming it "SpecialMasterPage" (i.e., html.SpecialMasterPage). Then you can modify the "mc-master-page" property for that class so that it is associated with the secondary master page. Finally, you can apply the html.SpecialMasterPage style to the topics that you want to be associated with that master page.

  See About Master Pages.

  How to use multiple master pages by creating topic styles

  1. Create the master pages that you need. See Creating Master Pages.
  2. Open your style sheet (in the Advanced view) and select the html tag on the left side of the editor. See Opening Style Sheets.
  3. Create a new class. When you are finished it will be placed under the html tag. See Creating New Style Classes.
  4. Select your new class on the left side of the editor.
  5. In the upper-right corner of the Stylesheet Editor, click the Show field and select Show: Assorted Relevant Properties.
  6. Click the cell to the right of the mc-master-page property and select the master page to be associated with it.
  7. Press CTRL+S or click to save your work.
  8. Open a topic that you want to associate with that master page. See Opening Topics.
  9. At the bottom of the XML Editor, click to turn on the structure bars. See About Structure Bars.
  10. Hover over the html bar to the left of the topic content until the cursor displays as a hand, and then click it.

  11. In the popup menu, select Style Class and choose the style that you want to apply.

      Note: You will not see any styles from this list until you create a class for the <html> tag in the Stylesheet Editor.

• Paragraph styles These are styles that are applied to content comprised of an entire paragraph. This is one of the most common types of styles used.

  example

  You might select a style class called "p.Body" that you have created and modify its "font-size" property to enlarge the body text in your topics.

• Footnote styles These are styles that are applied to footnotes inserted into content. Footnotes are commonly used if you are producing print-based output. The <MadCap|footnote> style affects the number (or symbol) that is inserted into topic content and represents a footnote located elsewhere (end of the page, end of the chapter, etc.). The <MadCap|footnoteBlock> style affects the text of the footnote. The <MadCap|footnotesBlock> style affects the area that holds a collection of footnotes.

  example

  You might select the <MadCap|footnote> style and modify its "mc-footnote-number" in order to restart the numbering for footnotes at each chapter (as opposed to each book, page, or section). You might select the <MadCap|footnoteBlock> style and modify its "color" property in order to show the footnote text in blue.

  See About Footnotes.

• Heading styles These are styles that are applied to content intended to serve as headings above sections of content.

  example

  You might select the <h2> style and modify its "font-family" property in order to display second-level headings in an Arial font.

• Character styles These are styles that are applied to selected text within a paragraph, rather than the entire paragraph.

  example

  You might select the <span> style and create a class under it named "code" (span.code). Then you might set its "font-family" property to "Courier New" in order to display text that represents programming code.

• Table styles These are styles that are applied to tables and the content within them.

  example

  You might select the <th> style and modify its "color" property in order to display table header row text in green.

  Note: These styles are not to be confused with the separate table style sheets that you can create. However, you can use both table style sheets and these standard table styles from a topic style sheet in order to design the look of your tables and their content.

• List styles These are styles that are applied to content displayed in a list, such as a bulleted list or numbered procedures.

  example

  You might select the <li> style and create a class under it named "indented." Then you might set its "margin-left" property to "0.5 in" so that bulleted list items are indented one-half inch from the left edge.

• Link styles These are styles that are applied to content that contains a link, such as a cross-reference or a Related Topics link.

  example

  You might select the <MadCap|xref> style and modify its "mc-format" property to change the text displayed in cross-references (e.g., "see page…").

• Dynamic effects styles These are styles that are applied to content used in Dynamic HTML effects, such as drop-down text or popups.

  example

  You might select the <MadCap|dropDown> style and modify its "mc-open-image" and "mc-closed-image" properties in order to change or remove the image, such as an arrow, displayed next to drop-down effects.

• Reusable content styles These are styles that are applied to reusable content, such as snippets, variables, or proxies.

  example

  You might select the <MadCap|breadcrumbsProxy> style and modify its "border-bottom" property. This lets you set the color and width of the bottom border for the "You are here" breadcrumbs feature that can be displayed at the top of topics.

• Generated content styles These are styles that are applied to content that is created when you generate output, such as glossaries, indexes, or tables of contents (TOCs).

  example

  You might select the "TOC1" class under the <p> tag (p.TOC1) and modify its "mc-leader-format" property. This lets you set the leader format, such as dots, to be displayed after the first-level headings in the generated TOC for print-based output.

• Controls/form styles These are styles that are applied to content within controls, such as buttons, or forms.

  example

  You might select the <form> style tag and modify its "text-align" property in order to center a form that you add in a topic.

Pseudo classes are a special group of style classes in cascading style sheets that pertain to elements when they're in a certain state. They are most often used for styles associated with hyperlinks.

Link Pseudo Classes

Link pseudo classes include the following:

• Active This class is used when the person activates the element (mouse is clicked).
• Focus This class is used if the element has the focus.
• Hover This class is used when the person hovers the mouse over the element.
• Link This class is used for links that have not yet been clicked.
• Visited This class is used for links that have already been clicked.

example

Let's say you want the text to display in green for links that have not yet been clicked. But after a link is clicked, you want it to display as gray text. Therefore, under the <a> style tag, you modify the "link" pseudo class and change the font color to green. Then you modify the "visited" pseudo class under the <a> tag so that the font color is gray.

First-Letter and First-Child Pseudo Classes

There are a couple of additional kinds of pseudo classes that you can create from the Stylesheet Editor. These are called "first-letter" and "first-child" pseudo classes.

The first-letter class lets you apply style settings to the first letter in a block (such as a paragraph), if it is not preceded by any other content (such as an image). This pseudo class is useful for creating drop caps and initial caps effects. See Creating Initial Caps Effects and Creating Drop Caps Effects.

The first-child class lets you apply style settings to the first child of another element (e.g., the first <p> tag that occurs within a <div> tag).

When you want to use styles in your content, the style sheet needs to be made available for the content in question. In Flare, you can associate style sheets with a single topic (see Applying Style Sheets to Topics). However, you also have the option of using a style sheet as a "master," applying it at either the project or target level, or both.

• Master style sheets at the project level You can associate a master style sheet with an entire Flare project. The styles will therefore be available to all content in the project. You can set the project-level master style sheet in the Project Properties dialog (select Project>Project Properties).
• Master style sheets at the target level You can associate a master style sheet with an entire Flare target. The styles will therefore be used for the content in the target. If you have specified a master style sheet at the project level and another at a target level, the style sheet at the target will take precedence. If you are using different master style sheets for different targets, the style sheet associated with the primary target determines what you see in the XML Editor. You can set the target-level master style sheet on the Basic tab of the Target Editor.

See Applying Master Style Sheets.

 

  Best Practice: Use master style sheets at the project or target level.

 

Note: If you apply a master style sheet at either the target or project level, you will no longer be able to associate style sheets at the topic level (unless you remove the master style sheet associations at the project and/or target level). If you have previously applied multiple style sheets to a single topic and then switch to using a master style sheet, you should make sure that all of the styles you need from the various style sheets are all included in your master style sheet.

What if you want to use certain style settings for some online outputs and different style settings for print-based outputs, without duplicating content? You can single-source styles for topics through the use of mediums.

A medium is an alternative set of styles in a style sheet that you use for different outputs. They are intended to be an exception to the default style you want to use. A common use for a medium is to have one group of style settings for online formats (DotNet Help, HTML Help, WebHelp, WebHelp Plus, WebHelp AIR) and a different group of settings for print-based formats (Adobe PDF, XHTML, Microsoft XPS, Microsoft Word, Adobe FrameMaker). Therefore, you could use the default medium for the online formats and use a "print medium" for PDF and the other print-based targets.

example

Let's say you have text hyperlinks that are shown in blue font with an underline. That may be fine for Target A, but let's say you want this style to appear in black font with no underline for Target B. The solution is to use a style sheet medium.

Suppose Target A is using the "default" medium, where the blue underline properties are specified. With the properties for Target A already set, you now need to specify style properties for Target B. Therefore, in the Stylesheet Editor, instead of selecting the "default" medium, you can select another medium (e.g., the "print" medium) and change the properties for the style to black with no underline. It's the same style sheet and the same style that you are working with. The only difference is that one medium is telling Flare to display that content in blue with an underline, and the other medium is telling it to use black font with no underline. With Target A using the default medium and Target B using the other medium, the content will display appropriately in each output.

See About Style Sheet Mediums and Creating Topic Styles for Print Output.

A print style is an alternative set of table styles intended for use in print-based outputs (Adobe PDF, XHTML, Microsoft XPS, Microsoft Word, Adobe FrameMaker). See Creating Table Styles for Print Output.

example

Let's say that you insert tables into several topics and apply a table style to them that uses a green border. This might be fine for online outputs (such as DotNet Help or WebHelp), but what if you need to create printed output that displays everything in black and white? Option 1 is to create two different tables in each of those topics (one with a green border and one with a black border), and then use condition tags to separate them into the appropriate targets when you build the output. Option 2 is to manually fix your tables when you generate the printed output, changing all of the green borders to black. Option 3 is to use a print version of the table style, which is much easier and less time-consuming.

Therefore, you create a new table style to be used only for print output. It might even be identical to the your default table style, except that the print table style uses black for the borders. When you insert a new table or edit an existing one, you click the Print Style button (in the Insert Table dialog or Table Properties dialog) and select your new table style.

Following are the basic tasks involved with using styles and style sheets in your project.

1. Create a new style sheet This entails adding to your project a new style sheet that is based on a template for an existing style sheet. Flare provides you with templates for both topic and table style sheets. (If you import a project that already contains a style sheet, it is added to the Flare project automatically.) See Creating New Style Sheets.

   Note: You can also import an existing style sheet from outside your project.

2. Apply a style sheet To use the styles from a topic style sheet, you must link the style sheet to the appropriate file(s). It is recommended that you apply a master style sheet at the project or target level. The style sheet then automatically becomes available for all topics in that project or target. See Applying Master Style Sheets.

   You also have the option of applying a style sheet to a single topic or to multiple topics at the same time. See Applying Style Sheets to Topics.

3. Create style classes After a style sheet is opened, you can add new classes to parent tags (e.g., if you add a class called "Tip" to the parent tag <p>, the result is a style called "p.Tip"). There are numerous ways to do this. See Creating New Style Classes.
4. Edit styles You can customize the properties for your styles to get the look and feel that you want. See Editing Styles.
5. Apply a style to topic content The final step is to apply styles to the content in your project. See Applying Styles to Topic Content.

There are hundreds of tasks that you can perform in Flare by using styles. Following are some common tasks that you might perform when editing styles.

• Auto-numbers
  • Formats Auto-numbering can be used when you want to create content where certain portions are numbered automatically. This can be accomplished through the use of auto-number formats. See Creating Auto-Number Formats for Styles.
• Breadcrumbs
  • Look After you create breadcrumbs for online output by using the breadcrumbs proxy, you can modify the look of those breadcrumbs by using styles. There are numerous ways that you can change the look of breadcrumbs. See Using Styles to Determine the Look of Breadcrumbs.
• Footnotes
  • Border You can modify the default border that is added above footnote comments. You can change the border thickness, color, style, and other settings. You can also remove the border altogether. See Editing the Border Above Footnotes.
  • Comment font settings You can modify the font in a footnote comment. This includes changing the font family, size, color, case, and more. See Editing Footnote Comment Font Settings.
  • Comment position You can change the location where a footnote comment is placed in the output (e.g., end of page, document, chapter, section, book). See Editing Footnote Comment Position.
  • Comment spacing You can modify the spacing for the footnote comment text. This includes the ability to change the spacing above or below the comment text, the white space between words or characters, or the indentation before the number and text. See Editing Footnote Comment Spacing.
  • Number format By default, a decimal number (e.g., 1, 2, 3) is used when you insert a footnote. However, you can select a different format. For example, you can change the format to uppercase alpha (e.g., A, B, C) or lowercase Roman (e.g., i, ii, iii). You can also replace the number with a symbol, such as an asterisk. See Editing Footnote Number Formats.
  • Number - look You can change the look of the footnote numbers (both in-text and in-comment), by creating and modifying <span> style classes. Alternatively, you can use the <MadCap|footnote> style or a class of it to modify the look of both the in-text and in-comment footnote numbers. The difference is that the <span> style lets you change the look of one or the other, rather than both at the same time. See Editing the Look of Footnote Numbers.
  • Restart numbering When you insert footnotes, the numbers are incremented throughout your manual. However, you can restart the numbering at a certain location (e.g., at the beginning of the next chapter or section). See Restarting Footnote Numbering.
• Glossaries

  • Look of generated glossary You can use styles to change the appearance of a glossary in print-based output. You can modify the look of individual elements within the glossary, as well as the entire container holding the glossary. See Using Styles to Change the Look of a Glossary.

    Note: If you want to change the look of glossaries in online output, you can do so by modifying styles within your skin. See Editing Skin Settings, Specifying Style Settings for WebHelp Output, and Specifying Style Settings for HTML Help Output.

• Help controls
  • Concept links You can edit the style (e.g., font, color, wording) of a concept link. When you edit the style for a concept link, the style changes for all concept links in any topics in your project. See Editing Concept Links.
  • Keyword links You can edit keyword links that you have inserted into topics. See Editing Keyword Links.
  • Related topics links You can edit Related Topics links that you have inserted into topics. See Editing Related Topics Links.
• Indexes

  • Look of generated index for print output If you incorporate a generated index into your printed output (see Creating a Topic for a Print Index), you can customize the way the index entries look in the output. This includes adjusting properties such as font family and size, word space, and space above/below. You can also change the look of the entire container holding the generated index. See Determining the Look of Your Print Index.

    Note: If you want to change the look of indexes in online output, you can do so by modifying styles within your skin. See Editing Skin Settings, Specifying Style Settings for WebHelp Output, and Specifying Style Settings for HTML Help Output.

• Links
  • Cross-references You can edit the style settings (e.g., format, font, color) of cross-references. This includes the ability to incorporate page numbers and context-sensitivity into a cross-reference format. See Editing Cross-Reference Style Formats and Editing Text for Context-Sensitive Cross-References.
  • Drop-down text You can edit drop-down effects that you have inserted into topics. See Editing Drop-Down Text.
  • Expanding text You can edit expanding text effects that you have inserted into topics. See Editing Expanding Text.
  • Text hyperlinks You can edit the style settings (e.g., font, color) of text hyperlinks. See Editing Text Hyperlinks.
  • Text popups You can edit the style (e.g., font, color) of the hotspot or the popup body in text popups. See Editing Text Popups.
  • Togglers You can edit the style (e.g., font, color) of the hotspot for togglers. See Editing Togglers.
  • Topic popups You can edit the style (e.g., font, color) of the hyperlink for topic popups. See Editing Topic Popups.
• List of concepts
  • Look After you use the concepts proxy to create a list of concepts, you can change the look of that list by using styles. You can modify the look of individual entries in the list, as well as the entire container. See Using Styles to Determine the Look of a List of Concepts.
• List of elements
  • Look After you use the list-of proxy to create a list of elements (such as a list of figures or tables), you can use styles to determine the look of the generated list. See Using Styles to Determine the Look of a List of Elements.
• Lists
  • Alignment You can format lists or items within them so that the text is aligned right, left, centered, or justified. See Aligning Lists.
  • Background You can set a background color and/or image on lists or items within them. See Setting the Background for Lists.
  • Borders You can add borders around lists or items within them. Borders can be added on any side (left, right, top, bottom), or all around. See Setting Borders for Lists.
  • Images for bullets You can change the image used for bullets in lists. For example, if you have a small check mark icon that you want to use instead of round bullets, you can select your image. See Selecting Images for List Bullets.
  • Indentation You can indent lists or items within them so that they start or end at a certain distance from the left or right side of the window or page frame. See Indenting Lists.
  • Line spacing You can specify the amount of spacing between lines of text in a list. See Setting Line Spacing for Lists.
  • Page and column breaks You can apply a page or column break to lists or items within them. You might do this if you want a list to end with a particular item on one page and begin with another list item on the next page or column. For example, you could create a class of the <li> style tag and you could call it something like "PageBreakBefore" (li.PageBreakBefore). For most items in a list, you could use the parent <li> tag, but if you want a page break to occur on a particular list item, you could apply your li.PageBreakBefore style to it. This feature is used for print-based output.  See Setting Page and Column Breaks for Lists.
  • Spacing above/below You can specify the amount of spacing above and below lists or items within them. See Setting Spacing Above and Below in Lists.
  • Type You can specify the type of list (e.g., circle, square, decimal, upper alpha) for a style. See Specifying a List Type for a Style.
• Mini-TOCs
  • Look of mini-TOC in online output You can use the <MadCap|miniTocProxy> style to modify the look of mini-TOCs in your online output. See Using Styles to Determine the Look of an Online Mini-TOC.
  • Look of mini-TOC in print-based output For generated mini-TOCs, you can use styles to adjust properties such as font family and size, indentation, word spacing, spacing above/below, TOC width, page number alignment, and leader settings (e.g., the dots between the headings and the numbers). The headings in the mini-TOC will take on the settings that you specify. You can also modify the look of the entire container holding the generated mini-TOC. See Using Styles to Determine the Look of a Print Mini-TOC.
• Paragraphs
  • Alignment You can format a paragraph so that the text is aligned right, left, centered, or justified. See Aligning Paragraphs.
  • Background You can set a background color and/or image on a paragraph. See Setting the Background for Paragraphs.
  • Borders You can add borders around a paragraph. Borders can be added on any side of a paragraph (left, right, top, bottom), or all around it. See Setting Borders for Paragraphs.
  • Drop caps/initial caps You can create an effect on a paragraph so that the initial letter is different than the others and drops down to the lines below. See Creating Drop Caps Effects and Creating Initial Caps Effects.
  • Hyphenation You can specify whether words at the end of a line in a paragraph should be hyphenated before continuing to the next line. You can also determine minimum word and character settings to be used for hyphenation. See Setting Hyphenation.
  • Indentation You can indent paragraphs so that they start or end at a certain distance from the left or right side of the window or page frame. See Indenting Paragraphs.
  • Line spacing You can specify the amount of spacing between lines in a paragraph. See Setting Line Spacing.
  • Page and column breaks You can apply a page or column break to a paragraph or heading. For example, you might do this if you want the paragraph or heading to start at the beginning of the next page or column. This feature is used for print-based output. See Setting Page and Column Breaks.
  • Positioning After you add a paragraph or heading to a topic, you can adjust its positioning on the page. For example, you can float it to the left of the page layout frame to create a side heading. You can do this by applying a positioning setting on the style used by the paragraph. See Positioning Paragraphs and Heading Examples.
  • Short line elimination You can use this feature to automatically adjust word spacing if the last line of a paragraph is only a certain number of characters long. Therefore, the spacing may be widened to make the last line longer, or the spacing may be narrowed to bring the words in the last line up to the previous line. See Setting Short Line Elimination.
  • Spacing above/below You can specify the amount of spacing above and below paragraphs. See Setting Paragraph Spacing Above and Below.
  • Widow and orphan control You can use widow and orphan control to avoid instances where "leftover" lines from a paragraph are shown at the top or bottom of a page or column. See Setting Widow and Orphan Control.
• Pictures
  • Resize You can resize many images at once by using the <img> style tag in the Stylesheet Editor. See Resizing Pictures.
• Rulers (horizontal lines)
  • Edit After you insert a ruler ("horizontal line") in a topic, you can edit its settings (e.g., size, color, position) by modifying the <hr> style in the Stylesheet Editor. See Editing Rulers.
• Search
  • Look of highlighted search terms When users perform searches in your online output, the keywords that are found are highlighted in the topics. The background for each term found in a topic is highlighted in a different color. In Flare, you can create styles for this purpose and change not only the color background, but other settings as well (e.g., font style, text decoration). See Using Styles to Change the Look of Highlighted Search Terms.
• Tables
  • Using table style sheet You can modify the look and feel of multiple tables at once by editing the properties in a custom table style sheet. These table style sheets let you easily and quickly create patterns and different looks for tables. See How to edit styles in a table style sheet.
  • Using topic style sheet You can modify the look and feel of multiple tables at once by editing standard HTML table tags (e.g., <table>, <th>, <td>, <tr>) in your topic style sheet. For example, you might use these styles in order to control the look of the text that appears in your table headings (<th> style) or within the cells (<td> style). See Editing Table Styles in Topic Style Sheets.
• Tables of contents
  • Heading levels When creating print-based output, you can determine which topic headings will be displayed at which level in the generated TOC. For example, even though all of your topics may use a heading style of <h1>, you might want some of those topic headings to display at the first level in the print TOC (acting as an <h1>), others at the second level (acting as an <h2>), and still others at the third level (acting as an <h3>). See Using Styles for Print TOC Heading Levels.
  • Look For TOCs in print-based output, you can use styles to adjust properties such as font family and size, indentation, word spacing, spacing above/below, TOC width, page number alignment, and leader settings (e.g., the dots between the headings and the numbers). The headings in the print TOC will take on the settings that you specify. You can also modify the look of the entire container holding the generated TOC. See Using Styles to Determine the Look of a Print TOC.

  Note: If you want to change the look of your TOC in online output, you can do so by modifying styles within your skin. See Editing Skin Settings, Specifying Style Settings for WebHelp Output, and Specifying Style Settings for HTML Help Output.

• Text
  • Bold You can apply a bold weight to text. Perhaps the easiest way to do this is to highlight the text and click the Bold button . However, you can also change the properties of a different tag so that it uses a bold weight. See Setting Bold Text.
  • Case You can change the case of text so that it is all uppercase or all lowercase. You can also specify that the first letter of each word in the selected content should be capitalized, while the other letters are lowercase. See Setting the Case of Text.
  • Color of background You can set a background color for text. See Setting the Background Color for Text.
  • Color of text You can select a color for text. See Setting the Color for Text.
  • Font family You can select a font family (e.g., Arial, Verdana) for text to change its look. See Setting the Font Family for Text.
  • Italics You can apply italics to text. Perhaps the easiest way to do this is to highlight the text and click the Italic button . However, you can also change the properties of a different tag so that it uses italics. See Setting Italic Text.
  • Italic correction You can correct the spacing in a line when italic formatting is involved. Often, when you italicize a word in the middle of a sentence, the last letter of that word has less space between it and the following word (due to the fact that it is italicized and the following word is not). Using italic correction, you can increase this space between the italicized word and the non-italicized word. See Setting Italic Correction.
  • Letter spacing You can specify the amount of spacing between letters in text. See Setting Letter Spacing.
  • Overline You can specify that a horizontal line should be placed above text (opposite of underlined text). See Setting an Overline on Text.
  • Size You can specify the size of text, choosing from many different units of measurement. See Setting the Font Size.
  • Smallcaps You can specify that text should be displayed in all capital letters, but in a small size. See Setting Smallcaps on Text.
  • Strikethrough You can specify that a horizontal line should be added through the middle of the text, providing the effect of content that has been "striked through." See Setting a Strikethrough Effect on Text.
  • Subscript You can apply a subscript effect to topic text, where some text appears below the level of the other characters (e.g., H₂O). Perhaps the easiest way to do this is to highlight the text and then click the Subscript button . However, you can also change the properties of a different tag so that it appears as subscript text. See Setting Subscript Text.
  • Superscript You can apply a superscript effect to text, where some text appears above the regular text (e.g., X²). Perhaps the easiest way to do this is to highlight the text and click the Superscript button . However, you can also change the properties of a different tag so that it appears as superscript text. See Setting Superscript Text.
  • Underline You can easily underline text. See Setting Underlined Text.
  • Word spacing You can specify the amount of spacing between words. See Setting Word Spacing.
• Text boxes
  • Background After you insert a text box, you can add background settings to the text box. This includes the ability to specify a color, an image, and a repeating pattern for the background image. See Adding Backgrounds to Text Boxes.
  • Borders After you insert a text box, you can add borders around it, specifying the border size, color, and type. See Adding Borders to Text Boxes.
  • Hyphenation After you insert a text box, you can adjust the way that the text within it is hyphenated. See Setting Hyphenation in Text Boxes.
  • Margins After you insert a text box, you can adjust the margins around it so that there is extra space above, below, to the right, or to the left of it. See Adding Margins to Text Boxes.
  • Padding After you insert a text box, you can add padding (i.e., extra space) between the text box's border and the text within it. See Adding Padding to Text Boxes.
  • Positioning After you insert a text box, you can adjust its positioning on the page. This includes the ability to float text boxes to the left or right, or even outside of page frames. See Positioning Text Boxes.
  • Size After you insert a text box, you can adjust its width and height. See Specifying the Size of Text Boxes.
• Topics
  • Background color You can change the background color for topics by using the <body> style or classes of that style. If you want the background color to be applied to all topics using a particular style sheet, you can use the main <body> style. If you want to change the background color for only some topics, create and use a class of the <body> style. See Applying Color to the Background for Topics.

When applying styles to content, you may notice from time to time that the style you are looking for is not available from the drop-down list or Styles window pane when you try to select it. This can occur if you have not yet made any modifications to the style in the Stylesheet Editor. Therefore, before applying a style to content, make sure you first provide the necessary settings for the style. See Editing Styles.

Another possible reason for this has to do with the location of the cursor in the topic. Flare realizes where the cursor is placed and knows that only certain styles should be applied at that location.

example

Let's say that you have your cursor on a regular paragraph and you want to apply a list <li> style to it in order to turn it into the beginning of a bulleted list. Because it is not yet a list item, but rather a simple paragraph, you will not see your <li> style when you try to select it. Instead, you will see several paragraph styles in the list. In order to use the list style, you first need to turn the paragraph into a bulleted list item, by clicking the bullet button in the Text Format toolbar or selecting an option such as Format>List>Bullet List.

Here is another example. If multiple paragraphs are selected or if the cursor is simply placed somewhere within a paragraph, the paragraph styles are shown in the Styles window pane. If only a portion of a paragraph is selected, the character styles are shown.

If you still do not see your style available for selection, try closing and re-launching Flare.