示例：使用Word加载项管理Word文档中的引文
引文管理是文档的一个重要方面，特别是在学术界和教育领域。 每种引文样式都有其自己的指南，指导如何在文档中标记引文，以及应在哪里以及如何记下源。 此类样式包括 APA 和 MLA。
本文提供了一个管理Word文档中引文的示例加载项。 加载项显示从 .bib 文件加载的引用，用户选择引用其文档中。
先决条件
- Visual Studio Code。
- 已连接到 Microsoft 365 订阅的 Office (包括 Office 网页版)。
- Node.js 版本 16 或更高版本。
- npm 版本 8 或更高版本。
运行示例代码
本文的示例代码名为管理Word文档中的引文。 若要运行示例，请按照 自述文件中的说明进行操作。
示例中的关键步骤
- 用户选择包含要引用的引用的本地 .bib 文件。
- 加载项读取 .bib 文件，然后在任务窗格中显示书目引用。 此示例使用 @orcid/bibtexParseJs 来分析 .bib 文件。
- 用户选择适当的引用，然后将其插入光标的位置 (或文档中选定文本) 的末尾。
- 加载项在文档中的该位置添加引用标记，并将引用添加到尾注。 所有尾注都会自动列在文档末尾。
让它成为你的
下面是有关如何根据方案定制此示例的一些建议。
管理用户设置
在 Office 外接程序中启用单一登录 (SSO) ，以支持跨多个文档持久保存用户数据和设置。 如果服务提供或托管书目库，授权用户可以在其文档中访问和选择该书目。
还可以在用户的当前文档中 保留加载项状态和设置 。
警告
不要存储敏感信息，例如身份验证令牌或连接字符串。 文档中的属性不受加密或保护。
使用脚注
根据引文样式，在页面末尾的 脚注 而不是尾注中列出引用。
或者，允许用户选择要显示引用的位置。 如果是这样，则可以使用文档属性或作为其身份验证体验的一部分来更新加载项以保留用户的首选项。
更新引文样式
更新用于在尾注 (或脚注) 中显示引用的引文样式。
或者，提供各种样式选项，然后允许用户选择。 如果是这样，则可以使用文档属性或作为其身份验证体验的一部分来更新加载项以保留用户的首选项。
替换 bibtexParseJs
将 .bib 文件分析器 @orcid/bibtexParseJs 替换为你自己的或其他可用的分析程序，尤其是在此选项未提供解决方案所需的功能时。