Citation-JS未按指定CSL模板生成文内引用问题求助

问题原因 #

你遇到的核心问题是：Citation-JS v0.7.x的核心模块不包含CSL（Citation Style Language）格式处理能力，默认的citation输出是极简通用格式，不识别template参数。必须启用官方的CSL插件才能支持APA、AMA等标准引用格式。

解决方案步骤 #

1. 安装/引入CSL插件 #

• Node.js环境：
  先安装核心库和CSL插件：

  npm install citation-js @citation-js/plugin-csl
  

  然后在代码中注册插件：

  const Cite = require('citation-js')
  require('@citation-js/plugin-csl')(Cite)
  

• 浏览器环境：
  引入核心库后，再引入CSL插件的脚本：

  <script src="https://cdnjs.cloudflare.com/ajax/libs/citation-js/0.7.14/citation.js"></script>
  <script src="https://cdn.jsdelivr.net/npm/@citation-js/plugin-csl@0.7.14/dist/plugin-csl.min.js"></script>
  

  插件会自动注册到全局的Cite对象上。

2. 正确生成CSL格式的文内引用 #

启用插件后，需要使用csl作为格式类型，而非原来的citation，同时参数配置要符合CSL插件要求：

• 文内引用用format: 'csl'，搭配template指定格式（如apa、ama）
• 批量引用无需拆分条目，直接传入多个ID数组即可
• APA的上标格式需要额外配置citation-note-number选项，AMA默认是作者年份格式

修正后的示例代码 #

Node.js版本

const Cite = require('citation-js');
require('@citation-js/plugin-csl')(Cite);

const bibtex = `
@article{Loomes2017,
    title = {Loomes Title},
    author = {Loomes, Rachel and Hull, Laura and Mandy, William Polmear Locke},
    date = {2017-06},
    journaltitle = {Journal of the American Academy of Child and Adolescent Psychiatry},
    volume = {56},
    number = {6},
    pages = {466--474},
    doi = {10.1016/j.jaac.2017.03.013}
}
@article{Mantzalas2022,
    title = {Mantzalas Title},
    author = {Mantzalas, Jane and Richdale, Amanda L. and Adikari, Achini and Lowe, Jennifer and Dissanayake, Cheryl},
    date = {2022-03},
    journaltitle = {Autism in Adulthood},
    volume = {4},
    number = {1},
    pages = {52--65},
    doi = {10.1089/aut.2021.0021}
}
`;

const library = new Cite(bibtex);

// 生成APA格式单条文内引用（上标）
const single_inline_apa = library.format('csl', {
  entry: 'Loomes2017',
  format: 'html',
  template: 'apa',
  lang: 'en-US',
  'citation-note-number': true
});
console.log(`单条APA文内引用：${single_inline_apa}`);

// 生成APA格式多条文内引用
const double_inline_apa = library.format('csl', {
  entry: ['Loomes2017', 'Mantzalas2022'],
  format: 'html',
  template: 'apa',
  lang: 'en-US',
  'citation-note-number': true
});
console.log(`多条APA文内引用：${double_inline_apa}`);

// 生成AMA格式单条文内引用
const single_inline_ama = library.format('csl', {
  entry: 'Loomes2017',
  format: 'html',
  template: 'ama',
  lang: 'en-US'
});
console.log(`单条AMA文内引用：${single_inline_ama}`);

// 生成AMA格式多条文内引用
const double_inline_ama = library.format('csl', {
  entry: ['Loomes2017', 'Mantzalas2022'],
  format: 'html',
  template: 'ama',
  lang: 'en-US'
});
console.log(`多条AMA文内引用：${double_inline_ama}`);

浏览器版本

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Citation-JS CSL Example</title>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/citation-js/0.7.14/citation.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/@citation-js/plugin-csl@0.7.14/dist/plugin-csl.min.js"></script>
</head>
<body>
    <div id="content"></div>
    <script>
        const bibtex = `
@article{Loomes2017,
    title = {Loomes Title},
    author = {Loomes, Rachel and Hull, Laura and Mandy, William Polmear Locke},
    date = {2017-06},
    journaltitle = {Journal of the American Academy of Child and Adolescent Psychiatry},
    volume = {56},
    number = {6},
    pages = {466--474},
    doi = {10.1016/j.jaac.2017.03.013}
}
@article{Mantzalas2022,
    title = {Mantzalas Title},
    author = {Mantzalas, Jane and Richdale, Amanda L. and Adikari, Achini and Lowe, Jennifer and Dissanayake, Cheryl},
    date = {2022-03},
    journaltitle = {Autism in Adulthood},
    volume = {4},
    number = {1},
    pages = {52--65},
    doi = {10.1089/aut.2021.0021}
}
        `;

        const library = new Cite(bibtex);

        // 生成并展示结果
        const content = document.getElementById('content');
        content.innerHTML += `<h3>APA单条引用</h3>${library.format('csl', { entry: 'Loomes2017', format: 'html', template: 'apa', lang: 'en-US', 'citation-note-number': true })}<br>`;
        content.innerHTML += `<h3>APA多条引用</h3>${library.format('csl', { entry: ['Loomes2017', 'Mantzalas2022'], format: 'html', template: 'apa', lang: 'en-US', 'citation-note-number': true })}<br>`;
        content.innerHTML += `<h3>AMA单条引用</h3>${library.format('csl', { entry: 'Loomes2017', format: 'html', template: 'ama', lang: 'en-US' })}<br>`;
        content.innerHTML += `<h3>AMA多条引用</h3>${library.format('csl', { entry: ['Loomes2017', 'Mantzalas2022'], format: 'html', template: 'ama', lang: 'en-US' })}<br>`;
    </script>
</body>
</html>

关键说明 #

• 插件启用后，format('csl')会调用citeproc-js处理CSL模板，支持所有标准CSL样式
• APA的上标格式依赖citation-note-number配置，AMA默认采用作者年份括号分隔的格式
• 批量引用直接传入ID数组即可，无需手动拆分拼接，插件会自动按格式规则合并

内容的提问来源于stack exchange，提问作者abalter