Learn about project basics and how to create your first project from scratch in Adobe RoboHelp.

Бележка:

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.

Project components

The following table lists the various components of a RoboHelp project:

Project component Description
Topic

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.

Index

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.

Glossary

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.

Condition tags

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.

Variables

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.

Snippets

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.

Master pages

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.

Browse sequences

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.

Reports

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.

Output presets

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.

Skins

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.

Labels

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.

Variable sets

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. 

Condition expressions

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

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. 

Synonyms

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. 

Style sheets

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

Start a project

Do one of the following to start a project in RoboHelp:

Create a project from scratch

Once you've launched RoboHelp, follow these steps to create a project from scratch:

  1. Choose File > New Project or press Alt+Ctrl+N. The New Project dialog box appears.

  2. 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.
  3. Click Create.

    To add topics and start authoring content in your project, see Work with topics and folders.

Upgrade a RoboHelp Classic project

To open a RoboHelp Classic project (.xpj file) in RoboHelp, follow these steps:

  1. Choose File > Upgrade RoboHelp Classic Project.

  2. In the Open dialog box that appears, browse your computer, select the desired .xpj project file, and click Open.

  3. In the New Project dialog box, click Create.

    The RoboHelp project is now saved as a .rhpj file.

Save a project

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.

Configure project settings

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:

  1. Once you've launched RoboHelp and opened your project, choose File > Project settings or press Ctrl+Shift+/.

  2. In the Project Settings dialog box, you can specify settings in tabs such as General, Topic Status, Colors, and more.

    See Project Settings for more details. 

  3. Once you've entered your desired settings, click Done.

Project Settings

You can find the following tabs in the left panel of the Projects Settings dialog box.

General

In the Project Settings dialog box, the General tab is selected by default. To configure the General tab, do the following:

  1. Specify or edit the name of the project in Project Title.

  2. In Language, click to select the desired language for your project.

  3. In Default Stylesheet, click  to select a desired style sheet for your project. When you create a topic in your current project, this style sheet is automatically applied to the topic. 

  4. 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.

  5. Select Do not allow inline formatting to avoid applying new inline formatting. Previously applied inline formatting remains unchanged.

Topic Status

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. 

  1. Select the Topic Status tab from the left panel of the Project Settings dialog box.

  2. To create your own status, specify the name of the status in Add a new status and click  against it. 

    The new status is added to the list of statuses.

  3. To rename a status, click its name and modify it.

  4. To reorder statuses, click  against a status and drag-and-drop it at the desired position.

  5. To delete a status, click  against it.

    Бележка:

    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.

Colors

You can add a color and maintain a list of specified colors for your project. You can also rename or delete existing colors. 

  1. Select the Colors tab from the left panel of the Project Settings dialog box.

  2. To add a color, click  to choose a color, specify a name in Color Name, and click .

    The new color is added to the list of colors.

  3. To rename a color, click its name and modify it.

  4. To reorder colors, click  against a color and drag-and-drop it at the desired position.

  5. To delete a color, click  against it.

Tag Groups

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. 

  1. Select the Tag Groups tab from the left panel of the Project Settings dialog box.

  2. To add a tag group, specify its name in Add a new tag group and click  against it.

    The new group is added to the list of tag groups.

  3. To rename a tag group, click its name and modify it.

  4. To delete a tag group, click  against it.

    Бележка:

    A tag group cannot be deleted if it contains tags. Before you delete a tag group, ensure that all the tags grouped under that tag group are deleted. To delete a tag, in the Condition Tags panel, right-click the tag and click Delete

Version Control

If your project is connected to Git or SharePoint Online version control system, information about your connection profile is displayed in the Version Control tab.

To configure your connection profile, choose Collaborate > Open Connection > New Connection and provide the necessary information in the Connection Profiles tab. 

Този материал е лицензиран под лиценз Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported  Публикациите в Twitter™ и Facebook не попадат под клаузите на Creative Commons.

Правни бележки   |   Правила за онлайн поверителност