MadCap Flare

In this section, you can find some tips and hints that I have found useful as I convert existing documents into Madcap Flare, for single sourcing purposes. Some of these are just little shortcuts that made my life easier, while others are detailed procedures for completing complex processes.

Madcap Flare – Adding New Styles to CSS

Posted in MadCap Flare, Tips and Hints

Flare (with its strict adherence to CSS rules) makes me crazy when I import WORD or FRAMEMAKER documents. I want to be able to easily apply a style to a paragraph,  or map a CSS style to my Framemaker or WORD stylesheet when I do an import. However, Flare will not let you:

  • Select from your full portfolio of styles when your paragraph is already formatted as a paragraph <p>, list <li, ol, ul>, or any other format. It will only show the subset of styles under that category. NOT USEFUL when you have a procedural documents with numbered steps, sub-bullets, sub paragraphs, images, etc. You want to be able to apply the appropriate style when you need it, and you need to be able to SEE that style in your Flare Stylesheet List.
  • Map your numbered styles from WORD or FRAMEMAKER to your list styles.

The following is a round-about solution, but is the only way I have been able to get around this whole issue while remaining compliant with CSS rules:

Create your Style as a Paragraph Class

  1. Open your CSS file in the Flare Stylesheet Editor.
  2. Select the p element.
  3. Click the Add Class option on the toolbar to add a new paragraph class.
  4. Give this new Class a decent name (eg: Numbered1, NumberedCont, NumberedBullet, NumberedBody, etc).
  5. Apply whatever attributes you need associated with this Paragraph Class.
  6. Save all your changes.

This new Paragraph Class can now be applied to any Paragraph in your project, but cannot be applied to content in a list (ul, li, ol), table, cell, , or to any other element that already has a CSS style applied to it. It will disappear from your available styles list when you try to use it against any other element than a paragraph <p>. Thats the URGH part. So how do you make this new style appear on your stylesheet at all times? That is the next step!

Convert the Paragraph Class into a Top Level Class

  1.  Navigate to the Content Explorer and find your CSS file in the Resources>Stylesheet section.
  2. Right-click on your CSS file, and select Open with > Internal Text Editor.
  3. Press CTRL+F, enter the name of your new paragraph class, and press Enter to navigate to the CSS definition for that item.
    • In my case, I had a series of paragraph definitions named p.Numbered1, p.NumberedCont, p.NumberedBullet, p.NumberedBody.
  4. Delete the ‘p‘ in your paragraph class name.
    • This will leave you with just the name of the style. In my case: .Numbered1, .NumberedCont, .NumberedBullet, .NumberedBody.
    • This is basically equivalent to the styles that I had in my WORD and FRAMEMAKER document.  Apparently these are  known as “Generic Styles“.
    • These styles will now show up in your Styles list, no matter what paragraph format you choose. HURRAH!
  5. CTRL +S to save your changes.
Read More

MadCap Flare Tips and Shortcuts

Posted in MadCap Flare, Tips and Hints

MadCap Flare Tips and Shortcuts

So, this blog page is basically a place where I keep handy shortcuts and tips for MadCap Flare. These are mostly one-liner, handy things to know and use as I develop my projects. Sorry for the current lack of organization, but I promise to add appropriate headers once I have enough here to make it worthwhile. Hope you find it useful, and if you have any special tips yourself, please feel free to submit them!

Continuing a Numbered List

I often have a nested description under a numbered list. In WORD and FRAMEMAKER, I simply apply a special style to the next paragraph to continue my numbered list after the nested description. How to do this in Flare?

  1. Place your cursor in the paragraph from which you want to continue numbering.
  2. Navigate to the Formatting Toolbar and click the List Actions Button.
  3. Select Continue Sequence.

Bullet Icons are huge in Flare 10 - Why?

All of a sudden, all my bullet icons (.png) format became huge when displayed in Flare. After a bit of searching in the Software Forums, I found the solution. Flare 10 automatically checks “Automatically resize low DPI Images“. URGH.

The fix is:

File > Options > General Tab > Uncheck Automatically Resize Low DPI Images

Create Character Styles in Flare?

I wanted to be able to map my Character Styles (bold, italicize, highlight, color, footnote)  from Framemaker and Word with  matching Character Styles in Flare. To do this:

  1. Open the CSS file that you are using.
  2. Select the span tag in the Stylesheet Editor.
  3. Click Add Class.
  4. Type a name for the Character Style (bold, italicize, highlight, color, footnote, etc ) and click OK.
  5. Format the Character Style with the features that you want.
  6. Save your changes.
  7. Test by applying these styles to sample content – select content, select the span class from the style drop-down list.

I found this tip in Scott DeLoach’s page, along with some other great tips you may find useful.  See http://www.clickstart.net/presentations/flaretips_writersua10.pdf .

Read More

Flare – Using File Tag Sets to Track Source of Content

Posted in MadCap Flare, Tips and Hints

Flare – Using File Tag Sets to Track Source of Content

As you have probably realized by now, I am importing and merging a large amount of content from a broad variety of Word  and Framemaker books that we have written.  For reasons of organization, searchability, single-sourcing,  and future maintenance, I wanted to be able to identify WHICH book each of the Flare generated files and graphics originally came from! Unfortunately, at this time, Flare does NOT allow you to automatically attach prefixes to filenames at the time of import. For example, if I wanted to prefix every imported file and graphic with ‘FL_‘ to indicate that this is from a =manual about Flare. Doing this would let me easily identify any file, and its original source manual, just by looking at the filename. File sorting would also be much easier (especially if I start moving files from their original import folder to another folder). But sadly, this remains another feature request that more people have to ask for before they make it happen. Sooooo….what to do!

Well, with a little thought and assistance from the Flare Tech Support, we came up with a workaround so that I would at least be able to tag each file with the name of the source manual. That’s right, “TAG”! Typically, File tags are used to assign authors, or track project milestones. But you can also use it to identify the source of a document. So first you creat a File Tag Set, then you apply the appropriate tag to each file, or group of files.  You can then generate reports, export by tags, etc, etc. Hurrah!

 Add a File Tag Set

  1. Navigate to the Project Explorer tab.
  2. Right mouse click on Advanced and selecct Add File Tag Set.
  3. Set the following to suit our needs. I entered the following for tracking my book sources:
    1. Source ==> New from Template >Factory Templates > MyFileTagSet.
    2. FileName ==> FileSource
    3. Tag Type ==> Book Names
    4. Description ==>Enter any description that will help you to identify the function of this tag
  4. Click Add to view a table for File Source (currently blank)
  5. Enter each new tag (book name in this case) and a description of each tag.
  6. Choose File> Save to save all your tags.

 Apply a File Tag to a File

Now that you have entered your book names, you can apply this tag to each file (either individually, or as a group). Seeing as I did this to save time, I prefer to select a whole bunch of files, and then apply the appropriate file tag to it. Here’s what I did.

  1. Navigate to the Content Explorer tab.
  2. Open the folder containing the files you want to tag.
  3. Select all the files that you want to tag.
  4. Click F4 to open the Properties dialog box for these files.
  5. Select the File Tags tab.
  6. Select the Tag Type from the drop down list. In my case, I choose Book Names.
  7. Check or select the File Tag that applies to this collection of files.
  8. Click OK to apply that file tag to all the selected files.

Learn More

You can find more detailed information about this, as well as different ways to access these file tag options in the Flare Online Help.

 

Read More