Highlighted

RH2019.0.9 New UI - Word output issues

Participant ,
Nov 27, 2019

Copy link to clipboard

Copied

EDIT: Peter and Adobe are now aware of these issues, and I'm working with them to find a solution. If anyone else experiences the problems I've found, they're working on it. Any updates or workarounds will be posted at the end of this thread.

 

I have tried to generate Word output from the RoboHelp Reimagined project, but the result has multiple issues.

 

These issues concern both the use of a CSS to generate the word styles, as well the use of a Word template to map the Word styles to.

 

I have created a test project, where I start off by creating Word output by CSS only, and then step by step use a Word template to map the styles, style by style. I have added a lot of screenshots to show which settings are used, and what the result looks like in Word and which styling is used. You can find this project and its description here:

https://drive.google.com/drive/folders/109ytnkuZEcXCvrVYbHmu87TLnVLsQmvk

 

Summary:

  • When generating from CSS, RH also adds Heading1, Heading2, etc. and uses those styles, instead of the built-in Heading 1 etc. styles, which is confusing. Moreover, it still applies direct formatting to its own created Heading2 style to make it look like the CSS style.
  • When generating with a template, and mapping styles, RH looks at the styles to see how the text should look, but then creates that look not by using the styles themselves but makes everything Normal + direct formatting.
    So while the generated Word document may look somwehat like the template, under the hood the styles are one big mess.

 

The whole reason for generating in Word instead of PDF is to gain control, but if every style becomes Normal except the headings, there is almost no control whatsoever.

 

Since they just added Word output, I'm not surprised it's still a bit buggy. But I hope they solve these issues in the near future.

Topics

New UI, Single source layouts

Views

226

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more

RH2019.0.9 New UI - Word output issues

Participant ,
Nov 27, 2019

Copy link to clipboard

Copied

EDIT: Peter and Adobe are now aware of these issues, and I'm working with them to find a solution. If anyone else experiences the problems I've found, they're working on it. Any updates or workarounds will be posted at the end of this thread.

 

I have tried to generate Word output from the RoboHelp Reimagined project, but the result has multiple issues.

 

These issues concern both the use of a CSS to generate the word styles, as well the use of a Word template to map the Word styles to.

 

I have created a test project, where I start off by creating Word output by CSS only, and then step by step use a Word template to map the styles, style by style. I have added a lot of screenshots to show which settings are used, and what the result looks like in Word and which styling is used. You can find this project and its description here:

https://drive.google.com/drive/folders/109ytnkuZEcXCvrVYbHmu87TLnVLsQmvk

 

Summary:

  • When generating from CSS, RH also adds Heading1, Heading2, etc. and uses those styles, instead of the built-in Heading 1 etc. styles, which is confusing. Moreover, it still applies direct formatting to its own created Heading2 style to make it look like the CSS style.
  • When generating with a template, and mapping styles, RH looks at the styles to see how the text should look, but then creates that look not by using the styles themselves but makes everything Normal + direct formatting.
    So while the generated Word document may look somwehat like the template, under the hood the styles are one big mess.

 

The whole reason for generating in Word instead of PDF is to gain control, but if every style becomes Normal except the headings, there is almost no control whatsoever.

 

Since they just added Word output, I'm not surprised it's still a bit buggy. But I hope they solve these issues in the near future.

Topics

New UI, Single source layouts

Views

227

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Adobe Community Professional ,
Nov 27, 2019

Copy link to clipboard

Copied

Please ignore this specific post and see further on. I believe the cause of the problems has been resolved as detailed in later post. It has worked for me and I have asked Erwin to try it as well.

 

I have been working on this with Erwin and I have raised the issues with Adobe. I had hoped to be given a bit more time to let them respond.

 

I have worked on the RoboHelp Reimagined sample project and found what I think is the root cause and a workaround pending resolution.

 

THE CAUSE

The Word template path has been removed here but a template was used and it had the Word styles in it. However as you can see Map to Style is not seeing it.

 

What then happens then is RoboHelp creates Heading1 (rather than using Heading 1 - note the space) so you get Heading1 as a name but it is based on Normal so the font and the background are inline.

 

mapping.png

 

THE WORKAROUND

Generate the document and open it in Word.

  1. Open the Styles pane.
    styles.png
  2. Go to the first instance of Heading1 as created by RoboHelp.
  3. Select the line.
  4. Locate Word's own Heading 1 which will be further down the list of styles.
  5. Right click the style name and click Update Style to Match Selection. That will do two things. It will make Word's Heading 1 be in line with the document created and it will apply that style to all instances.
  6. At the bottom of the styles pod click Manage Styles and delete the Heading1 created by RoboHelp.
  7. Repeat for any other affected styles.
  8. At this point you can now modify the styles to whatever you want. The easiest way of doing that is to go Manage Styles again and click Import/Export and import the styles from a document that does have the required styles in.

 

I realise this is extra work but it will help if you must work this way. Personally for now I would take my topic CSS and create a copy of it and amend the styles there. Then I would apply that CSS to a master page and select that. It will not get around the problem of RoboHelp creating Heading1 etc but it will instantly give you the required output.

 

As I indicated I have reported this to Adobe and will update this thread when I hear back.


www.grainge.org

www.grainge.org for free RoboHelp & Authoring info. Use the blue Reply button at the top to help me help you.
The black Reply link nests replies and they sort out of order.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Participant ,
Nov 27, 2019

Copy link to clipboard

Copied

This only explains the first bullet point, not the second, which is much more important IMO.

 

If you read the description I've put in the link, you'll see that when using a template Heading1 etc. don't give an issue at all, because they are mapped. But all the other styles that RH does recognize aren't used, but they are recreated via Normal + direct formatting. See the EmphasisOne style. That completely defies the use of styles. 

 

p.Emphasis1 mapped to EmphasisOnep.Emphasis1 mapped to EmphasisOneSelected text should have style EmphasisOne. Instead it has direct formatting that makes it LOOK like EmphasisOne.Selected text should have style EmphasisOne. Instead it has direct formatting that makes it LOOK like EmphasisOne.

 

You've only taken up the first issue with Adobe, but not the second. If they only fix that, they're not even halfway there. My sample project and description show in great detail what goes wrong when mapping styles, I hope they can use it to fix things. I can't copy/paste all of it here, because there are too many screen shots showing what happens to include them in this post.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Adobe Community Professional ,
Nov 27, 2019

Copy link to clipboard

Copied

Word can only have the supplied Heading styles, you cannot create new Heading styles. Thus the Heading1 that RoboHelp creates is Normal plus formatting. The workaround I have given fixes that by converting all instances of a style to the correct Word Heading styles. Word's Heading 1 becomes correct and replaces the old Heading1 which is Normal + formatting. Also I have made Adobe aware of that.

 

I have also just gone through your project and the document and replied direct to you.

 

It is making it very difficult when you are posting to both the forum and direct and not allowing me some time to get back to you.


www.grainge.org

www.grainge.org for free RoboHelp & Authoring info. Use the blue Reply button at the top to help me help you.
The black Reply link nests replies and they sort out of order.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Adobe Community Professional ,
Nov 27, 2019

Copy link to clipboard

Copied

The reason the mapping was not working is because while the template contained the styles required, there is also a requirement to actually use them in the template.

 

By adding some text to the template and applying the styles, on generating the document Heading 1 mapped to Heading 1 in Word without any inline styling. Hopefully Erwin will confirm the same result.

 

I am grateful to the Adobe developer who resolved this at about 9pm!


www.grainge.org

www.grainge.org for free RoboHelp & Authoring info. Use the blue Reply button at the top to help me help you.
The black Reply link nests replies and they sort out of order.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Participant ,
Nov 28, 2019

Copy link to clipboard

Copied

This indeed works for the headings, but for some reason not for the other paragraph styles, at least in my setup. These are still created as Normal + inline styling. 

 

However, I'm working with Peter to resolve these issues, and Peter as well as Adobe are now aware of the extent of the problems. So if anyone else experiences the same, they're on it!

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...