Skip to content

Allow DOI form of note in IEEEtran rules - #22

Merged
s-heppner merged 1 commit into
mainfrom
IEEEtran/doi_field
Oct 8, 2026
Merged

s-heppner merged 1 commit into
mainfrom
IEEEtran/doi_field

Conversation

@s-heppner

Copy link
Copy Markdown
Owner

Previously, the IEEEtran ruleset only accepted the note field in the form [ONLINE]. Available: \url{...}, Accessed: YYYY-MM-DD. For entries with a DOI this is wrong: The IEEE Reference Guide gives a DOI as doi: 10.xxxx/yyy, without the [Online] prefix and without an access date, since a DOI is persistent. Additionally, a doi field was silently dropped by IEEEtran.bst without any warning.

This change extends check_url_field to also accept doi: \href{https://doi.org/10.xxxx/yyy}{10.xxxx/yyy} in note, where the shown DOI must be the same as the DOI in the URL. A doi field is now flagged in the same way as url. The error message and docs/IEEEtran_best_practices.md now list both forms and use the date format YYYY-MM-DD that the check actually requires, instead of YYYY-mmm-dd.

Tests for check_url_field are added. Since importing the IEEEtran rules registers them globally, the existing verify tests now patch the list of rules to only contain their own example rule.

Previously, the IEEEtran ruleset only accepted the `note` field in the
form `[ONLINE]. Available: \url{...}, Accessed: YYYY-MM-DD`. For
entries with a DOI this is wrong: The IEEE Reference Guide gives a DOI
as `doi: 10.xxxx/yyy`, without the `[Online]` prefix and without an
access date, since a DOI is persistent. Additionally, a `doi` field
was silently dropped by `IEEEtran.bst` without any warning.

This change extends `check_url_field` to also accept
`doi: \href{https://doi.org/10.xxxx/yyy}{10.xxxx/yyy}` in `note`,
where the shown DOI must be the same as the DOI in the URL. A `doi`
field is now flagged in the same way as `url`. The error message and
`docs/IEEEtran_best_practices.md` now list both forms and use the
date format `YYYY-MM-DD` that the check actually requires, instead
of `YYYY-mmm-dd`.

Tests for `check_url_field` are added. Since importing the IEEEtran
rules registers them globally, the existing `verify` tests now patch
the list of rules to only contain their own example rule.
@s-heppner
s-heppner merged commit b601c4c into main Oct 8, 2026
2 checks passed
@s-heppner
s-heppner deleted the IEEEtran/doi_field branch October 8, 2026 19:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant