Skip to main content
March 7, 2019
Question

RH2019 - TOC/ bookmark management problems

  • March 7, 2019
  • 2 replies
  • 1285 views

I am using Robohelp 2019.0.5.

RH2017 allows you to easily copy portions of one TOC into another to manage TOC sets. I cannot find how to accomplish this in RH2019. Is this feature just missing or am I just not seeing it?

If I have an Admin TOC and a User TOC that share most of their content, I want to be able to either duplicate the larger TOC and then delete the unneeded topics or I want to be able to copy "books" or "pages" from one and paste them in the other.

I make topics "books" and subtopics (headings in the topic) "pages" in the topic's book in the TOC.

It appears that the only way to get "Books" to self-populate with subtopics is to use Auto-Create TOC to populate the TOC and click "Create TOC pages for bookmarks."  When I do this, I get all the topics that are in "Contents" and the subtopics all have the generic bookmark1, bookmark2, bookmark3, etc. names of the bookmarks. I then have to edit each “page” title so that it matches the subtopic or headings title instead of bookmark1, bookmark2, etc. This becomes a problem when I  want to add another topic to the TOC without wiping out what I  have already set up or copying all of the topics in Contents into the TOC again, requiring that I delete the duplicate.

Also, it seems as though bookmarks must follow the bookmark1, bookmark2, bookmark3, etc. format or the links won’t be valid in the generated HTML. For example, if I edit a bookmark to something recognizable like the actual heading it is bookmarking, then the link in the generated HTML’s TOC doesn’t work. Are bookmarks supposed to work this way or am I missing something there as well? In RH2017 we were to make the bookmark text whatever we wanted.

This topic has been closed for replies.

2 replies

Community Expert
March 8, 2019

Regarding the topic>book and bookmark>page issue.

It's probably worth adding a feature request. I could see it being possible to add a checkbox to the Insert Book dialog box "Create toc pages for bookmarks" that's available when a topic is selected.It should be possible to create pages using the bookmark text name similar to the Auto-create toc function, but it might not be possible to use any other text, as maybe the bookmark is next to a paragraph of text or an image or a table? But I think it's worth creating a feature request for it.

Add bugs and feature requests here: Tracker

I'm not sure about your other problem. I auto-created a toc and the bookmarks I'd manually added in to my topic ("new_heading", "another_heading", "this_is_a_test")  were created as pages using the bookmark text. I then modified the display name to some other text and the table of contents worked correctly in the output. If you change a bookmark after you create the table of contents, you need to manually update that TOC entry to the new bookmark name. We might need more detail about your workflow if this doesn't spark any ideas.

Peter Grainge
Community Expert
Community Expert
March 8, 2019

If you look at the project in Windows Explorer, you will find a TOC folder. You could open the two TOCs in a text editor and work with them that way.

However, that should not be necessary so definitely add a feature request as Amber has suggested.


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.
Community Expert
March 8, 2019

After much playing around I found a way you can do it.

If you open one toc in the toc panel and one toc in the editor pane you can drag and drop from one to the other. This performs a copy, not a move.

There are a couple of bugs though.

  • I couldn't drop a book if the destination toc was currently empty, so make sure you have at least one topic or book in your destination toc to start.
  • If you drag a book that isn't linked to a topic (that is, it only contains topics and isn't linked to one itself) the book name will vanish when you drop it in the destination. The names of any unlinked sub-books will copy across fine though.
  • If you drag a topic across which you've changed the toc display title for, that will lose the name similar to an unlinked book.