文档首选项

文档首选项决定一篇文档怎样排版引用：用哪个样式、哪种语言、是否转写、脚注还是尾注。它们存在文档开头的 frontmatter 里，随文档走。

受管键#

CiteDesk 在文档开头的 YAML 属性块里维护五个常驻键，五个都始终存在：

---
citedesk-style: http://www.zotero.org/styles/apa
citedesk-locale: en-US
citedesk-romanize: source
citedesk-journal-abbreviations: auto
citedesk-note-type: footnotes
---

另有三个可选键，只在非空时才出现，由「编辑参考文献表」写入，见编辑参考文献表。

不必手改这些键，用右栏文档卡片上的 更换 打开「文档首选项」窗口，改完点「确定」即写回。在窗口打开期间这些键被别处改过，窗口会拒绝保存并提示「文档首选项已在其他地方被修改」。

样式#

citedesk-style 的值是样式文件里声明的样式 ID。内置样式和您导入的样式没有区别，都在设置「引用」页的样式管理器里管理。

样式决定三件事：引用文字的写法；引用排在正文里还是脚注里（由样式的类别决定，不由您选）；有没有参考文献表。如果样式没有定义参考文献表，预览里会明说。

排版语言#

citedesk-locale 决定标点、日期格式、「等」和 et al. 一类固定词用哪种语言。取值是随包的 CSL locale 的记号，默认 en-US；没有「自动」选项，整篇文档只有一个排版语言。样式自己声明了默认语言时，窗口里这一项会锁住并显示声明的语言。

排版语言和文献自身的语言是两回事：前者决定怎么排，后者是文献数据的一部分。

转写#

citedesk-romanize 只有一个开关：all 表示把文献的姓名、题名、刊名换成已录入的罗马化值再排版，其他写法一律表示用原文。开启后整篇文档的文献都按英文排版。罗马化值在文献表单里录入，没有录的位置保持原文。

举例：中文论文引用英文文献，排版语言选中文，转写保持关闭；投英文期刊的稿子要把中文文献也转成英文字母，排版语言选英文，并开启转写。

期刊缩写#

citedesk-journal-abbreviations 为 auto 时，样式要印刊名缩写的地方用 MEDLINE 期刊缩写表算出缩写；off 则不用。只有所选样式会用刊名缩写时，窗口里才显示这个开关；开关的值不论显示与否都随文档保存。

脚注或尾注#

citedesk-note-type 对应 Zotero 的「引注显示为」：footnotes 是脚注，endnotes 是尾注。只有样式属于脚注类时窗口才显示它。它只在导出成稿时起作用：Word 写页脚脚注或文末尾注，PDF 的注排在页脚或文末，HTML 一律把注放在文末。

编辑参考文献表#

右栏里的「编辑参考文献表」窗口（对应 Zotero 的同名窗口）可以做三件事，结果写进三个可选键：

• 把没有被正文引用的文献加进表里：citedesk-bibliography-add；
• 把被引用的文献排除在表外：citedesk-bibliography-omit；
• 把表里某一条改成您要的样子：citedesk-bibliography-custom，保存的是带格式的文字。

这三项只影响参考文献表，不影响正文里的引用。键值里的文献 ID 在文献库里找不到时保留不删，窗口里灰显并标明「不在文献库中」。改文献 ID 或合并文献时，这里的 ID 会一起改。改过的某一条，在它没有被引用也不在「加入」名单里时，会在下次打开窗口时丢弃；换样式、换语言不会使它作废。

如果所选样式没有参考文献表，应用会提示「当前的参考文献样式并未定义参考文献表」，不打开这个窗口。

样式缺失或无效#

文档声明的样式在这台电脑上找不到（例如换了电脑、样式被移除）时：

• 文档照常显示，用 APA 样式临时排版；
• 文档里的 citedesk-style 保持不变，装回同一个样式它就恢复；
• 预览页和右栏会提示「缺少此文档中使用的参考文献样式」，下面有「安装」按钮：样式 ID 是网址时，点它按这个网址下载样式。来自 zotero.org 或 citationstyles.org 的直接安装，别的来源会先问您一句。

样式无效#

样式在本机但无法使用时，会提示「您选择的样式似乎无效」，并给出错误原文，文档临时按 APA 排版，文档里的设置不改。这说明那份 CSL 文件本身有问题：如果它是您自己写的，请先用 CSL 官方的验证工具检查；否则请换一个样式。