Adobe RoboHelp 11: Sharing Resources via Dropbox

by Kevin Siegel Follow us on Twitter View our profile on LinkedIn View our videos on YouTube
 
Adobe released Adobe RoboHelp 11 last week. Over the next few weeks, I'll be covering some of hottest new features. This week: sharing resources via the Cloud (specifically, with Dropbox).
 
Sharing resources isn't a new concept in RoboHelp. In fact, the Resource Manager pod has been around for the past few versions of RoboHelp. What's new in RoboHelp 11 is the ability to specify a Dropbox as a folder on the Resource Manager.
 
To begin, visited Dropbox.com and created an account. I also created a folder in Dropbox and set it up as a share object (both tasks, creating and sharing the folder, were simple and took mere seconds).
 
Once my Dropbox account had been set up, I started RoboHelp 11 and chose View > Pods > Resource Manager. From the top of the Resource Manager pod, I clicked the Add Shared Location tool.
 

In the Add Shared Location dialog box, I clicked theLocation type drop-down menu and selected Dropbox. (Each time I've performed this step over the past few weeks, RoboHelp has consistently loaded my Dropbox folder and Path for me. Alternatively, you can click the Browse button and manually locate your Dropbox folder.)

 
The next step was to add content to my shared Dropbox folder on the RoboHelp Resource Manager. My shared Dropbox folder is called SharedRoboHelpTopics. When I dragged a topic (Alcohol_Policy) to the shared folder, I was delighted to see that in addition to the topic, the Cascading Style Sheet being used by the topic (policies.css) was also added to the shared folder.
 
 
One of my team members (Biff Bifferson), who is located in another state, was working on a RoboHelp project and needed to use some of my content. While we don't share a network connection, we both have Dropbox accounts. I accessed my Dropbox account and sent Biff an invite to my SharedRoboHelpTopics folder.
 
Biff checked his email and added the SharedRoboHelpTopics folder to his Dropbox. Biff then used RoboHelp's Resource Manager pod to add his Dropbox as a Shared Location.

 
Since his Dropbox included my shared folder, Biff's Resource Manager immediately displayed my shared resources.
 
 
To add my shared content to his RoboHelp project, Biff right-clicked the Alcohol_Policy topic on the Resource Manager pod and chose Add to Project.
 
 
Like magic, my content was now being used in two projects in two different locations. What do you think? Cool?
 
But then… then… I edited the topic on my computer. (I know, crazy right?)
 
 
My Resource Manager alerted me that my shared assets weren't synchronized (via the red icon shown in the image below). When content isn't synchronized, it's likely that team members aren't using the same content.
 
 
Because I wanted to ensure that both Biff and I were working with the same assets, I right-clicked the topic on my Resources Manager and selected Sync.
 
 
Green check marks indicated that all was well between the content in my RoboHelp project and the assets in my Dropbox. But I was curious to learn if Biff actually got the updated content in his project. And if so, what was his experience? Was it painful?
 
 
It turns out that Biff's experience was almost, well, routine. He told me that when he opened his project with RoboHelp 11 later that day, he was greeted with the Linked Resource Notification dialog box shown below. All he had to do was click the Update button and his content was automatically synchronized with mine. In a word… that's awesome!
 

***

Looking for training on Adobe RoboHelp? IconLogic offers live, online Adobe RoboHelp classes each month for both RoboHelp 10 and the new RoboHelp 11. We can also bring the same great training onsite to your facility. Interested? Contact us for details.

Adobe RoboHelp: Using Images in Variables

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

Variable sets, which I've written about previously, allow you to define groups of definitions for a variable which allows you to easily support differently branded products from a single RoboHelp project. This week I want to show you another cool variables feature: images.

You can easily reuse images in multiple RoboHelp topics. Since the images that appear in the topics are linked externally to the original image, when you edit the original image, all of the RoboHelp topics are updated automatically. One drawback to this global update is that it only works if you use the same image in all of the generated layouts.

You can make your life even easier by adding images to variables. Take a logo for example. Many customers require that their software is personalized. For example, the application must use the client's brand colors and logo. By adding a logo to a variable and using variable sets, you can easily change the branding used in your Help content.

Add an Image to a Variable

  1. Open the User Defined Variables pod. (View > Pods > User Defined Variables).
  2. Select a variable (in the image below, I've selected a variable that I created called Logo).
    Adobe RoboHelp: Variable selected
  3. Choose Insert > Image.
  4. Select an image and then click OK.
    Adobe RoboHelp: Image selected

The image is added to the variable. At this point, you can use the variable within any topic, just like a typical variable.

Adobe RoboHelp: Image added to a variable

See also: Working with variables and adding variables to topic titles.

***

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 FrameMaker: Nested Lists

by Barb Binder Follow us on Twitter View our profile on LinkedIn

A recent FrameMaker student contacted me with a numbering dilemma:

I am working with a two-level list. The first level uses numbers and the second list uses letters. The numbers start out correctly, as do the letters; but when I go back to numbers, things get wacky. What is going on? Here's what my list looks like:

The obvious problem is that the numbers are increasing incorrectly, but why? The numbered list is picking up from where the lettered list left off. The letter "e" is the fifth letter of the alphabet. When FrameMaker sees the <n+> in the next paragraph, it adds one to the counter value and displays a 6.

The trick is to look at the numbers as columns. I'll sketch them out on paper. This one is fairly straightforward and just needs two columns of building blocks along with the series label. Here's how numbering properties should look for each of these paragraph formats:

Adobe FrameMaker: Sketch out your lists.

Series Label. The series label tells FrameMaker that these two paragraph formats are part of the same numbering series. While I used S for a series of steps, any uppercase letter will work as a Series Label.

List 123. The <n+>. building block in the first column will add one to the current counter and display the result as a number followed by a period. The < =0> building block resets the second column counter back to 0 for each new sub-list, but the space says not to show the 0.

Adobe FrameMaker: List 123

List abc. The < > holds the counter value in the first column (it won't increment), but the space says not to display the value. The <a+>. in the second column adds one to the current counter value (which was reset to 0 in the previous paragraph) and displays the result as a letter.

Adobe FrameMaker: List ABC

The result?

Adobe FrameMaker: Nest list working correctly.

Note: Setting up just these two tags assumes you are using another paragraph to restart the numeric counter. For more information on restarting lists, see "Adobe FrameMaker: How to Restart a Numbered List."

***

Looking to learn FrameMaker? We offer both beginner and advanced FrameMaker training.