Mapping styles

    Mapped styles

    Non-mapped styles are formatted as they appear in the Design Editor. Style maps are saved in a ZPL file.

    Heading styles

    For heading mapping to occur, a standard HTML heading style must be applied to topic titles. If custom heading styles aren’t named in the format Heading <number>, they are not treated as headings.

    Heading styles are automatically mapped to Word heading styles. To disable automatic mapping, select Maintain HTML Heading Levels in the Print Document Content dialog box. Heading style levels are retained, regardless of their position in the Print Document Content dialog box.

    RoboHelp considers the RoboHelp project style applied to the heading and the placement of the topic in the printed TOC hierarchy.

    Generating a printed document TOC exactly like the project TOC creates Word documents with identical heading styles and an identical TOC hierarchy. When the hierarchy of the TOC changes, the automatic process takes over and assigns heading levels.

    • Books and pages at the root level are always Heading 1. If the project heading style is lower (such as a Heading 2), it is adjusted up.

    • Books and pages with Headings 2 – 6 are adjusted according to their level in the printed document structure and their project heading style. Different project heading styles are adjusted as needed.

    • Books and pages with Headings 7 – 9 are automatically mapped to Word Headings 7 – 9 styles.

    • Books that link to pages are treated like topics.

    RoboHelp makes these heading adjustments when it creates the printed document TOC.

    Paragraph styles
    Paragraph styles can be mapped only to paragraph styles in Word. They apply to font attributes, line spacing, numbering, and borders and shading.

    Character styles
    Character styles can be mapped only to character styles in Word. They apply to font attributes.

    Multi-level list styles
    Multi-level list styles in RoboHelp can be mapped only to multi-level list styles in Word. The individual levels of the multi-level lists are mapped automatically. For example, the style for the level 3 items in the RoboHelp list are mapped automatically to the style for the level 3 items in the list in Word.

    Table styles
    Table styles in RoboHelp can be mapped only to table styles in Word.

    Embedded styles
    Embedded styles that are not defined in the external style sheet are applied inline in the Word document. They are not available for global use.

    Inline styles
    Inline styles are applied inline in the Word document and are not available for global use in the template.

    Adobe recommends

    Using style mapping

    David Rivers
    Learn how to map project styles to various styles defined in a Microsoft Word template.

    Unmapped styles

    The following styles aren’t available for mapping:

    • Background + Text (BODY). These style settings are applied inline.

    • Heading styles.

    Unmapped styles denoted by Unassigned - Use Style In Project in the Print Document Appearance dialog box are added to the Word document. This style has the same attributes as the project style. To access the Print Document Appearance dialog box, double-click a printed documentation layout in the Single Source Layouts pod, and click Next three times.

    Style naming

    Mapped template styles retain the name of the Word template style.

    Styles that RoboHelp adds

    If title page title, TOC title, and glossary definitions, terms, and headings are defined in the selected Word template, RoboHelp maps them to the Word document.

    Duplicate styles

    If the project has multiple style sheets with duplicate style names, the most frequently used style is mapped.

    Map styles

    1. Double-click Printed Documentation in the Single Source Layouts pod, and click Next until Print Document Appearance appears.

      Project styles appear on the left. Matching template styles appear on the right. If a matching style is not found, you see [Unassigned - Use style in project]. Heading styles, which are mapped automatically, are not listed.

    2. Under Microsoft Word Template, select a template already in the project or another template option from the pop-up menu.

      (None) Use The Project's CSS Styles
      Formats from topics, not from a template.

      Use Microsoft Word Templates
      In the Select Template File dialog box, open a template. Choose copy to the project folder or overwrite an existing template. Click Yes to enable quick access to the template. To share the template with other authors and maintain it in one location, click No.

      Style Mapping. dot
      Uses default template.

      Browse 
      Lets you select a custom template not yet in the project, or browse to the location of a ZPL file from another layout. Click Browse Files to browse to the location of the desired template. Select copy to the project folder or overwrite an existing template.
      Note: If the template you select has the same name as one of the default Word templates, _RHT is added to the custom template name.

    3. Under Project’s CSS Styles, select a project style to map to a template style. A sample of the selected style is displayed underneath Preview.

      Project’s CSS Styles (All)
      Displays all styles in the project.

      Project’s CSS Styles (Used Only)
      Displays only the styles used in the project.

      Character
      Preview the font attributes of a style.

      Paragraph
      Preview the font attributes and spacing of a style.

      Description
      Preview a text description of a style.

    4. Under Microsoft Word Template Styles, select the pop-up menu to display template styles.

      Microsoft Word Styles (All)
      Displays all styles in the template including Word defaults.

      Microsoft Word Styles (User Defined)
      Displays only user-defined styles.

      Note: Styles must be mapped to other styles of the same type. For example, character to character, paragraph to paragraph, table to table, and multi-level list to multi-level list.

    5. Select a style, and map all desired project styles, selecting them from the pop-up menu of the selected Microsoft Word style.

    6. Map all desired project styles.

    7. Click Finish to generate.

    8. When the macros message appears, click Always Trust Macros From This Publisher. Then click Enable Macros. Printed documentation files appear under !SSL!\[layout name] in the project folder.

    9. Click View Result to view the output, or click Done.

      Microsoft Word opens the document. Depending on the settings selected, the TOC, master document, or a single document is displayed.

    Export style maps

    Ensure that the project styles are all mapped to the same Word template styles.

    1. Open the project.

    2. Create a printed documentation layout.

    3. Map the styles. Save the settings.

    4. In the Single Source Layouts pod, right-click the layout containing the style map to export. Select Export Preferences.

    5. Browse to the destination for the style map. Click Save.

    Import style maps

    Share style maps to ensure that the project styles are all mapped to the same Word template styles.

    1. In the Single Source Layouts pod, right-click the printed documentation layout. Select Import Preferences.

    2. Browse to the exported style map (.zpl file).

    3. Select Open.

      • If the template associated with the style map is not in the project, select Yes to copy it to the project folder.

      • Select Yes to overwrite the template.

      When you generate output, the imported style map is used.

    4. To edit the style map after it is imported, right-click the layout. Select Properties. Set options and click Next for each screen of the Properties dialog box.

    5. Click Save.