How to manage linking, searching across child projects

Question

I see a lot of questions about technical difficulties but don't see anything about how to manage child projects in general. Two of us share 20 child projects (HTML5), which were originally a single giant project (CHM). We're on RH 2019 classic using TFS. At the moment, we're maintaining the giant project AND the child projects while programming finishes up doing what it needs to do to deploy HTML5 child projects instead of a single CHM project.

1. We miss is being able to find ALL the topics that link to a topic (in single project: Project Manager > right click topic > Show > Topic Links). This method only finds links within the current project, so how can we find ALL the linked topics across the child projects? Do we search the topic's html file name in the source files somehow?

2. While we tried to split up the single project as logically as possible, we still sometimes struggle to find where a topic is located. So far, we've been searching the source files for the topic's .html file name, but is there a better method to search across all child projects? Occasionally, the .html name does not match the topic name and we get stuck.

Basically, we keep going back to the source files to accomplish cross-child project goals but that increases the chance of moving, altering, deleting (!!) a file. Is there anything in RH that can reach across projects? Being that many work with merged projects, is there any chance RH will one day recognize child projects as being "bonded" and give them appropriate functionality?

Thank you in advance!!!

Peter Grainge · Accepted Answer

There is nothing within RoboHelp that will let you see the linked topics in the same way as you do in a single project. That said I've not seen anyone ask for it before and it was not something I needed with 14,000 topics across the projects. Essentially that was because the child projects contained logical topic groupings.You have mentioned that you have tried to do that so I guess your topics didn't make it quite as easy.

I think you will need to use something like Ultra Search which I have found very efficient in a different context. I haven't tried for your purpose but think it would work well as you can set up different folders to be searched. You would thus just search your projects rather than a whole drive.

What I did use was Xenu. The UI is not the best but it was great at searching a merged output (not CHMs) for broken links, both internal and external. I have been pushing for a similar feature in RoboHelp and am hopeful it will come at some point in the 2019 version. I doubt there will be much development in the Classic version.

Hope this helps.

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

@petergrainge

Amebr · Answer

One workplace, we used variables for the links. You still can't automatically find them, but at least changing them is only required in a couple of places (plus ensuring all the child projects have the same suite of variables - you'll need defined rules for naming, communication and updating ALL variables as they're all stored in a single file).

We made the rule that the link to another topic only ever came as a self contained paragraph ("See Creating a Snazzy Widget.") and added that text as the variable value. The downside was we needed to create multiple variables for each level of folders where the link would be used (so try to keep your source folder structure flat) and would need to remember to use the correct variable in each topic.

e.g.

Snazzy_widget for the root folder

Snazzy_widget_L1 for the first level folders

Snazzy_widget_L2 for the second level folders.

The link had to be manually edited to ensure the correct relative path was entered.

e.g. root was "../child_2/path/to/topic.htm"

(from the root folder, go up one folder, into child_2 project and down to whatever topic)

l1 was "../../child_2/path/to/topic.htm"
(from a topic in the first level of folders, go up to the root, then up one more, then down into the child_2 project and down to whatever topic)

etc.

EDIT: Oh wait, I might be confusing which product we had to do multiple variables for. I think RH *might* adjust the URLs in variables. I'll have to test later, so you might be able to create a single variable to manage an inter-project link.

Sign up

To post, reply, or follow discussions, please sign in with your Adobe ID.

Sign in to Adobe Community

To post, reply, or follow discussions, please sign in with your Adobe ID.

Scanning file for viruses.

This file cannot be downloaded