Highlighted

Merging User Defined Variables

New Here ,
May 16, 2016

Copy link to clipboard

Copied

Hello everyone,

I'm using RoboHelp 2015 outputting to WebHelp (not my choice). Is there anyway to merge existing User Defined Variables (UDV) into one name? Some of my companies are turning into one big company and I need the UDV names to also change.

For example, I have two UDVs called "abc123" and one called "321cbe". I need them to both to be "abc123".

I have tried manually tweaking the rhvariable.apj but just keep corrupting my project even if I delete the *.cpd file. Search and Replace is not finding my instances.

This is one big help system using UDVs, Snippets, Build Tags, and Multiple TOCs. 

Thank you,

Tawni

Views

151

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more

Merging User Defined Variables

New Here ,
May 16, 2016

Copy link to clipboard

Copied

Hello everyone,

I'm using RoboHelp 2015 outputting to WebHelp (not my choice). Is there anyway to merge existing User Defined Variables (UDV) into one name? Some of my companies are turning into one big company and I need the UDV names to also change.

For example, I have two UDVs called "abc123" and one called "321cbe". I need them to both to be "abc123".

I have tried manually tweaking the rhvariable.apj but just keep corrupting my project even if I delete the *.cpd file. Search and Replace is not finding my instances.

This is one big help system using UDVs, Snippets, Build Tags, and Multiple TOCs. 

Thank you,

Tawni

Views

152

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
LEGEND ,
May 16, 2016

Copy link to clipboard

Copied

Hi there

Does it really matter what the actual variable name is?

Perhaps you have a variable named 123 and another named abc. But the value contained inside the variable is really what counts. So if you need both variables to represent the same value, just configure them to contain the same value.

Cheers... Rick

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Adobe Community Professional ,
May 17, 2016

Copy link to clipboard

Copied

I agree with Rick that it is best to leave the two variable and assign the same values.

If you are forced to to have just one variable you would need to look at the code in a topic and then do a multifile find and replace to change the name. If you do go that route, then reate a backup first. I always recommend creating the backup as a zip file. That prevents you opening it accidentally and working on it before you realise it was the backup. This way you always have a clean backup that can be used to create a new clean copy time after time.


See www.grainge.org for RoboHelp and Authoring information

@petergrainge

www.grainge.org for free RoboHelp & Authoring info. Use the blue Reply button at the top to help me help you.
The black Reply link nests replies and they sort out of order.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Contributor ,
May 17, 2016

Copy link to clipboard

Copied

When you wrote that your searches weren't finding the instances of your UDV, what happens if you search for "rh-udv_start"? If you're using the search within RoboHelp, I noticed there is a "Find in Source Code" check box - is it selected when you perform a search that yields no results? One option would be to download and then use a tool called FAR (Find and Replace) to search your HTML code.

As far as whether you need to actually consolidate your UDVs, why did you set up a UDV in the first place? I'm presuming it was because you had a common string of text that was going to be used in many different places and you didn't want to make multiple changes - you wanted to maintain in one place. The primary benefit of using a UDV is exactly that: you only have to change it once. You don't have to search all of your HTML files to make a change. You're making your work so much easier because you've done the "hard work" and identified common strings of text in your documentation. It's a technique called "modular documentation" and when enforced, it can eliminate a lot of redundant work. That said, if multiple UDVs with the same definition makes sense, be sure to document your reasoning in your style guide as well as within a comment within the UDV itself.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...