{"id":27275168,"url":"https://github.com/continuous-foundation/crossref-utils","last_synced_at":"2026-01-22T07:05:16.647Z","repository":{"id":260253811,"uuid":"751702073","full_name":"continuous-foundation/crossref-utils","owner":"continuous-foundation","description":"Utilities for creating crossref deposits","archived":false,"fork":false,"pushed_at":"2025-11-15T01:53:01.000Z","size":1037,"stargazers_count":0,"open_issues_count":6,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-11-21T11:09:01.777Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/continuous-foundation.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-02-02T06:16:05.000Z","updated_at":"2025-10-18T09:26:42.000Z","dependencies_parsed_at":"2024-10-30T12:10:11.399Z","dependency_job_id":"a3cdda59-c9d0-4704-9586-ba1e2c419ede","html_url":"https://github.com/continuous-foundation/crossref-utils","commit_stats":null,"previous_names":["curvenote/crossref-utils","continuous-foundation/crossref-utils"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/continuous-foundation/crossref-utils","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/continuous-foundation%2Fcrossref-utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/continuous-foundation%2Fcrossref-utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/continuous-foundation%2Fcrossref-utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/continuous-foundation%2Fcrossref-utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/continuous-foundation","download_url":"https://codeload.github.com/continuous-foundation/crossref-utils/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/continuous-foundation%2Fcrossref-utils/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28657601,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T01:17:37.254Z","status":"online","status_checked_at":"2026-01-22T02:00:07.137Z","response_time":144,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-11T15:31:02.024Z","updated_at":"2026-01-22T07:05:16.641Z","avatar_url":"https://github.com/continuous-foundation.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# crossref utilities\n\n[![crossref-utils on npm](https://img.shields.io/npm/v/crossref-utils.svg)](https://www.npmjs.com/package/crossref-utils)\n[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/continuous-foundation/crossref-utils/blob/main/LICENSE)\n[![CI](https://github.com/continuous-foundation/crossref-utils/workflows/CI/badge.svg)](https://github.com/continuous-foundation/crossref-utils/actions)\n\nUtilities for creating crossref.org deposit metadata from node or the command line.\n\nTo use from the command line, use the `-g` to create a global install.\n\n```\nnpm install -g crossref-utils\n```\n\n## Creating a deposit\n\nTo create a deposit, from within a [MyST](https://github.com/jupyter-book/mystmd) project, run:\n\n```\ncrossref deposit --type \u003ctype\u003e -o \u003coutput\u003e.xml\n```\n\nThis will prompt the user to select new DOIs, if they are not present in MyST metadata. Available options are:\n\n- `--type`: Currently available types are `journal`, `preprint`, `conference`, and `dataset`. Each type is discussed in more detail below.\n- `-o, --output`: Output xml file. If this is not provided, the xml will be printed to stdout.\n- `--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.\n- `--prefix`: DOI prefix to use for new, generated DOIs. Default is Curvenote's prefix.\n- `--name`, `--email`: Depositor name and email. Default Depositor is Curvenote.\n- `--registrant`: Registrant organization. Default is `Crossref` - likely this should not be changed.\n- `--id`: Unique ID for the deposit. By default, a random ID will be autogenerated - likely this should not be changed.\n\n### Deposit types\n\nCrossref supports multiple deposit types; currently `crossref-utils` supports the following four. For each of these, supported article metadata pulled from MyST frontmatter include:\n\n- `title`\n- `subtitle`\n- `doi`\n- `date` - used as publication date\n- `license` - only the URL is used\n- `funding` - MyST funding information is reduced to only award numbers and sources\n- `first_page`/`last_page`\n\nAdditionally, the following information will be pulled from the MyST project:\n\n- `abstract`\n- `citations` - only citations with DOIs are included\n\nDifferent 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.\n\n#### Journal\n\nThis 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.\n\nIn addition to the above article metadata for each article, this deposit type requires journal title and DOI, set under `venue` frontmatter in `myst.yml`:\n\n- `venue.title` - journal title\n- `venue.doi` - journal DOI\n\nYou may also specify in the frontmatter:\n\n- `venue.short_title` - journal abbreviation\n- `volume.number`\n- `issue.number`\n- `issue.doi`\n\n#### Conference\n\nThis type is used to register a conference proceedings. Similar to \"journal\" deposits, this will attempt to discover multiple articles.\n\nIn addition to the above article metadata for each article, this deposit type requires conference title, proceedings title, and proceedings publisher, set in `myst.yml`:\n\n- `venue.title` - conference title\n- `volume.title` - proceedings title\n- `venue.publisher` - proceedings publisher\n\nYou may also specify in the frontmatter:\n\n- `venue.short_title` - conference acronym\n- `venue.number` - conference number\n- `venue.date` - conference date\n- `venue.location` - conference location\n- `venue.series` - series title\n- `venue.issn` - series issn\n- `venue.doi` - series doi\n- `volume.subject` - proceedings subject\n- `editors` - proceedings editors\n\n#### Dataset\n\nThis 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.\n\nIn addition to the individual dataset metadata, this deposit type requires a database title, set under `venue` frontmatter in `myst.yml`:\n\n- `venue.title` - database title\n\nYou may also specify in the frontmatter:\n\n- `editors` - database contributors (independent from the individual dataset authors)\n- `venue.doi` - a related item that each dataset is part of.\n\n#### Preprint\n\nThis 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.\n\n## Validating a deposit file\n\nTo validate an existing deposit XML file against the schema:\n\n```\ncrossref validate \u003cdeposit\u003e.xml\n```\n\n\n---\n\nThis package is [ESM only](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).\n\n---\n\n\u003cp style=\"text-align: center; color: #aaa; padding-top: 50px\"\u003e\n  Made with love by\n  \u003ca href=\"https://continuous.foundation\" target=\"_blank\" style=\"color: #aaa\"\u003e\n    Continuous Science Foundation \u003cimg src=\"https://continuous.foundation/images/logo-small.svg\" style=\"height: 1em\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontinuous-foundation%2Fcrossref-utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcontinuous-foundation%2Fcrossref-utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcontinuous-foundation%2Fcrossref-utils/lists"}