Adobe RoboHelp 7: Text-only Popups

by Kevin A. Siegel

 
When you create links in RoboHelp, one of the more common techniques is to create a link to topics that appear in an auto-sizing popup. This slick technique usually links to existing topics in your project. The content that appears in the popup window can be highly formatted (using Style Sheets) and contain images and multimedia effects. Of course, to create a pop-up link, you'd need to ensure the content exists in a topic. If you want to create a popup link to text that is not contained within a topic, you can create a Text-only Popup.
 
Because Text-only Popups do not link to project topics, you are limited to the amount of formatting you can control. In addition, Text-only Popups cannot contain images, audio or other multimedia effects.
 
One appropriate use of Text-only Popups would be for glossary terms, where you want the definition of a term to pop up when users click the term.
 
Insert a Text Only Popup in a Topic
  1. Open a topic and select some text
  2. Choose Insert > Text-only Popup

    A yellow box appears near the word you selected.

  3. Type some text into the yellow box

    Text-only Popup

  4. Press [Ctrl] [W] to preview the topic
  5. Click the link you just created to display the Text-only Popup

Change the Appearance of the Text-only Popup

  1. Double-click the Text-only Popup you added to display the Text Popup Properties
  2. Select any Font you like from the Font menu
  3. Select any Text Color and Size you like
  4. Select any Background color you like

    Text-only Properties

  5. Click OK
Want to learn more about Adobe RoboHelp 7? Click here.

Adobe RoboHelp 7: Adding Background Images to Topics Via CSS

 
A background image can easily be added to any RoboHelp topic via the Format menu (Format > Topic Borders and Shading). However, if your intent is to use the same background image on all or several topics, a more efficient technique would be to attach a CSS to the topics and then attach the background image to the CSS.
 
Note: While background images can be cool, they can also make your topics harder to read. If you are going to use a graphic as a background image, consider using a simple graphic that is not too overpowering or distracting.
 
  1. Ensure you have attached a CSS to at least one of your topics
  2. On the Project Manager pod, open the Project Files folder
  3. Double-click your CSS to display the Styles dialog box
  4. Double-click the word Other to show the Styles in the group
  5. Select Background + Text (BODY)

    The Background + Text (BODY) style controls the text, background images, background colors and borders used in any topic that uses the style sheet you are currently editing. Any of the topics in your project that use the style sheet will be affected by any changes you make here.

    As mentioned earlier, if you want to change the background image used in a single topic, you would not modify the style sheet. Instead, you would open the topic and choose Format > Topic Borders and Shading. In that case, any changes you make would affect only the open topic.

  6. Click Format and select Borders and Shading

    The Borders and Shading dialog box appears.

  7. Click the Shading tab
  8. In the Pattern area, click the folder with the Magnifying Glass
  9. In the Image name area, click the folder at the right and open the image you want to use for the background

    Background Image attached to CSS

  10. Click OK
  11. Click OK
  12. Click Close

    The graphic you opened will be "tiling" and filling up the background of every topic in your project that was using the CSS you edited.


Want to learn more about Adobe RoboHelp 7? Click here.

Adobe RoboHelp 7: Multiple TOCs

by Kevin A. Siegel

 
A typical Help system has a Contents tab which you create in RoboHelp's Table of Contents folder on the Project Manager pod.
 
A typical Contents tab is made up of books and pages. Books can contain pages or other books. The pages typically point to topics in your project. 
 
RoboHelp 7 allows you to create multiple TOCs, each of which can be attached to a Single Source Layout. Using this feature, you can create myriad versions of your Help System, each with a unique TOC. 
  1. On the Project Manager pod, open the Table of Contents folder

    By default, there is always one TOC in the Table of Contents folder.

  2. To create a new TOC, right-click the Table of Contents folder and choose New Table of Contents
  3. Give the new TOC a name
  4. To make you new TOC look like an existing TOC (you will be able to modify the new TOC later), select Copy existing Table of Contents
  5. Click the button to the far right of the dialog box and open an existing project TOC (any .hhc file within your project folder)

    Creating a new RoboHelp TOC

  6. Click OK

    For the moment, your new TOC is identical to the project's existing TOC.

  7. Open the new TOC and move, delete and rename books and pages as you see it

    In the image below, the TOC at the left is the original TOC; the one on the right is the new one. While similar, the one on the right is missing one of the books.

    Two TOCs, Side By Side

    The only remaining task is to attach the new TOC to a Single Source Layout.

  8. On the Single Source Layouts pod, show the Properties of a layout (right-click the layout and choose Properties)
  9. Select your new TOC from the Table of Contents drop-down menu
  10. Click Save

    You will see your new TOC the next time you generate and view the layout.  


Want to learn more about Adobe RoboHelp 7? Click here.

Adobe RoboHelp 7: Watch Your WYSIWYG

by Kevin A. Siegel

 
There are two ways to add content to your RoboHelp project: create topics within RoboHelp or import the content (you can import HTML files, Word documents, FrameMaker books and file, PDFs and more).
 
Regardless of how you get your content into a RoboHelp project, you will likely need to edit the content at some point. The question is, do you want to edit the content from within RoboHelp (in the WYSIWYG window–What Your See Is What You Get) or within the program that created it?
 
When opening topics within RoboHelp for editing, you might receive the alert message "The file is associated with a 3rd party editor and may be opened in the other editor." As a result, the topic might open in NotePad or Dreamweaver, instead of RoboHelp. You can prevent this message from appearing–and lower your stress level–by following the following steps.
  1. Choose Tools > Options
  2. Select the Tool Location tab
  3. In the HTML Editors area, select RoboHelp WYSIWYG
  4. Click the Set As Default button
  5. Click the Use Default Editor button at the bottom of the dialog box

    Setting the HTML editor in RoboHelp

  6. Click OK to close the Options dialog box
 

Want to learn more about Adobe RoboHelp 7? Click here.

Adobe RoboHelp 7: Something Revealing About RoboHelp’s Menus

 
Adobe RoboHelp version 7 is arguably the best RoboHelp version ever… and considering that the program has been around for a long time, that's saying something.
 
If you are new to RoboHelp 7, you'll be happy to know that you can customize the keyboard shortcuts, create your own toolbars and arrange your own workspace (known as an Environment).
 
While I just love the RoboHelp 7 interface and very much prefer it to the look and feel of Adobe RoboHelp 6, I'm not a big fan of menus that don't immediately show me all of the available commands.
 
Not sure what I'm babbling about? Start RoboHelp and select any of the menus (the File menu is a great place to start). Notice that the full menu only appears after a delay. Maybe I'm showing my age… or my lack of patience… but I want my menu commands, and I want them now.
 
If you'd like to set RoboHelp up so that you always see the available menu commands, follow these steps:
  1. Choose View > Toolbars > Customize
  2. Select the Options tab
  3. Select Always show full menus

    Always show full RoboHelp 7 menus

  4. Click Close
And that's that… go ahead and check your menus… very revealing!

Want to learn more about Adobe RoboHelp 7? Click here.

Adobe RoboHelp 7: Use a Marquee to Enhance Your Topic’s Message

by Kevin A. Siegel

A marquee is an area in a RoboHelp topic that displays a text message that scrolls horizontally across the screen. Believe it or not, the ability to add a marquee to your project has been available in RoboHelp for years… but maybe you just didn't know about it. Read on and you'll learn how to insert a marquee and how to control its properties.
 
Insert a Marquee
  1. Open a RoboHelp 7 topic
  2. Click in the topic where you would like to insert the marquee
  3. Choose Insert > HTML > Marquee

    A box appears with a green, dashed border. This is the marquee. By default, the marquee is empty (unless you had selected text prior to inserting the marquee).
  4. Type the text you would like to see in the marquee

    A marquee with text.

  5. Choose View > View Item to preview the topic and the marquee

    Notice that the marquee text scrolls across your page. You may or may not be happy with the speed of the scrolling text. You can change that easily enough.

  6. Close the preview 
 
Change Marquee Properties 
  1. Right-click within the marquee and choose Marquee Properties

    The Marquee dialog box appears. Using the options available on the Marquee tab, you can change such marquee features as Direction, Speed and Behavior.

    Marquee properties

  2. After making your changes, click OK (if you want more information about any of the marquee features on any of the tabs in this dialog box, you can use the Help button)
  3. Choose View > View Item to preview the changes you have made to the marquee

    Note: If you single source your RoboHelp project to a printed document, your marquees will be converted to text. 


Want to learn more about Adobe RoboHelp 7? Attend one of my RoboHelp classes. Click here for details.

Reader Feedback

RoboHelp 7 Keyboard Shortcuts
 
Hi Kevin,
 
In your last Skills & Drills newsletter, one of the Questions of the Week asked for a list of RH7 shortcut keys. One does exist:
  1. Choose Help > Contents & Index
  2. On the Search tab, search for Shortcut keys
  3. Click the link Use Design Editor shortcut keys
Hope this helps.
 
 
Editor's Note: Thanks Randi. Believe it or not, we had looked in the Help System for shortcuts but just didn't see them.

Adobe RoboHelp 7 eLearning Course Now Available

We are proud to announce that our RoboHelp 7 eLearning course is now available.
  • 40 lessons!
  • All 100% interactive!
  • Unlimited access for 1 full year.
Topics covered:
 
Create a New Project | Pods and Toolbars | Environments | Retitle and Rename a Project | Creating New Topics | Generating | Create Project Folders | Auto-Create A TOC | Cascading Style Sheets | Custom Style Sheets | Font Sets | Inline Styles | Spell Check | Multi-File Find and Replace | Compliant WebHelp | FlashHelp | Custom Toolbars | Links | Bookmarks | Importing PDFs | Popups | Custom Sized Popups | Text-Only Popups | Link View | Inserting Images | Background Images | Image Maps | Sound | Create Conditional Build Tags | Attach Conditions To Layouts | Multiple TOCs | User Defined Variables | Snippets | Smart Index Wizard | Add Remove Index Keywords | Reports | Printed Docs and PDFs | Skins
 
Price: $85.00

Click here to test drive a few of the lessons.
 
Click here to register for the course. 

Adobe RoboHelp 7: Font Sets

A Font Set tells the Web browser which font to display for a topic. If the end-user’s computer does not have a certain font, you can use the Font Set to show a different font.

 

For instance, let’s say that your topics use a font called “ReallyCoolFont.” You just love that font… I mean, it’s a really cool font! The only problem is, it’s unlikely that your customers will have the font. If you don’t specify a font set, your user’s computer will substitute a different font, essentially ruining your design. If you specify a font set, you can tell the computer which font to load if “ReallyCoolFont” is not available.

 

Because you can’t control the fonts on the end-user’s computer, simple fonts such as Verdana and Arial are recommended. While they may not be exotic, you know what you are getting with both of these fonts. And just about every Mac and PC has them.

 

Create a Font Set

  1. Open any topic in your RoboHelp project
  2. Choose Format > Font Sets

    The Font Sets dialog box appears.
  3. Click the New button and then name your Font Set (the name can contain spaces)
  4. Click the Modify button
  5. Double-click any of the fonts you want to add to the Font Set.

    Creating the Font Set

    The order of the fonts in the list is important. In the image above, Verdana is above Arial. Based on the order, Verdana will be the first choice when the browser looks for a font to use. If Verdana is not installed on the computer, the browser will look for and load Arial. If you want to add a font to the list that is not installed on your computer (such as Helvetica), you can type the name of the font into the Available Typefaces field and click Add.

  6. Click OK
  7. Click OK again

    The font set has been created, but it is not currently being used by any of the topics in your project. You will “attach” Font Set to a style next.

Attach a Font Set to a style 

  1. On the Project Manager pod, double-click your project’s CSS to open the CSS file for editing (in the image below, the CSS file to be edited it MS_Help.css)

    The project's CSS file

  2. Double-click the word Paragraph to display the project’s paragraph styles
  3. Select a style and click Format
  4. Choose Font and, from the Font list, scroll and select your new Font Set

    The Font Set appears in the Font list

  5. Click OK
  6. Click Close

Attaching a Font Set to styles won’t pay off obvious benefits while you continue to develop your Help System. But remember, thanks to the font set, you will not have to worry about missing fonts fouling up your topics when user’s browse your finished Help system.

 




Want to learn more about RoboHelp? Click here. 

Adobe Announces RoboHelp Packager for Adobe AIR

I recently attended the WritersUA conference in Portland, Oregon. During the conference, I sat in on a couple of sessions about Adobe AIR. It was at one of these sessions that Adobe introduced the RoboHelp Packager for Adobe AIR.

The RoboHelp Packager for Adobe AIR allows RoboHelp developers to convert existing WebHelp files generated using Adobe RoboHelp to an Adobe AIR application.

As the name implies, the RoboHelp Packager for Adobe AIR packages WebHelp files generated using Adobe RoboHelp versions 6 or 7 and packages them into an Adobe AIR file. Using the same single-file output as Microsoft HTML Help (where a single CHM file is created), a single Adobe AIR Application file is created.

What is Adobe AIR? Good question. According to Adobe, "Adobe AIR is a cross-operating system runtime that enables you to use your existing HTML/Ajax, Flex, or Flash Web development skills and tools to build and deploy rich Internet applications to the desktop.

"Adobe AIR applications support native desktop integration, including clipboard and drag-and-drop support, local file IO, system notification, and more."

Impact on Business

According to Adobe, "Adobe AIR offers an exciting new way for a business to engage customers with innovative, branded desktop applications, without requiring changes to existing technology, people, or processes."

Impact on Developers

"The Adobe AIR runtime lets developers use proven web technologies to build rich Internet applications that deploy to the desktop and run across operating systems," said Adobe.

Overview of RoboHelp Packager for Adobe AIR:

  • Generate a single distributable file similar to a CHM file.
  • Unlike a CHM file, Adobe AIR Help files will work on all platforms and operating systems (CHM files will only work under the Windows operating system).
  • Users can add comments, in addition to using other advanced features such as Breadcrumbs, Mini TOC and Security (Digital Signatures).
  • When you install the packager with Adobe RoboHelp 7 already installed on your PC, it gets added as a tool in the Toolbox Pod. The installer also creates a shortcut for launching this tool on your desktop.

    Note: You must install the Java Runtime Engine version 6 and Adobe AIR Runtime before installing the tool. Links for both can be found here.

Click here to learn more about Adobe AIR.

Click here to learn more about RoboHelp Packager for Adobe AIR or to download the Packager from Adobe Labs.


Want to learn more about RoboHelp? Click here.