Skip to main content
Participating Frequently
March 13, 2025
Question

Corrupt Word output (RH2022)

  • March 13, 2025
  • 15 replies
  • 1989 views

Hi everyone,

 

We have switched from RH2015 to RH2022.5.28 and are now looking forward to using RH as our only source for maintaining our content. We have been using both Word and Robohelp ever since... However, we have problems generating Word output from Robohelp.

 

Exporting our RH content to Word creates a corrupt file that has to be recovered. The recovered file does not use our defined styles. Does anyone have any idea why the Word output is corrupt and what we can do about it?

Additional questions:

- Do the styles in Word and the styles in Robohelp need to be named the same in order the be mapped?

- Is there a guide for creating templates (headers, footers, cover pages...) you would recommend?

Thanks a lot in advance.

    15 replies

    Peter Grainge
    Community Expert
    Community Expert
    March 19, 2025

    Did you pick up that I offered to take a look at your project?

    ________________________________________________________

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

      

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    Peter Grainge
    Community Expert
    Community Expert
    March 19, 2025

    I have no further suggestions. I suggest for this one you need to go to Adobe Support. See https://helpx.adobe.com/contact/enterprise-support.other.html#robohelp for your Adobe Support options. The email link tcssup@adobe.com is recommended as it reaches a team dedicated to Technical Communication Suite products including RoboHelp.

    ________________________________________________________

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

      

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    ruth_9390Author
    Participating Frequently
    March 19, 2025

    Thanks a lot for your help anyways. I have tried to reach out to the support team using the email address you stated but have not heard from them so far.

    Peter Grainge
    Community Expert
    Community Expert
    March 19, 2025

    They may not be stopping generation but they are still issues to be fixed the same way.

    ________________________________________________________

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

     

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    ruth_9390Author
    Participating Frequently
    March 19, 2025

    I see. Got these errors, which stopped generation (see screenshot). With the other faulty site: I did not see the issue causing the corrupt file. Thus, I do not know what to look for in other topics. Removing the formatting of every topic and reformatting them would probably help but it's a huge amount of content. Also, our documentation is available in 3 languages which are maintained in 3 separate RoHe projects.

    Peter Grainge
    Community Expert
    Community Expert
    March 19, 2025

    It looks like that topic may have been created from a Word import and the code is now choking generation.

     

    OPTION ONE

    Create a new topic and paste the first few parts of the old topic into it. Does that generate? The idea here is to identify specifically what is choking the generation so that you can fix it in other topics.

     

    OPTION TWO

    Copy all the content into a text editor and then paste that into a new topic, then apply styling as required. I suggest pasting into a new topic rather than the old one as it will give you something to refer to visually. Once done you can delete the old topic.

     

    OPTION THREE

    Select all the content and then use the Remove Inline Styling icon top right in the Styles panel. You won't have a visual reference.

     

    Try whichever you prefer and let us know how you get on. My concern is you may have many topics like this. Try generating after cleaning up each topic.

     

    Can you share the project? If you can, then see the Contact page on my site and send the project as instructed there. Do make sure you include a link to this thread and please do not email the project direct. I'm happy to have a look and see if I can find a better solution.

    ________________________________________________________

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

     

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    ruth_9390Author
    Participating Frequently
    March 19, 2025

    Hi again,
    I chose the first option. After several attempts, I was able to locate the faulty spot. A list with bullet points might have caused a problem. We used tags in this topic and this specific section is tagged, too. I removed the formatting and reapplied it, including the tags. The page can now be generated using Word Output. However, I could not find out what the problem actually was. There are various lists with bullet points on the page, which are also tagged. The one at the bottom of the page was problematic. Errors are still being reported in the output log, e.g.:

    Error 44
    Description: Attribute 'http://schemas.openxmlformats.org/wordprocessingml/2006/main:id' should have unique value. Its current value '153' duplicates with others.
    ErrorType: Semantic
    Node: DocumentFormat.OpenXml.Wordprocessing.BookmarkEnd
    Path: /w:document[1]/w:body[1]/w:tbl[50]/w:tr[18]/w:tc[1]/w:p[1]/w:bookmarkEnd[1]
    Part: /word/document.xml
    -------------------------------------------
    Error 45
    Description: The element has unexpected child element 'http://schemas.openxmlformats.org/wordprocessingml/2006/main:evenAndOddHeaders'.
    ErrorType: Schema
    Node: DocumentFormat.OpenXml.Wordprocessing.Settings
    Path: /w:settings[1]
    Part: /word/settings.xml

    So, now I could create a Word document consisting of 2 of our manuals - 32 remaining...

    Peter Grainge
    Community Expert
    Community Expert
    March 18, 2025

    Not disagreeing with @WoutJacobs but I would suggest now you have hit a bunch of topics with the issue, delete the last batch back to where it worked, then add topics one by one. That will identify a problem topic.

    ________________________________________________________

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

     

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    ruth_9390Author
    Participating Frequently
    March 19, 2025

    Did that and found one topic to be the problem:

    Converting mergedHTML.htm
    Error in declaration 3 of table {
    border-spacing: 0px;
    border-collapse: collapse;
    }
    CssParser error: line 1 col 88: "}" expected.  CSS => table{border-spacing:0px;border-collapse: collapse; mso-border-alt: solid windowtext .5pt;     mso-yfti-tbllook: 1184; mso-padding-alt: 0cm 5.4pt 0cm 5.4pt;}
    Error 1
    Description: The element has unexpected child element 'http://schemas.openxmlformats.org/wordprocessingml/2006/main:pgNumType'.
    ErrorType: Schema
    Node: DocumentFormat.OpenXml.Wordprocessing.SectionProperties
    Path: /w:document[1]/w:body[1]/w:p[3]/w:pPr[1]/w:sectPr[1]
    Part: /word/document.xml
    -------------------------------------------
    Error 2
    Description: The element has unexpected child element 'http://schemas.openxmlformats.org/wordprocessingml/2006/main:pgNumType'.
    ErrorType: Schema
    Node: DocumentFormat.OpenXml.Wordprocessing.SectionProperties
    Path: /w:document[1]/w:body[1]/w:sectPr[1]
    Part: /word/document.xml
    -------------------------------------------
    Error 3
    Description: The element has unexpected child element 'http://schemas.openxmlformats.org/wordprocessingml/2006/main:evenAndOddHeaders'.
    ErrorType: Schema
    Node: DocumentFormat.OpenXml.Wordprocessing.Settings
    Path: /w:settings[1]
    Part: /word/settings.xml
    -------------------------------------------
    Error 4
    Description: The attribute 'http://schemas.openxmlformats.org/wordprocessingml/2006/main:val' has invalid value 'disc'. The Enumeration constraint failed.
    ErrorType: Schema
    Node: DocumentFormat.OpenXml.Wordprocessing.NumberingFormat
    Path: /w:numbering[1]/w:abstractNum[11]/w:lvl[1]/w:numFmt[1]
    Part: /word/numbering.xml
    -------------------------------------------
    Error 5
    Description: The attribute 'http://schemas.openxmlformats.org/wordprocessingml/2006/main:val' has invalid value 'disc'. The Enumeration constraint failed.
    ErrorType: Schema
    Node: DocumentFormat.OpenXml.Wordprocessing.NumberingFormat
    Path: /w:numbering[1]/w:abstractNum[13]/w:lvl[1]/w:numFmt[1]
    Part: /word/numbering.xml
    -------------------------------------------
    Error 6
    Description: The attribute 'http://schemas.openxmlformats.org/wordprocessingml/2006/main:val' has invalid value 'disc'. The Enumeration constraint failed.
    ErrorType: Schema
    Node: DocumentFormat.OpenXml.Wordprocessing.NumberingFormat
    Path: /w:numbering[1]/w:abstractNum[15]/w:lvl[1]/w:numFmt[1]
    Part: /word/numbering.xml
    -------------------------------------------
    Validation error count=6
     
    Output generation successful.
    Peter Grainge
    Community Expert
    Community Expert
    March 18, 2025

    In Classic you had Books and you could have any number of topics in a book.You could also have books within books. In the new UI, sections replace books.

     

    I would worry about that later. Right now you just need to keep adding topics in any old order to find out what is breaking things.

    ________________________________________________________

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

     

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    ruth_9390Author
    Participating Frequently
    March 18, 2025

    Word output worked for a "manual" inlcuding just a few topics. Then I added more topics of another manual and got several errors. The generated Word file was corrupt again.

    Here's some of the errors:

    Converting mergedHTML.htm
    Error 1
    Description: The element has unexpected child element 'http://schemas.openxmlformats.org/wordprocessingml/2006/main:pgNumType'.
    ErrorType: Schema
    Node: DocumentFormat.OpenXml.Wordprocessing.SectionProperties
    Path: /w:document[1]/w:body[1]/w:p[13]/w:pPr[1]/w:sectPr[1]
    Part: /word/document.xml
    -------------------------------------------
    [...]

    Error 116
    Description: The attribute 'http://schemas.openxmlformats.org/wordprocessingml/2006/main:val' has invalid value 'disc'. The Enumeration constraint failed.
    ErrorType: Schema
    Node: DocumentFormat.OpenXml.Wordprocessing.NumberingFormat
    Path: /w:numbering[1]/w:abstractNum[38]/w:lvl[1]/w:numFmt[1]
    Part: /word/numbering.xml
    -------------------------------------------
    Validation error count=116

    Peter Grainge
    Community Expert
    Community Expert
    March 18, 2025

    Major changes in the new UI. You need to read the pages on my site and set up a template and preset as described there.

    ________________________________________________________

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

     

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    Peter Grainge
    Community Expert
    Community Expert
    March 18, 2025

    Here I have selected the two topics. If there are other files it is important not to select those as well, just topics.

     

     

    When I right click those, the dialog is Delete and Properties. If there is any file other than topics select, you will not see Properties. 

     

    Properties will open this dialog where you can change the CSS.

     

    ________________________________________________________

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

     

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    ruth_9390Author
    Participating Frequently
    March 18, 2025

    The default.css is set. I managed to generate a Word output with very limited context (topics only, no sections). Maybe I do not get the concept of sections? In our old Robohelp project we had a folder (book) named e.g. Automatic and inside this book were all the chapters related to this manual. For every Header1 with subheadlines we had a separate book within the main book. I thought, for the new RoHe version this would be a section. Am I wrong?

    Peter Grainge
    Community Expert
    Community Expert
    March 18, 2025

    OK, we now know it is not your installation or environment.

     

    In this case I think I would create a copy of your project so that none of the tests affect the original copy.

     

    First create a new TOC but don't delete the original. The order of things in the new TOC doesn't matter as this is about fault finding. Drag one folder of topics to the TOC, ideally a small folder to start with.

     

    Does that generate OK? If not select all the topics in that folder in the Contents Panel and right click. In the dialog that appears, delete your TOC and apply the default.css. If you had used that in your project, then rename the one in the test project and then import it.

     

    Post back where that gets you. 

    ________________________________________________________

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

     

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    ruth_9390Author
    Participating Frequently
    March 18, 2025

    I generated Word file was corrupt again. I do not get these steps:
    Select all the topics in that folder in the Contents Panel and right click. In the dialog that appears, delete your TOC and apply the default.css.

    I select the topics in the Contents Panel and right click. However, the only option I have is to delete the topics. I guess I am in the wrong section?

    Peter Grainge
    Community Expert
    Community Expert
    March 13, 2025

    You need to select a template here. in the Preset.

     

     

    RoboHelp might apply a default but it's best to create a template and know what is being used. It's only a matter of going to Templates, clicking + and selecting Simple.

     

    Come back when you are ready and let us know exactly which steps you have followed. Can't help any more until you have followed those steps but taking a break might help. 🙂

    ________________________________________________________

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

     

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    ruth_9390Author
    Participating Frequently
    March 13, 2025

    I'll keep you updated. I did as you said but currently RoboHelp seems to take forever to generate output so I cannot tell whether it worked or not (new Book TOC only including 2 pages, Word output with no specific settings but the template which was already available in RH). Maybe it's my connection. Tomorrow's a new day...

    ruth_9390Author
    Participating Frequently
    March 14, 2025

    Great. Let us know when you have tried again today and tried the tests I suggested. I won't be around much today but will pick up whatever you post back.

    ________________________________________________________

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

     


    I'll continue testing with a better connection (just in case it is a problem) on Tuesday and let you know as soon as I have completed the steps you recommended. Thanks a lot.