Hopefully, this is my last question for the day.
I'm importing a Word document into RoboHelp 2019 and seeing some odd numbering issues.
In my project I have set up Heading 2s for topics, Heading 4s for procedures, which should initiate autonumbering that starts at 1).
In the attached graphic, somehow the numbering is showing up adjacent to the Heading 2. Additionally, restart numbering at 1 does not occure after the second Heading 4, which is the expected behavior.
All of this looks good in my Word doc, so I figure something weird is happening with the import. Right?
8
Replies
Yeah, no, this is not what I meant 🙂
Just the code of the part of the content from your screenshot from the topic itself, not from the framework of the published output 
Click on the </> button at the top right in the open topic in RoboHelp:
Okay, makes sense. The elements and content are a little bit mixed up. And it gets complicated to debug with all the local formatting overrides.
First, let's remove all the manual local formatting overrides to make cleaner and straight forward (reduced to the "body" part of the code here for simplicity only):
<body>
<div>
<ol class="List0" data-start="1" xmlns="">
<li>
<h2>Login/Logout</h2>
<p>You can login/logout to the Marketplace place to access the website and to subscribe and deploy a service.</p>
<h4>To login to Marketplace</h4>
</li>
<li>In the address bar of your browser, enter the Marketplace URL.</li>
<li>In the <strong>Username</strong> and <strong>Password</strong> fields, enter your user name and password.</li>
<li>Click <strong>Login</strong>.</li>
<li>Select the <strong>Remember Me</strong> check box if you want your login credentials saved in the site.
<h4>To logout of the Marketplace</h4>
</li>
<li>
<p>On the top-right corner of the screen, click the arrow corresponding to your name to access the drop-down menu.</p>
<p>My Dashboard and Logout options are displayed.</p>
</li>
<li>Click <strong>Logout</strong>.</li>
</ol>
</div>
</body>
Now the problem becomes more obvious: First, the whole content including the headings and list items are just one big list (<ol>). Heading 2 ("Login/Logout") is inside the first list item, starting with 1. Followed by a paragraph and Heading 4 ("To login to Marketplace"). All this is in the first list item.
Then the content follows that shall be a list in its own ("In the address bar" until "in the site."). Then an h4 follows again (inside the <ol> list, but not inside a list item). THen another list items and so on.
Now let's fix that: First, let's remove the "big list" surrounding everything. Then let's wrap the "real" list items into separate ordered lists (<ol>).
Result (reduced to the "body" part of the code here for simplicity only):
<body>
<div>
<h2>Login/Logout</h2>
<p>You can login/logout to the Marketplace place to access the website and to subscribe and deploy a service.</p>
<h4>To login to Marketplace</h4>
<ol>
<li>In the address bar of your browser, enter the Marketplace URL.</li>
<li>In the <strong>Username</strong> and <strong>Password</strong> fields, enter your user name and password.</li>
<li>Click <strong>Login</strong>.</li>
<li>Select the <strong>Remember Me</strong> check box if you want your login credentials saved in the site.</li>
</ol>
<h4>To logout of the Marketplace</h4>
<ol>
<li>
<p>On the top-right corner of the screen, click the arrow corresponding to your name to access the drop-down menu.</p>
<p>My Dashboard and Logout options are displayed.</p>
</li>
<li>Click <strong>Logout</strong>.</li>
</ol>
</div>
</body>
Will look like this (default CSS):
Now go the CSS and change the formatting for Heading 2 and 4 as per your needs (blue, Roboto Font etc.)
(P.S. On a heading 2 a heading 3 should follow, not a heading 4. Also: Is "Login/Logout" intended to be the topic title (highest level in the topic?)? If so, it should be h1, not h2 and the procedure heading should then be h2).
Cheers!
Some general import information about importing to respond to Amber.
- Mapping is much improved. First of all the only styles presented for mapping are those in use in the document.
If anyone has tried to import an old document that has been edited by numerous users, they will know how the number of styles in use can be a fraction of the styles available in the document. Just change any document so that everything is Normal and see how many styles are still available. If a style was used once ten years ago it remains in the document in Word. In RoboHelp mapping, as I said, you will now only see what is in use. - In 2019 you have to tick a check box to import inline styles so you won't need to strip them out.
- I haven't tested lists exhaustively but what I have tested has worked in the later versions so make sure all updates are applied.
- If you don't map a style, one of the options is to import from Word. That works better as the styles are put into a second css applied to the topic(s) created. You can then leave that topic with two css files applied or move those styles to your regular css. 2019 allows more than one css to be applied.
- There is a wrinkle at the moment that if a Word style other than lists has numbering applied, such as Heading 1, then it does not show for mapping. I believe that is being fixed in the next update.
See www.grainge.org for free RoboHelp and Authoring information.
AdChoices