pandoc-citeproc - 云端在线

程序：

您的姓名

pandoc-citeproc - 过滤以解析 pandoc 文档中的引用。

概要

pandoc-citeproc [选项] [文件..]

商品描述

pandoc-citeproc 可执行文件有两种模式，过滤模式和转换模式。

筛选 模式
不带选项运行，它充当过滤器，接收 JSON 编码的 Pandoc 文档，
格式化引文并添加参考书目，并返回 JSON 编码的 pandoc 文档。
引用将被解析，参考书目将被插入到带有 id 的 Div 元素中
参考如果不存在这样的 Div，则将创建一个并附加到文档末尾
（除非将抑制参考书目元数据字段设置为真值）。 如果您希望
参考书目要有节标题，请将节标题放在文档的末尾。
（有关如何编码的详细信息，请参阅“引用”下的 pandoc_markdown (5) 手册页
pandoc 降价中的引用。）

要使用 pandoc 处理引文，请调用 pandoc-citeproc 作为过滤器：

pandoc --filter pandoc-citeproc input.md -s -o output.html

pandoc-citeproc 将在输入中查找以下元数据字段：

参考书目
要使用的参考书目文件的路径或 YAML 路径列表。 这些可能在任何
bibutils 支持的格式。

格式文件扩展名
────────────────────────────────
中文提供.bib
中文提供.bibtex
科帕克.copac
中超 JSON .json
CSL YAML .yaml
尾注.enl
尾注 XML .xml
ISI.wos
医学线.medline
模组 .mods
RIS

请注意，.bib 通常可以与 BibTeX 和 BibLaTeX 文件一起使用，但是您
可以使用 .bibtex 来强制 BibTeX。

引用
YAML 引用列表。 每个引用都是一个 YAML 对象。 格式是
本质上是 CSL JSON 格式。 下面是一个例子：

- 编号：doe2006
作者：
家庭：母鹿
给定：[约翰，F.]
标题：文章
第 33-34 页
发布：
年：2006
类型：文章期刊
体积：6
容器标题：通用研究杂志

字段的内容将在适当的时候被解释为降价：所以，对于
例如，可以在标题字段中使用强调和强烈强调。 简单的 tex 数学
也将被适当地解析和呈现。

CSL or 引文式
CSL 样式文件的路径或 URL。 如果未找到相对于工作的文件
目录，pandoc-citeproc 将在 $HOME/.csl 目录（或
C:\Users\USERNAME\AppData\Roaming\csl（在 Windows 7 中）。 如果这个不做，
pandoc-citeproc 将查找 $HOME/.pandoc/default.csl，如果不是
目前，它将使用 Chicago-author-date.csl，首先在 $HOME/.csl 中查找，然后
在它自己的数据文件中。

链接引用
如果这有一个真正的价值，作者日期和数字风格的引用将是
超链接到其相应的参考书目条目。 默认不添加
超链接。

引文缩写
CSL 缩写 JSON 文件的路径。 如果未找到相对于
工作目录，pandoc-citeproc 将在 $HOME/.csl 目录（或
C:\Users\USERNAME\AppData\Roaming\csl（在 Windows 7 中）。 格式描述为here
(http://citationstylist.org/2011/10/19/abbreviations-for-zotero-test-release).
这是一个简短的例子：

{ “默认”： {
“容器标题”：{
“劳埃德法律报告”：“劳埃德律师”，
“地产公报”：“EG”，
《苏格兰法律时报》：《SLT》
}
}
}

郎 用于格式化引文的区域设置。 如果未设置，则采用语言环境
来自 CSL 文件的 default-locale 属性。 如果区域设置是，则使用 en-US
未在元数据或 CSL 文件中指定。 （对于向后
兼容性，可以使用字段语言环境代替 lang，但是这个 lang 应该
继续使用。）

压制书目
如果这有一个真正的价值，参考书目将被忽略。 否则一个
参考书目将被插入到每个带有 id refs 的 Div 元素中。 如果没有
这样的Div，会在文件末尾创建一个。

参考部分标题
如果它有一个值，一个带有这个标题的节标题将被添加到
参考书目。 如果未指定 reference-section-title 并且文档结束
带有节标题，此最终标题将被视为参考书目
标头。

元数据必须包含参考文献或参考书目，或两者都作为来源
参考。 csl 和引文缩写是可选的。 如果未提供 csl，则
将使用默认样式表（或者 〜/.pandoc/default.csl 或一个版本
芝加哥作者日期.csl）。

转化率 模式
如果使用选项 --bib2yaml 或 --bib2json ， pandoc-citeproc 将不会处理
引文； 相反，它会将其输入（来自标准输入或文件）视为参考书目，并且
将其转换为 pandoc YAML 元数据部分，适合包含在 pandoc 中
文档 (--bib2yaml)，或作为 CSL JSON 参考书目，适合导入到 zotero
(--bib2json)。

--format 选项可用于指定书目格式，但当文件是
使用， pandoc-citeproc 通常可以从扩展中猜测这一点。

这种模式取代了旧的 biblio2yaml 程序。

配置

-H， - 帮帮我
打印使用信息。

-V, - 版
印刷版。

-y, --bib2yaml
将参考书目转换为适合包含在 pandoc 元数据中的 YAML。

-j, --bib2json
将参考书目转换为适合导入 Zotero 的 CSL JSON。

-f FORMAT, --格式=FORMAT
指定要转换的书目格式。 合法值是 biblatex、bibtex、
ris、尾注、endnotexml、isi、medline、copac、mods 和 json。

附注

一般用途总体评估
如果您使用 biblatex 数据库，请严格遵循“数据库指南”中的规范
biblatex 手册的部分（当前为 2.8a）。

如果您使用 CSL-YAML 或 CSL-JSON 数据库，或者在您的
markdown 文档，遵循《Citation Style Language 1.0.1 Language Specification》
(<http://citationstyles.org/downloads/specification.html>)。 特别相关的是
<http://citationstyles.org/downloads/specification.html#appendix-iii-types>（既不
关于使用的评论也没有指定必填和可选字段）和
<http://citationstyles.org/downloads/specification.html#appendix-iv-variables>（确实
包含评论）。

标题： 职位名称 与 句子 案例
如果您使用的是 bibtex 或 biblatex 参考书目，请遵守以下规则：

· 英文标题应在标题大小写中。 非英文标题应该在句子中，
并且 biblatex 中的 langid 字段应设置为相关语言。 （下列
值被视为英语：美国的、英国的、加拿大的、英语的、澳大利亚的、
新西兰、美国英语或英国英语。）

· 作为 bibtex/biblatex 的标准，专有名称应该用花括号保护
这样它们就不会在需要句子大小写的样式中被小写。 例如：

标题 = {我和{安德烈}的晚餐}

· 此外，应保护应保持小写（或驼峰式）的单词：

标题 = {{nm} 尺度上的自旋波色散}

虽然这在 bibtex/biblatex 中不是必需的，但在 citeproc 中却是必需的，其中
在句子大小写内部存储标题，并在样式中转换为标题大小写
需要它。 在这里，我们保护“nm”，这样它就不会在此时转换为“Nm”
阶段。

如果您使用的是 CSL 参考书目（JSON 或 YAML），请注意以下事项
规则：

· 所有标题都应该在句子中。

· 使用非英语标题的语言字段来防止它们转换为标题大小写
在需要这一点的风格中。 （转换仅在语言以 en 开头或 is
留空。）

· 使用以下语法保护不应转换为标题大小写的单词：

纳米尺度上的自旋波色散

会议 文件， 发布时间 与 未出版
对于正式发表的会议论文，请使用 biblatex 条目类型 inproceedings
（将映射到 CSL 论文会议）。

对于未发表的手稿，请使用未发表的 biblatex 条目类型，不带
eventtitle 字段（此条目类型将映射到 CSL 手稿）。

对于演讲、未发表的会议论文或海报展示，请使用 biblatex
使用 eventtitle 字段取消发布的条目类型（此条目类型将映射到 CSL
演讲）。 使用 biblatex 类型字段来指示类型，例如“Paper”或“Poster”。
场地和事件日期也可能有用，尽管大多数 CSL 不会呈现事件日期
样式。 请注意，场地是活动的场地，与描述活动的地点不同
出版商的位置； 不要将后者用于未发表的会议论文。

作者

安德里亚·罗萨托和约翰·麦克法兰。

使用 onworks.net 服务在线使用 pandoc-citeproc