Skip to content
Merged
Show file tree
Hide file tree
Changes from 47 commits
Commits
Show all changes
63 commits
Select commit Hold shift + click to select a range
e1c9939
Export orcid in hugo data
mjpost Sep 19, 2025
2c68ced
Move ORCID icon
mjpost Sep 19, 2025
1308c3d
Remove ORCID itself
mjpost Sep 19, 2025
d650dee
Add question mark for unverified authors
mjpost Sep 19, 2025
a95873c
Add verification page stub
mjpost Sep 19, 2025
5307d68
black
mjpost Sep 19, 2025
ed41c0d
Ensmallen; use fontawesome for both
mjpost Sep 19, 2025
67f4f8f
Bump fontawesome version 5.7.2 -> 5.11.0
mjpost Sep 19, 2025
50bfb33
Icon sizing
mjpost Sep 19, 2025
07ce0b3
Update checksum
mjpost Sep 19, 2025
54ba165
Use fontawesome kit
mjpost Sep 19, 2025
ac57e3b
black
mjpost Sep 19, 2025
2dbb39b
Contra all docs everywhere, you need "fab"
mjpost Sep 19, 2025
2eb7946
Switch back to stylesheet
mjpost Sep 19, 2025
c37d7b1
fa-solid -> fas
mjpost Sep 19, 2025
675b6b7
Relativize link and lighten question mark
mjpost Sep 20, 2025
9083f2b
Set opacity for unverified people
mjpost Sep 20, 2025
c516654
reference syntax
mjpost Sep 20, 2025
b46429a
fontawesome hash
nschneid Sep 20, 2025
57e9cfb
Merge branch 'master-new-author-system' into master-new-author-system-ui
mbollmann Dec 16, 2025
52f6d40
Update bulk metadata form
mjpost Dec 17, 2025
e311b02
Merge branch 'master-new-author-system' into master-new-author-system-ui
mbollmann Dec 24, 2025
fe2cb90
First pass at documentation
mjpost Dec 29, 2025
4e5fb9b
Add note about name variants
mjpost Dec 29, 2025
589f149
Stub page for names
mjpost Dec 29, 2025
bdced7f
Update orcid.md
nschneid Dec 29, 2025
d0f9745
Merge pull request #6965 from acl-org/nschneid-orcid-info
mjpost Dec 30, 2025
d8ed9ee
black
mjpost Dec 30, 2025
85e6d15
Addressing weird hugo error
mjpost Dec 30, 2025
d6012da
names.yml: blank lines
nschneid Dec 30, 2025
c7f6db3
orcid.md: date
nschneid Dec 30, 2025
8b59e4c
Rename names.yml to names.md
nschneid Dec 30, 2025
bdaa993
Partial commit
mjpost Dec 31, 2025
98782b8
Add "Verifying your account" section"
mjpost Dec 31, 2025
636ea83
single.html: source line break led to space before comma
nschneid Jan 4, 2026
a73c095
orcid.md: no space in OpenReview
nschneid Jan 4, 2026
da1bb1b
verification.md: no space in OpenReview
nschneid Jan 4, 2026
22223c5
corrections.md: no space in OpenReview
nschneid Jan 4, 2026
b6012b6
Add three-way verification display
mjpost Jan 4, 2026
5d54bcd
with -> if
mjpost Jan 4, 2026
7fe19b9
Make icon a light green
mjpost Jan 4, 2026
955ebca
Fiddling with color, size, opacity
mjpost Jan 4, 2026
afcd7ca
Handle links to verified & unverified pages separately
mbollmann Jan 6, 2026
70f143f
Merge branch 'master-new-author-system' into master-new-author-system-ui
mbollmann Jan 6, 2026
8506353
Refactor verified check on author page template
mbollmann Jan 6, 2026
900e86e
Refactor and update icon styling
mbollmann Jan 6, 2026
3625997
Spacing: add some daylight between the name and the icon so it doesn'…
nschneid Jan 6, 2026
ce7741f
bootstrap class to set icon margin
nschneid Jan 6, 2026
d297b22
verification.md: a bit more detail on the icons and what verification…
nschneid Jan 7, 2026
10b99e0
header_navbar.html "GitHub" capitalization
nschneid Jan 7, 2026
5139fe4
verification.md: steps for verifying - we want an ORCID iD regardless…
nschneid Jan 7, 2026
c7709ef
orcid.md: OpenReview is one word
nschneid Jan 7, 2026
0fcdc4b
verification.md: fix icons
nschneid Jan 7, 2026
abde567
verification.md: rephrase part about unverified page for ambiguous names
nschneid Jan 7, 2026
893ca21
author page template: no checkmark icon for verification, just ORCID …
nschneid Jan 10, 2026
84063f9
No ? for verified accounts
mjpost Jan 10, 2026
a2c9fd9
Revert "No ? for verified accounts"
mjpost Jan 10, 2026
3d9bc64
Revert "author page template: no checkmark icon for verification, jus…
mjpost Jan 10, 2026
e3d7106
Make question mark green
mjpost Jan 10, 2026
20b83be
Restore paper verification notice in tooltip
mjpost Jan 10, 2026
cea36bd
ORCID iD isn't recorded
mjpost Jan 10, 2026
3f312cc
accidental </a>
nschneid Jan 10, 2026
d2a8772
for author's full display name, only include script variants if verified
nschneid Jan 10, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/02-name-correction.yml
Original file line number Diff line number Diff line change
Expand Up @@ -37,8 +37,8 @@ body:
attributes:
label: Author ORCID
description: |
Provide a valid [ORCID](https://orcid.org) link here. This will be used to help match future papers to your Anthology ID.
placeholder: ex. https://orcid.org/my-orcid?orcid=0009-0003-8868-7504
Provide a valid [ORCID](https://orcid.org) link here, and [add your name variants to your ORCID profile](https://aclanthology.org/info/orcid_id). This will be used to match papers to your Anthology ID.
placeholder: ex. https://orcid.org/0009-0003-8868-7504
validations:
required: true
- type: textarea
Expand Down
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/99-bulk-metadata-correction.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,11 @@ body:
- type: markdown
attributes:
value: >
**This form is not meant to be used manually.** Instead, it is activated by clicking the yellow "Fix data" button found on each paper page in the Anthology (e.g., https://aclanthology.org/K17-1003/). Clicking this button displays a UI tool for modifying the title, abstract, and author list. Submission of that form will automatically populate the title above and data block below.
**Please do not edit the JSON below.** This form is not meant to be used manually; instead, it is activated by clicking the yellow "Fix data" button found on each paper page in the Anthology (e.g., https://aclanthology.org/K17-1003/). Doing so displays a UI tool for modifying the title, abstract, and author list. Submission of that form will automatically populate the title above and data block below.
- type: markdown
attributes:
value: >
Corrections will be processed in bulk on a weekly basis after verification by Anthology staff.
Corrections will be manually reviewed by Anthology staff and processed in bulk on a roughly weekly basis.
- type: textarea
id: data
attributes:
Expand Down
9 changes: 7 additions & 2 deletions bin/create_hugo_data.py
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@
from acl_anthology.collections.paper import PaperDeletionType
from acl_anthology.collections.volume import VolumeType
from acl_anthology.utils.logging import setup_rich_logging
from acl_anthology.utils.ids import is_verified_person_id
from acl_anthology.utils.text import (
interpret_pages,
month_str2num,
Expand Down Expand Up @@ -401,8 +402,12 @@ def export_people(anthology, builddir, dryrun):
if person.orcid is not None:
data["orcid"] = person.orcid
similar = anthology.people.similar.subset(person_id)
if len(similar) > 1:
data["similar"] = list(similar - {person_id})
similar.remove(person_id)
if similar_verified := [id_ for id_ in similar if is_verified_person_id(id_)]:
data["similar_verified"] = sorted(list(similar_verified))
similar.difference_update(similar_verified)
if similar: # any remaining IDs are unverified
data["similar_unverified"] = sorted(list(similar))
people[person_id] = data
progress.update(task, advance=1)

Expand Down
3 changes: 2 additions & 1 deletion hugo/assets/css/main.scss
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,8 @@ $attachment_color: darken( $green, 10% );
$theme-colors: map-merge(
$theme-colors,
(
"attachment": $attachment_color
"attachment": $attachment_color,
"verified": $attachment_color,
)
);

Expand Down
2 changes: 1 addition & 1 deletion hugo/content/info/corrections.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ Please pay careful attention to the following steps.
1. **Ensure that each name is correct**. We treat the information on the PDF as authoritative; this means that the metadata should reflect exactly what is printed on the PDF. A common situation is that the name recorded in Anthology metadata (e.g., John P. Hancock) will not match what is displayed on the PDF (John Hancock). This needs to be corrected first. Please review your papers and [follow the steps here](#metadata-corrections) to correct any discrepancies. Sometimes, this will resolve the split pages.
2. Obtain [an ORCID](https://orcid.org). This is required to help with matching of future papers.
3. Fill out [an author page correction](https://github.com/acl-org/acl-anthology/issues/new?template=02-name-correction.yml). A Github issue is our preferred mechanism, but you can also email [the Anthology director](mailto:[email protected]).
4. Finally, to avoid issues in the future, ensure that the name you use on papers is properly recorded in your profile in publication management systems such as [Open Review](https://openreview.net), [Softconf](https://softconf.com), [EasyChair](https://easychair.org), and so on.
4. Finally, to avoid issues in the future, ensure that the name you use on papers is properly recorded in your profile in publication management systems such as [OpenReview](https://openreview.net), [Softconf](https://softconf.com), [EasyChair](https://easychair.org), and so on.

Anthology staff will address your issue as quickly as possible.
An example merged author profile is [Aravand Joshi](https://aclanthology.org/people/aravind-joshi).
Expand Down
14 changes: 14 additions & 0 deletions hugo/content/info/names.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
Title: Names in the ACL Anthology
linktitle: Names
subtitle: How the Anthology deals with names
date: "2025-12-29"
---
_This page is a stub. It should describe how the Anthology deals with names, including the following._

- PDF metadata and the formation of name slugs
- Creating author pages
- Disambiguating names and merging name variants
- How papers are matched to authors

It can and should refer to other documentation spread around, but this could be a piece of central information.
24 changes: 24 additions & 0 deletions hugo/content/info/orcid.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
Title: ORCID iDs in the ACL Anthology
linktitle: ORCID iDs
subtitle: Best practices for ensuring your papers are correctly linked
date: "2025-12-29"
---

An [ORCID iD](https://orcid.org) is a persistent digital identifier that distinguishes you from other researchers and links your research outputs and activities to your identity.
When these iDs are present on ingested papers, it removes the ambiguity that sometimes arises with popular names and name variants.

We urge every author who is actively publishing papers to create an ORCID iD, and to supply this ID to publication systems such as OpenReview.[^1] In creating or editing your ORCID iD profile, please consider the following tips to help match your papers to your Anthology page:

[^1]: Visit the [edit page link at OpenReview](https://openreview.net/profile/edit) and add your ORCID iD under the "Personal Links" section.

- **Add name variants**: This is most important. In your ORCID iD profile, you can set your given and family names, your published name, and any name variants you have published under (e.g., with or without middle initials, maiden names, etc.). https://orcid.org/0000-0002-1831-3457 is a good example. Make sure you have at least one Latin variant of your name. This helps the Anthology match your publications even if they are listed under different names.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I’m confused about this. When/how are we planning to use name variants recorded on an ORCID profile? This is the first I hear about this, as we have so far only ever talked about using ORCID iDs as they are recorded in the ingestion material. Do we plan to query the ORCID API as part of every ingestion?

Copy link
Contributor

@nschneid nschneid Jan 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I understood it to mean, when we manually verify author page requests it helps to see name matches on orcid.org. And we may add screening checks at ingestion time to flag totally wrong ORCIDs: #7055

- **Make sure your name is visible**: Ensure that your name is set to be visible to everyone in your ORCID iD profile settings. If your name is private, the Anthology may not be able to access it for matching.
- **Register at least one personal email address**: This can be kept private but ensures permanent access so that you can update your ORCID record in the future.

In addition, the following information can help us improve matching, should we need to manually disambiguate authors.

- **Add a few representative publications**: You can add your publications to your ORCID iD profile. This is less important for matching in the Anthology, but it is a good practice to keep your ORCID iD profile complete. Many Anthology papers have DOIs, which simplifies the process.
- **Add educational history and affiliations**: Adding your educational background and current affiliations can help further distinguish you from other researchers with similar names. It is especially helpful for us to know the institution from which you receive (or expect to receive) your highest degree, since we use this information when disambiguating authors.

In addition to this, make sure that the name you enter into submission mangagement systems (such as Softconf or Open Review) matches one of the ORCID variants, ideally the published name.
22 changes: 22 additions & 0 deletions hugo/content/info/verification.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
Title: Verified authors
linktitle: Verification
subtitle: How the ACL Anthology verifies authors
date: "2025-12-29"
---
Every author appearing on a paper in the Anthology is given an author page. The ACL Anthology distinguishes between verified and unverified authors.

A _verified_ author is one for whom we have an explicit entry in our names database.
This can happen either automatically or manually. Entries are created automatically when a paper is ingested with ORCID iD information attached to the papers author(s). We also create entries manually when we intervene to disambiguate authors with similar names or who publish under multiple names. We include a link to the ORCID profile from each verified author's page.

An _unverified_ author is one for whom we do not have an explicit entry in our names database. Unverified pages have `/unverified/` appended to the URL. These pages are created automatically when a paper is ingested without ORCID iD information attached to the authors. Unverified author pages do not include a link to an ORCID profile, but instead include a question mark icon next to the author's name.

### Verifying your account

1. Create an ORCID iD and populate it.

We urge every author to create an [ORCID iD](https://orcid.org), and to supply this ID to publication systems such as OpenReview. The reason is that we use this information at ingestion time to match appers to an author. This is increasingly important as the size of the global scientific community increases, and ambiguous names proliferate. Please see our simple [ORCID iD guide]({{< ref "/info/orcid">}}) for information that will help match your papers to your Anthology page.

2. File an issue on Github.

Navigate to your author page in the Anthology. If you are unverified, the URL will contain `/unverified/`. Click the "Fix author" link at the bottom of the links on the righthand side of the page to create an issue from our template. Provide your ORCID iD along with other relevant information.
2 changes: 1 addition & 1 deletion hugo/layouts/_default/baseof.html
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@
{{ $sass_options := (dict "includePaths" (slice "assets/css" "assets/css/vendor/bootstrap/scss")) }}
{{ $style := resources.Get "css/main.scss" | toCSS $sass_options | minify | fingerprint }}
<link rel="stylesheet" href="{{ $style.RelPermalink }}" media="screen" />
<link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.7.2/css/all.css" integrity="sha384-fnmOCqbTlWIlj8LyTjo7mOUStjsKC4pOpQbqyi7RrhN7udi9RwhKkMHpvLbHG9Sr" crossorigin="anonymous">
<link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.11.0/css/all.css" integrity="sha384-XLYVh3ZsmvjnjODXg/qvDYjcINmPLORACP+Tk6qA3jNLbStl84PzAeEz2Su02511" crossorigin="anonymous">
<link rel="stylesheet" href="{{ relURL "css/academicons.min.css" }}">

{{ block "meta" . }}{{ end }}
Expand Down
30 changes: 26 additions & 4 deletions hugo/layouts/people/single.html
Original file line number Diff line number Diff line change
@@ -1,9 +1,23 @@
{{ define "main" }}
{{ $person := index .Site.Data.people .Params.name }}
{{ $is_verified := not (hasSuffix $person.slug "/unverified") }}
<section id="main">
<h2 id="title">
<!-- {{- .Title -}} -->
<span class="font-weight-normal">{{ $person.first }}</span> <span class="font-weight-bold">{{ $person.last }}</span>
{{ if $person.orcid }}
<a href="https://orcid.org/{{ $person.orcid }}" title="ORCID profile" target="_blank" rel="noopener">
<i class="fab fa-orcid fa-xs align-middle text-verified" style="margin-left: 5pt"></i>
</a>
{{ else if $is_verified }}
<a href="{{ ref . `info/verification` }}" title="Author is verified" target="_blank" rel="noopener">
<i class="fas fa-check-circle fa-xs align-middle text-verified" style="margin-left: 5pt"></i>
</a>
{{ else }}
<a href="{{ ref . `info/verification` }}" title="How to verify an author" target="_blank" rel="noopener">
<i class="fas fa-question-circle fa-xs align-middle text-secondary" style="margin-left: 5pt"></i>
</a>
{{ end }}
</h2>
{{ with $person.comment }}
<p class="font-weight-light text-muted">{{.}}</p>
Expand All @@ -17,13 +31,21 @@ <h2 id="title">
{{ end }}
</p>
{{ end }}
{{ with $person.similar }}
{{ with $person.similar_verified }}
<p class="font-weight-light text-muted">
{{ $len := (len .) }}
<span class="font-italic">{{ if $is_verified }}Other people with similar names:{{ else }}Papers on this page may belong to the following people:{{ end }}</span>
{{ range $index, $sim_id := . }}
{{ trim (partial "author_link.html" (dict "ctx" $ "person" (dict "id" $sim_id))) " \n" | safeHTML }}{{ $sim_person := index $.Site.Data.people $sim_id }}{{ with $sim_person.comment }} ({{.}}){{ end }}{{ if ne (add $index 1) $len }}, {{ end }}
{{ end }}
</p>
{{ end }}
{{ with $person.similar_unverified }}
<p class="font-weight-light text-muted">
<span class="font-italic">Other people with similar names:</span>
{{ $len := (len .) }}
<span class="font-italic">Unverified author pages with similar names:</span>
{{ range $index, $sim_id := . }}
{{ trim (partial "author_link.html" (dict "ctx" $ "person" (dict "id" $sim_id))) " \n" | safeHTML }}
{{ $sim_person := index $.Site.Data.people $sim_id }}{{ with $sim_person.comment }}({{.}}){{ end }}{{ if ne (add $index 1) $len }}, {{ end }}
{{ trim (partial "author_link.html" (dict "ctx" $ "person" (dict "id" $sim_id))) " \n" | safeHTML }}{{ $sim_person := index $.Site.Data.people $sim_id }}{{ if ne (add $index 1) $len }}, {{ end }}
{{ end }}
</p>
{{ end }}
Expand Down
Loading