Adapt mechanism for citiation count

[dfuchss]

Summary

This PR introduces an automated mechanism to update the citation count for authors' publications.

• Inspired by @BernardoCama’s suggestion in google scholar citation count no longer working. #3150.
• Resolves google scholar citation count no longer working. #3150.

Key Changes

• Adds an action to update publication citation counts.
  • Note: This action creates a commit on the main branch.
  • To trigger further GitHub Actions workflows from this commit, a Personal Access Token (PAT) must be used (the default GitHub Actions token cannot trigger subsequent workflows).
• Adds and manages citation data in _data/citations.yml.
• Adds and adapts bin/update_scholar_citations.py to handle citation updates.

Usage Examples

• Sample action runs:
  • https://github.com/dfuchss/fuchss.org/actions/runs/15248640083
  • https://github.com/dfuchss/fuchss.org/actions/runs/15237708076
  • https://github.com/dfuchss/fuchss.org/actions/runs/15379217290 (here you can see how it looks like, if scholar could not be updated)
    E.g.,

Outstanding Tasks

• Add thorough documentation (suggestions for location are welcome).
• Discuss whether the action should always require a PAT for commits, as not using one will prevent CI from being triggered.

[netlify]

✅ Deploy Preview for relaxed-lollipop-b6bc17 ready!

Name	Link
🔨 Latest commit	d49d586
🔍 Latest deploy log	https://app.netlify.com/projects/relaxed-lollipop-b6bc17/deploys/687e8af4e6996800083b703c
😎 Deploy Preview	https://deploy-preview-3177--relaxed-lollipop-b6bc17.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[george-gca]

What are the reasons for the Personal Access Token (PAT) to be needed? I don't think I completely understand it.

[dfuchss]

Without a Personal Access Token (PAT), everything will function normally except that the commit updating citations.yml won't trigger any subsequent GitHub Actions --- meaning the update of the citation count won't be deployed. To ensure the CI pipeline runs after the commit, you need to use a PAT (see https://github.com/orgs/community/discussions/25702)

[george-gca]

Can you also add a section in CUSTOMIZE.md teaching how one could set up the personal key?

[dfuchss]

Can you also add a section in CUSTOMIZE.md teaching how one could set up the personal key?

Sure. I'll update the PR.

[dfuchss]

@george-gca I've added the section.

From my point of view, we have two options:

a) before merging, you should create a PAT secret for al-folio itself, otherwise the action will fail
b) by default we could comment the part in the action regarding the PAT; then users that want to use PAT, need to uncomment that part in the action.

What do you think?

[george-gca]

I prefer the second one, since I don't have permission to create the token myself (only @alshedivat does). I just checked, and our deploy workflow have a manual dispatch option, so could you add it to the CUSTOMIZE.md the information that if you don't want to create a token, you can forcefully run the deploy action manually?

[dfuchss]

@george-gca it's now adapted accordingly

[dfuchss]

@george-gca do you need further changes :) ?