9 Replies Latest reply on Mar 9, 2008 6:56 AM by Peter Grainge

    Numbering in topics created by importing a Word doc

    eoprigjernt
      I have created a project and imported a single Word file that is 88 pg. in length and that uses Word's styles to create bulleted and numbered paragraphs. In the HTML topics, the HTML code follows the pattern below for all lists:

      <p class=Bullet1>first bulleted item</p>
      <li class=p-Bullet1><p class=Bullet1>second bulleted item</p></li>

      Of course this causes the text to appear without bullets (or numbers) for the following three reasons:
      - the <ol... tag is missing
      - the first bulleted/numbered item is assigned a <p tag rather than an <li tag
      - the second tag - <p... - overrides the <li tag

      Is there some way to prevent this from happening? (If I import a smaller Word doc, the problem doesn't seem to happen as often. )
        • 1. Re: Numbering in topics created by importing a Word doc
          MergeThis Level 4
          Chances are, the style for that sample was applied improperly in Word.

          I've found that best practice for lists in RH is this: no styles at all. Start with Normal style, select the list item paragraphs, and click the bullet/number toolbar icon. For sub-list items, select those paras and click the Indent toolbar icon. This method also enables your lists to look the same when you generate Printed Doc layouts.

          If you absolutely must enforce some styles, use the OL and UL elements in your style sheet. (You can even use what's called descendant selectors (set styles for all UL lists nested within OL lists with an OL UL setting, for example). See the WWW site for tutorials.

          You might want to strip all those styles from the Word doc before you import it. (Word is good at allowing global style changes through the Replace function.)


          Good luck,
          Leon
          • 2. Re: Numbering in topics created by importing a Word doc
            Level 1
            Leon said:

            I've found that best practice for lists in RH is this: no styles at all. Start with Normal style, select the list item paragraphs, and click the bullet/number toolbar icon. For sub-list items, select those paras and click the Indent toolbar icon. This method also enables your lists to look the same when you generate Printed Doc layouts.

            I'll second that. Strongly.
            • 3. Re: Numbering in topics created by importing a Word doc
              eoprigjernt Level 1
              Thanks for your replies, Leon and Chet.

              If I understand you correctly, you are saying that the conversion of Word numbering styles into RoboHelp just doesn't work, and the common practice is to work around that by removing all formatting of lists in Word and then reformat them manually in RoboHelp. Is this correct?

              Given that the HTML is wrong, but consistent, wouldn't it seem that a better solution for me at this point would be to write a script to repair the HTML? This would enable me to provide my client with an automated, repeatable workflow to single-source print and online help.

              Thanks again for taking the time to advise me!

              - Carol

              • 4. Re: Numbering in topics created by importing a Word doc
                MergeThis Level 4
                Sorry, Carol, I'm not "saying that the conversion of Word numbering styles into RoboHelp just doesn't work." I'm saying that Word doesn't convert well because of all the bloat that Microsoft has added over the years.

                Therefore, the best way is to clean up Word first; scripting should not be necessary. Also, I didn't mean to imply that you would have to manually reset the lists in RH: they'll be imported properly if the Word file is clean.

                Try extracting, from the big file, one Heading 1 that has several Heading 2 sections and at least one list, into a new DOC file. Redo the list(s), save the file, and import it into a test project. See what happens.


                Good luck,
                Leon
                • 5. Re: Numbering in topics created by importing a Word doc
                  eoprigjernt Level 1
                  Ah, now that makes sense. And sorry - I wasn't trying to put words in your mouth - just trying to understand.

                  I don't really see anything wrong with the styles in Word, but that doesn't mean there aren't problems that aren't visible.

                  I'll try what you suggest.

                  - Carol
                  • 6. Re: Numbering in topics created by importing a Word doc
                    eoprigjernt Level 1
                    OK. I tried to clean up the styles in the Word document. I took one section out of the doc (its styles came with it), created new styles for the two types of bullet lists, saved it, and imported it into RoboHelp. The code is cleaner, but the problem I first described is still happening.

                    If I'm the only person this is happening to, it must be something I'm doing with Word styles.
                    • 7. Re: Numbering in topics created by importing a Word doc
                      Peter Grainge Adobe Community Professional (Moderator)
                      There's a topic on importing Word documents on my site. Maybe that will help.

                      • 8. Re: Numbering in topics created by importing a Word doc
                        eoprigjernt Level 1
                        Thank you, Peter. I had been to your site before, but didn't read the detailed articles about importing Word docs, because I thought they applied only to earlier versions of RoboHelp. Having reviewed them, I feel A LOT BETTER and have a better understanding of what's going on "under the covers." Also, I've now spent some time reviewing & modifying the stylesheet & HTML directly in the topics, so I'm better prepared to understand the HTML code you include.

                        Nonetheless, the original problem I posted still mystefies me. As you suggest, I'll have to so some experimenting to understand what's causing the first bullet or numbered item to be assigned a <p class=classname> rather than an <li class=classname>.

                        As I stated earlier, it may just be that this particular document's checkered past will require that I use your (thank you!) macro to remove the formatting of bulleted & numbered paragraphs & reassign bullets & numbering.

                        This leaves one final question: For RoboHelp 7 specifically, do you advise setting bullets & numbering using styles, or the Word toolbar?

                        Thank you again to all who share your experience & advice.

                        - Carol
                        • 9. Re: Numbering in topics created by importing a Word doc
                          Peter Grainge Adobe Community Professional (Moderator)
                          Carol

                          I haven't done any RH7 specific testing so I cannot answer the question. Every other version has worked better though with the toolbar options.