If you are a RoboHelp Classic user, upgrade your projects in a few simple steps. For more information, see Upgrade a RoboHelp Classic project.
A project is the core entity that you work with in Adobe RoboHelp. The basic element of a project is a topic. To start authoring your content, add topics to a project. Then, add navigation, configure project properties, and generate the desired output. A typical output of RoboHelp is a Help system in one or more formats, such as Responsive HTML5 and PDF. A RoboHelp project file has the .rhpj extension.
Besides the project file, RoboHelp maintains various project components, such as topics, Table of Contents, variables, skins, and master pages, in separate files. As an author, you need not manipulate the project file or the component files directly. Whenever you edit a project from within RoboHelp, the project file and any other affected project component file are updated automatically.
The basic element of your content structure in RoboHelp. A topic can contain text, multimedia such as images and videos, navigation links, and more. When you plan a topic, make sure that it is easy to consume and reuse. Avoid creating topics that are very long or very short.
From the Author toolbar, click the Contents icon to work with topics. For more information, see Work with topics and folders.
|Folder and subfolder||
The components that help you organize the contents of your project. You can create folders and subfolders to organize topics and assets, such as images, videos, and style sheets.
From the Author toolbar, click the Contents icon to create, rename, or delete folders and subfolders. For more information, see Work with topics and folders.
|Image and multimedia||
Graphics, audio, video, animation, and other audiovisual assets that you can add to a topic to enhance your content.
In an open topic, you can find the Insert Image and Insert Multimedia icons in the toolbar on top of the authoring area. For more information, see Work with image and multimedia content.
|Table of Contents (TOC)||
A TOC helps present a hierarchical outline of the content in a Help system. During authoring, you can browse the TOC and select folders or topics to view and edit. In the published output, end users can use the TOC to quickly view the scope and coverage of content in the Help system. A TOC also allows the end user to quickly jump to a topic of choice.
From the Author toolbar, click the Table of Contents icon to work with TOC. For more information, see Create and manage a Table of Contents.
Allows the end user to navigate through a Help system using keywords or phrases that you've specified. These keywords or phrases require to be associated with specific topics. An index can include multiple levels of keywords and cross-references to other keywords.
From the Author toolbar, click the Index icon to work with indexes. For more information, see Create and manage an index.
Displays the list of definitions for terms or phrases in a Help system. You can filter glossary terms with the help of conditions, link to a glossary file external to the project, and maintain multiple glossary files in a Help system.
From the Author toolbar, click the Glossary icon to work with glossaries. For more information, see Create and manage a glossary.
Allow you to define subsets of content and generate multiple Help systems from the same project. Condition tags help you manage your content for different needs, such as different target audiences and delivery formats.
From the Author toolbar, click the Condition Tags icon to work with condition tags. For more information, see What is conditional content.
Allow you to store text or a phrase that you can update in one place but use in many places across the project. Variables help you make quick global updates and ensure consistency. A good use case of variables is to store information such as product names and release dates.
From the Author toolbar, click the Variables icon to work with variables. For more information, see Create and use variables for easy updates.
Allow you to create and manage reusable content. Global snippets help you to identify content and replace it across several topics in a single step, which saves times and facilitates efficient content changes.
From the Author toolbar, click the Snippets icon to work with snippets. For more information, see Single-source with snippets.
Provide templates for the layout of a topic and help control the styling of content. You can apply a master page to a topic during topic creation or to an existing topic, and see the master page applied to the topic in preview.
From the Author toolbar, click the Master Pages icon to work with master pages. For more information, see Work with master pages.
A browse sequence is a linear list of files that helps you logically navigate to the next relevant topic. You can add, edit, and delete browse sequences. In a browse sequence, you can drag-and-drop topics from the Contents panel and TOC, change the sequence of topics, and delete topics.
From the Author toolbar, click the Browse Sequences icon to work with browse sequences. For more information, see Create and manage browse sequences.
You can generate various reports using the Reports icon on the Author toolbar. You can then view and share reports of broken links, unused files, missing topics, and more.
From the Author toolbar, click the Reports icon to work with reports. For more information, see Generate Reports.
Allow you to define your preferred output format and content layout. You can also assign search-related settings for your output, such as Enable autocorrect in search box, Show definitions from glossary, and more.
From the Output toolbar, click the Output Presets icon to work with output presets. For more information, see Generate output.
Allow you to define the appearance of your HTML output. Just as a website template comes with a unique appearance, a RoboHelp skin can add a unique appearance to your output. You can add a logo, choose the color of borders and headings, and do more to make your output look good. You can preview the output in a skin of your choice.
From the Output toolbar, click the Skins icon to work with skins. For more information, see Work with skins.
Allow you to edit and delete language-specific labels, and undo or redo the edits. You can also export languagewise labels as XML for localization, and import a translated copy for a specific language.
From the Output toolbar, click the Labels icon to work with labels.
A variable set enables you to customize variables (added using the Variables icon in the Author toolbar) for a specific output by overriding the values of the variables. In a newly created variable set, all the variables from the project are listed. From this list, you can override the values of the variables that you want to customize for a specific output. You can create different variable sets to customize the variables for different outputs.
From the Output toolbar, click the Variable Sets icon to work with variable sets.
A condition expression controls the inclusion of tagged source content or its exclusion from the output. Depending on the condition tags used in an expression, the corresponding source content is included in the output. You can define various tag combinations in the expression using OR, AND, and NOT operators to customize the inclusion or exclusion of content in the output. Condition expressions are not published along with the source content and do not appear in the output.
From the Output toolbar, click the Condition Expressions icon to work with condition expressions. For more information, see Configure condition expressions and dynamic content filters.
|Dynamic content filters||
A dynamic content filter controls the display of content in the output. Add a dynamic content filter and then customize it by adding condition tags. The filters are published along with the tagged source content. From the published filters displayed in the output, your end-users can select specific filters to view selective content and hide the rest of the content. Dynamic content filters facilitate quick retrieval and consumption of specific information, instead of having to go through the entire published content.
From the Output toolbar, click the Dynamic Content Filters icon to work with dynamic content filters. For more information, see Configure condition expressions and dynamic content filters.
Stop words add common (minor) words, such as “a” or “the” in the stop list file. During search, RoboHelp ignores the words listed in the stop list file to display optimal and relevant search results. You can add, edit, and delete stop words for different languages. RoboHelp creates a stop list file for each language, for example English (US).stp.
From the Output toolbar, click the Stop Words icon to work with stop words.
You can define multiple synonyms for a word to allow for variations in search terminologies. For example, you can define "cursor," "pointer," and "mouse" as synonymous terms. If the search term is "mouse," RoboHelp returns all topics containing the word "cursor," with that term highlighted. You can add, edit, and delete synonyms for different languages. RoboHelp creates a synonyms file for each language, for example English (US).syn.
From the Output toolbar, click the Synonyms icon to work with synonyms.
Stores styles defined to control the appearance of your content. Instead of formatting content locally, create styles for different elements of your content (for example, the different heading levels) and apply a style sheet at a project- or topic-level.
To apply a style sheet provided by RoboHelp to an open topic, go to the Properties panel > Topic tab > Style Sheets.
In the New Project dialog box, do the following:
- Title Enter the name of the project.
- Language From the drop-down list, select your preferred language for the project's content.
- Save Location Specify the location to save your project. Click to browse your computer and select your preferred folder to save your project in that folder.
To add topics and start authoring content in your project, see Work with topics and folders.
When a new project is created, or any classic or RoboHelp 2019 project is upgraded, a uniquely defined value is automatically generated referred as Project ID. It is defined in the .rhpj file.
To check how to track the translation files using the Project ID, see Translating content to multiple languages.
The Project ID is automatically assigned to all the projects upgraded from Classic and RH2019.
To save your project or file in RoboHelp, you can do the following:
- To save your project, choose File > Save All or press Ctrl+S.
- To save your topic, choose File > Save or press Alt+Ctrl+S.
Alternatively, you can click in the upper-left corner of the standard toolbar to save your work.
You can specify and edit the title and language of the project, along with settings such as topic status, colors, tag groups, and version control.
To access the Project Settings dialog box, follow these steps:
In the Project Settings dialog box, the General tab is selected by default. To configure the General tab, do the following:
In Default Word Import Settings, choose the file that contains the default settings for converting Word files to HTML files.
To edit this file, choose File > Import > Word Document and configure the settings in the General tab of the Word Import Settings dialog box. For information about the General tab, see General.
You can select a topic status such as Draft, In Progress, and Ready for Review to indicate the current stage of authoring of your topic. You can also add a custom status, rename and delete an existing status, and reorder the statuses.
The topmost status in the list of statuses is considered as the default status for new topics.
If you delete a status, all topics that are in the deleted status move to the default status. For example, the default (topmost) status in the Topic Status tab is Draft and some of your topics are in the Review status. If you delete the Review status, all topics that were previously in the Review status move to the Draft status.
You can add or edit a color and maintain a list of specified colors for your project. You can also rename or delete existing colors.
To know more about Color Picker, see Use the Color Picker dialog box.
Tag groups help you group multiple related condition tags to provide relevant content to a focus group. You can add a tag group to the list of default tag groups. You can also rename and delete existing tag groups.
Fonts are essential for the look and feel of your publication, maintaining consistency through all your topics. For custom fonts to work, they must be installed on the computer building the output.
Using file explorer, you will find the FontList.xml in Project > Settings. You can use this file to copy the fonts to another project.
You can optimize the display of the left toolbar in the Author and Publish view using Panels. They can be controlled by the user, by show/hide button associated with the panels.