Skip to main content
Adobe Employee
October 29, 2025
Question

RH2022: Some topics not included in Responsive HTML5 output

  • October 29, 2025
  • 2 replies
  • 66 views

I recently upgraded a project from RH 2017 to RH 2022. Most things seemed to migrate fine. I just discovered, however, that some of my topics aren't included in my Responsive HTML5 output. And some of the new files I create also aren't included in the output. I could really use some help.  Some information:

  • The missing files are all in the TOC, with the "Hide in online output" property plus a condition (as a visual, color-coded reminder).
  • The output preset uses the correct TOC, and I don't specify a TOC-level topic layout. The individual topics use one of three different topic layouts.
  • The missing files are quite simple, one-paragraph files without any page-level condition tags that would exclude them from the output.
  • The files that aren't included are in a specific subfolder (which contains files called as context-sensitive help and that all use a specific topic layout ("csh-layout")). Most of the files in that subfolder are included in my output, but some aren't. The missing files include existing files and new files I create now (including attempts to just recreate the problematic files), whether I use either the same "csh-topic" layout or my "regular-topic" layout.
  • When I create new files with my "regular-topic" layout at the top level of the help directory, they appear in output. New files in the same location that use the "csh-topic" layout, however, don't appear in output. (I don't know why the choice of layout should matter, regardless of the topic's location. I should be able to mix and match layouts, right? And most of the files that use the iffy csh-topic layout (in the subfolder) do appear in the output, so the layout itself must be fine.)

 

Here's the csh-topic layout (where "my-css.css" is my actual CSS filename). It's not exacly complicated, so I can't see anything wrong with the layout itself.

 

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="topic-comment" content="" />
<meta name="generator" content="Adobe RoboHelp 2022" />
<title>csh-topic</title>
<link rel="StyleSheet" href="../css/my-css.css" type="text/css" />
</head>
<body>
<div data-region="topic">
<p class="CSH_Heading">Title of CSH topic</p>
<p>This is Body Placeholder text for your Master Page.</p>
</div>
</body>
</html>

 

Any ideas?

2 replies

Peter Grainge
Community Expert
Community Expert
October 31, 2025

Ah. I thought you meant they were not in the output rather than not getting called from the app. Glad you have solved 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.
Adobe Employee
October 31, 2025

They a) weren't in the output and b) therefore not getting called from the app.  I understand b) but not a).  Why they needed to be in the map file to be in the output is a mystery to me.

Peter Grainge
Community Expert
Community Expert
October 31, 2025

Weird. Not being in the map file explains not getting called but not failing to be in the output. The elves at play?

________________________________________________________

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.
Peter Grainge
Community Expert
Community Expert
October 30, 2025

Try removing the condition from one and see if it then appears.

________________________________________________________

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.
Adobe Employee
October 30, 2025

Thanks, the conditions didn't matter. But I figured out the issue: the files that were missing weren't in my map file. Possibly they were lost somehow during the software upgrade. Anyway, once I added the files to my map file, they now appear in output.
Although I'm not actually clear on why that was necessary. RH doesn't know at the time of output how a particular file is going to be used. There isn't a "context-sensitive help" flag in the topic properties (unless I'm forgetting something). So my context-sensitive help topics are really just topics that don't appear in the published TOC but are included in the build. Why would they need to be in the map file? But it works.