Links of the Week

Add Right-Click Functionality to Captivate Simulations

William Heinz, OpenSky Learning, Inc., has come up with a clever way to add right-click functionality to your Captivate simulations… and you won’t have to worry about knowing JavaScript.

According to Heinz, "Most software today uses right-click functionality to accomplish various software tasks. In Adobe Captivate, you can add click boxes that support left and double-click. The right-click functionality is trapped by the Flash Player to display the player menu. Right-click functionality is an essential tool for creating software testing using Adobe Captivate, and it greatly enhances the ability of Adobe Captivate to teach software applications. The approach described in this tutorial allows you to size and place the right-click area almost as intuitively as adding a Adobe Captivate Click box. The solution will work with Adobe Captivate 1.01, Adobe Captivate 2, and Adobe Captivate 3."

Click here to read the article.

Automate the Process of Creating Numbered Lists in Microsoft Word

David Knopf, president and founder of Knopf Online, wrote a wonderful article a while back about numbering lists in Microsoft Word. Specifically, you’ll learn how to actually make the numbered lists work, especially with RoboHelp.

According to Knopf, "…it’s difficult to number lists automatically. The (Word) Numbering  toolbar button doesn’t work reliably, and neither does RoboHelp’s Topic Text Numbered style.

"…many RoboHelp users have reverted to "manual" list numbering, which is both time-consuming and error-prone. You can automate the process of creating numbered lists in Word and completely insulate yourself from the Word bug that has plagued so many Help authors."

Click here to read the article.

Link of the Week

Converting Word Documents for Use in FrameMaker

Matt Sullivan of Grafix Training and Consulting has written an article that will improve your efficiency when working with Word documents that you intend to import into FrameMaker.

According to Sullivan, "FrameMaker gives you control over formatting, referencing, and numbering. Follow a few simple rules, and your numbered lists stay properly numbered, and your cross-references, Table of Contents (TOCs), and Indexes (Indices) stay up-to-date.

"All that control doesn’t help unless you have content. This usually means importing legacy documents from Microsoft Word, or accepting submissions from team members who do not work with long documents in FrameMaker."

In his article, Sullivan teaches you some nice techniques such as:

  • Legacy document conversion
  • Using the Find/Change tool for cleanup
  • Common wildcard strings
  • Formatting
  • Word/FrameMaker integrated workflow

Click here to read the article.

Grammar Workshop: When a Verb is Not a Verb… Part III

by Jennie Ruby

When it’s not just a stick, it might be a walking stick. When it’s not just a class, it might be a writing class, and when it’s not a verb, it might just be an adjective. The -ing form of a verb, when used as an adjective, is called a participle. And when a past-tense form of a verb is used as an adjective, that is a past participle.

Without these verbs as adjectives, we could never be a motivated employee, a devoted spouse, or an aging parent. And we are not happy to let these verbs-as-adjectives stand alone. Even while using them as adjectives, we remember that they are still, indeed, verbs, and verbs can be modified by adverbs. So we talk about the highly talented vocalists on "American Idol" and the sparsely populated areas of our planet.

Of course, we do manage to use these words incorrectly in the occasional unfortunate sentence, creating the famous dangling participle:

  • Carrying a big stick, no one will mess with us.
  • Built over a century ago, ivy clings to the walls of the stone house.

In these sentences, the participle acting as an adjective is either too far from the word it is describing (stone house) or has no word to modify at all (the word we is not even in the first sentence).

So, when is a verb not a verb? Answer: when it is an infinitive, a gerund, or a participle.


About the Author: Jennie Ruby is a veteran IconLogic trainer and author with titles such as "Essentials of Access 2000" and "Editing with MS Word 2003 and Adobe Acrobat 7" to her credit. Jennie specializes in electronic editing. At the American Psychological Association, she was manager of electronic publishing and manager of technical editing and journal production. Jennie has an M.A. from George Washington University and is a Certified Technical Trainer (Chauncey Group). She is a publishing professional with 20 years of experience in writing, editing and desktop publishing.


Want help with a grammar issue? Email us your troubles and we’ll turn Jennie loose!

Marketing Lessons from My Motorcycle

by Quinn McDonald

I was grumbling about all the chrome on the bike. Not a fan of shiny, polish-needing parts on anything, I was using a toothbrush to clean the wheels of the bike. No, I’m not a neat-freak, but the bike is black and chrome, and it had started to look unkempt, insect-spotted and dusty. So I was polishing, wiping, washing and toothbrush- wielding. It felt like the whole bike was made of chrome.

Dan rolled up in the driveway behind me.

"What’s new?" he asked, getting off his bike.

"Polishing up Suzie Lightning, then going for a ride," I said.

He considered the cloud cover and said, "Every minute you spend polishing that thing, you aren’t riding it. And you bought it to ride, not polish."

He was right, but I said, "Gotta keep it clean."

"Sure," he agreed, "but you can keep it clean at night or when it’s cold. Take advantage of what you have."

The same is true of marketing your business.  You can spend a lot of time on prep work, planning, developing and never get the call to present your real work.

Unless you market yourself all the time, you don’t have a marketing plan, and you can’t count on steady work.

Cleaning the office or house, doing paperwork all are important, but the wrong time to do them is when it is time to market.

If you wait till the phone stops ringing, you are too late. By the time you get results from marketing, you won’t have a steady income coming in.

And when the steady income doesn’t happen, you start to take jobs just for the money, and that creates another whole poblem.

There are jobs you should turn down and clients you should say "No,thanks" to.

Regular marketing allows you to say "No" and not regret it.

Life is short, marketing keeps your phone ringing. Do your marketing today so you’ll have a ringing phone to answer tomorrow..


About the Author: Quinn McDonald is a writer and nationally-known speaker who has achieved the "Professional" designation from the National Speakers Association. Contact Quinn through her website, QuinnCreative.com.

Questions of the Week

Question: How Do I Control The PowerPoint Bullets After Import into Captivate?

I’m trying to figure out how to sync animations from an imported PPT with audio imported to the Captivate timeline (using Captivate 3).

Several slides have bullets that appear on-mouse-click in PPT.  After importing into Captivate, the bullets appear one after the other, spaced by a second or two.  What I would like to be able to do is define a cue-point (e.g., on the slide timeline) that triggers each bullet to appear at a specific time during the audio.

In the Adobe Captivate forum it appears that I can pause the animation by adding an invisible click button, which would display the bullet text when the slide continues.  But this isn’t what I need–I don’t want to require a pause and click, but rather just have the bullets appear as they’re spoken in the audio.

(This is a trivial task in Articulate, and of course they’re entirely different technologies, but I thought that this is the kind of thing that Adobe was talking about when they touted that Captivate 3 imports PPT animation.)

I would appreciate knowing if this is doable in Captivate (even if it requires import into and jiggering in Flash), or just not possible in this version.

Answer

I think you’ll find the PowerPoint bullet builds (animations) do not import as well as you’d hope. As you’ve seen, the animation does import as advertised. But you cannot easily control the speed at which the bullets appear. I haven’t attempted to control the animation in Flash… if your fellow readers have had success, perhaps they’ll contact me and I’ll pass along any recommendations.

In the meantime, you might want to consider importing the slides as backgrounds, use highlight boxes to "reveal" each bullet, synched with your audio.

 

Question: Em Dashes in RoboHelp Possible?

I’m using RoboHelp 7 and would like to insert an em dash. Is this possible?

Answer

Yes! To insert an em dash in RoboHelp 7, choose Insert > HTML > Symbol and select em dash from the list of symbols.

Question: Which is Better, InDesign or FrameMaker?

I am a technical writer and want to learn a desktop publishing program but am not sure which–FrameMaker or InDesign.
I don’t see a lot of books on the market for FM but I do see them for ID (IconLogic being a prime example).

In your opinion, is ID the future for tech writing or is FM firmly entrenched. My employer has neither but I am considering investing in one to learn it so your opinion would be helpful.

Answer

What a great, great question! Both FrameMaker (FM) and InDesign (ID) have a place in the publishing world. They are both wonderful tools, but if you are a technical communicator like me, and you own the TechCom suite, FrameMaker integrates wonderfully with RoboHelp and Captivate… InDesign simply does not. For the record, I own both QuarkXPress and InDesign (and I teach both applications to the highest levels). However, the program I choose to use every day (when I write and develop my books) is FrameMaker.


Got a question you’d like answered? Email me.

Adobe Captivate: What’s a Little Space Between Friends… or Names?

When publishing your Captivate projects as SWFs, it’s important to pay attention to the Project Title in the Publish dialog box. Why? The text you type in the Project Title field will be used in the HTML, SWF and Skin SWF files that are created when you publish a typical Captivate project (the skin SWF will be created if you use a skin).

In the example below, the words Kevin Project Name have been typed in the Project Title field. The problem isn’t with the words themselves… it’s the spaces between the words that will prove lethal. Published Captivate SWFs are typically uploaded to a Web server and spaces in file names are a very bad idea. If you allow spaces in your file names, you’ll end up with either broken links, network errors or both.

Published file name with spaces

In the picture below, you’ll notice that I kept the name the same, but simply used underscores between the words. While spaces are a bad idea, underscores and perfectly acceptable.

Published file name without spaces

Watch for Spaces in Media File Names

If you’ve added Full Motion Recordings (FMRs) or Flash Video (FLV) to your project, be wary of spaces in the media file names. When you publish your project, the FMRs and FLVs are actually published as external files. (This fact comes as a surprise to many developers who assume the FMRs and FLVs are contained within the main SWF that is created when the project is published.)

If the FMRs or FLVs have spaces in their file names, your good naming habits in the Project Title field when you publish won’t matter since both FLVS and FMRs keep their original media names (or the names the files were given when they were created or imported into a Captivate project). What’s a developer to do? Read on…

Prior to publishing, show the Library (View > Show Library) and observe the Media folder. If your clips contain spaces (such as those shown in the picture below), right-click the clips and choose Rename. Remove the space from the name and then press Enter. Then go ahead and publish the project.

FMRs with spaces in the their file names


Got a Captivate production problem that’s making you pull your hair out? Email your problem and let others learn solutions from your experience.


Want to learn more about Captivate? Click here.

Adobe Captivate: Custom Buttons Made Easy

When inserting buttons onto a Captivate slide, you can elect to use a Text button (you’ll end up with a gray button and you can control the text that appears on the button’s face) or an Image button (you can select from several images containing canned text).

The process of inserting a button is simple. Choose Insert > Button, select your button type, select the button action and click OK. Done.

However, since Captivate does not currently offer a "button editor" where you can create buttons on the fly, you might think it’s beyond you to create your own buttons. Maybe you think you need to know PhotoShop to create a custom button. Or maybe you think custom buttons are too expensive? Read on…

There are many sites you can find on the Web that allow you to create custom buttons. The site that I use (because it’s inexpensive and easy to use) is ButtonGenerator.com. Many of the buttons you create at ButtonGenerator.com are actually free (and you can’t beat that).

Using ButtonGenerator.com, I created the following three buttons in about 30 seconds:

Custom buttons created with ButtonGenerator in about 30 seconds

I gave the three buttons the following names:

  • kevincustom_up.bmp
  • kevincustom_over.bmp
  • kevincustom_down.bmp

The names are important. Notice that the three buttons are very similar, but contain the words up, over and down. When inserted onto your Captivate slide, the buttons will automatically include a JavaScript rollover behavior–but you won’t have to know anything about JavaScript. If the button is not clicked by your users, the "up" version of the button appears on the slide. If the user points to the button with their mouse, the "over" version of the button will appear. If the user clicks the button, the "down" version will appear. Sweet!

I saved all three buttons as bitmaps (ButtonGenerator lets you save as PNG or BMP… I had better luck with BMPs) to the following location: C:\Program Files\Adobe\Adobe Captivate 3\Gallery\Buttons. (Note: The buttons you add to the Buttons folder will not be available for use within Captivate until you exit and restart Captivate.)

After creating the buttons, start Captivate and open a slide. Choose Insert > Button and select Image button as the button Type.

Select your custom button from the button image drop-down menu.

Custom button available in Captivate

Finally, preview the project to see and test your new button.


Got a Captivate production problem that’s making you pull your hair out? Email your problem and let others learn solutions from your experience.


Want to learn more about Captivate? Click here.

Questions of the Week

Question: Can Captivate User Interaction Be Reused?

We want to have users enter their details (Name, where they’re studying, name of their course, etc), then take the Captivate assessment and have the results fed back to them at the end with their name, which they can then theoretically print as a certificate.

Is anything even remotely similar to this do-able or are we crazy for assuming it can be done?

Answer

You can insert multiple text entry fields, then put a SWF on the slide that allows users to print the slide (the slide could be made up to look like a certificate).

I wrote an article about inserting multiple text entry fields here. And you can add a Print icon to your Skin playbar that will let users print the slide/certificate.

However, without adding JavaScript’s, there is no way for Captivate to display information that a user types later in the movie. Most people use an LMS to create user certificates (based on their user login, not what they type in the project).

 

Question: Why is my RoboHelp Project Running Soooo Slowwwwwly?

I’m using RoboHelp 7. Everything I do in my RoboHelp project seems to take forever. For instance, generating the project (it’s small, maybe 50 tiny topics) takes almost 10 minutes. The project is kept on my network drive and my network guys tell me it’s NOT the network causing the problem. Please help!

Answer

You said everything I need to know about the problem in your fourth sentence: "The project is kept on my network drive…" RoboHelp must be installed on your local hard drive (C:\) AND your project must be installed on your local hard drive. If your project is accessed from a network drive, you are likely to experience any or all of the following:

  • Lack of speed
  • Crashes
  • Corrupt projects

I would immediately copy your RoboHelp project folder to your hard drive and open the project via  File > Open (open the XPJ file). Don’t use the Recently Used project to open the project since the link is pointing to project on the network. In the future, only use the network drive to backup your project only.

Follow-Up On Dual Screen Captivate Recording Question

Last week a reader wanted to know if it was possible to use Adobe Captivate to record two screens at one time (could you record actions in, let’s say, Word on one screen and Excel on the other). I don’t have a dual-monitor setup so I couldn’t see if it was possible. But two fellow Captivator’s, Bob Cave and Richard Brimson, tested this for me. They each started Captivate, stretched the red recording area over both monitors and successfully recorded a movie. While they confirmed that it was easy-enough to record a Captivate project across two monitors, the resulting movie is too large to be useful.


Got a question you’d like answered? Email me.

Hiding Costs, Not A Good Plan

by Quinn McDonald

Note: The article you are about to read is free!!!

There is an annoying trend starting up on websites, and I’d like to nip it in the bud. All of you who sell products and services on your websites, quit hiding the cost of your memberships, classes and products. Quit making me click on "buy now" or fill out registration forms with all my information before I find what I have to pay.

You are probably thinking that telling me the price up front will make me leave, because my buying decision is based on price, and if you can show me a few more facts, I’ll think the price is a bargain.

If I can’t find the price right away, I feel like I’m being scammed. I don’t like searching for things you cleverly hide. You can’t make your clients eat your vegetables on your website.

Put your price where I can see it and consider it. I’m not so dumb that if you’ve led me on a chase through your website, and I finally find the price, I’m going to think it’s worthwhile and buy.

And while I’m at it, stop calling prices "investment fees," "opportunity cost" and other nonsense. It’s a price, and I’m willing to pay it if you give me real information and put the price up front, so I can make a decision like an adult. If you don’t, I’m finding someone who will.


About the Author: Quinn McDonald is a writer and nationally-known speaker who has achieved the "Professional" designation from the National Speakers Association. Contact Quinn through her website, QuinnCreative.com.

Grammar Workshop: When a Verb is Not a Verb… Part II

by Jennie Ruby

Nouns are things. We use nouns to name physical objects in our world, such as books, telephone, desk. We also have nouns that name abstract things such as love, intelligence, and theory. But when we need to name an action or a behavior, nothing works better than a verb. We use the -ing form of a verb as a noun to name an action: singing, walking, running. The grammar term for an -ing verb used as a noun to name an action or behavior is gerund.

A gerund can be the subject of a sentence, just as any noun can:

  • Walking is good exercise.

A gerund can be the direct object of a verb, just as a noun can:

  • This week’s exercise plan includes running.

A gerund can also belong to someone, just as a noun can:

  • Her singing was superb.
  • Her leaving was a surprise.
  • I did not mind his standing by the door.

A common error speakers and writers of English make is failing to use the possessive pronoun in front of a gerund:

  • *I did not mind him standing by the door.*

To avoid this error, ask whether you are talking about the person, or an action or behavior belonging to the person:

  • I saw him standing by the door. (I saw a person, him,  not a behavior.)
  • I did not mind his standing by the door. (What I didn’t mind was a behavior, his standing there, not a person.)

Watch for these -ing verb acting as nouns, until next week, when we meet the -ing verb in another non-verb role: as an adjective.


About the Author: Jennie Ruby is a veteran IconLogic trainer and author with titles such as "Essentials of Access 2000" and "Editing with MS Word 2003 and Adobe Acrobat 7" to her credit. Jennie specializes in electronic editing. At the American Psychological Association, she was manager of electronic publishing and manager of technical editing and journal production. Jennie has an M.A. from George Washington University and is a Certified Technical Trainer (Chauncey Group). She is a publishing professional with 20 years of experience in writing, editing and desktop publishing.


Want help with a grammar issue? Email us your troubles and we’ll turn Jennie loose!