Adobe RoboHelp 2022: Update 2 Now Available

Fresh on the heels of Adobe releasing update 1 for RoboHelp 2022, there's a new update. Normally, updates can be accessed by going to the RoboHelp Help menu and choosing Check for Updates. You won't get the update that way this time. Instead, head over to the following website and download the update manually: https://helpx.adobe.com/robohelp/using/whats-new-robohelp-2022-release-update-2.html.

After installing the update, you'll know you're up-to-date by choosing Help.

Robohelp-2022-update-2

Here's a list of the bug fixes:

Application

  • When changing topics on the Style panel, the stickiness of the Preview button does not work as expected. (Bug ID: 11471)

Publishing

    General

  • In the German locale, after setting Publish Profiles for File System, the error message "Invalid destination path" displays. (Bug ID: 11482)  

   PDF output

  • Sometimes, the PDF metadata is missing after upgrading from Adobe RoboHelp 2022. (Bug ID: 11460)
  • A notice about the evaluation version of the PDF reactor is displayed when using the Save As PDF option. (Bug ID: 11473)
  • Headings are missing for Front Matter and Back Matter items in TOC. (Bug ID: 11492)
  • In the PDF template, the Use Headings up to Level option under TOC Structure is not working. (Bug ID: 11495)

Translation

  • Project files (.rhpj), PDF, and Word template files (.plt and .wlt) are not exported during translation. (Bug ID: 11502)

ADOBE ROBOHELP: Getting Around Preview Errors

by Willam van Weelden, COTP

RoboHelp is an awesome help authoring tool. However, even the best tools misbehave.

While working with RoboHelp, you are likely to come across error message from time to time. For instance, atsome point you'll likely be tasked with customizing a Screen Layout.

You can access RoboHelp's Screen Layout Editor by visiting the Output Setup pod. (Projects > Pods > Output Setup). From there, expand the Screen Layouts and double-click the layout you want to edit.

You can make all kinds of changes to a layout including modifying its colors and images. During the editing process, it’s reasonable to assume that you’ll want to see a Preview. For this, the Screen Layout Editor has a Save and Preview button in the bottom right of the dialog box.

When attempting to show the preview, you'll likely see the following error message:

 
 
If you encounter the error, don’t panic. The error is caused by an internal script error; you haven't done anything wrong. You can simply click the Yes button to continue. (If the same message appears again, click Yes again.)

The preview will open. Unfortunately, if you click anything within the Preview window (such as a different topic), the same error message will appear.

I don't know about you, but I'd prefer to avoid all of these error message. Go ahead and click the Save and Preview button. Then, from the upper-left of the Preview, click the View with button and select your browser of choice. The preview will open in your browser without additional error messages.

 
 
***
 
If you'd like to learn how to use RoboHelp, check out Willam's live, online RoboHelp classes.
 
***
 
Willam van Weelden is a Certified Online Training Professional (COTP), veteran Help Author, RoboHelp consultant, and technical writer based in the Netherlands. He is an Adobe Community Professional, ranking him among the world's leading experts on RoboHelp. Willam’s specialties are HTML5 and RoboHelp automation. Apart from RoboHelp, Willam also has experience with other technical communications applications such as Adobe Captivate and Adobe FrameMaker.

ADOBE ROBOHELP: Publish to SharePoint

by Willam Van Weelden, COTP

You can host output from Adobe RoboHelp on multiple hosting platforms. When your company uses SharePoint, you can even leverage the power of SharePoint to host your help.
 
Leveraging SharePoint has a major benefit: Access control. Using SharePoint’s access control of document libraries, you can control who in your organisation can view your help system. Note that access is limited to people who have access to SharePoint, so that generally rules out clients and customers without a login to your corporate network.
 
Before you publish to SharePoint, make sure you have a Document Library in SharePoint where you have read and write rights.
 
Set up a SharePoint output
 
To create an output for SharePoint, the best results are achieved with Responsive HTML5 special SharePoint output. In the Single Source Layout settings, go to the SharePoint page. At the bottom, expand the Advanced Options section and select Generate SharePoint Native Output before Publishing.
 
 
Simply generate your output. RoboHelp will create two folders: the normal output and the SharePoint output:
 
 
Publish to SharePoint
 
RoboHelp has a built-in feature for publishing to SharePoint. Unfortunately, it only supports SharePoint 2007 and 2010/2013 on premises. If you are using SharePoint Online, the best option is to open the document library, and drag and drop the RoboHelp output. Alternatively, use the Upload Folder feature in SharePoint to upload the project.
 
 
To access the Help system from within SharePoint, open index.aspx. The help looks and works just like a regular help output. You can copy the URL of the index.aspx file to allow others to open the help immediately.
 
 
***
Willam van Weelden is a Certified Online Training Professional (COTP), veteran Help Author, RoboHelp consultant, and technical writer based in the Netherlands. He is an Adobe Community Professional, ranking him among the world's leading experts on RoboHelp. Willam’s specialties are HTML5 and RoboHelp automation. Apart from RoboHelp, Willam also has experience with other technical communications applications such as Adobe Captivate and Adobe FrameMaker.
 

Adobe RoboHelp: Importing Google Docs

by Willam van Weelden, COTP Follow us on Twitter View our profile on LinkedIn
As more companies make the move to Google products (over 5 million and counting), more content is created with Google Docs. This is understandable as Google Docs allows people to simultaneously work on documents and see each other's edits in real time. Personally, I use Google Docs all the time to make content reviews easier and avoid attachments in email.

When it comes to brining Google Docs into RoboHelp, there is a single downside: The documents reside on a Google server so you cannot directly import or link them into RoboHelp like you can with other content (like Word documents). Fortunately, you can download Google Docs to your computer and then import the downloaded content into RoboHelp.

Importing Google Docs into RoboHelp
  1. Open your Google Docs document.
  2. Choose File > Download as > Web page (.html, zipped).
  3. Open the zip file and extract the file and images folder to a location of your choice.
  4. Open a RoboHelp project.
  5. Choose Project > Import > HTML.

    Import Google Doc
     

  6. Select the HTML file and click Open.
The document is now available as a topic. Assign the correct style sheet and update the topic as you see fit.

Imported doc

Tip: Are you planning on updating the Google Docs document? Or do you need fine control over how the document is converted to a topic? Export the Google Doc as a Word document. You can then leverage RoboHelp's Word integration for full formatting control.

***
Looking to learn Adobe RoboHelp? Come join me for my live, two-day online RoboHelp class (held once each month). And if you'd like to learn more about Dynamic Filters, check out my 3-hour mini course: Adobe RoboHelp: Advanced Content Reuse.

Adobe RoboHelp: Linking Between Merged Projects

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

In my last article I introduced you to merged help and showed you how to create merged Microsoft HTML Help (CHM). This week I will show you how to create links to a merged project.

Create a Link to a Merged Project from Within a Topic

  1. Using RoboHelp, open a topic in one of the merged projects.
  2. Select some text and choose Insert > Hyperlink/Popup to open the Hyperlink dialog box.
  3. From the Link to drop-down menu, choose Remote Topic.
    Link to a Remote Topic  
  4. From the HTML Help file name drop-down menu, choose a CHM file. (If your CHM is not in the drop-down, click the Browse button and open it.)
  5. From the Topic area, select the topic you want to link to.
     Select a Remote Topic from a CHM.
  6. Click OK to close the Select Remote Topic dialog box.
  7. Click OK to close the Hyperlink dialog box.

You created the link to another project. Please note: Should the file name of the topic in the remote project be changed, the link will no longer work.

 

Create Link to Merged Help Within a TOC

In much the same way as from a topic, you can also create a TOC link to a merged project:

  1. Open the TOC and click New Topic PageNew Topic Page
  2. Click the Link to drop-down menu and choose Remote Topic.
    Remote Topic  
  3. From the HTML Help file name field, select the CHM file.
  4. From the Topic area, select the topic you want to link to.
  5. Click OK to close the Select Remote Topic dialog box.
  6. Add a title for the TOC page in the Page Title field.
  7. Click OK to close the New TOC Page dialog box.
    Topic in the TOC 

The link to the topic is added to the TOC. The same warning I gave you above applies: If the file name of the topic in the remote project is changed, the link will no longer work. Be careful not to change the file name or location of a topic once it is referenced it in another project.

***

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: Create Merged Help

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

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.

Adobe RoboHelp: New Merged Project tool. 

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

Adobe RoboHelp: Merged Project dialog box. 

Click Yes when prompted.

Adobe RoboHelp: Click Yes to the alert dialog box. 

Click the OK button to merge the CHM file.

Adobe RoboHelp: Child project ready to add to a master project. 

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

Adobe RoboHelp: Child added to the TOC.

Save your project and generate the layout. 

Adobe RoboHelp: Merged projects  
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 RoboHelp: Embed a Vimeo Video

by Willam van Weelden Follow us on Twitter View our profile on LinkedIn
 
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. 

Video: Share Button

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

Vimeo: 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. 

Adobe RoboHelp: Embed code added to RoboHelp's HTML.

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

Adobe RoboHelp: HTTP added.

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

Adobe RoboHelp: Embedded Vimeo 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.

Adobe RoboHelp: Multilevel List Sub-Numbering

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

A few weeks ago I showed you how you can use multilevel lists to easily create complex lists with multiple levels. But multilevel lists are far more powerful than I could show you in a single article. This week, I'm going to expand on the multi-level list theme by teaching you how to add sub-numbers to lists: 

Sub-numbering is important for many procedures and legal documents. You simply can't have sub numbering in RoboHelp without multilevel lists, unless you want to manually type in all sub-numbers. But with multilevel lists, you control this behavior right from the style sheet!

To add sub-numbering to a Multilevel List, first Create a multilevel list. Then, on the Project Manager pod, double-click your style sheet to open the Styles dialog box. 

In the Styles dialog box, select your multilevel list. From the Apply Formatting To drop-down menu, choose a level that will use the sub-numbers.

 

Click in the Edit Style field and, from the Insert Level drop-down menu, choose 1.

 

Click OK to close the Styles dialog and save your changes.

And that's it. From this point forward, any of your multilevel lists can include sub-numbering (as shown in the image below):

 

***

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 12: Single Source to Responsive HTML5 and ePub

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

Adobe's new FrameMaker 12 allows you to quickly generate Responsive HTML5 and ePubs. If these features sound familiar, they should… you'll find both in Adobe RoboHelp 11. Now that FrameMaker has these output options,you can take content that was traditionally confined to print or PDF, and deliver it to users over the web. 

Your customers can use Responsive HTML5 or ePub content via desktop computers, mobile devices… just about anything. And you don't have to take the variety of screen sizes users might use into account. If the user is viewing your content on a desktop, they will automatically see an appropriate arrangement of the screen components; if they view your content on an iPhone or Android phone, they will see the components resized and rearranged in a layout to best suit the smaller display size.

Generate Responsive HTML5

  1. Create or open a single FrameMaker document or a book file.
  2. Choose File > Publish to open the Publish pod.
    Adobe FrameMaker 12: Publish Pod
  3. On the Publish pod, right-click Responsive HTML5 and choose Edit Settings to open the Publish Settings dialog box.
  4. Click the Gallery button to open the New Screen Layout dialog box.
    Adobe FrameMaker 12: New Screen Layout dialog box  
  5. Select a Theme and click the OK button. (You will be presented with a series of options that allow you to quickly customize many components that make up the original design. What I really like about this area is that the Adobe engineers have labelled everything so you know what each area controls.)Adobe FrameMaker:  Theme Editor
  6. When you're finished customizing the Theme, click theSave button to return to the Publish Settings dialog box.
  7. Click the Save and Close button to close the Publish Settings dialog box.
  8. To generate the layout, return to the Publish pod, right-click Responsive HTML5 and choose Generate.

In the first image below, you can see the chapter structure in my FrameMaker book file. In the second image, you can see how that structure appears in my web browser thanks to Responsive HTML5.

 
Adobe FrameMaker: Book structure

 

Generate an ePub

  1. On the Publish pod, right-click ePub and choose Edit Settings.
  2. On the Meta Information tab, fill in the information as necessary.
  3. Click the Save and Close button.
  4. To generate the Pub, return to the Publish pod, right-click ePub, and choose Generate.
In the image below, you can see how my FrameMaker book looks when viewed with an ePub reader (I'm using Adobe's free Digital Editions).
 
Adobe FrameMaker 12: ePub output 
 
All in all, this is some pretty awesome stuff. Keep in mind that you will only need Adobe FrameMaker 12 to generate these layouts. I mentioned at the outset that Responsive HTML5 and ePub layouts were once the domain of Adobe RoboHelp. However, with FrameMaker 12, you don't need RoboHelp or any of the other tools that make up the Adobe Technical Communication Suite. Once you've created the FrameMaker content, you can output content for any audience, no matter the end-user device used to view your content.
 

***

Looking for training on Adobe FrameMaker? We offer multiple live, online FrameMaker classes each month. We can also bring the same great training onsite to your facility. Interested? Contact us for details.

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.