Adobe RoboHelp: Show Variables in Topics

by Willam Van Weelden Follow us on Twitter View our profile on LinkedIn

In previous articles you've learned about RoboHelp's User Defined Variables (how to create themgroup them, and use them in topic titles).

As a brief review, variables can contain information that occurs frequently in your project, such as a product name, company name, or copyright notice. After creating the variable, you can insert it into any RoboHelp topic or onto a template by simply dragging and dropping. Now here's the cool part. Assume your company name now appears throughout your project and now you want to change it. Without the variable, you would have to search your entire project and update the company name. Thanks to variables, all you will need to do is update the definition of the CompanyName variable, and you will change the displayed company name project-wide in just a few seconds.

One issue you'll come across when inserting variables within a topic is that, by default, the variable text looks like regular topic text. In the picture below, I challenge you to locate the variable. 

Adobe RoboHelp: Find the variable text  

Did you find the variable text? I'm betting that the answer is no. So what's the big deal? This can be particularly frustrating if you need to replace regular text with a variable. For example, you can highlight regular text in a topic and convert it to a variable by dragging the variable on top of the text. That's an awesome feature. Before I begin however, I need to be able to tell, at a glance, if the text I'm looking to replace is already a variable. As it stands, I have no idea since I cannot tell the difference between a variable and regular text.

Luckily, RoboHelp has a handy feature that allows you to distinguish between variables and regular text in topics. To enable this feature, simply choose View > Show > Fields.

Adobe RoboHelp: Color coding for Variable Text. 

Voila. All variables in topics are now shown as green text. Best of all, variables only show up green in your project… when you generate a layout, the green color will not be visible to your users.

***

Looking for instructor-led training on RoboHelp? We offer live, online training once each month. We can also bring the same great training onsite to your facility. Interested? Contact us for details.

Adobe Captivate 8: Responsive Projects for mLearning

by Kevin Siegel Follow us on Twitter View our profile on LinkedIn View our videos on YouTube

Creating eLearning for mobile devices was high on the wish list a few years ago when Adobe asked users for the top features they'd like to see added to Adobe Captivate. It wasn't long before Adobe responded by adding HTML5 as a publishing option. HTML5 allowed developers to create interactive content that can be used by mobile learners who have a device that does not support Flash.

Publishing HTML5 solved the issue of creating interactive eLearning on the iPad. But there remained another problem. The size of the screen that learners use can vary widely. Your eLearning lesson might look perfect on a desktop system but might be too small when viewed on a small device (such as a smart phone). To accommodate the many screen sizes, your only recourse was to develop several Captivate projects, sized specifically to work on each screen size. Of course that also meant that you'd have to edit and update several projects. No thanks!
 
Adobe Captivate 8 now allows you to create responsive projects. During the development process, you can basically create and work on multiple screen sizes (called break points) in one project. When you publish the responsive project, the learner will automatically be served the break point appropriate for the device they're using. This one Captivate 8 feature is the main, compelling reason that upgrading to Captivate 8 isn't just something to consider… it's mandatory if your mission is to create eLearning for desktop and mobile users.
 
To create a responsive project, double-click Responsive Project on the Welcome screen or choose File > New > Responsive Project.
 
Adobe Captivate: Responsive Projects
 
Developing a responsive project is pretty much the same as developing a standard project, but there's one notable difference–breakpoints. By default, new projects contain three breakpoints for the most common screen sizes (for desktop users, tablet users, and smart phone users). You can click each of the breakpoints to see how the layout changes dependent upon the size of the canvas.
Adobe Captivate: Default breakpoints 
 
In the images below, I've selected each of the default break points I was given in my new project (you can create as many break points as you need and edit existing break points at any time).
Adobe Captivate: Breakpoint for a desktop user.
 

Adobe Captivate: Breakpoint for a tablet user.

Adobe Captivate: Layout for a smart phone 

In the images below, you can see a responsive project developed by Anita Horsley, and how she designed each canvas to work best with each of her break points. (As you review each image, pay particular attention to the position of the character as each break point is selected.)

Adobe Captivate: Breakpoint for a desktop user.
Desktop user: 1024 pixels wide.

Tablet user: 768 pixels wide.

Mobile user: 360 pixels

Once you're done laying out each canvas, all you need to do is publish and post the lesson to a web server or LMS just like always. When the lesson is accessed by your learner, the lesson will automatically detect the learner's screen size and the correct canvas will be displayed. Awesome!

***

Want to learn more about creating responsive projects? Join our3-hour mini course on creating Responsive Layouts with Adobe Captivate.
 
***
Looking for instructor-led training on the top eLearning tools? We offer live, online training on Adobe Captivate, Articulate Storyline, Adobe Presenter, and TechSmith Camtasia Studio. We can also bring the same great training onsite to your facility. Interested? Contact us for details.
 

Adobe Captivate: Kill the Click Sounds

by Kevin Siegel Follow us on Twitter View our profile on LinkedIn View our videos on YouTube

I received an email from a new Captivate developer who was having a hate-hate relationship with the click sounds he was hearing in his Adobe Captivate demonstrations and simulations. He told me that in his demonstrations, the mouse was making an obnoxious click sound when a click occurred. In his simulations, the same click sound was heard every time the learner clicked a click box. 

The developer was desperate to disable the mouse-click sounds in his projects but was unable to find the option in Captivate's Preferences. While looking in Captivate's Preferences seems like a logical place to look for the click sound option, it's not there. Nevertheless, the solution is very simple. Here's how you disable the click sounds for the mouse, click boxes, and buttons.
To disable the mouse click sound in a software demonstration, select the mouse pointer on any slide. On the Properties panel,Options group, deselect Mouse Click Sound
Adobe Captivate: Turn Off Mouse Click Sound
 
To remove the click sound from every mouse pointer in the project, click the drop-down menu in the upper right of the Options group and choose Apply to all items of this type.
 

Adobe Captivate: Apply to all items of this type.  

If you've created a software simulation with click boxes, you can easily get rid of the click sound for a single click box, or all of the click boxes in the project. First, select a click box on any slide. Then, on the Properties panel, Options group, select Disable click sound

To disable the click box sound.

If you'd like this change to affect every click box in the project, click the drop-down menu in the upper right of the Options group and choose Apply to all items of this type.

 
Adobe Captivate: Apply to all items of this type.

If you'd like to see a demonstration showing how to remove the mouse click sound from interactive objects and the mouse, check out the video I created on IconLogic's YouTube channel.

***

Looking for instructor-led training on the top eLearning tools? We offer live, online training on Adobe Captivate, Articulate Storyline, Adobe Presenter, and TechSmith Camtasia Studio. We can also bring the same great training onsite to your facility. Interested?Contact us for details.

Adobe RoboHelp: Assigning Master Pages to Word Sections

by Willam Van Weelden Follow us on Twitter View our profile on LinkedIn

A few weeks ago I showed you how you can use master pages to control the headers and footers of a generated Microsoft Word document. But setting a single header and footer for your entire Word document may not be what you need. The Table of Contents may need a different header and footer than the actual content. Perhaps the even and odd pages require different headers and footers. With RoboHelp 11 you can use different master pages for different sections of your Microsoft Word output.

After you have created multiple master pages, you assign these master pages to different sections of the document:

  1. Open the Single Source Layouts pod (View > Pods > Single Source Layouts).
  2. Double-click a Printed Documentation layout to open the Print Document options.
  3. Click Multiple Header/Footer to open the configuration dialog box.
    Adobe RoboHelp: Multiple Header/Footer button  
  4. Select a section in the left side of the popup.
  5. From the First Page drop-down menu, choose a master page.
  6. From the Even Pages and Odd Pages drop-down menus, choose a master page.
    Adobe RoboHelp: Configuration dialog box  
  7. Repeat these steps for all of the sections of the document.
  8. Click OK to return to Print Document options.
  9. Click Save and Generate to create a Microsoft Word document.
    Adobe RoboHelp: Word document  

***

Looking for instructor-led training on RoboHelp? We offer live, online training once each month. We can also bring the same great training onsite to your facility. Interested? Contact us for details.

Adobe Captivate: Sometimes a Smooth Mouse Path Isn’t So Slick

by Kevin Siegel Follow us on Twitter View our profile on LinkedIn View our videos on YouTube

I've written a few articles about Captivate's video mode including how to trim videos, use the Pan and Zoom feature, how to edit the mouse points, and how to publish video demos.

I received an email from a fellow Captivate developer who really liked creating eLearning using Video Demo mode but was lamenting the slow speed of the mouse.

"I was previewing the project. You could hear my voiceover audio and could see the mouse moving from point A to B," she said, "But the mouse was moving really, really slowly. The speed was fine a few days earlier but now it's so slow it's distracting."

The developer was sure she'd done something to the video to mess up the mouse tracking speed but was stymied to explain the exact cause of the trouble.

I asked her if she had trimmed the video.

"Why yes," she replied. "I watched your video on YouTube to learn how."

And with that, I had the reason for her troubles and the solution.

For whatever reason, when you trim a Captivate video, the mouse speed shown in the video after the trim point often reduces to a crawl. While I don't know why this happens, I do have a solution.

Choose Edit > Edit Mouse Points. On the Timeline, select the first mouse point after the trimmed section of the video.

Adobe Captivate: Mouse point selected on the Timeline. 

On the Properties panel, deselect Smoothen Mouse Path (Smoothen? Anyone think the option should be named Smooth instead of Smoothen?).

Adobe Captivate: Smoothen Mouse Path  

If you preview the video, you'll see that the mouse speed returns to its pre-trimmed speed. While you may need to repeat this process every time you trim a Captivate video, at least it's fast and painless.

It you'd like to see a slow mouse in action and how deselecting Smoothen Mouse Path fixes things, check out the video I created on IconLogic's YouTube channel.

***

Looking for instructor-led training on the top eLearning tools? We offer live, online training on Adobe Captivate, Articulate Storyline, Adobe Presenter, and TechSmith Camtasia Studio.We can also bring the same great training onsite to your facility. Interested? Contact us for details.

User Assistance: HUDs in Technical Communication

by Tony Self Follow us on Twitter View our profile on LinkedIn
 
Did you ever see the 1986 movie "Top Gun?" If so, perhaps you recall seeing gun-sights, cross-hairs, warning messages, and air speeds displayed as green text on the cockpit windshield of the jets. What you saw in the movie was an early Head Up Display (HUD). If Top Gun is too old for you, how about Iron Man? HUD was featured prominently in that movie as well.

While HUDs may seem like something you'll find only in fighter jets or the movies, they are actually creeping into everyday life. For instance, HUDs are now installed as standard equipment in many cars displaying speed, distance, and messages onto the windshield. Drivers don't need to move their head up or down to read the text; they can keep looking straight ahead.

If your car isn't equipped with a HUD, you can use your smart phone, download a HUD app, place the phone on the dashboard, and reflect an inverted readout onto the windshield. And you can purchase HUD navigation systems (such as the unit shown below from Garmin).

Garmin HUD   

There's a new type of HUD that's attracting lots of attention: Google Glass. Glass isn't the only product of its type on the market (there are dozens), but it attracts the most publicity. These wearable technology products display text in a tiny HUD in a pair of lens-less spectacles. The text displayed depends on the application; it could be the current time, an appointment, alerts… but it could also be procedural information, checklists, or product descriptions.

What does HUD technology have to do with technical communication? HUDs will provide innovative new ways to deliver technical information. For instance, Virgin Atlantic is currently testing Google Glass at Heathrow Airport. According to CNN, "The airline is conducting a six-week experiment with the wearable technology for passengers in its Upper Class Lounge at London. With data flashing before their eyes, staff can update customers on their latest flight information, as well as weather and events at their destination."

Google Glass being tested at Virgin Atlantic

 Source: CNN

If the Virgin Atlantic tests prove successful, the opportunities for technical communicators are endless. Beyond simply documenting HUD devices and applications, technical documentation and eLearning content could actually be displayed on a HUD. There will be challenges of course. Writers looking to create content for HUDs will need to embrace writing techniques such as minimalism and separation of content and form. Nevertheless, it will be possible for technical communicators to one day deliver to this new media… a layer above reality. 

eLearning & Training: How Long is Too Long?

by Kevin Siegel Follow us on Twitter View our profile on LinkedIn View our videos on YouTube

You can create the best-looking, most well-written eLearning lesson anyone has ever seen. But for the lesson to be effective, one of the most important things to keep in mind is that more does not mean better. If your lesson plays too long, you run the risk of losing the attention span of your learner and lowering the effectiveness of the lesson in general.

So how long is too long? The answer is directly tied to the average attention span of an adult learner. According to Joan Middendorf and Alan Kalish, Indiana University, "Adult learners can keep tuned in to a lecture for no more than 15 to 20 minutes at a time."

In their excellent article, The 'Change-Up' in Lectures, Middendorf and Kalish found that after three to five minutes of 'settling down' at the start of class, a lapse of attention usually occurred 10 to 18 minutes later. As the lecture proceeded the attention span became shorter and often fell to three or four minutes towards the end of a standard lecture.

I have been teaching classes for nearly 30 years (both online and in-person). Keeping my students engaged (and awake) has always been a top concern. Here's one final quote from the Middendorf and Kalish article (and it's something to which any trainer can relate). One of their colleagues attended a class and observed the following: 

"I sat in the back of the classroom, observing and taking careful notes as usual. The class had started at one o'clock. The student sitting in front of me took copious notes until 1:20. Then he just nodded off. The student sat motionless, with eyes shut for about a minute and a half, pen still poised. Then he awoke and continued his rapid note-taking as if he hadn't missed a beat."

In the 1800s, people had very good attention spans. In her article, Keeping Pace with Today's Quick BrainsKathie F. Nunley cited the Lincoln-Douglas debates which were literally read from paper and lasted for hours. Nunley said that "people stayed, listened, and paid attention."

Back in the Lincoln-Douglas days, there was less competition for the attention span of the debate attendees. But what about today? Why are attention spans getting shorter? More likely than not the culprit is the distractions and experiences of modern daily life.

"Today's mind, young or old, is continuously bombarded with new and novel experiences. Rather than novel opportunities every few days or weeks, we now have novelty presented in micro-seconds," said Nunley.

eLearning and the Common Goldfish

So eLearning lessons can last anywhere between 15 and 20 minutes and still be effective, yes? Ummm, no. The 15-20 minute range was for an in-person classroom with a live trainer. The times are just a bit different when it comes to asynchronous eLearning lessons that will be accessed over the Internet. 

According to the article Turning into Digital Goldfish, "The addictive nature of web browsing can leave you with an attention span of a goldfish."

Granted, a learner accessing your eLearning lesson will have a greater attention span than a typical web surfer–or even a goldfish. However, in my experience developing eLearning, I put the attention span of an adult learner at 15-20 seconds per slide or scene. If the slide/scene plays any longer, your learner will begin to fog out.

I know what you're thinking: 15-20 seconds is not enough time to teach anything. If your slide contains some voiceover audio, a text caption or two, and an interactive object controlling navigation (such as a button or click box), 15-20 seconds is perfect. Your student will have enough time to understand and absorb the content before moving on to the next slide.

I encourage students who attend my eLearning classes to try to chunk a one-hour eLearning course into several short eLearning lessons. That would translate into 12 Captivate eLearning lessons (if you use the 5 minute-per-lesson timing) for the 60-minute course.

What do you think? Is 3-5 minutes the right amount of timing for an eLearning module? I'd love to see your opinion as comments below.

***

Looking for instructor-led training on the top eLearning tools? We offer live, online training on Adobe Captivate, Articulate Storyline, Adobe Presenter, and TechSmith Camtasia Studio.We can also bring the same great training onsite to your facility. Interested? Contact us for details.

eLearning: Is Right-Clicking Right?

by Kevin Siegel Follow us on Twitter View our profile on LinkedIn View our videos on YouTube

Most computer programs offer multiple ways to accomplish any one task. For instance, in Microsoft Word you can make a selected word bold using a menu, a toolbar button, pressing a keyboard shortcut, or by right-clicking the text.

If you're responsible for creating a software simulation that teaches a learner how to make Word text bold, which of the commands are you going to simulate? While you could simulate multiple options, I'd encourage you to focus on just one (adding multiple options is going to take you too long to produce). Personally, I'd simulate the menu option or the toolbar button. However, many people love right-clicking, and I'm betting you'd love to add that option to your eLearning lesson.
 
You'll be happy to learn that both Adobe Captivate and Articulate Storyline allow you to easily add right-click functionality to software simulations. If you're using Captivate, show the Properties of a Click Box, and, on the Options tab, select the Right-click check box.
 
Adobe Captivate: Adding a right-click to a click box.
 
If you're using Storyline, select an object and, on the Triggers panel, create a new Trigger. From the When drop-down menu, choose User right clicks from the list of click events.
 
Articulate Storyline: Adding a right-click Trigger
 
While adding a right-click to your eLearning lesson is easy, I'd like to offer a few things to think about before you move forward. First, the Captivate and Storyline forums are littered with frantic posts from developers who cannot get the right-click functionality to work. Developers report that the right-click feature works when the lesson is previewed, but doesn't work when published. It turns out that the right-click feature doesn't usually work when the published lesson is tested locally but is fine when posted and tested via a web server or Learning Management System.
 
When accessed by your learners, there are instances when the right-click feature simply will not work, or it will be difficult to use. For instance, if you're a Captivate developer you can publish a lesson as a PDF. When the PDF is opened in Adobe Reader or Acrobat, the software captures the right-click and it won't work as you intended when you added it to the simulation.
 
How about an eLearning lesson that's opened by a Macintosh? While some Mac users will have a mouse that can handle a right-click, others do not support right-clicking at all. (As an alternative to using the mouse to right-click, Mac users can get a right-click menu to appear by pressing [control] when clicking. Nevertheless, some Mac users won't know that keyboard alternative unless you tell them about it.) 
 
If your learners are using a mobile device (such as an iPad), there's no right-click gesture. If your simulation tells an iPad user to right-click to perform a step within your simulation, the iPad user could get stuck.
 
Lastly, if you are required to provide 508 compliant eLearning for learners with disabilities, right-clicking isn't supported at all. Bottom line: unless it's absolutely necessary for the success of your eLearning simulation, I suggest you pass on using right-click functionality. (Showing a right-click in a software demonstration is fine, but not a simulation.)

What's your take on right-clicking? Do you use it? If not, why not? Feel free to share your opinions here

***

Looking for instructor-led training on the top eLearning tools? We offer live, online training on Adobe Captivate, Articulate Storyline, Adobe Presenter, and TechSmith Camtasia Studio.We can also bring the same great training onsite to your facility. Interested? Contact us for details.

eLearning & Presentations: More Free Images. A MILLION more!

by AJ Walther Follow us on Twitter View our profile on LinkedIn

Want more free images for your eLearning or PowerPoint presentations? How about over a MILLION more? In December of last year, the British Library released into the public domain a huge collection of scanned images from more than 65,000 books spanning the 16th to 19th centuries. Yes, that's right, I said public domain. That means these images are free to use, share, and modify in any way that you see fit. The library asks only that you help to populate the metadata for the images to help make them more easily searchable–and to help spread the knowledge.

Free image 

The project is called the Mechanical Curator and is housed on a tumblr page that purports to post a randomly selected small illustration or ornamentation from these antiquated books. All of the images can be found on the British Library's flickr feed

Another free image  

Think these images are a little too old school for anything you'll be designing? Think again. Just for funsies I threw together a little eLearning layout by using the British Library's free images. Here's what I came up with:

Free images used in an eLearning project

The great thing about these images is that most all of them go together cohesively. And that "B" I used? I was able to find every letter I searched for, in a variety of styles. That could lead to endless designs… for free! Design on, friends.

See also:

Adobe Captivate: Bookmarking Without an LMS

by Kevin Siegel Follow us on Twitter View our profile on LinkedIn View our videos on YouTube

Bookmarking a lesson provides the learner an opportunity to continue viewing a lesson from the exact spot where they left off. If you've uploaded your eLearning lesson into a Learning Management System, bookmarking is enabled by default in every lesson that you publish. 

If you're not working with an LMS and you still want to enable bookmarking, you're out of luck, right? Not exactly. With a few simple clicks, you can enable bookmarking within any Captivate project. Once enabled, learners will see the following message should they close their web browser while your eLearning lesson and then return at a later time.
 
Adobe Captivate: Bookmarking message
 
Enable Bookmarking (Self-Paced Learning)

  1. Open or create a Captivate project and choose Project > Table of Contents. (The Skin Editor Window opens.)
  2. From the left of the Skin Editor Window, select Show TOC.
    Adobe Captivate: Show TOC  
  3. From the bottom of the window, click the Settingsbutton. (The TOC Settings dialog box opens.)
    Adobe Captivate: TOC Settings  
  4. From the Runtime Options area, select Self-Paced Learning.
    Adobe Captivate: Self-Paced Learning   
  5. Click the OK button.

By enabling Self-Paced Learning, you have basically activated Captivate's bookmarking feature. You can test the bookmarking by publishing the project and then opening the HTML file with any web browser.

Move through a few slides in the lesson and then close the browser window. Reopen the HTML file and instead of the lesson simply starting over from the beginning, you (and your learners) will see the "Continue from where you stopped last time?" message shown below. How cool is that?

Adobe Captivate: Bookmarking message

If you'd like to see the Self-Paced Learning option in action, check out the video I created on the IconLogic YouTube channel.

***

Looking for instructor-led training on the top eLearning tools? We offer live, online training on Adobe Captivate, Articulate Storyline, Adobe Presenter, and TechSmith Camtasia Studio.We can also bring the same great training onsite to your facility. Interested? Contact us for details.