Inspiring

Question

RoboHelp 2022 is not readjusting heading levels as expected when new options are on in the template

Forum|Forum|1 year ago
March 1, 2024
3 replies
459 views

I have a large project with topics that I reuse between various printed doc outputs. RoboHelp 2019 would adjust the headings according to the TOC so that a topic could be at one level in on document (e.g., H2) and a different level in a different document (e.g., H3). There was an option to take care of this. Then, in RoboHelp 2020, the printed doc hierarchy did not work the same way. The headings themselves determined the doc hierarchy entirely. This was problematic when I wanted to share topics between outputs (which was often). To solve it, I had to create extra topics that were heading only in some cases and add multiple headings (with different heading levels) to some topics with conditional build tages to determine which one to show in which layout. Overall, this is a messy solution.

I was excited to see new options in RoboHelp 2022: Readjust heading levels as in the source TOC hierarchy and Add or replace heading from the source TOC to maintain the hierarchy options. In fact, I was able to use these in one fairly simple project to eliminate the messiness. This project only had two levels in the TOCs. Now in a bigger project, I am realizing that these options are not working for lower level sections. For example, here the "The Salient Dashboards screen" section is underneath the "Getting Started" section in the TOC.

However, when I generate this with those two options on, here is the hierarchy in the resulting Word doc. That section is moved up to the first level (not underneath Getting Started) and the heading 1 style is applied to the heading.

Has anyone been able to use these options successfully in a document with more than two levels?

This topic has been closed for replies.

A

Amebr

Community Expert

When Adobe initially brought in the book toc concept, they had some weird flex that books can't have more than 2 levels of heading. I personally guess this behaviour is some holdover from this weird take.

Peter Grainge

Community Expert

Word Ouput

The Readjust Setting affects topic headings only. With the setting cleared, the topic heading will be whatever it is in the topic, typically H1. With the option set, the heading will be reduced to the level of indentation in the TOC. The setting does not affect Section Titles.

Add or Replace is simply about whether of not Section Titles are included.

Section Titles do not indent with any combination. I believe there is some technical reason but I will check that.

Meantime I think your only option right now is:

PDF Output

RoboHelp can configure PDFs much more than in Word as PDF is an Adobe format. I believe that is why the Section Titles can be indented in the way you want.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

Use menu (bottom right) to mark as Best Answer or to Highlight particularly useful replies. Found the answer elsewhere? Share it here.

J

JC @ SalientAuthor

Inspiring

I would think that when Readjust Settings and Add and Replace are on together, it would also adjust the section titles based on the hierarchy, but like you said maybe there is some limitation? For now, I am using separate topics that only contain the heading rather than using the Add or Replace option. It is a little clunky but does work for now. I run macros in word to accomplish various formatting things, but maybe the PDF output is more robust now than it was previously and this wouldn't be necessary. I will investigate a little when I have time.

Peter Grainge

Community Expert

I'm pretty sure that functionality is covered in the RoboHelp Tour on my site. Look in the Word/PDF Template topics and the Word/PDF Output topics.

Come back if you can't find it.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

Use menu (bottom right) to mark as Best Answer or to Highlight particularly useful replies. Found the answer elsewhere? Share it here.

J

JC @ SalientAuthor

Inspiring

I looked at your site and that encouraged me to play with the settings a little bit, so it was helpful. I was able to simplify my project quite a bit using the "Readjust heading levels as in the source TOC" setting. However, I still think that the "Add or replace heading from the source TOC to maintain the hierarchy" setting is either not supported or has a bug beyond the 2nd level. I tried this out in the sample project also. Here is my TOC-

The SECTION1a should be underneath SECTION 1. But in the output doc, it is the same level as SECTION 1. And it has the Heading 1 style applied to it.

So I'm unable to use the "Add or replace heading..." option because my document hierarchy has multiple levels.

Sign up

To post, reply, or follow discussions, please sign in with your Adobe ID.

Sign in to Adobe Community

To post, reply, or follow discussions, please sign in with your Adobe ID.

Scanning file for viruses.

This file cannot be downloaded