• Global community
    • Language:
      • Deutsch
      • English
      • Español
      • Français
      • Português
  • 日本語コミュニティ
    Dedicated community for Japanese speakers
  • 한국 커뮤니티
    Dedicated community for Korean speakers
Exit
0

Adding custom tags in RoboHelp 2017

Participant ,
Dec 13, 2018 Dec 13, 2018

Copy link to clipboard

Copied

To identify the content that is required by tooltips in my application, I currently add tags to the start and end of the relevant content in each Help topic. They use the following format:

<tooltipabc>

</tooltipabc>

The relevant tooltip content is picked up by the software, which is great. However, RoboHelp does not like them as it sees them as alien, and highlights them in red. When they are used within tables, they appear to corrupt the table, and make it hard to edit it. My question please: could anyone suggest a way of hiding information within a topic that does not involve using tags such as these? This information should not be visible to the reader, but could hopefully be picked up by the application, which would look for tags beginning with a certain word, for example, "tooltip". I currently use the HTML5 output. I'd really appreciate any advice on this. Thanks.

Views

662

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
community guidelines
Community Expert ,
Dec 13, 2018 Dec 13, 2018

Copy link to clipboard

Copied

I don't think it is what you want but maybe Item 6 at Snippets will lead you somewhere.


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

@petergrainge

Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.

Votes

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
community guidelines
Community Expert ,
Dec 13, 2018 Dec 13, 2018

Copy link to clipboard

Copied

Assuming that the application slurps in the content surrounded by the custom tags (that is, you want to use the content in the application, not put a tooltip over the content in your help file) then I think the data-* attributes are what you want. You'd have to enter them in the code and I can't guarantee that RH will leave them alone, but worth a try. (For what it's worth, RH11 seems to leave the attribute alone both after editing a topic and when generated.)

Using data attributes | MDN

Votes

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
community guidelines
Participant ,
Dec 14, 2018 Dec 14, 2018

Copy link to clipboard

Copied

Thanks both. I do want to use the content in the application, but need the tags to be hidden in the displayed topic. I have had a quick try at getting this working by adding <article> tags and then adding 'data' items within them, but found that anything within these tags is displayed when I preview the topic.

Votes

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
community guidelines
Community Expert ,
Dec 14, 2018 Dec 14, 2018

Copy link to clipboard

Copied

Thinking about it again, I think it's not going to do what you want, as you'd need to put the content in the data-xx attribute.

e.g <span data-tooltip="This is my tooltip content">This is my tooltip content</span>

Unless it's more extensible that I think. But you'd have to ask web developers about it.

So, next idea is to use an id. The id attribute can go on any tag as far as I'm aware, so you could put it on a p, or wrap what you need in a span or a div, depending on your needs.

<p id="apptooltip">This is my tooltip content</p>

Similar to the data-xx, you can't see that it's set in the RH interface, but you could apply a hack so the style displays in RH but not in browser (As far as I can tell. But no guarantees.)

The css you need is:

#apptooltip {

     background-color: pink !rhstyle;

}

  • #apptooltip indicates you're targeting a tag with an ID attribute that has a value of "apptooltip".
    I haven't specified a tag, so it will match where ever you use the id. But if you decided to always use a span, you could write it as span#apptooltip. You can use whatever value you want as long as it meets the ID guidelines - there's a couple of characters you can't use; I think space is a banned one.
  • Use whatever styles you want. I figured some sort of background colour would be stand out.
  • The !rhstyle text is the hack that means it doesn't display in browsers. It isn't recognised by the browsers, so they ignore the entire property declaration. You could use any text except 'important' after the exclamation mark (e.g. !apptooltip would also work).

idstylehack.PNG

Votes

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
community guidelines
Participant ,
Dec 18, 2018 Dec 18, 2018

Copy link to clipboard

Copied

Thanks very much. Really appreciate your advice. Haven't had time to test this yet in my environment, but will let you know how I get on ASAP. Cheers,

Mark

Votes

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
community guidelines
Participant ,
Jan 07, 2019 Jan 07, 2019

Copy link to clipboard

Copied

Hi. I have tried adding <span id=”tooltipX”></span> tags  within a table in RoboHelp, and unfortunately the application would not accept them, and tries to strip them out. They appear to work OK outside of tables. The tricky challenge is to find a way to add tooltip tags within a table. If you have any other suggestions, they would be much appreciated.

Thanks again.

Votes

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
community guidelines
Community Expert ,
Jan 07, 2019 Jan 07, 2019

Copy link to clipboard

Copied

See if Item 6 in Snippets on my site helps.


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

@petergrainge

Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.

Votes

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
community guidelines
Participant ,
Jan 08, 2019 Jan 08, 2019

Copy link to clipboard

Copied

Thanks for the link. However, this does not do quite what I need. I don't need to add a pop-up tooltip in the RoboHelp topic. I actually need to add hidden tags within RoboHelp tables that our software application can use to identify the tooltip content it needs to display in the software. I feel there must be a way to do this within a table, but I can't find a way of doing this that RoboHelp is happy with.

Votes

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
community guidelines
Community Expert ,
Jan 08, 2019 Jan 08, 2019

Copy link to clipboard

Copied

What if you add the id on the td tag instead? Does your application pick that up?

Otherwise, I think you'll need to talk to your developers to see if they can make changes to how the application detects the text you need. There doesn't seem to be any problem with the span tag making it in to the output, at least in the small test I tried (RH2017, Responsive HTML5, Indigo).

Votes

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
community guidelines
Participant ,
Jan 08, 2019 Jan 08, 2019

Copy link to clipboard

Copied

LATEST

Thanks for the suggestion to try adding the id on the td tag instead. I created a new character style for tooltips and applied it to the relevant cells in a table. I then edited the HTML, changing the tag name to a unique tooltip tag name. This tag survived the output, which is great. The only problem is that a </span> tag is added in each cell, but I'd hope our developers could get round that. I tried removing this tag but RoboHelp adds it in again when you come out of HTML view. I think this will be a much better solution as RoboHelp no longer highlights the tags in red, and hopefully now sees them as "native".

Cheers,

Mark

Votes

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
community guidelines
Resources
RoboHelp Documentation
Download Adobe RoboHelp