Error during publishing: maker: Show/Hide setting for DITA-Comment is inconsistent.

Report · Jan 25, 2023

I am using FM2020, structured with DITA.

I am having what appears to be same error posted in an older post (https://community.adobe.com/t5/framemaker-discussions/has-anyone-seen-this-conditional-text-error-sh...), but the solution there does not work. I am guessing that the difference is that I am using structured DITA.

The error message is:

maker: Error in <filename>.fm while updating UntitledBook13.book:
maker: Show/Hide setting for DITA-Comment is inconsistent.

It does not matter what ditamap I publish, i always get this error for DITA-Comment and DITA-Prolog for all files in the DITAMAP.

I have reviewed all DITA files, and used the "import format " to make them consistent (as per the above the suggestion) and that did not fix the problem.

I then used "import format" to all of the template files to ensure that they were consistent with each other, and that did not fix the problem.

I then used "import format" to all of the output template files to ensure that they were consistent with each other and imported them all to the STS, and that did not fix the problem.

Report · Jan 25, 2023

Is DITA-Comment the name of a Condition Code by any chance?

Report · Jan 25, 2023

Not entirely sure what "Condition Code" means, but if I open up the Show/Hide Conditional Text panel, I can see 6 different items listed, 4 under the Show panel and DITA-Comment and DITA-Prolog under the Hide panel. However, all of the files show this same pattern (i.e. there is no inconsistency between the files that I could find). Even that it did not make sense (given the text of the error message...) I did try to move DITA-Comment and DITA-Prolog to the Show column for one of the DITA files and also one of the DITA templates, but that did not appear to make a difference.

BTW - I inherited this project and have no idea what/why these settings are there. I am just trying to clean things up.

Report · Jan 26, 2023

re: Not entirely sure what "Condition Code" means…

You may need to learn about it, because this document is using them. CC is a way of having text regions that you can switch on and off, with adjoining text re-flowing.

re: …there is no inconsistency between the files that I could find…

You might try:
🗐 have all the book files open
🗏 make note of one {source.fm} that has apparently correct Conditional settings
🗐 in the book menu, select all except that one
File » Import » Formats
Import from Document [source.fm]
☐ deselect all except:
☑ Conditional Text Settings
[Import]

That will make them all identical from a CC standpoint.

Report · Jan 26, 2023

Thanks for the response.

As part of my testing, I deleted everything from one of my books except for 2 files (which makes testing for issues like this much simpler). The error occurs for BOTH files, so I cannot implement your solution of importing from the correct version, because there does not appear to be one...

Report · Mar 31, 2023

I have an update based on new observations, but still do not have a solution. The problem is somehow related to the Table of Contents.

If I Publish and PDF using the default .STS file that ships with Framemaker, then the problem disappears.

If I do the following, the problem is still not there:

start with the default .STS file
Edit the .STS file
on the DITA Options tab, check Save PDF via Book with components node
on the DITA Options tab, uncheck all of the options.

However, if I subsequently do the following, then the problem appears:

check at least one of:

Generate Table of Contents
Generate Index
Generate List of Figures
Generate List of Tables

These observations are highly repeatable. If I uncheck whichever of those I have checked, then the problem disappears.

Thoughts?