添加Z7智能引用，完善引用常见问题

.markdownlint-cli2.cjs

@@ -144,6 +144,8 @@ module.exports = {
         "ThemeColorPicker",
         "ToggleFullScreenButton",
         "ToggleRTLButton",
+        "sub",
+        "sup",
       ],
     },
     // 兼容 Prettier 禁用

.vitepress/theme/styles/custom.css

@@ -1,3 +1,10 @@
 img {
   display: unset;
 }
+
+.vp-doc a {
+  text-decoration: unset;
+}
+.vp-doc a:hover {
+  text-decoration: underline;
+}

user-guide/misc/wps-plugin-vba.md

@@ -39,7 +39,7 @@ updated: 2023-10-04 12:06:44
 
 检查 Zotero 是否已正常安装好**Microsoft Word 加载项**。安装此加载项的步骤，详见 Zotero 百科全书的 [「引文|插件」Word 加载项相关问题](../faqs/word-addon.md)（点击左侧蓝字自查）
 
-![重新安装 Word 插件](../../assets/images/settings-reinstalll-word-plugin.png)
+![重新安装加载项](../../assets/images/zotero-addon-重新安装加载项.jpg)
 
 ### 2、WPS.VBA 插件的安装
 

user-guide/ms-word-plugin.md

@@ -5,6 +5,8 @@ date: 2023-06-28 21:17:07
 updated: 2023-07-21 19:01:31
 ---
 
+# 在 Word 中插入参考文献
+
 这些是使用 Zotero for MS Office Word 插件的说明。
 
 要在 WPS 中使用插件，请参见 [在 WPS 中使用 Zotero Word 插件](./wps-plugin.md)。
@@ -54,11 +56,15 @@ Zotero 选项卡包含以下图标：
 
 ## 添加引注
 
-您可以通过单击「添加/编辑引注」（![插入引文](../assets/icons/integration/icon-word-插入引文.png)）按钮开始添加/编辑引用。
+您可以通过单击「![插入引文](../assets/icons/integration/icon-word-插入引文.png) 添加/编辑引注」在当前光标位置插入或编辑引注。
+
+::: tip
 
-在一个未添加过引文的文档中，按下按钮将首先显示「文档首选项」窗口以让用户选择一个样式文件，之后按下按钮将显示引文对话框。
+此按钮只是插入引注，不会在文末自动生成参考文献表。要插入参考文献表，请点击 「插入/编辑参考文献表」 按钮。
 
-引文对话框用于从 Zotero 库中选择项目，并创建引文。
+:::
+
+在一个未添加过引文的文档中，按下按钮将先弹出一个「文档首选项」窗口以让你选择一个 CSL 样式，之后再点「添加/编辑引注」将直接显示「引注对话框」，这个对话框可以从 Zotero 库中选择条目，并创建引注。
 
 开始在对话框中键入标题的一部分、一个或多个作者的姓氏和/或年份。匹配项将立即显示在对话框下方。
 
@@ -70,50 +76,104 @@ Zotero 选项卡包含以下图标：
 
 :::
 
-通过单击项目或在项目突出显示时按 Enter/Return 键来选择该项目。该项目将以阴影气泡的形式显示在对话框中。完成添加所有引用项目后，再次按 Enter/Return 键以插入引文并关闭「添加引文」框。
+单击某条目可以选择这个条目，也可以用键盘「↑↓」+「Enter」 键来选择条目。
+
+::: tip 快速选择正在阅读的
+
+如果你在 Zotero 的条目列表里已经选中了一些条目，或者是你正在阅读一篇文献，「引文对话框」将自动将这些条目显示在对话框的「已选择 / Seleted」区域，你可以直接按下「Enter」确认选择。
+
+注：这是 Zotero 7 的新特性，先前版本的 Zotero 不支持。
+
+:::
+
+选中的条目以气泡形状显示在对话框中。完成选择后，再次按「Enter/Return」键以插入引注并关闭引注对话框。
 
 ![引文对话框](../assets/images/word-引文对话框2.png)
 
-::: info 小技巧
+### 孤立的条目
 
-在「添加引文」对话框中，您可以单击被引用项目的气泡，然后单击「在我的库中打开（或组库的名称）」以在 Zotero 中查看该项目。
+在「添加引注」对话框中，您可以单击被引用条目的气泡，然后单击「在我的库中打开（或组库的名称）」以在 Zotero 中查看该条目。
 
-孤立的项目（未连接到 Zotero 数据库中的任何项目）将没有「在我的库中打开」按钮。如果孤立项目是由协作者从其「我的媒体库」或您无权访问的群组中插入的，或者您已从 Zotero 资料库中删除了这些项目，则这些项目可能存在。
+孤立的条目（未连接到 Zotero 数据库中的任何条目）将没有「在我的库中打开」按钮。
 
 ![编辑引文](../assets/images/word-编辑引文.png)
 
-:::
+孤立条目通常是以下原因导致的：
+
+- 协作者从 TA 自己的文库或您无权访问的群组中插入的
+- 您已从 Zotero 文库中删除了这些条目
+- 你曾经有个一样的重复条目 A 和 B，你在文档里插入了 A，然后再 Zotero 里删除了 A 留下了 B（而不是合并）
+
+Zotero 可以正常为孤立条目排序，但由于你的 Zotero 库中没有这个条目，因此你无法修改它的题录信息。若要更新，请将这些文献重新导入您自己的文库，并重新插入。
 
-### 包含多个被引用项目的引文
+### 在同一位置引用多个文献
 
 ![引文对话框](../assets/images/word-引文对话框2.png)
 
-要创建包含多个引文的引文（例如，数字样式为`[2，4-6]`，作者日期样式为「（Smith 1776， Schumpeter 1962）」），请在「添加引文」框中一个接一个地添加它们。选择第一个项目后，不要按 Enter/Return 键，而是键入下一个项目的作者、标题或年份。
+要在同一位置引用多篇文献（例如，数字样式为`[2，4-6]`，作者日期样式为`(Smith 1776, Schumpeter 1962）`），请在「添加引注」框中一个接一个地添加它们。选择第一个项目后，不要按 Enter/Return 键，而是继续选择下一个条目。
 
 ::: tip
 
 如果在连续添加多个引文时，新输入的内容仍被包裹在上一个引用项目的气泡中，您可以先输入一个空格，然后再输入下一个引用项目的信息。
 
 :::
 
+::: details 按作者字母或时间排序？
+
 某些引文样式要求一个文本内引文中的项目按字母顺序排序（例如，「（Doe 2000， Grey 1994， Smith 2008）」）或按时间顺序排序（「（Grey 1994， Doe 2000， Smith 2008）」）。Zotero 将自动遵循这些排序规则。
 
-- 若要禁用引文中引文的自动排序，请拖动引文以在「添加引文」框中重新排列引文。您也可以单击「添加引文」框左侧的「Z」图标，然后取消选中「将源排序」选项。_此选项仅对指定引文排序顺序的引文样式显示。_ 要恢复自动排序，请重新选中「保持源已排序」选项。
+若要禁用引文中引文的自动排序，请拖动引文以在「添加引文」框中重新排列引文。您也可以单击「添加引文」框左侧的「Z」图标，然后取消选中「将源排序」选项。_此选项仅对指定引文排序顺序的引文样式显示。_ 要恢复自动排序，请重新选中「保持源已排序」选项。
+
+:::
+
+### 编辑引注
+
+如果您想在之前插入的引注中增加/删除条目，或者修改引注的信息，可以将光标定位在引注内（此时引注区域会出现灰色阴影），然后再单击「![插入引文](../assets/icons/integration/icon-word-插入引文.png) 添加/编辑引注」按钮开始编辑引注。
+
+![编辑引注](../assets/images/edit-citation.jpg){width=60%}
 
 ## 添加参考文献表
 
-单击「添加/编辑参考文献表」（![添加参考文献表](../assets/icons/integration/icon-word-添加参考文献表.png)）按钮会在光标位置插入参考文献表。
+单击「![添加参考文献表](../assets/icons/integration/icon-word-添加参考文献表.png) 添加/编辑参考文献表」按钮会在光标位置插入参考文献表。
+
+::: info
+
+一般情况下，在文末写一个 `参考文献` 标题，然后按回车另起一行，再点击这个按钮插入参考文献表。
+
+:::
 
 Zotero 将根据文档中的引文自动更新参考书目。
 
-在极少数情况下，如果要将未在文档中引用的项目添加到书目中，可以再次单击「添加/编辑书目」按钮，这将打开 [书目编辑器](https://www.zotero.org/support/word_processor_plugin_usage#editing_the_bibliography)。在 Word 中对书目进行的手动编辑将在下次 Zotero 刷新文档时被覆盖。
+在极少数情况下，如果要将未在文档中引用的条目添加到书目中，可以再次单击「添加/编辑参考文献表」按钮，这将打开 [参考文献表编辑器](#编辑参考文献表)。
+
+::: warning
+
+不要在 Word 中手动编辑参考文献表，这些编辑将在下次 Zotero 刷新文档时被覆盖。
+
+:::
+
+### 参考文献表段落格式
+
+参考文献表的缩进、悬挂、字体字号、行间距、编号与条目之间的距离等，都是在 Word 「书目」样式中修改，请阅读 [关于引用文献的一揽子问题](./faqs/word-addon.md) 中的 Word 样式小节。
+
+## 添加笔记
+
+在光标当前位置插入笔记。
+
+::: tip
+
+此功能不常用，点击后会出现黄色插入框。如果不小心点开了，可以用键盘上的 `Esc` 键关闭黄色插入框。
+
+:::
 
 ## 切换到「经典视图」
 
 「添加/编辑引注」对话框有默认版与经典版两种，下图为经典版的示例：
 
 ![经典引文对话框](../assets/images/word-引文对话框-经典.png)
 
+::: details 查看经典视图使用方法
+
 您可以通过单击「添加引文对话框」左侧的「Z」图标并选择「经典视图」来切换到「经典视图」引文对话框。
 
 ![切换经典视图](../assets/images/word-切换经典视图.png)
@@ -132,53 +192,70 @@ Zotero 将根据文档中的引文自动更新参考书目。
 
 - 若要禁用引文中引文的自动排序，请在「添加引文」框中拖动引文以重新排列它们。你也可以取消选中「保持来源分类」选项。_此选项仅对指定引文排序顺序的引文样式显示。_ 要恢复自动排序，请重新选中「保持源已排序」选项。
 
-## 自定义引用
+:::
+
+## 自定义引注
 
-可以通过各种方式自定义引文。
+可以通过各种方式自定义引注。
 
-如果引文只是不正确或缺少数据，请首先确保 Zotero 中的项目元数据正确完整，然后单击插件中的「刷新」以使用任何更改更新文档。
+如果引注只是不正确或缺少数据，请首先确保 Zotero 中的条目元数据正确完整，然后单击 Word 中 Zotero 选项卡中的「刷新」以更新文档。
 
-可以通过引文对话框进行其他自定义。单击文档中的现有引文，然后单击「添加/编辑引文」以打开引文对话框，然后单击引文气泡以打开引文选项窗口，您可以在其中进行以下更改。
+可以通过引注对话框进行以下更改：
 
 ![编辑引文](../assets/images/word-编辑引文.png)
 
-### 页码和其他定位器（图、表等）
+### 页码和其他定位符（图、表等）
 
-在某些情况下，您希望引用项目的某个部分，例如某个页面，页码范围或卷。这种额外的引文特定信息（例如，引文「Doe et al.，2001 年，page 4-7」中的「page 4-7」）被称为「定位器」。
+在某些情况下，您希望引用条目的某个部分，例如某个页面，页码范围或卷（例如，引注 `Doe et al., 2001，page 4-7` 中的 `page 4-7`），这种额外的引文特定信息被称为「定位符」。
 
-引用选项窗口具有不同定位器类型的下拉列表（默认为「page」），以及一个可在其中输入定位器值（例如「4-7」）的文本框。要引用除所列定位符以外的定位符（例如「表」），请使用「后缀」字段。
+引注选项窗口的「page」处有个下拉列表，里面是不同的定位符类型，后面的输入框里输入这个定位符的值。
 
-您还可以在插入引文时添加页码。搜索项目，在选择项目之前或之后，但在按 Enter 将引文插入到文档中之前，键入「p.34」、「p34」，甚至只是键入「34」，页码将添加到引文中。
+要使用其他的定位符，例如「表」，请使用「后缀」。
+
+您还可以在插入引注时添加页码。搜索条目，在选择条目之前或之后，但在按 Enter 将引注插入到文档中之前，输入 `p.34`、`p34`，甚至 `34`，都可以将页码添加到引注中。
 
 ### 前缀和后缀
 
-「前缀」和「后缀」文本框允许您指定文本，分别位于自动生成的引用之前和之后。例如，您可能想要「cf. Tribe 1999， see also see……」，而不是「Tribe 1999」。
+有时候，你需要 `cf. Tribe 1999， see also see……` ，而不只是 `Tribe 1999`，你就需要「前缀」和「后缀」。
+
+前缀和后缀字段中的任何文本都可以使用 HTML 标记 `<i>斜体</i>`、`<b>粗体</b>`、`<sub>下标</sub>` 和 `<sup>上标</sup>` 进行格式设置。
 
-前缀和后缀字段中的任何文本都可以使用 HTML 标记 `<i>（斜体）、<b>（粗体）、<子>（下标）和<up>（上标）` 进行格式设置。例如，键入 `<i>cf</i>`。`example` 将显示为 `_cf_. example`。
+前缀和后缀可以应用于引注中的每个条目，以创建复杂的引注。例如：
 
-前缀和后缀可以应用于引文中的每个项目，以创建复杂的引文。例如：「（参见 Smith 1776 的经典例子; 马克思 1867 年提出和另一种观点）」。通过在「前缀」和「后缀」字段中输入文本来修改引文始终比直接在 Word 中的引文字段中键入内容更可取。手动修改将阻止 Zotero 自动更新引文。
+```plain
+（参见 Smith 1776 的经典例子; 马克思 1867 年提出和另一种观点）
+```
+
+通过在「前缀」和「后缀」修改引注始终比直接在 Word 域代码字段中输入内容更可取。手动修改域代码字段将阻止 Zotero 自动更新引注。
 
 ### 省略作者：在文本中使用作者
 
-使用作者日期样式，作者经常被移到文本中，并从以下括号括起来的引文中省略，例如：“……根据史密斯（1776）的说法，劳动分工至关重要……“。要从引用中省略作者，请选中「省略作者」框（这将导致引用类似于「（1776）」而不是「（Smith，1776）」），并将作者的姓名（「Smith」）作为文档中常规文本的一部分。
+使用作者日期样式，作者经常被移到文本中，并从以下括号括起来的引文中省略，例如：
+
+```plain
+……根据 Smith（1776）的说法，劳动分工至关重要……
+
+```
+
+这种需要从引注中省略作者，请选中「省略作者」框（产生的引注变成 `(1776)` 而不是原来的 `(Smith，1776)`），并将作者的姓名「Smith」作为文档中常规文本的一部分。
 
 ### 其他更改
 
-如果您的引文仍未按所需方式显示，您可以直接在文档中编辑引文，但请注意，这样做会阻止 Zotero 自动更新引文以反映文档中的其他更改（例如，对于「同上」或给定名称消除歧义）。在您进行手动编辑后，Zotero 将要求您确认是否要保留编辑并防止引文自动更新。最好是在要进行的更改的文本中做注释，等到准备好提交文档，然后在使用「取消链接引文」后在文档的副本中进行更改。
+如果您的引注仍未按所需方式显示，您可以直接在文档中编辑引注，但请注意，这样做会阻止 Zotero 自动更新引注以反映文档中的其他更改（例如，对于「同上」或给定名称消除歧义）。在您进行手动编辑后，Zotero 将要求您确认是否要保留编辑并防止引注自动更新。
 
-如果您认为引用样式中存在错误，请发布到 Zotero 论坛，以便我们可以进行调查，并在必要时更正样式。如果样式已更新，则文档将自动更新，以便在您下次刷新文档时反映任何更改。
+最好是在要进行的更改的文本中做注释，等到准备好提交文档，然后在使用「取消链接引文」后的文档副本中进行更改。
 
-## 编辑引注
+如果您认为 CSL 样式中存在错误，请发布到 Zotero 论坛，并在必要时更正样式。如果样式已更新，则文档将自动更新。
 
-如果您想在之前插入的引注中增加/删除引用项目，或者修改引注中的信息，您可以将光标定位在编号内（此时编号区域会出现灰色阴影），然后单击「添加/编辑引注」（![插入引文](../assets/icons/integration/icon-word-插入引文.png)）按钮开始编辑引注。
+## 编辑参考文献表
 
-![编辑引注](../assets/images/edit-citation.jpg){width=60%}
+当您在文档中添加和删除引注时，Zotero 将自动更新参考文献表。一般来说，这已经足够了。
 
-## 编辑参考书目
+::: details
 
-当您在文档中添加和删除引文时，Zotero 将自动更新参考书目以反映您的更改。一般来说，这就是你所要做的。
+但是，在极少数情况下，您可能希望将未引用的文献添加到参考文献表中（例如，综述中包含的项目，但论文中未引用的项目）或删除文本中引用但不应包含在参考书目中的项目（例如，个人通信）。
 
-但是，在极少数情况下，您可能希望将未引用的来源添加到参考书目中（例如，综述中包含的项目，但论文中未引用的项目）或删除文本中引用但不应包含在参考书目中的项目（例如，个人通信）。为此，请再次单击「添加/编辑书目」（![添加参考文献表](../assets/icons/integration/icon-word-添加参考文献表.png)）按钮以打开「编辑书目」窗口：
+为此，请再次单击「添加/编辑书目」（![添加参考文献表](../assets/icons/integration/icon-word-添加参考文献表.png)）按钮以打开「编辑书目」窗口：
 
 ![编辑参考文献表](../assets/images/word-编辑参考文献表.png)
 
@@ -195,20 +272,29 @@ Zotero 将根据文档中的引文自动更新参考书目。
 - 添加有关项目的批注或注释
 - 为书目子部分添加标题（例如，主要来源与次要来源）
 
+:::
+
+## 定稿：取消链接
+
+删除所有 Zotero 域代码且断开与 Zotero 文库链接。点击后所有的引注和文末的参考文献表都会变成纯文本。
+
 ::: warning
 
-- 对样式格式的一般更正应在 [CSL 引文样式](https://www.zotero.org/support/styles) 进行，而不是在此处进行。
-- 对项目数据的更正应该在 Zotero 库中进行，而不是在这里。
+该操作不可逆，一旦断开连接，所有的引注信息都会变成纯文本，无法再自动更新编号和参考文献表，也无法恢复到以前带有链接的状态。
+
+因此强烈建议在断开连接之前将文档另存一份备用，仅将用于提交/共享的副本断开连接。
+
+正常地，Zotero 会在取消链接时自动新建一个文档，但如果文档保存在 OneDrive 上，这种自动机制无法生效，Zotero 会弹窗要求你手动新建一个文档。
 
 :::
 
 ## 注意事项与常见问题
 
 ::: warning
 
-所有的引注顺序更改都应在 Word 「引文编辑对话框」中进行，而不是直接在 Word 里手动修改！
-所有的引注/参考文献表的样式修改都应在 CSL 文件中进行，而不是直接在 Word 里手动修改！
-所有的条目信息，如作者、标题、期刊、期卷页等，都应在 Zotero 中更新条目信息，而不是直接在 Word 里手动修改！
+- 所有的引注/参考文献表的样式修改都应在 [CSL 引文样式](./citation-styles.md) 中进行，而不是直接在 Word 里手动修改！
+- 对引注顺序更改应在 Word 「引注编辑对话框」中进行，而不是直接在 Word 里手动修改！
+- 所有的条目信息，如作者、标题、期刊、期卷页等，都应在 Zotero 中更新条目信息，而不是直接在 Word 里手动修改！
 
 :::