Skip navigation
Currently Being Moderated

RH9 Bulleted Lists to Printed output in Word

Aug 28, 2011 12:39 AM

Hi,

 

I am using RH9 and Word 2007 and once again I find myself very frustrated with the issues of bulleted lists in printed documentation.

 

I have read much of what is available here on this issue and I have also read 'Single Level Lists' from Peter Grainge.

 

As suggested I have defined both a list and a paragraph styles in RH so the code looks like this:

 

<ul type="disc">
<li class="BulletList1_List"><p class="BulletList1">View Source</p></li>

<li class="BulletList1_List"><p class="BulletList1">Edit template</p></li>
</ul>

 

I then want to map my paragraph style list 'BulletList1' to my defined bullet style in my MS Word template (Style Mapping.dot)

This if I understand correctly will not work, so I map it as suggested to the 'List' style as supplied in the template.

The output appears as follows:

·         View Source

·         Edit template

 

However, if I change the 'List' style in Word to have a different bullet then the 'List' style is no longer available for mapping and the output has the RH style but is displayed  as above.

 

The only solution I have found is that in the Word document I can select all text with the 'List' style (not modified) and then apply my defined bullet style.

Is this my only solution or have I missed something?

 

TIA

Morven

 

 

 

 

 

 

 

 

 
Replies
  • Currently Being Moderated
    Aug 28, 2011 1:18 AM   in reply to MPizanti

    I assume you are followng the instructions in the section on Printed Documentation in http://www.grainge.org/pages/authoring/lists/lists_single_level.htm.

     

    However, if I change the 'List' style in Word to have a different bullet then the 'List' style is no longer available for mapping and the output has the RH style but is displayed as above.

     

    I can't follow this. You are saying that if you open in Word the template you use for mapping, it is then no longer displayed when you get to the mapping page in RoboHelp. That makes no sense as changing a style in Word does not affect whether it is there or not for RoboHelp to map to. It could affect appearance but not its presence.

     

    The only solution I have found is that in the Word document I can select all text with the 'List' style (not modified) and then apply my defined bullet style.

     

    So in effect you are making the changes to each document you produce.

     

    Send me a one topic project with some lists in it plus some screenshots of what you want the lists to look like. I will also need your Word template.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Aug 28, 2011 5:22 AM   in reply to MPizanti

    The CHM file has blue text where <p> is applied and blue bullets. In the printed document from RoboHelp anything with the <p> tag becomes Normal in Word and what I am seeing there is black for both text and lists. What you want is for RoboHelp to generate the document as shown in Document for Peter. Just want to check that is correct.

     

    I'm thinking the fact that Normal in Word is not blue could be the problem and that is the first thing I will check once you have confirmed the above.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Aug 28, 2011 9:50 AM   in reply to MPizanti

    I haven't opened the project yet because before I do that I am trying to ascertain what is wrong with the result you are getting.

     

    What I am seeing in the Suite_8_Introduction_Manual you generated in the project you sent is black and you are saying that is correct. The only difference between the CHM and that document is the indenting.

     

    morven1.gif

     

    In Document for Peter you are showing blue. I thought that was supposed to illustrate what you want but you are saying black is correct.

     

    Does that explain my confusion?

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Aug 28, 2011 2:48 PM   in reply to MPizanti

    Doh! I looked quickly at your document and saw a lot of white space below your CSS code on page 1. I mistakenly thought that was all that was in the document. Hence why we have been going back and forth as I was seeing the blue text on that page and thinking that was the example and that did not fit with what you were saying you wanted. I needed to know what you wanted while fixing the core problem.

     

    When I came up with the solution on my site I was using Word 2010 so I will test on both 2007 and 2010 in case that makes a difference. Worst come to the worst, I think we could sort it out using a green bullet image.

     

    I will take a look tomorrow.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Aug 29, 2011 1:45 AM   in reply to Peter Grainge

    I opened your project on a RoboHelp 9 Word 2007 machine and sure enough the List style does not appear for mapping. That was good in that it was consistent with your findings.

     

    Then I opened a fresh copy of the project (unzipped it again) on a RoboHelp 9 Word 2010 machine and by using my CSS and Word template I was able to map but I didn't get the desired result. I'm pretty sure I know why that was so I thought a few changes would fix that. However, when I tried to reopen the project it just kept crashing and nothing I had done would account for that. Only when I got to the level of having to open the project with the HHP file could I open it again. That caused other issues so I unzipped a fresh copy of your project and it just crashes first time. All other projects I have tested open fine on the same machine.

     

    For that reason I am a bit stumped at the moment as it is in exactly the state you sent it and that has opened on the same machine. It's a holiday here today and I am going out shortly. I may be able to try again later but if not or if I make no further progress, I will try again tomorrow on another machine. I really don't think there is anything wrong with what you sent me but neither is there anything wrong with the RoboHelp installation. Weird.

     

    Sorry but you will have to bear with me for a day or two. As much as fixing the problem for you, I want to reprove the mapping method and establish if it is Word 2007 and Word 2010 compatible or Word 2010 only.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Aug 29, 2011 12:12 PM   in reply to Peter Grainge

    I have cracked the problem of mapping by working on my own test project. In RoboHelp I have blue bullets and text. Normal is set to blue and a paragraph class called ListMapping is in the CSS but has no nothing defined it. That way it looks the same as Normal. ListMapping is applied to bullet list items.

     

    In Word is where you had gone wrong. You had amended the style List to have a green bullet. Look again at my instructions and not that they say to amend the style ListBullet. You map to List but you amend ListBullet. In my tests I used an image that I found when I changed the ListBullet style and clicked the Use Image option.

     

    When I map ListMapping to List, on opening the Word document the bullet is blue and so is the text after the bullet whereas other Normal paragraphs in the document are black. Then you have to do what is in the instructions, find all instances of ListMapping and replace them with ListBullet. That corrects things. You will have the green bullet and black text.

     

    I will send you the project where this works so that you can see it. This was set up on a RoboHelp 9 Word 2010 machine. I have yet to test it on the RoboHelp 9 Word 2007 machine but I really don't expect any difference. All you have to do is generate the printed document and then use Word to find all instances of ListMapping and replace them with ListBullet.

     

    Now to the problem of not seeing List when you map. After seeing your template I fell into the trap of amending List at first. That didn't stop List appearing in the mapping so I am a bit lost on that at the moment. I am hoping you have a copy of your template before you made the changes and that if you use that to change the correct style (ListMapping), then List will appear. Let me know if not and I will poke around some more.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Aug 29, 2011 1:05 PM   in reply to Peter Grainge

    Whilst the method does also work on the demo project you sent me, there may be a showstopper.

     

    In the text viewable when you open the topic, the method works as ordinary paragraphs have the style Normal and bullet lists have the style ListMapping. They are mapped separately so the method works.

     

    When you generate printed documentation from topics that have dropdown text all the content in the dropdowns gets mapped as Drop-Down Text regardless of whether or not it is an ordinary paragraph or a bulleted list. You can run the find and replace on the body stuff but not it will not catch the dropdowns. Whilst you could have a second set of bullet styles, the fact that all dropdown content has one style would mean they would all become bulleted paragraphs.

     

    All the problems with dropdowns come from needing a different colour bullet. If blue bullets were OK in the dropdown content in the printed document, there wouldn't be any problem. Or indeed, any colour as long as it is the same in both.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Aug 30, 2011 12:25 AM   in reply to Peter Grainge

    I've devised a fairly straightforward solution to fix the lists in dropdowns problem.

     

    In the source topic preface each item in the list with something like ### and apply a build tag to it and the space before the text. I suggest the tag is called PrintOnly.

     

    When you generate online help, use the Build Expression to exclude PrintOnly content.

     

    For printed documentation first go back to the template and amend a second ListBullet2. Give it the same bullet as ListBullet but also apply the italic font. That has to be done once only.

     

    When you generate the printed document you will do another search and replace. This time you search for ### with the style Dropdown Text applied, the replace will be ListBullet2. That will give you the bullet image but retain the italic formatting.

     

    I haven't tested it but I'm pretty sure it will work.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Aug 31, 2011 3:38 AM   in reply to MPizanti

    Thanks for letting me know. Make sure you download the project I sent you as that will not be available next week. Then put it all to one side and let me know how you get on. I'm sure we can get it working.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Sep 14, 2011 11:42 AM   in reply to MPizanti

    In the stuff you sent me the RoboHelp projects had blue bullets but the printed documentation had green bullets. I couldn't understand why you wanted different colours but that's for you to decide.

     

    When you work through the steps you will see that at first the bullets are blue in the printed document. Take another look at what is on my site and in this thread and I think you will see what I mean. If not let me know and I will go through the steps again.

     

    I wasn't aware there was a problem with tables in dropdowns. Are you talking about the formatting of the table itself (borders, shading and suchlike) or the text in the tables?

     

    To map to a Word table is a bit tricky Take a look at the Employee Care sample project as the process is described there.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:

More Like This

  • Retrieving data ...

Bookmarked By (0)

Answers + Points = Status

  • 10 points awarded for Correct Answers
  • 5 points awarded for Helpful Answers
  • 10,000+ points
  • 1,001-10,000 points
  • 501-1,000 points
  • 5-500 points