106 lines
4.7 KiB
JavaScript
106 lines
4.7 KiB
JavaScript
/**
|
||
* @typedef {import('./types').CiteItem} CiteItem
|
||
* @typedef {import('./types').Mode} Mode
|
||
* @typedef {import('./types').Options} Options
|
||
*/
|
||
import { getSortedRelevantRegistryItems, split, isSameAuthor } from './utils.js';
|
||
import { htmlToHast } from './html-transform-node.js';
|
||
/**
|
||
* Generate citation using citeproc
|
||
* This accounts for prev citations and additional properties
|
||
*
|
||
* @param {*} citeproc
|
||
* @param {Mode} mode
|
||
* @param {CiteItem[]} entries
|
||
* @param {string} citationIdRoot
|
||
* @param {number} citationId
|
||
* @param {any[]} citationPre
|
||
* @param {Options} options
|
||
* @param {boolean} isComposite
|
||
* @param {import('./types').CitationFormat} citationFormat
|
||
* @return {[string, string]}
|
||
*/
|
||
export const genCitation = (citeproc, mode, entries, citationIdRoot, citationId, citationPre, options, isComposite, citationFormat) => {
|
||
const { inlineClass, linkCitations } = options;
|
||
const key = `${citationIdRoot}-${citationId}`;
|
||
const c = citeproc.processCitationCluster({
|
||
citationID: key,
|
||
citationItems: entries,
|
||
properties: mode === 'in-text'
|
||
? { noteIndex: 0, mode: isComposite ? 'composite' : '' }
|
||
: { noteIndex: citationId, mode: isComposite ? 'composite' : '' },
|
||
}, citationPre.length > 0 ? citationPre : [], []);
|
||
console.log(citationFormat);
|
||
// c = [ { bibchange: true, citation_errors: [] }, [ [ 0, '(1)', 'CITATION-1' ] ]]
|
||
const citationText = c[1].find((x) => x[2] === key)[1];
|
||
const ids = `citation--${entries.map((x) => x.id.toLowerCase()).join('--')}--${citationId}`;
|
||
if (mode === 'note') {
|
||
// Use cite-fn-{id} to denote footnote from citation, will clean it up later to follow gfm "user-content" format
|
||
return [
|
||
citationText,
|
||
htmlToHast(`<span class="${(inlineClass ?? []).join(' ')}" id=${ids}><sup><a href="#cite-fn-${citationId}" id="cite-fnref-${citationId}" data-footnote-ref aria-describedby="footnote-label">${citationId}</a></sup></span>`),
|
||
];
|
||
}
|
||
else if (linkCitations && citationFormat === 'numeric') {
|
||
// e.g. [1, 2]
|
||
let i = 0;
|
||
const refIds = entries.map((e) => e.id);
|
||
const output = citationText.replace(/\d+/g, function (d) {
|
||
const url = `<a href="#bib-${refIds[i].toLowerCase()}">${d}</a>`;
|
||
i++;
|
||
return url;
|
||
});
|
||
return [
|
||
citationText,
|
||
htmlToHast(`<span class="${(inlineClass ?? []).join(' ')}" id=${ids}>${output}</span>`),
|
||
];
|
||
}
|
||
else if (linkCitations && citationFormat === 'author-date') {
|
||
// E.g. (see Nash, 1950, pp. 12–13, 1951); (Nash, 1950; Xie, 2016)
|
||
if (entries.length === 1) {
|
||
// Do not link bracket
|
||
const output = isComposite
|
||
? `<a href="#bib-${entries[0].id.toLowerCase()}">${citationText}</a>`
|
||
: `${citationText.slice(0, 1)}<a href="#bib-${entries[0].id.toLowerCase()}">${citationText.slice(1, -1)}</a>${citationText.slice(-1)}`;
|
||
return [
|
||
citationText,
|
||
htmlToHast(`<span class="${(inlineClass ?? []).join(' ')}" id=${ids}>${output}</span>`),
|
||
];
|
||
}
|
||
else {
|
||
// Retrieve the items in the correct order and attach link each of them
|
||
const refIds = entries.map((e) => e.id);
|
||
const results = getSortedRelevantRegistryItems(citeproc, refIds, citeproc.opt.sort_citations);
|
||
const output = [];
|
||
let str = citationText;
|
||
for (const [i, item] of results.entries()) {
|
||
// Need to compare author. If same just match on date.
|
||
const id = item.id;
|
||
let citeMatch = item.ambig;
|
||
// If author is the same as the previous, some styles like apa collapse the author
|
||
if (i > 0 && isSameAuthor(results[i - 1], item) && str.indexOf(citeMatch) === -1) {
|
||
// Just match on year
|
||
citeMatch = item.ref.issued.year.toString();
|
||
}
|
||
const startPos = str.indexOf(citeMatch);
|
||
const [start, rest] = split(str, startPos);
|
||
output.push(start); // Irrelevant parts
|
||
const url = `<a href="#bib-${id.toLowerCase()}">${rest.substring(0, citeMatch.length)}</a>`;
|
||
output.push(url);
|
||
str = rest.substr(citeMatch.length);
|
||
}
|
||
output.push(str);
|
||
return [
|
||
citationText,
|
||
htmlToHast(`<span class="${(inlineClass ?? []).join(' ')}" id=${ids}>${output.join('')}</span>`),
|
||
];
|
||
}
|
||
}
|
||
else {
|
||
return [
|
||
citationText,
|
||
htmlToHast(`<span class="${(inlineClass ?? []).join(' ')}" id=${ids}>${citationText}</span>`),
|
||
];
|
||
}
|
||
};
|