Skip to main content
Community Expert
September 24, 2018
Question

Linking Word documents - how to include bookmarks

  • September 24, 2018
  • 1 reply
  • 981 views

Hi guys,

I'm assuming it's possible, but I haven't had any luck.

I'm trying to use the linked Word document feature. The Word document has bookmarks inserted.

Should the bookmarks be included in the html files created by Robohelp? At the moment I'm not getting any bookmarks and I can't see any settings related to including or excluding them. Are there any tricks I need to be aware of?

RH11

Word 2013

Multiscreen HTML5

This topic has been closed for replies.

1 reply

Peter Grainge
Community Expert
Community Expert
September 24, 2018

No tricks that I am aware of. Something is nagging about using cross references in Word rather than bookmarks. Sorry. Haven't touched this for a long time.


See www.grainge.org for free RoboHelp and Authoring information.

@petergrainge

Use the menu (bottom right) to mark the Best Answer or Highlight particularly useful replies. Found the answer elsewhere? Share it here.
AmebrCommunity ExpertAuthor
Community Expert
September 25, 2018

I should clarify that I'm not including any links in the document, just the bookmarks. The request was a data dictionary that they can link to individual terms in, but the dictionary itself will be managed in a Word file, so the bookmarks need to be added in the Word file and survive the import process. I'd thought I'd seen this sort of thing work years ago, but it's been literally decades since I've worked with Word source.

AmebrCommunity ExpertAuthor
Community Expert
September 26, 2018

I was hoping the bookmarks in the Word doc would come through into the htm file. I'd thought I'd seen it work that way years ago, but couldn't get it to work.

Now that you've confirmed that it doesn't, I'll go back to my stakeholder and let them know what they want is not possible and they'll have to investigate other options.

Edit: And the idea was that the bookmarks would be, for example, the dictionary term with underscores instead of spaces, and people who know what they're doing could link to www.mysite.com/data_dict.htm#widget_one. It would only be a subset of people creating links to individual terms (probably mostly just me, given how most non-tech-writer-people do documentation ).


Oh! Oh! I might have something!

It looks like you can apply a condition code to the created htm in RH and that survives the update process.

So theoretically I can get them to include a table of contents in the Word doc and a heading with a particular style before the content, then set the import to create sepearate topics at that heading. The bookmarks created by the TOC then flow into the topic. Then I apply an Exclude condition to the TOC htm file.

Obviously needs a thorough testing, but works in a simple example. Then there's just the challenge of ensuring they apply styles correctly and refresh the TOC every time they update the doc... (What *do* they teach kids these days??)