Problem/Motivation

A new user to this module but failing to get it working, despite following instructions at
https://www.drupal.org/project/term_glossary
albeit for v3 (latest on said page)

Firstly there is no indication that I need to go to Admin -> Structure -> Taxonomy to edit (or add) a 'vocabulary'. I have done this and added two simple terms (that I expect to be 'underlined' when I hoover in a page and the explanation of that term to appear)

However once I have done so and then gone to Admin -> Structure -> Content Types -> (eg) Basic Page & enabled "Term Glossary" I am not seeing any expected 'underline' and no explanation appears

Proposed resolution

Provide clear step-by-step instructions, perhaps with graphical illustrations

Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

Comments

mkbane created an issue. See original summary.

mably’s picture

Hi @mkbane, I'm one of the module's maintainer.

Any documentation improvements are welcome.

Where are you stuck exactly? Could you provide some screenshot of your configuration screen ? Have you checked the README file?

We need more info to be able to help.

mably’s picture

Status: Active » Needs review

Added a few elements to the README file in this issue's MR.

  • mably committed fb077f0d on 4.x
    Issue #3538785 by mably, mkbane: unclear 'getting started' info
    
mably’s picture

Status: Needs review » Fixed
mably’s picture

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.

mkbane’s picture

apologies @mably for my delay (I didn't get any email notification and (hands-up!) forgot to check back and look for myself).

However, this is still an issue. i have attempted to follow the README but am not getting any glossary entries.

I humbly suggest that the "Go to the display options of the text fields you want to parse in the entity
display configuration forms and check the option Enable term glossary." is not particularly clear as to where this option is.

My site is GreenCompute.UK, I have (I think!) enabled a glossary for "ChatGPT" including on page
https://greencompute.uk/Footprints/AI
but nothing happens (no underline, nothing when i hoover over it)

Happy to share specific page configs if you let me know what's useful

mably’s picture

Could you describe in details what you have done so far so I can check if you missed a step?

mkbane’s picture

I have the module installed.
I have created a GreenSoftware vocab with a term ChatGPT (how to add screenshot here?)
The phrase ChatGPT is on page https://greencompute.uk/Footprints/AI which is a Basic Page
In https://greencompute.uk/admin/structure/types/manage/page/fields I have added reuse an existing field and can see Entity Reference, Reference Type: Taxonomy Term, Vocabulary: GreenSoftware (with Label "Tags", and I have checked Vocabulary "GreenSoftware")
In admin/config/glossary I have GreenSoftware selected and have tried a couple of the integration types (left at their default config)

mably’s picture

It looks like you missed the "Manage display" step on your "body" field:

Manage display

mkbane’s picture

Ah, that screenshot of yours is useful. It is now working :)
I think the phase "Go to the display options of the text fields you want to parse in the entity
display configuration forms and check the option Enable term glossary." on the README would benefit from a screenshot

mably’s picture

@mkbane looks like it's working now :)

Feel free to make any suggestions to improve the documentation.

mkbane’s picture

Yes works now. I got lost at the "Go to the display options of the text fields you want to parse in the entity
display configuration forms and check the option Enable term glossary." so screenshots would have helped (and maybe more exact names of Drupal pages?). with thanks! m

mably’s picture

Feel free to suggest a better wording.

I'll update the readme file accordingly.

mkbane’s picture

@mably it seems to work for Basic Pages but something non-deterministic seemed to happen re Articles eg

e.g. see https://greencompute.uk/Measurement/CarbonFootprint

It felt like I had to set the Manage Display a couple of times...

mably’s picture

It seems to be working fine from here.

May be a cache problem.