Skip to main content
Inspiring
May 21, 2024
Answered

Link to glossary in PDF not working

  • May 21, 2024
  • 5 replies
  • 1681 views

Hi all,

I've recently updated to RH 2022.4.179 (on Windows) and wanted to try the new "Link glossary terms to the glossary page" feature, but the resulting PDF doesn't have the glossterms hyperlinked. I wonder what I've done wrong.

Here's a snippet of the HTML for one of the terms:

<p>To add artwork elements to the Dashboard:</p>
<ol>
<li>Select an artwork element to receive the <a class="glossterm" data-glossterm="enhancement" href="#">enhancement</a>.</li>
<li>Click <strong>Add Targeted Element to Dashboard</strong> ( <img alt="Add Targeted Element Icon" class="icon" height="20" src="assets/images/044-addElementButton.png" width="20" /> ) from the toolbar. The element is added with a default name. </li>
<li>Repeat these steps for each artwork element to be <a class="glossterm" data-glossterm="enhanced" href="#">enhanced</a>.</li>
</ol>


When I generate the PDF (which does include the glossary), the term has no hyperlink visual, nor does clicking it take me to the glossary.

(When I generate the HTML output, the glossary term has the definition in the tooltip as expected/desired.)


The RH help says only that I need to enable the feature:
https://helpx.adobe.com/robohelp/using/components-pdf-template.html#hyperlink_glossary_term

What am I missing?

    This topic has been closed for replies.
    Correct answer Peter Grainge

    @KarenMinOR Try this.

     

    Set up glossary terms.

     

    Use these settings.

     

    In Terms click the dropdown and click each term you want included. 

     

     Close the dropdown 

     

     

    Run the wizard and click Convert, bottom right. You should see this.

     

    Go to one of the topics and it should show as a link. Generate your PDF and it should be OK.

    ________________________________________________________

    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

     

    5 replies

    Peter Grainge
    Community Expert
    Peter GraingeCommunity ExpertCorrect answer
    Community Expert
    May 22, 2024

    @KarenMinOR Try this.

     

    Set up glossary terms.

     

    Use these settings.

     

    In Terms click the dropdown and click each term you want included. 

     

     Close the dropdown 

     

     

    Run the wizard and click Convert, bottom right. You should see this.

     

    Go to one of the topics and it should show as a link. Generate your PDF and it should be OK.

    ________________________________________________________

    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

     

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

    Thank you @Peter Grainge ! This caused new problems, such as

    1. all instances of a word in the glossary are made lowercase, even in titles (which were Title Case before)
    2. the term in the PDF topic is still in plain text, despite #1
    3. every instance of the defined term in a topic are now showing as glossary terms in the RH UI, even though our convention is to only define a word the first time it appears in the topic.

    I'll play around with manual vs automatic to see if I can resolve these issues, but I wanted to thank you for posting this.

    Peter Grainge
    Community Expert
    Community Expert
    May 22, 2024

    @KarenMinOR Case was not changed for me. I think there is an option somewhere for first instance only.

    ________________________________________________________
    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

     

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    Peter Grainge
    Community Expert
    Community Expert
    May 22, 2024

    @KarenMinOR In the TOC if I double click a topic, it opens. If I double click the Glossary, I see nothing and the page is not included in the PDF. Are you seeing the same?

    ________________________________________________________

    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

     

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

    @Peter Grainge , no -- that's not happening in my PDFs. The link to the glossary from the ToC works fine.

    Peter Grainge
    Community Expert
    Community Expert
    May 22, 2024

    Shows how often I work with PDFs. 🙂

     

    Didn't help though. I'll vote for the report. Also if Adobe come back to me, I will let you know what they say.

    ________________________________________________________

    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

     

    Help others by clicking Correct Answer if the question is answered. Found the answer elsewhere? Share it here. "Upvote" is for useful posts.
    Peter Grainge
    Community Expert
    Community Expert
    May 22, 2024

    I'm not sure but I think I see the issue. In a frameless output you have to select which glossary you want to apply. There is no such option in the PDF output.

     

    I have asked Adobe to check.

    ________________________________________________________

    My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

     

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

    Thanks, Peter! It seems that you'd select the desired glossary by including it in the ToC's back matter, which I've done. It is included in the PDF -- that part has always worked fine. Being the gun-jumper that I am :P, I went ahead and logged a bug (upvotes would be welcomed): RH-12470

    Jeff_Coatsworth
    Community Expert
    Community Expert
    May 21, 2024

    Not sure what's going on there - just get 404 errors when trying to look at that help topic, but I suspect the answer is in how glossary terms are defined in the template.

    Inspiring
    May 21, 2024

    Huh. Not sure why that link doesn't work. I followed the Link glossary terms to glossary page link on What's new in RoboHelp (2022 release) Update 4 (adobe.com). The only instruction provided is to enable the checkbox. My glossary works fine in HTML output, but the term is still plain text in the PDF whether the new checkbox is enabled or not. 

    Jeff_Coatsworth
    Community Expert
    Community Expert
    May 21, 2024

    Nope, that link within that page 404s for me too. It kind of makes me think that you need to have a glossary page that is being referenced by the hyperlink, not as a tooltip or popup text.