https://github.com/continuous-foundation/crossref-utils
Utilities for creating crossref deposits
https://github.com/continuous-foundation/crossref-utils
Last synced: 5 months ago
JSON representation
Utilities for creating crossref deposits
- Host: GitHub
- URL: https://github.com/continuous-foundation/crossref-utils
- Owner: continuous-foundation
- License: mit
- Created: 2024-02-02T06:16:05.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-11-15T01:53:01.000Z (7 months ago)
- Last Synced: 2025-11-21T11:09:01.777Z (7 months ago)
- Language: TypeScript
- Size: 1010 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# crossref utilities
[](https://www.npmjs.com/package/crossref-utils)
[](https://github.com/continuous-foundation/crossref-utils/blob/main/LICENSE)
[](https://github.com/continuous-foundation/crossref-utils/actions)
Utilities for creating crossref.org deposit metadata from node or the command line.
To use from the command line, use the `-g` to create a global install.
```
npm install -g crossref-utils
```
## Creating a deposit
To create a deposit, from within a [MyST](https://github.com/jupyter-book/mystmd) project, run:
```
crossref deposit --type -o .xml
```
This will prompt the user to select new DOIs, if they are not present in MyST metadata. Available options are:
- `--type`: Currently available types are `journal`, `preprint`, `conference`, and `dataset`. Each type is discussed in more detail below.
- `-o, --output`: Output xml file. If this is not provided, the xml will be printed to stdout.
- `--file`: Specific file to use for the deposit; this may be a single article or a `myst.yml` file. If not specified, the CLI will prompt the user.
- `--prefix`: DOI prefix to use for new, generated DOIs. Default is Curvenote's prefix.
- `--name`, `--email`: Depositor name and email. Default Depositor is Curvenote.
- `--registrant`: Registrant organization. Default is `Crossref` - likely this should not be changed.
- `--id`: Unique ID for the deposit. By default, a random ID will be autogenerated - likely this should not be changed.
### Deposit types
Crossref supports multiple deposit types; currently `crossref-utils` supports the following four. For each of these, supported article metadata pulled from MyST frontmatter include:
- `title`
- `subtitle`
- `doi`
- `date` - used as publication date
- `license` - only the URL is used
- `funding` - MyST funding information is reduced to only award numbers and sources
- `first_page`/`last_page`
Additionally, the following information will be pulled from the MyST project:
- `abstract`
- `citations` - only citations with DOIs are included
Different deposit types have different required fields. If DOIs are not provided, the user will be prompted to select new DOIs. If other required fields are not provided, the user will receive an error message.
#### Journal
This type is used to register a new journal and/or new journal articles. If `--file` is set to `myst.yml`, this deposit type will attempt to discover multiple articles in the MyST project.
In addition to the above article metadata for each article, this deposit type requires journal title and DOI, set under `venue` frontmatter in `myst.yml`:
- `venue.title` - journal title
- `venue.doi` - journal DOI
You may also specify in the frontmatter:
- `venue.short_title` - journal abbreviation
- `volume.number`
- `issue.number`
- `issue.doi`
#### Conference
This type is used to register a conference proceedings. Similar to "journal" deposits, this will attempt to discover multiple articles.
In addition to the above article metadata for each article, this deposit type requires conference title, proceedings title, and proceedings publisher, set in `myst.yml`:
- `venue.title` - conference title
- `volume.title` - proceedings title
- `venue.publisher` - proceedings publisher
You may also specify in the frontmatter:
- `venue.short_title` - conference acronym
- `venue.number` - conference number
- `venue.date` - conference date
- `venue.location` - conference location
- `venue.series` - series title
- `venue.issn` - series issn
- `venue.doi` - series doi
- `volume.subject` - proceedings subject
- `editors` - proceedings editors
#### Dataset
This type is used to register a database deposit. For this type, each "article" is considered a dataset, where "article frontmatter" is used as dataset frontmatter.
In addition to the individual dataset metadata, this deposit type requires a database title, set under `venue` frontmatter in `myst.yml`:
- `venue.title` - database title
You may also specify in the frontmatter:
- `editors` - database contributors (independent from the individual dataset authors)
- `venue.doi` - a related item that each dataset is part of.
#### Preprint
This type is used to register any posted content - these are standalone articles not associated with a journal or conference. You cannot register multiple articles with this type. Also, there is no additional metadata required than the article metadata described above.
## Validating a deposit file
To validate an existing deposit XML file against the schema:
```
crossref validate .xml
```
---
This package is [ESM only](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).
---
Made with love by
Continuous Science Foundation 