metascraper-citation
v5.58.7
Published
Metascraper rules for Highwire Press citation_* and Dublin Core dc.* / dcterms.* meta tags.
Maintainers
Readme
Install
$ npm install metascraper-citation --saveLoad it before the generic property packages so these values win over Open Graph (e.g. a clean citation_title instead of og:title with a site suffix).
const metascraper = require('metascraper')([
require('metascraper-citation')(),
require('metascraper-author')(),
require('metascraper-date')(),
require('metascraper-publisher')(),
require('metascraper-title')()
])Supported tags
The bundle is a no-op unless test finds at least one Highwire or Dublin Core tag. Highwire selectors run first; Dublin Core fills gaps (and covers repositories that only emit DC). Missing fields fall through to the generic rules.
Only the four properties below are set. Bibliographic extras (citation_doi, dc.identifier, ISSN, volume, issue, pages, PDF URL, language, abstract) are ignored.
| Property | Tags (first match wins) |
| --- | --- |
| title | citation_title, dc.title, dcterms.title |
| author | citation_author, dc.creator, dcterms.creator, dc.contributor, dcterms.contributor (first author only) |
| date | citation_publication_date, citation_date, citation_online_date, dcterms.issued, dcterms.created, dc.date, dcterms.date |
| publisher | citation_publisher, citation_journal_title, dc.publisher, dcterms.publisher |
Names are matched case-insensitively (DC.Title and dc.title are the same tag).
API
test
const { test } = require('metascraper-citation')Returns true when the Cheerio document has at least one meta[name] starting with citation_, dc., or dcterms. (case-insensitive). Used as rules.test so the bundle skips pages with no scholarly markup.
License
metascraper-citation © Microlink, released under the MIT License. Authored and maintained by Microlink with help from contributors.
microlink.io · GitHub microlinkhq · X @microlinkhq
