Author Archive: nandinig

Tech Note on How to Repair Damaged RoboHelp 8 Projects

As you already know, RoboHelp Service Release 8.0.2 addresses the problem of slow performance and broken links in RoboHelp 8.

RoboHelp 8.0.2 update is now available through Adobe Update Manager (AUM). You can check for updates from the Help > Update menu in RoboHelp 8. This update is also available for download from RoboHelp Support Center.

Installing RoboHelp Service Release 8.0.1 followed by RoboHelp Service Release 8.0.2 addresses problems related to CPDs. However, you need to manually repair any damaged projects you have. See this tech note for the exact steps.

..

Adobe RoboHelp 8.0.2 – ‘Must Install’ Patch Available Now

RoboHelp Service Release 8.0.2 is available now. This is a ‘must apply’ service release. Make sure that you install the RoboHelp 8.0.1 update before installing the 8.0.2 update.

The 8.0.2 update addresses the following issues:
1. The CPD file grows in size and may result in slow performance.
2. The mouse cursor flickers in certain scenarios.
3. Deleting the CPD may result in scenarios where Project Manager reports broken links.

Both 8.0.1 and 8.0.2 updates are available for download here.

RoboHelp Support Center Page Updated with Links to Earlier Versions of RoboHelp Help

Many RoboHelp users who are yet to migrate to RoboHelp 8–the latest RoboHelp version–have had some difficulty in finding Help on RoboHelp 7. The good news is that they can now access the documentation for all key RoboHelp software components from the familiar RoboHelp Support Center page. The Reviewer’s Guide is also linked from this page.

Tweet to Help

Some days back, I spotted a tweet by Tom Johnson announcing his new post – Podcast on the Seven Deadly Sins of Blogging. I know that I have been a sinner, not having updated my blog for over a month.
Nowadays, I spend a good part of my day keeping an eye on my Twitter home. My primary intent is to play the information facilitator for RoboHelp, the Adobe product I document. Twitter gives me the means to shout out updates, new tools, hidden features, and events.
I follow the power users of RoboHelp on Twitter and easily get information when they post new content on the web. My job then is to map that content to core Help topics and add the links so that other users can benefit from this supplementary content.

Step 1: Spot the announcement of a useful post.

tweet_colum.jpg

Step 2: Identify the relevant topic in Help and add a link to the post.

comment_web.jpg

Step 3: Tweet about the Help update.

tweet_nandini_web.jpg

Twitter gets me thinking – in different directions. Every now and then, I get derailed and something non-RoboHelp catches my attention. I spot ‘cloud computing’ and become curious to find out about what the world is thinking about documentation for SaaS applications.
Johnson’s posts reassured me that these occasional detours are a necessary part of the social networking experience that we are seeking as corporate tweeters and bloggers. They broaden our interests, update us on the trends, and prepare us to create relevant and interesting posts (being irrelevant and being boring are two of the seven sins Johnson talks about).
You can check out Johnson’s blog for the other five sins. Meanwhile, what are the seven deadly sins of tweeting?

MAX Awards Finalists

If you’re a multimedia enthusiast, don’t miss the entries chosen as MAX Awards finalists. Watch the videos selected in each of the eight categories and vote your favorite.
Voting ends on October 6th, at 12:00 noon PDT.

New Adobe TV

The well-stocked Adobe TV has always been a great source for learning Adobe products. The new version that went live a couple of days back is packed with cool new features that you’ll love. Here are some top ones:

• Customizable homepage
• Improved navigation and search
• Save your favorite episodes to “My Library”
• Share videos on social networking sites
• Subscribe to the RSS feeds of your favorite shows
• Pop-out video player to view videos at any size
• Commenting and rating
• Tags

Check out the latest on Adobe TV.

Adobe Help Events at MAX

At MAX next month, Adobe is putting together some sessions with snacks and drinks to get feedback on the new version of Community Help. Get a sneak preview. The new Community Help has an all new AIR interface and some exciting new features.

The sessions will be held at these times:
• Monday 10/5/09 11:30 am – 1 pm
• Tuesday 10/6/09 4:30 pm – 6 pm

Please contact tknoop@adobe.com if you think you can make either of these sessions at MAX and she’ll send you more details.

Creating a Multi-Module Adobe Captivate 4 Movie with a TOC

Typically, when you create a multi-module course, you add a menu to support a user-driven learning path. When users can study the modules in any order or when a course has many modules, adding a visual clue to indicate user progress helps.

In Captivate 4, you can create a multi-module course that supports a user-driven learning path and also gives a visual clue (a checkmark) when a user completes a module by simply adding a TOC to the movie.

The steps to create a TOC are here.

If you are using a menu to create a multi-module course, check this article by Isaac Tabe. Isaac gives step-by-step instructions to show checkmarks on the menu slide of a multi-module Captivate movie based on user progress. The solution uses variables and advanced actions, a powerful way to add complex interactivity in your Captivate movie.

For more information on variables and advanced actions, see Captivate Help.

Mini TOC Placeholder in RoboHelp

With RoboHelp, you can automatically generate mini TOCs in long articles with many subsections.

minitoc.jpg

Here’s Benny Joseph, my colleague at Adobe and a RoboHelp pro, on when to use the mini TOC placeholder and how:

Consider the following when you create and apply master pages with mini TOC in your RoboHelp project:
Need for mini TOC: Many topics could contain only one coherent topic, which does not require structuring through sub headings or bookmarks within the topic. For such topics, a mini TOC might not be required. You can create a separate master page without the mini TOC placeholder and apply it to such topics to avoid the mini TOC from appearing.

Topic Length: If your article is a large topic with many subsections, the mini TOC could appear long and nested. In such cases, try to restructure and divide the content and in multiple topics. For example, if you use lower heading levels such as Heading 5 and Heading 6 to highlight definition lists, try to bunch them under a higher level heading, and apply paragraph styles other than heading styles.

Number of levels: RoboHelp includes heading levels 2 through 6 in the mini TOC by default. However, if the topics have a large number of lower-level heading styles, the mini TOCs generated on these pages can become long and deeply nested. To avoid this, limit the number of levels in the mini TOC to have a shorter mini TOC that gives a quick overview of your topic contents.

Placement: Even though you can place a mini TOC placeholder in a topic or a master page, use the master page option if your project is large or you are updating an existing project. Inserting a mini TOC placeholder in each topic can be time-consuming, whereas you can apply a master page with a mini TOC placeholder to large projects at one go.

Adobe Community Publishing 1.1 beta

If you refer to Adobe documentation on the web, you know you can sign in with your Adobe ID and add your comments to any Help topic. Experts designated as moderators answer your queries.
With the release of Adobe Community Publishing 1.1 beta, Adobe has taken another huge step in encouraging community participation.
Community members can contribute tips, movies, code snippets and more with easy-to-use templates. Contributions are moderated by community experts. Plus, everyone in the community can rate and comment on contributions.
To add a contribution, follow these steps:

  1. Download the Community Publishing app: http://www.adobe.com/community/publishing/download.html
  2. Author your tip using a simple template
  3. Publish it to adobe.com

Content goes live within minutes and is automatically added to community help search.

Check out this useful tip added recently by RoboHelp moderator Peter Grainge.

For all tips, see http://www.adobe.com/community/publishing.