forrtproject.github.io icon indicating copy to clipboard operation
forrtproject.github.io copied to clipboard

Transfer glossary creation to Google Sheets

Open LukasWallrich opened this issue 8 months ago • 6 comments

Currently, the glossaries get read from Google Docs (see content/glossary/_create_glossaries.py) … but this is very fiddly for everyone involved, as the Doc style needs to be precisely right, so that we will need to shift to an approach where the glossary translations live in a Google Sheet, before we can add the next batch of languages.

As a first step, we need to create the spreadsheets - probably best with this script that already turns the Docs into a more structured format. Firstly, that should be

  • [ ] English master file with all the details from the English entries

and then translated files from the other languages

  • [ ] German
  • [ ] Arabic

and soon more, each with entry name, translated name, translated entry - and other fields that are not repeating the English.

Then we would need a script to generate the glossary entries from the spreadsheets (pulling all the meta-data from the English one, so that it only needs to be updated in one place - and only the translation and translator info from the respective language.

In this step, also a standard citation footer to each glossary entry (TASL format), with reference to original glossary article.

LukasWallrich avatar Apr 11 '25 16:04 LukasWallrich

Just adding a little note here about the Carpentries and Glosario. I just found out about Glosario and I'm curious what we could learn from them/ share with them. This is just a stub for now to remind me look into this more. Also - they have an event tomorrow which I'll try to go to.

https://hachyderm.io/@thecarpentries/114459354773259110

da5nsy avatar May 06 '25 06:05 da5nsy

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[bot] avatar Jul 06 '25 02:07 github-actions[bot]

Keep open

Lukas Wallrich 1001 Valegro House // London SE10 9LJ @.*** // +44 7591 975294 // +49 163 4704135 https://lukaswallrich.coffee

On Sun, 6 Jul 2025, 04:39 github-actions[bot], @.***> wrote:

github-actions[bot] left a comment (forrtproject/forrtproject.github.io#321) https://github.com/forrtproject/forrtproject.github.io/issues/321#issuecomment-3040599042

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.

— Reply to this email directly, view it on GitHub https://github.com/forrtproject/forrtproject.github.io/issues/321#issuecomment-3040599042, or unsubscribe https://github.com/notifications/unsubscribe-auth/AOK6NGPRX3ZXRSMAA4FDRR33HCD65AVCNFSM6AAAAAB26UZ2VWVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTANBQGU4TSMBUGI . You are receiving this because you authored the thread.Message ID: @.***>

LukasWallrich avatar Jul 06 '25 16:07 LukasWallrich

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[bot] avatar Sep 06 '25 02:09 github-actions[bot]

Keep open!

flavioazevedo avatar Sep 06 '25 09:09 flavioazevedo

@richarddushime this is the spreadsheet where the glossary entries live - https://docs.google.com/spreadsheets/d/1IelzKlB7_UmnwbqgpEZnkFubB0ks-qFaIxhqEJGBH2g/edit

To embed in code, this is the csv link https://docs.google.com/spreadsheets/d/e/2PACX-1vRKXOzAaBg19k2mjs6EIwY3la7DjX1XXDB2Wzkos4y3r7MS0f1g8bGskSEoQWkaAv4unczvpeGAQFwv/pub?gid=955789150&single=true&output=csv

LukasWallrich avatar Oct 30 '25 21:10 LukasWallrich

Then review English Literature review contains the whole reference list for part 1

LukasWallrich avatar Nov 26 '25 16:11 LukasWallrich

Enhancement would be to also make the references in glossary entries clickable - but first need to make reference section useful

LukasWallrich avatar Nov 26 '25 16:11 LukasWallrich

Here two reference issues that were kindly flagged to us - they will help us to check whether the new approach improves things:

  • In the glossary's "Red Team" entrance [https://forrt.org/glossary/english/red_teams/] there is a reference "Coles et al. (2020)" that does not appear in the references page [https://forrt.org/glossary/references/]; there is only one reference with an author called "Coles" [Obels, P., Lakens, D., Coles, N. A., Gottfried, J., & Green, S. A. (2020). Analysis of Open Data and Computational Reproducibility in Registered Reports in Psychology. Advances in Methods and Practices in Psychological Science, 3(2), 229–237. https://doi.org/10.1177/2515245920918872] and it is not the first author but the year is the same. So, or A)the citation is wrong and should be "Obels et al., 2020", or B)there is a reference missing.

  • Also, less important, on the same page, for the "Lakens (2020)" reference, there are 2 "Lakens, 2020" refernces, so it would be nice to put either "a" or "b" on the glossary's reference citation.

LukasWallrich avatar Dec 11 '25 15:12 LukasWallrich