Link to glossary in PDF not working

[KarenMinOR]

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?

[Jeff_Coatsworth]

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.

[KarenMinOR]

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]

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.

[KarenMinOR]

The Glossary Style (tooltip in my case) is a selection for the frameless output preset, so that shouldn't affect the PDF output. The glossary is included in the PDF, so IDU why it's not working for the PDF. It's in the back matter section of the ToC, if that matters. The project has only one glossary -- it prints fine in the PDF; just the hyperlinks are missing.

For the fun of it, I Removed Glossary Term for one entry and readded it. Still, the PDF prints with plain text, even though Link glossary terms to the glossary page is enabled for the template.

I guess to see the help page, you'll need to open the update 4 announcement post from Adobe, click the What's New link, and follow the link to the new feature. 

[Jeff_Coatsworth]

Yeah, I tried following that - there seems to be bunch of broken links on that What's New in update 4 page to the further references in the help - Page Organization (https://helpx.adobe.com/robohelp/using/components-pdf-template.html#page-organization) is busted; Link glossary terms (https://helpx.adobe.com/robohelp/using/components-pdf-template.html#hyperlink_glossary_term) busted; Don't show chapter auto number (https://helpx.adobe.com/robohelp/using/components-pdf-template.html#donotshowchapterautonumber) busted; Page renumbering restart (https://helpx.adobe.com/robohelp/using/design-page-layout.html#page_number_restart_from) busted.

[KarenMinOR]

Oh! Wild. The link in my OP was working when I copied it! 😛

[Peter Grainge]

I have reported those links to Adobe.

________________________________________________________

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

[Peter Grainge]

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.

[KarenMinOR]

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

[Peter Grainge]

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.

[Peter Grainge]

@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.

[KarenMinOR]

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

[KarenMinOR]

Whoa. I just noticed that the ToC is listed in the ToC. That never happened before! (Unrelated to the OP, though.)

[Peter Grainge]

Content deleted 

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

[KarenMinOR]

OK, nvm 😄 

[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.

[KarenMinOR]

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]

@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.

[KarenMinOR]

I *just* noticed that! 😄 

There's also a case-sensitive match, so I'll try that too.

[KarenMinOR]

I finally got back to this project and tried these steps, also checking Case-sensitive match and Convert only the first instance. The results:

• Glossary is included in the PDF
• Glossary is no longer listed in the ToC (it was before the "conversion")
• The terms in the topics are still plain text

[Peter Grainge]

Test it in a new project with default.css or copy my CSS from the About RoboHelp sample project. It is working for me.

________________________________________________________

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

[KarenMinOR]

Using a sample project, I got it to work. Thanks for the tip! Now to figure out what's different in mine... 🙂