CiteTeX

一个 Sublime Text 3 用于引文和参考完成的插件

此插件并不旨在取代 LaTeXTools，其目标更倾向于增加一些关于引文和参考资料的功能。

免责声明

尽管已经稳定了一段时间，但我不能保证错误可能会影响甚至破坏您的 bib 文件。我不对因使用此插件直接或间接造成的任何损害负责，包括特别是 BibTeX 文件的损坏或丢失。请确保您有备份！

如何使用

引用完成

在 .tex 文件中键入 ref<TAB> 触发复杂的引用完成。将列出同一文件夹中定义的所有其他 .tex 文件中的符号。

资源管理

为了通过弹出窗口直接访问资源（例如 PDF），请在您的项目设置中声明 resource_root

"settings": {
        "TEXroot": "main.tex",
        "output_directory": "./build",
        "resource_root": "your resource directory here"
    }

要将 PDF 链接到您的 BibTeX 条目，请将 BibTeX 条目添加到您的 .bib 文件中。打开您的 .bib 文件时，运行 Citetex: Add resource to bibentry 命令，例如通过快速命令菜单（Ctrl+Shift+P）。您将看到一个预览列表，列出现有密钥及其标题，选择您想要添加资源的密钥。在后续菜单中，您可以选择您的 PDF 文件。请注意，它必须位于您在资源根文件夹中指定的文件夹中。

我这样构建它的原因是因为您可能有一个用于 TeX 工作的 Git 项目，但可能并不一定要将 PDF 材料包含在内。使用此方法，您有一个与您的工作分开的材料项目文件夹。

功能

关于引文

• 当鼠标悬停在 \cite{...} 上时，会预览引用参考。
• 在引用后显示标题和年份作为幽灵。
• 转到参考文献的 BibTeX 条目。
• 根据给定的引用样式预览渲染的条目。
  
• .bib 文件的错误检查和警告的即时显示。
• 支持多个 .bib 文件（尽管需要进行更多测试）
• 从 DOI 链接添加新的 .bib 条目
• 在浏览器中打开URL或DOI
• 如果资源本地存储，可以直接打开PDF
• 对于资源，必须指定一个'base'目录
• 直接通过快捷菜单打开PDF资源

关于参考文献

• 悬停在\ref{...}上方时预览引用标签
• 转到标签定义（从悬停引用或快捷菜单中）
• 复杂的引用插入（见下文）
• 根据地域和范围插入引用类型

待办事项

• 如果存在多次定义的标签或引用键，则引发警告
• 添加对其他类型材料的支持（例如图片）
• Mac OS，Windows支持

复杂的引用插入

虽然LaTeXTools在插入引用时提供了一个非常有帮助的完成菜单，但CiteTeX的引用插入不仅列出了定义的标签，还列出了其带标签的标题或图注及其来源，从而使得跨文档引用更加轻松。在插入引用时，它识别其类型（例如章节、章节、图例），并根据指定的语言添加相应的前缀（即Sec.，Ch.，Fig.）。

安装

迄今为止，此插件仅在以下操作系统上进行过测试

• Arch Linux
• Windows 10

欢迎Mac和Windows的测试者！（尽管如此，我将不会在Windows上投入太多精力让它运行。）

Windows

在Windows上，您必须安装并添加到路径（例如MikTeX）的其他软件包。（您可能需要安装MikTeX中的几个软件包，请使用其包管理器。）

在Citetex-default.sublime-settings文件中，将open_resource_pdf更改为“C:\Program Files\您的PDF READER.exe”，

依赖关系

本插件依赖于LaTeX和BibTeX来渲染和处理TeX文件。具体来说，您的PATH中应有latex和dvipng（这些可执行文件通常包含在TeX软件包中）。

为了正确支持biblatex，需要安装LaTeXTools sublime软件包（它提供Sublime中的biblatex语法方案）。

临时文件

CiteTeX使用Sublime Text缓存文件夹的子文件夹。

已知问题

当Sublime Text启动时，索引所有条目并提供弹出窗口的渲染可能需要一些时间。在Windows上，引用预览渲染较慢。

有问题吗？

给我发电子邮件：afk（at）daichronos（dot）net