The Logical Blog by IconLogic

Adobe Captivate & Articulate Storyline: Round-Tripping With Microsoft Word

by Kevin Siegel   

How do you collaborate with Subject Matter Experts (SMEs) who aren't Adobe Captivate or Articulate Storyline developers? Specifically I'm talking about text content. How many times have you gone back and forth (and back and forth again) with your SMEs, changing a word on a slide here, removing a comma there. Maddening, right?

Wouldn't it be great if you could export the text from your eLearning projects into Word, get your SMEs to make their changes in the document (using Word), and then import those changes back into your project? That kind of workflow is a dream, right? Nope. The workflow exists today in both Captivate and Storyline and the process is simple.

Adobe Captivate

Open or create a Captivate project and choose File > Import/Export > Export project captions and closed captions.

In the Open dialog box, name the resulting document, specify a save destination, and click the Save button. (You will be notified when the captions have been exported.)

Click Yes to open the document in Word.

The captions will appear in a Word table. There will be five columns: Slide ID, Item ID, Original Text Caption Data, Updated Text Caption Data, and Slide. You can make any changes you want to the Updated Text Caption Data, but you should not change any of the other information. The Slide ID identifies which slide your edited captions go to. The Item ID identifies which caption goes with which caption data.

 

Make your editorial changes; then save and close the Word document.

The final step is to to import the edited text back into Captivate. Choose File > Import/Export > Import project captions and closed captions. Find and open the document you edited in Word. A dialog box will appear confirming the number of captions that were imported. Not only will the edited content be imported, but formatting changes made to the Word document, such as making text bold or italic, are also retained.

 

Articulate Storyline

 

The process of round-tripping between Articulate Storyline and Microsoft Word is just about the same as it is in Adobe Captivate.

Open or create a Storyline project and then choose File > Translation > Export. In the Open dialog box, name the resulting document, specify a save destination, and click the Save button.

 

In the resulting Word document, SMEs can make any needed content changes in the Translate this column area of the document and then return the edited document to you.

 

The final step is to simply choose File > Translation > Import and open the edited Word document.

*** 

If you'd like to learn more about eLearning, come hang out in my next eLearning basics mini course. And if you'd like to learn more Captivate, Presenter, or Storyline, we've got a great collection of live, online classes for you. 

Adobe RoboHelp: Merging WebHelp

by Willam van Weelden  

I've previously taught you how to create links between Merged HTML Help projects. This time, let's tackle merged WebHelp. Merging WebHelp differs from merging HTML Help in that you select the RoboHelp project to merge instead of the output.

Prepare a Master Project

1. Open the master project's table of contents and click New Merged Project.
     
2. On the FlashHelp/WebHelp/Multiscreen/Adobe AIR tab, click the Browse button and open the RoboHelp project you want to merge.
     
3. Click the OK button to merge the project. (The child project will appear in the master project's TOC.)
     
4. Save your project and generate your master project.

Generate Merged Projects

Once you've created the master project, you need to generate the merged projects to the correct folder in the master project's output folder.

When you generated the master project, RoboHelp created the following folder structure:

   

For every child project, place the WebHelp output into the mergedProjects\<project name> folder. (Meaning that the child project called Child 1 has to be placed in the folder WebHelp\mergedProjects\Child 1.)

Once you generate all child projects to the correct location, open the master project output to see the results:

 

***

Looking to learn RoboHelp? We offer a live, two-day online RoboHelp class once a month. Feel free to contact us to learn other ways to meet your RoboHelp training requirements.

eLearning and TechComm: Click, Select, Choose, or Press?

by Jennie Ruby

Right at a time when flat design has become the rage, removing the three-dimensional look that for 30 years (happy anniversary to Windows this November!) has informed us that "this thing looks like you can poke it in! It must be a button!" people are starting to worry and become uncertain about the clear vocabulary that has helped us to write about software and computers for just as long.

In a recent class I had one participant tell me her office has forbidden the word "click" in favor of "select." Another told me that her office had done just the opposite!

The two concerns in question are whether the word "click" loses its meaning on mobile devices, and whether the word "click" is exclusionary toward individuals with disabilities or different abilities.

The good news is that using the word "click" is not ableist, nor is it declaring the hegemony of mouse users over mobile device users. It is just the standard word in technical communications to indicate "execute," on certain kinds of interactive items on screens. In other words, "click" means "hey you, button, do that thing you do."

The button, as with so many things in the computer realm, is an analogy to real-world little pokable nubbins that make things happen on electric devices from vacuum-cleaners to doorbells. Even real-world buttons have undergone some changes in the ways people use them. The buttons on my microwave and stove are now flat to the surface and covered with a plastic sheet so that spaghetti sauce and porkchop grease can't get in and ruin the mechanism. But you still actuate them by pressing them--and most of them still emit a satisfying "click" sound (or a beep) when you do so.

By analogy, "click" is whatever action you do to an on-screen button to make it do its thing. It is executed on various devices and by various computer users in various ways. Many of us already made the leap from "press and release the left button on a mouse device" to "press and release the left side of your mouse even though it no longer has a button" to "press and release the entire touchpad on your Mac laptop so that emits a click sound" to "tap ever-so-gently on the hair-trigger touchpad of your new Windows laptop" to "tap once on the screen of your iPad or phone" to "tap once on the screen of your touch-screen laptop" to "tab to the button and press the Enter key on your keyboard." And with Windows Speech Recognition, to actuate a button, you actually speak the word "click," as in, "Click OK;Click File; Click Bold; Click Save; Click Close," and so on.

To back away from the word "click" right now is as unnecessary, and even nonsensical, as deciding that the Save icon has to be changed because no-one has used an actual mini floppy disk since 2005. The Save icon has become a symbol that will retain its meaning like other permanent glyphs, such as the Arabic numerals or the smiley face. And the word "click" is the way you indicate "actuate" for certain screen items.

But that is not to say that the word "click" should be used for every screen action. By now I hope I have made clear that a "click" is a characteristic of certain screen items-buttons, icons, tools-not of the physical method by which you actuate them. So even though you may also click your mouse to execute the following actions, the word "click" is not the clearest vocabulary word for them.

You "choose" something from a menu, because you are "choosing" from a list of "choices," and once you "choose" the one you want, the chosen command is immediately executed.

choose File > Close

You "select" something that, once you select it, stays selected. You select a cell in Excel. You select part of the text in a document. You select an option from a list and the option stays selected-as in a drop-down list or a list-box. You select a radio button, and you select a checkbox. And they stay selected. Until you "deselect" them.

select the Portrait Orientation radio button

select the Kerning checkbox

from the Font drop-down list, select Verdana

select the first paragraph in your document

deselect the Enable Live Preview checkbox

You "press" a key on a keyboard or a real button on an actual piece of hardware. (The word "press" definitely cannot be used to describe what you do to an on-screen button, because it may create ambiguity: Does "Press Home" mean on the screen or on the keyboard?)

press the Enter key

press the F6 key

press the Power button (on the microwave)

And finally, you "click" an on-screen button, an icon, or a tool.

click the OK button

click the Bold tool

click the Wifi icon

As this vocabulary discussion continues, I would love to hear your take. Is your office using "select" for everything? Are you using "press" for mobile devices? Or tap? Are you combining commands, as in "click or tap the link"? Email me.

References

Microsoft Manual of Style for Technical Publications: "Do not use choose as an alternative to click or double-click. Choose does not convey any additional information to those who do not use a mouse, and such users normally understand the equivalent action that they must take when a procedure step says to click."

Web page: Use Speech Recognition to operate windows and programs

***
Do you need to learn how to write eLearning scripts? Come check out my live, online mini course.

eLearning: Become a Pedagogical Agent

by Jennie Ruby 

If you've taken any of our Adobe Captivate, Adobe Presenter, or Articulate Storyline classes, you are probably aware that these programs provide a selection of screen characters--cut-out pictures of professional actors in business, medical, or business-casual clothing posed as if they are talking to you. They are intended for use as a kind of avatar of the trainer.

There is research that shows that using a screen character as a pedagogical agent or learning coach, who speaks informally and appears to be giving the lesson, increases learning. (My reference for this is Ruth Colvin Clark and Richard E. Mayer, eLearning and the Science of Instruction.)

Over the past few weeks, I've had multiple students ask how hard it would be to use themselves as the learning coach. Believe it or not, becoming a pedagogical agent is easier than you think.

 

Put Your Picture into the Lesson. Place a professional head shot of yourself, your trainer, or expert on the introductory slide (including job title, credentials, etc.), and then have that individual record the audio narration for the project.

 

Create your own screen characters. Photograph your expert on a green screen background for a full set of screen characters in various poses. The IconLogic Blog has a whole series of articles on how to do this:

 

Green Screen Part I

Green Screen Part II

Green Screen Part III

Green Screen Part IV

 

Create cartoons of yourself or your in-house experts. You can use the images over and over in on-going training videos. Here is one article to get you started: Using Bitstrips Characters.

If you don't have specific, known individuals in your company to act as your learning coaches, you are not stuck with the same four or five actors that come with your software. You can purchase additional screen characters from The eLearning Brothers. Or you can just make good use of some inexpensive clip art. By trimming out the background in ordinary office photographs, you can get some nice effects.

 

Whether you use generic actors or your own home-grown experts, screen characters are an excellent way to add the personalization, engagement, and local feel that will bring your eLearning to the next level.

 

Once you have your screen characters, how do you know what to make them say? Join me for an afternoon mini course on writing voiceovers to find out.

Adobe Captivate: Text Hyperlinks

by Kevin Siegel   

Over the years I've had more than a few eLearning development clients ask us to create links to web resources on a slide. There's more than one way to accomplish the task. Over the next couple of weeks I'll discuss some of my favorite techniques. Up first, text hyperlinks.

To create a text hyperlink, select some text (the text can be contained within a text caption or a smart shape). Then, on the Properties Inspector, select the Style tab. From the Character area, click the Insert Hyperlink tool. 

 

 

From the Link To drop-down menu, choose Web Page. Next, type a web address into the field.

 

Prior to clicking the OK button, visit the drop-down menu to the right of the web address. I think it's a good idea to select New from the list of options. (This will ensure that the page that appears after the learner clicks is a new page or tab, rather than a page that replaces the current lesson.)

 

 

 

When previewed in a web browser, the text hyperlink will look similar to the image below. If clicked, the learner will be taken to the web address you specified in the Link To area.

 

  

 

Should you change your mind about the text hyperlink, removing the link is as simple as selecting the text and, back on the Properties Inspector, clicking the Remove Hyperlink tool.

 

 

***

If you'd like to learn more about eLearning, come hang out in my next eLearning basics mini course. And if you'd like to learn more Captivate, Presenter, or Storyline, we've got a great collection of live, online classes for you.

See also: Object Hyperlinks

Adobe RoboHelp: Create Merged Help

by Willam van Weelden  

Merged help is the process of combining outputs from multiple RoboHelp projects into a single help system. While the content is created from multiple projects, your users see a single, integrated help system.

Over the next couple of weeks I will teach you how to create merged help for several output formats. Since RoboHelp's layouts work differently, I will go over each layout in turn. 

Why Merge Help?

Generally speaking, if any of the following items are true in your environment, merging may be for you:

• You have a very large project (thousands of topics). Splitting the project into smaller projects may make maintenance easier.
• Multiple writers work on separate parts of the documentation and you don't have source control. Without source control, only a single author can work in a project at the same time. Having multiple smaller projects makes collaboration without source control easier.
• You need to update parts of the help separately from other parts. If you have a single project, you create an output for the entire project. You can publish only changed files, but you can't update only a single part. With merged help, you can.
• You have modules that are reused in different products. With merged help you maintain a single version, and reuse that.

Which Outputs can I Merge?

You can merge the following outputs:

• Adobe AIR
• Microsoft HTML Help (CHM)
• FlashHelp
• Multiscreen HTML5
• Responsive HTML5
• WebHelp

Master Project and Child Projects

When you merge help, you always have one master project and any number of child projects. The master project is the glue that holds everything together. When you generate your output, the master project makes sure that your help system is shown as an integrated whole.

Your master project is a regular RoboHelp project. You can use any features you want in the master project.

Merged Microsoft HTML Help

Generate a CHM file for every child project. (Using the Single Source Layouts pod, generate Microsoft HTML Help.) Then open the project that is to be the master project.

Open the layout's table of contents and click New Merged Project.

 

On the HTML Help tab, click the browse button (the yellow folder) and open the CHM file of the child project you published.

 

Click Yes when prompted.

 

Click the OK button to merge the CHM file.

 

The child project will appear in the Master project's TOC. 

Save your project and generate the layout. 

  

All that's left to do is deliver both CHM files as your help system.Whenever the child project changes, generate the CHM from the child project. Replace the CHM in the master project directory and generate your master project. You can also replace the child project CHM in the output directly.

 

***

Looking to learn RoboHelp? We offer a live, two-day online RoboHelp class once a month. Feel free to contact us to learn other ways to meet your RoboHelp training requirements.

Adobe Captivate: Six Ways to Use Voiceover Scripts

by Jennie Ruby 

 

I often point out in my classes on writing eLearning voiceover scripts that a script is necessary so that when you record the audio you don't skip anything, don't stumble, and don't say "um." However, using a voiceover script for eLearning is way more useful than just that.

Let's say for example that your eLearning project will be developed in Adobe Captivate. Captivate allows you to type--or copy and paste--the script into Slide Notes, similar to the slide notes you might be familiar with in PowerPoint. From there, you can use the notes in several different ways.

 

First, just as in PowerPoint, you can create handouts that print the Slide Notes along with an image of each slide, like this:

 

Second, if you are going to record the voiceover yourself, you can display the notes in the recording dialog box, like a miniature teleprompter, for your ease in recording the audio. At the bottom of the recording window, click the Captions & Slide Notes button to display the notes.

 
 

Third, if you are hiring voiceover talent to record the audio, you can provide the script to that professional, slide by slide, so that he or she can record the audio for each slide separately.

 

Then, fourth, once you either record the audio yourself or import the recordings from your voiceover talent, you may need closed captioning. Once you have pasted the voiceover script phrase by phrase into the Slide Notes pane, you can create the closed captioning just by clicking a check box.

 

And if you have accurately divided the script into phrases as shown above, it will automatically be synchronized with the audio. Below, you can see the yellow markers indicating the closed caption that goes with each audio segment.

 

Fifth, suppose instead of hiring voiceover talent and instead of recording the audio yourself, you decide to go with Text to Speech. Since Captivate comes with several high-quality computerized voices from NeoSpeech, this is a viable option. Just as with the closed captioning, creating the Text to Speech from the Slide Notes is very easy. In the Slide Notes pane, you click the TTS check box.

Then you open the Speech Management dialog box, where the Slide Notes are automatically imported, click the Generate Text button at the bottom, and you've got your voiceover audio.

 

And as before, to get closed captions with that, you just click the Audio CC check box.

Sixth, and finally, if you are creating accessible eLearning that is 508 compliant, then the final thing you can do from that one voiceover script is automatically import the Slide Notes to the Slide Accessibility dialog box. This contains the text to be read by screen readers, for those accessing the training through audio only.

 

So, let me count them up--yep, that would be six (6) ways to use a voiceover script to help in the development of eLearning with Adobe Captivate. By starting with a good voiceover script, you not only create a clear and well-planned audio, but you also save tons of work by using the script to automatically generate any or all of these aspects of your eLearning project.

Are your scripts up to the task? Join me for my afternoon mini course on how to write a good voiceover script.

***
Need more help with your script? Look for our hourly consulting service. We'll help you evaluate, substantively edit, or rewrite your voiceover script to make sure it is up to par.

Adobe Captivate: The Cure for Blurry Zoom Destinations

by Kevin Siegel   

 

Zoom Areas are typically used to emphasize an important area of a slide background. They are especially useful if you want your learner to automatically get closer to a specific area of the screen.

To insert a Zoom Area, click Objects on the Main Toolbar and choose Zoom Area.

 

Zoom Areas consist of two parts: the area of a background that you want to highlight (Zoom Source) and where the zoomed area of the background will appear (Zoom Destination).

 

In the image below, I have positioned and resized the Zoom Source over the area of the slide background that I want to get larger.

 

Then I positioned and resized the Zoom Destination on the slide. Remember, the Zoom Source won't move or resize when the lesson is viewed by the learner... that's the job of the Zoom Destination.



Right away you can see that there is a problem with the image in the Zoom Destination. Because a Zoom Area simply enlarges the Zoom Source, and I've resized the Zoom Destination quite a bit, the image in the Zoom Destination is blurry.

To fix the problem, you'll need a larger version of the image shown within the Zoom Source. In this case, I have the original photo of the handsome male model shown on the screen (in addition to being much larger, it has also been cropped similar to the image in the Zoom Source).

To swap out the blurry image in the Zoom Destination with the better image, double-click the Zoom Destination to open the Properties Inspector. On the Properties Inspector, click Add new image.

 

Click the Import button and open the larger version of the photo.



Compare the Zoom Destination below with the version above. The quality of the Zoom Destination image is much better.



If you would like to see a free demonstration of this concept, check out the IconLogic YouTube channel.

***

If you'd like to learn more about eLearning, come hang out in my next eLearning basics mini course. And if you'd like to learn more Captivate, Presenter, or Storyline, we've got a great collection of live, online classes for you.

Adobe RoboHelp: List Images

by Willam van Weelden  

 

When you create a list, there are several list styles you can use in RoboHelp: bullets, squares, lowercase alphabet, and numbers. But RoboHelp brings one more great feature: you can use images instead of bullets.

Create a List Style with Custom Images

1. On the Project Manager pod, double-click your style sheet to open the Styles dialog box.
2. Right-click List and choose New.
3. Enter a name for the list style and press [enter].
4. Click the Create a bulleted list button.
5. Select the list images option.
   
6. Click the browse button to open the Image dialog box.
   
7. Select the image you want to use as a bullet and click OK.
8. Then click the OK button to save your changes.

Apply an Image List Style

1. Open or create a topic, and then create a regular bulleted list.
2. Select the list.
3. Right-click and choose Bullets and Numbering.
4. Go to the Custom tab and select your list style in the left section.
   
5. Click the OK button to apply your list.

***

Looking to learn RoboHelp? We offer a live, two-day online RoboHelp class once a month. Feel free to contact us to learn other ways to meet your RoboHelp training requirements.

Adobe RoboHelp: Embed a Vimeo Video

by Willam van Weelden  

 

I have previously taught you how to embed YouTube videos in a RoboHelp project. While immensely popular, YouTube is not the only video site. This week, let's focus on embedding videos located on the Vimeo website.

First, access the Vimeo site, locate the video you'd like to use, and then click the Share button located on the video. 

Next, go to the Embed field and copy the embed code. 

Now that you've got the embed code copied, the rest of the work occurs in RoboHelp. Go ahead and open a RoboHelp topic, switch to HTML mode, and then paste the embed code in the topic as shown below. 

Lastly, you'll need to edit the HTML just a bit. In the src attribute, type http: in front of the url. 

Save the topic, generate the layout, and open the topic in your browser to see the embedded video.

Note: Vimeo includes a hyperlink with a description below the video. Retain this link unless you have the correct license for removing it.

***

Looking to learn RoboHelp? We offer a live, two-day online RoboHelp class once a month. Feel free to contact us to learn other ways to meet your RoboHelp training requirements.