Improve reference display

[LukasWallrich]

The website is full of citations that are currently not systematically linked to references - so that they are of little use. We have a standing promise to change that in the glossary (#135) but the issue also arises in many other places.

Could we fix this across the webpage? I can think of three options:

• project-specific reference pages, with links from the specific mentions
• FORRT wide reference page, with links from the specific mentions

Or, my favorite:

• when clicking on the citation, a popup appears with full reference and abstract - linking to the original source. Very simple dummy (with ChatGPT generated code) below, should of course be prettier.

popup_test.html.zip

@flavioazevedo would this solution make sense for you?

[LukasWallrich]

Add copy reference button in corner of popup

[LukasWallrich]

This would be the possible steps - from conversation with @seunolufemi123

Maybe you can try to first implement it prettily on one page, with one reference, just using HTML, CSS and JS, as needed? Then the next step would be to move the elements to their appropriate homes: CSS into our global CSS file (see https://hugo-mini-course.netlify.app/sections/styling/custom/), the JS into a central place (header.html or footer.html in layouts/partials or maybe baseof.html) and then generate a short code based on the HTML (https://gohugo.io/templates/shortcode/). To then avoid having to include full reference details into the shortcode, we would want to look up the reference in a database - according to ChatGPT, that should be very easy: https://chatgpt.com/share/673dc36e-23e4-800e-b3a9-0a5e57494bfc, though I expect we might have to do some touble-shooting.

[github-actions]

This issue has been inactive for more than 90 days. If there is no further activity, it will be automatically closed in seven days time. You can reopen the issue if it is still relevant.

[github-actions]

This issue has been automatically closed due to it being stale for more than 7 days. Please feel free to reopen if you still want this issue.

[LukasWallrich]

@seunolufemi123 are you still working on this? It would be a great improvement to the webpage ...

[seunolufemi123]

Hi @LukasWallrich, I am so sorry that this is delayed, I lost track of it. Can we fix a meeting, at your convenience so you can help me make sense of what am supposed to do and how best I could do it? I would be looking forward to hearing from you. Thanks and Best regards.

[LukasWallrich]

There is actually a very nice hugo plugin that would get us 95% there: https://github.com/loup-brun/hugo-cite. However, it's not been updated since 2002 - not entirely sure if it is working at the moment, and can obviously break at any point.

https://github.com/joksas/hugo-simplecite is a more active project, but does not support APA style (only footnotes), and - more importantly - does not support a site-wide reference file (and as I see it not even a cited-in bibliography, which would make it much less useful for e.g. the glossary.

[LukasWallrich]

We could go for a more "handmade" solution as suggested here - but that has already broken on their example site, so stating from hugo-cite (and maybe fixing issues in a PR to it) might be the best idea ...

[LukasWallrich]

Process from here:

• Lukas will set up hugo-cite on glossary landing page
• Seun will check functionality and see if this is a good tool
• S&L will decide on how to get citation data collected - e.g., a master spreadsheet (w/ key and bibliography entry)
• S will document how to add bibliography entry and citation in text
• S&L will agree how to get references into the text files

[seunolufemi123]

Good stuff, I am looking forward to hearing from you.