With RoboHelp (2017 release), a lot of existing users reported issues about missing header information from their RoboHelp (2015 release) projects. Whenever you generate responsive HTML5 output from RoboHelp 2017 for a project that was created in 2015, the header information is not maintained. The following screenshot shows the responsive HTML5 output generated from RoboHelp 2017 for a project that was created in RoboHelp 2015:

before
Responsive HTML5 output created without upgrading the layout

In the above screenshot, the following things from the header are either missing or not as defined in the project:

A. The project’s logo
B. Title color and font family
C. Background color
D. Navigation string (to open project’s layout)

Using the fix given in this article, you will be able to correct the missing or incorrect information from the header of your responsive HTML5 output.

  1. Open usersettings.js file of your project in an editor. The default location of usersettings.js file is:

    <project-folder>\!ScreenLayout!\<layout-name>

  2. In the variable declaration section of this file, add the following four variables:
    var titleColor = "#ffffff";
    var backgroundColor = "#509de6";
    var logo = "logo.png";
    var fontFamily = "\"Trebuchet MS\", Arial, sans-serif";

    The titleColor and fontFamily define the font color and family for the title used in the header (highlighted as ‘B’ in the above screenshot). backgroundColor is used to define the background color for the top header (C in screenshot). logo is used to define the project’s logo (A in screenshot).

    Note:

    You may choose to provide the actual values as per your project’s theme, or use these default values. The default values for these variables are overwritten by the actual values at the time of publishing the project.

  3. Save the changes made in the usersettings.js file and close the file.

  4. Open MasterThemeSchema.xml file of your project in an editor. The default location of MasterThemeSchema.xml file is:
    <project-folder>\!ScreenLayout!\<layout-name>

  5. In the MasterThemeSchema.xml file, make the following changes:

    a. Look for the variable name head_titlecolor, and add the following code in the sources element definition:

    <source filename="usersettings.js" variable="titleColor"></source>

    b. Look for the variable name head_logo, and add the following code after the <allowedvalues/> element definition:

    <sources>
           <source filename="usersettings.js" variable="logo"></source>
    </sources>

    c. Look for the variable name head_bgcolor, and add the following code in the sources element definition:

    <source filename="usersettings.js" variable="backgroundColor"></source>

    d. Look for the variable name us_font, and add the following code in the sources element definition:

    <source filename="usersettings.js" variable="fontFamily"></source>

  6. Save the changes made in the MasterThemeSchema.xml file and close the file.

  7. Open RoboHHRE.lng file of your project in an editor. The default location of RoboHHRE.lng file is:
    <project-folder>\!Language!\<locale-folder>

    Note:

    The RoboHHRE.lng file contains the definition for the navigation string (highlighted as ‘D’ in the above screenshot). You must update the navigation string definition in all locale folders created for your project.

  8. Look for the ResponsiveHelp section and add the following code before the </section> tag:

    <element name="ShowTopicInContext" value="Click here to see this page in full context"></element>

    Note:

    You can change the default value for the ShowTopicInContext element as per your project’s requirements.

  9. Save the changes made in the RoboHHRE.lng file and close the file.

  10. Open the RoboHelp (2015 release) project file in RoboHelp (2017 release) and regenerate responsive HTML5 output.

    The following screenshot shows the output generated after applying the fixes:

    after
    Responsive HTML5 output created after upgrading the layout

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy