Copy link to clipboard
Copied
Is there a way to import conditional tags, when importing FrameMaker documents to RoboHelp?
For example, I have a lot of text in my FrameMaker document that has conditions applied to it. When I import the document, the text is there in RoboHelp, but it does not have any conditions on it, and it is indistinguishable from the regular content. I don't see any way to map FrameMaker conditions to RoboHelp conditions when I do the import.
I'm using RoboHelp 2022.2.22, and FrameMaker 2020 (though I could upgrade to 2022 if that will help the situation).
If it is not possible to import the conditions, does anyone have any recommendations? Here are my initial thoughts:
Which leads to my next question: the find/replace functionality seems very weak in RoboHelp. In Frame, you can search for text using a particluar paragraph tag, character tag, or condition... You can search for cross references, unresolved cross refernces, specific markers (index, topic alias, etc), and the list goes on.. But in RoboHelp, I don't see any of that functionality. It looks like the only thing you can search for is a text phrase??
Ok, I think I have found the problem. When it converts the FrameMaker document, it is not converting it properly. When I look at the HTML/Source view, there are conditions applied, but they are applied incorrectly. Here is an example of how it gets converted:
<span data-conditional="technote">This conditional tag is used to convey any information that would be useful for internal staff. </span>
There are three problems:
Copy link to clipboard
Copied
Your conditions should come over from FM - just make sure that you haven't applied any Show/Hide settings to the content in FM before importing. You should see the conditional tags in the HTML view of topics. What you will have to do to use them is create Conditional expressions - the single CBTs of Classic imports don't apply anymore in the New UI.
Copy link to clipboard
Copied
I confirmed that I have "Show All" set in the Frame document before I do the import...
And yes, I do see the condition tags in the HTML/Source view of the topic. But they don't show up in the regular "Author" view, so how do I see what conditions are applied to which sections of text, without checking the HTML?
Also, the conditions themselves are not shown in the list of conditions under Author > Condition Tags. I tried creating the conditions under Author > Conditition, using the same names that I see in the HTML/Source view. Then I created a conditional expression (Output > Conditional Expression), and used that expression when I generated the output, but it did not have any effect.
Copy link to clipboard
Copied
Copy link to clipboard
Copied
Check under the View > Show menu to see if you have the condition tags formatting set to be displayed. It's configurable because sometimes all the extra formatting makes it hard to concentrate.
Copy link to clipboard
Copied
On the Search issue, there is a Find in Source View setting. Is that not giving you what you want?
________________________________________________________
My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.
Copy link to clipboard
Copied
Hi Peter,
Thanks for pointing out the Search in Source View. So yes, I see that you can search more discreetly in the Source View, but I think it would be a lot nicer to be able to search for things like paragarph styles, conditions, character styles, etc, in Author View... Maybe it's just because I am new to RH, and spoiled by FrameMaker, but IMHO, sifting through HTML code is a lot more difficult and harder on the eyes.
Copy link to clipboard
Copied
Ok, I think I have found the problem. When it converts the FrameMaker document, it is not converting it properly. When I look at the HTML/Source view, there are conditions applied, but they are applied incorrectly. Here is an example of how it gets converted:
<span data-conditional="technote">This conditional tag is used to convey any information that would be useful for internal staff. </span>
There are three problems:
So to fix this, I had to:
What should REALLY happen here, is you should create your conditions in RH first (assigning a Group to each one), then during the import, you should be able to map your Frame condtions (which won't have a group) to your RH conditions (which will have a group). And of course, they need to fix the "data-conditional" to "data-condition"
Copy link to clipboard
Copied
I forgot to say, that once I made all of these changes, the condition colors started showing up in Author view, and I could now show/hide various conditions, use conditional expressions, etc. Before I made the changes above, none of that was possible.
Copy link to clipboard
Copied
Just had a look at one of my FM to RH projects (back in RH11) - the HTML view shows this
<?rh-cbt_start condition="HelpOnly" ?>
as the tag that starts a conditional content tag coming from my FM content.
Copy link to clipboard
Copied
I never used that older version of Robohelp, I'm starting fresh with version 2022.2.22. The way I figured it out was by applying one of the "pre-loaded" conditions to a bit of text. For example, I applied the "OnLine" condition to some text, and then looked at the HTML to see how it got tagged:
<span data-condition="Platform:Online">sample text</span>
And then I compared it to how the imported FrameMaker text was getting tagged:
<span data-conditional="help">sample FrameMaker text</span>
WhenI changed the HTML on the Framemaker text to match how the "OnLine" condition was applied:
<span data-condition="Platform:help">sample FrameMaker text</span>
... it still didn't really fix anything. I also had to create a new condition called "help" that had a Group = Platform. And then everything worked fine.
Copy link to clipboard
Copied
Glad it worked out, but sounds a bit painful if you have to do it repeatedly. Two things I'd experiment with would be to first see what shows up if you Publish directly out of FM2020 to HTML5 (that might be interesting to see what/how the conditions come through) & the other is to upgrade to FM2022 and try the import route again to see how the conditions come across. If you still get that "data-conditional" bit, then I would suggest logging a bug in the Tracker (https://tracker.adobe.com/).
Copy link to clipboard
Copied
I tried it again after upgrading Frame to 2022, but got the exact same results. I did log the bug in the Tracker: https://tracker.adobe.com/#/view/RH-11586