Skip to content

Commit

Permalink
完善Word引用相关文档 (#120)
Browse files Browse the repository at this point in the history
* 修正图注错误,添加英文文献重抓元数据,完善Word引用教程

* 添加 Word 引用常见问题

* Fix lint

close: #41

---------

Co-authored-by: Northword <northword@outlook.com>
  • Loading branch information
wakewon and northword committed Jan 9, 2024
1 parent 76afb33 commit 8411f04
Show file tree
Hide file tree
Showing 5 changed files with 331 additions and 48 deletions.
26 changes: 25 additions & 1 deletion src/user-guide/add-items.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,10 +74,12 @@ Connector 抓取文献错误解决:[从浏览器抓取条目时发生错误 /

对于已有 PDF 文件的文献,可以通过将 PDF 文件拖拽到 Zotero 中来添加这篇文献的附件。添加附件后,Zotero 会自动通过 PDF 来识别文献 —— 英文文献通常通过识别 PDF 的元数据,中文文献则识别文件名(中文文献文件识别能力由 茉莉花 插件提供)。

::: note
::: note 小提示

不管是中文文献还是英文文献,都 **存在一定的概率无法成功匹配到信息并自动创建条目** 。如果遇到问题了,还是 **建议回到期刊官网的论文详情页抓取信息并创建条目** ,然后将 PDF 文件以附件的形式添加到该条目上(将附件拖到该条目上即可,但不要拖到条目之间的间隙里)。如果 Zotero 确实不支持抓取你正在使用的网站,你也可以采用后文的进阶方法创建条目。

如果您通过附件添加条目信息,建议您在添加后检查每一个条目的元数据。这一功能自动匹配的元数据可能存在错误,建议人工核对后再使用。

:::

#### 英文文献附件自动识别
Expand All @@ -104,6 +106,28 @@ Connector 抓取文献错误解决:[从浏览器抓取条目时发生错误 /

![获取元数据成功](./../assets/image-get-metadata-en2.webp)

:::: details 重新抓取外文 PDF 元数据

如果你 **之前添加的外文附件未能自动创建父条目** ,你也可以使用这一功能来重新 **手动触发一次检索匹配**

1. 右键点击 **不附属于任何条目的 PDF 附件**

2. 点击 检索元数据。

![检索元数据](./../assets/image-retrieve-metadata.jpg){width=60%}

Zotero 会弹出一个元数据检索窗口显示检索进度。如果检索完成后仍有部分文件检索失败,这意味着 Zotero 无法为这一文献自动检索元数据,请使用其他方法获取文献元数据。

![元数据检索窗口](./../assets/image-retrieve-metadata-finished.jpg){width=60%}

::: tip

请注意,这一功能仅对不属于任何条目的附件文件有效 。如果这一附件已经有了条目了,也就不能重新触发抓取了。右键菜单里不会出现 检索元数据 按钮。

:::

::::

#### 中文文献附件自动识别

::: info 中文 PDF/CAJ 识别依赖茉莉花插件
Expand Down
16 changes: 8 additions & 8 deletions src/user-guide/faqs/update-translators.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,23 +50,23 @@ updated: 2023-11-23 16:51:00

1. 右键点击 Zotero Connector 按钮,然后点击 选项

![Chrome更新translator1](../../assets/image-update-translator-chrome-1.jpg)
![打开 Zotero Connector 的选项](../../assets/image-update-translator-chrome-1.jpg)

2. 点击 Advanced 中的 Update Translators 按钮,**连续多点几(十)次**

![Chrome更新translator2](../../assets/image-update-translator-chrome-2.jpg)
![更新 Zotero Connector 中的 translators](../../assets/image-update-translator-chrome-2.jpg)

:::

::: details Apple Safari

1. 在网页空白处点鼠标右键,然后点击 Zotero Preference

![Safari更新translator1](../../assets/image-update-translator-safari-1.jpg)
![打开 Zotero Connector 的选项](../../assets/image-update-translator-safari-1.jpg)

2. 点击 Advanced 中的 Update Translators 按钮,**连续多点几(十)次**

![Chrome更新translator2](../../assets/image-update-translator-safari-2.jpg)
![更新 Zotero Connector 中的 translators](../../assets/image-update-translator-safari-2.jpg)

:::

Expand Down Expand Up @@ -112,23 +112,23 @@ updated: 2023-11-23 16:51:00

1. 右键点击 Zotero Connector 按钮,然后点击 选项

![Chrome更新translator1](../../assets/image-update-translator-chrome-1.jpg)
![打开 Zotero Connector 的选项](../../assets/image-update-translator-chrome-1.jpg)

2. 点击 Advanced 中的 Update Translators 按钮,**连续多点几(十)次**

![Chrome更新translator2](../../assets/image-update-translator-chrome-2.jpg)
![更新 Zotero Connector 中的 translators](../../assets/image-update-translator-chrome-2.jpg)

:::

::: details Apple Safari

1. 在网页空白处点鼠标右键,然后点击 Zotero Preference

![Safari更新translator1](../../assets/image-update-translator-safari-1.jpg)
![打开 Zotero Connector 的选项](../../assets/image-update-translator-safari-1.jpg)

2. 点击 Advanced 中的 Update Translators 按钮,**连续多点几(十)次**

![Chrome更新translator2](../../assets/image-update-translator-safari-2.jpg)
![更新 Zotero Connector 中的 translators](../../assets/image-update-translator-safari-2.jpg)

:::

Expand Down
225 changes: 225 additions & 0 deletions src/user-guide/faqs/word-citation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,225 @@
---
title: Word 中引用的常见问题
author:
- name: 可口可乐
url: https://github.com/wakewon
date: 2024-01-08 23:07:00
updated: 2024-01-09 00:36:00
---

## 插入参考文献的基础教程

在开始排查问题之前,请务必先了解 Zotero 的 Word 加载项中各个按钮的功能和用法。在 Word 中插入参考文献的基本操作请阅读:

[在 Word 中插入参考文献的基础教程](../ms-word-plugin.md)

此外,关于 Zotero 参考文献插入及排版的基本教程您还可以观看这个视频:

[Zotero 文献在 Word 中的引用](https://www.bilibili.com/video/BV1ma4y1f7yg/)

其中包括以下问题的解答:

1. 如何安装/重新安装 Word 中的 Zotero 工具条(Word 加载项)。
2. 如何从 Zotero 官方下载参考文献格式。
3. 如何在 Word 中插入参考文献。
4. 如何在 Word 中设置引用样式。

::::: tip 提醒

请注意, **Zotero 在更新至 6.0.23 或更高版本后,Word 选项卡里的按钮顺序有调整。** 新版本交换了第二个和第三个按钮的位置, **在阅读教程的时候请注意点击的按钮具体是哪一个,不要只去数是第几个按钮。**

![Zotero Word 插件选项卡](../../assets/image-word-zotero窗格.png)

:::: details 按钮功能说明

**目前新版本里横向布置三个大按钮分别是:**

1. ![插入引文](../../assets/icon-word-插入引文-large.png) **插入/编辑引注** `Add/Edit Citation`

在当前光标位置插入或编辑引注。

::: tip

此按钮只是插入引注,不会在文末自动生成参考文献表。要插入参考文献表,请点击 `插入/编辑参考文献表` 按钮。

:::

2. ![添加参考文献表](../../assets/icon-word-添加参考文献表-larger.png) **插入/编辑参考文献表** `Add/Edit Bibliography`

在光标当前位置插入或编辑已存在的参考文献表。

::: note

一般情况下,在文末写一个 `参考文献` 标题,然后按回车另起一行,再点击这个按钮插入参考文献表。

:::

3. **插入笔记** `Add Note`

在光标当前位置插入笔记。

::: tip

此功能不常用,点击后会出现黄色插入框。如果不小心点开了,可以用键盘上的 `Esc` 键关闭黄色插入框。

:::

**三个纵向布置的小按钮分别是:**

1. ![文档首选项](../../assets/icon-word-文档首选项.png) **文档首选项** `Document Preferences`

更改参考文献样式或语言,开启/关闭自动更新引注功能。

2. ![刷新](../../assets/icon-word-刷新.png) **刷新** `Refresh`

更新引注引注编号及文末参考文献表内容,关闭自动更新引注功能后需手动点击此按钮更新引注。

3. ![unlink](../../assets/icon-word-unlink.png) **取消链接引注** `Unlink Citations`

删除所有 Zotero 域代码且断开与 Zotero 文库链接。点击后所有的引注和文末的参考文献表都会变成纯文本。

::: warning

该操作不可逆,一旦断开连接,所有的引注信息都会变成纯文本,无法再自动更新编号和参考文献表,也无法恢复到以前带有链接的状态。因此强烈建议在断开连接之前将文档另存一份备用,仅将用于提交/共享的副本断开连接。

:::

::::

:::::

::: warning

在插入文献之前, **请务必先将 Zotero 里英文论文详细信息中的 `语言/Language` 字段改为** `en``en-US` 等与文献语言一致的信息,否则在中英文混排时可能会遇到错误。具体方法见后文里 **中英文混排** 部分的内容。

:::

## 插入引用常见的操作问题

在实际使用中,有一些操作上的小技巧,在这里略作整理:

1. **Zotero 有两种插入文献的方式,一种是搜索对话框,另一种是经典视图的选择窗:**

![引文对话框](../../assets/image-word-引文对话框.png)

![经典引文对话框](../../assets/image-word-引文对话框-经典.png)

如果你在使用新式搜索框,推荐采用`年份 作者姓名`进行检索(两个关键词中间敲一个空格)。

这两种界面可以在插入的时候临时切换,也可以在 Zotero 首选项 里修改默认使用经典选择窗。操作步骤请参见[在 Word 中插入参考文献的基础教程](../ms-word-plugin.md)

2. 如果你使用搜索框, **输入中文关键词后没有候选项目** ,请 **按一下键盘的空格键** ,然后就有候选项了。

3. 如果你 **在一处位置想同时引用多个文献** ,请在插入引用时 **一次性插入每一个文献** ,不要分成两次分开插。

:::: tip 插入多条文献

**在使用搜索窗时** ,先加入第一个文献,然后不要急着按回车确认插入,而是改为 **按一下空格然后继续搜下一个文献** 。直到所有文献都完成插入之后再按回车确认本次插入。

**在使用经典选择窗时** ,点击左下角的 `多重来源/Multiple Sources` 来实现同时插入多个文献。具体操作请参见[在 Word 中插入参考文献的基础教程](../ms-word-plugin.md)

::: note

注:这个窗口内可以多选,可以在左边窗口一次性选择多个条目,然后统一点向右的箭头加到右边。待全部文献添加完成后,再点击确认完成插入。

:::

::::

4. 如果你 **在插入完成后想重新修改引用信息** ,请先在 Word 中插好的编号角标中间点一下,使输入光标在角标内(此时角标会变为灰色),然后点 `插入/编辑引注` 按钮即可编辑/增删此处引用的文献。

![编辑引注](../../assets/image-edit-citation.jpg){width=60%}

5.`插入/编辑引注` 过程中,请务必在选择文献过程中 **不要转到其他窗口去翻看查阅** 。如果边翻看边插入,很有可能导致插入失败并报错。如果插入过程中希望查阅信息,你可以先按回车键确认本次插入,待查阅完成后再用第 4 点提醒中的方法编辑/补充引用。

6. Zotero 在插入文献时更新角标的速度非常缓慢, **建议关闭自动更新引用** 。这一设置在 Word 中的 Zotero 选项卡内:

![文档设置](../../assets/image-word-document-preferences.png){width=60%}

在关闭之后,你 **需要在增删引用项目后手动点 `刷新`![刷新](../../assets/icon-word-刷新.png) 按钮更新引用信息及编号** 。在 Zotero 6.0 新版本下,这个更新可能非常缓慢,你需要多一点耐心。

## 中英文混排以及其他特殊要求样式的问题

Zotero 官方样式对于中英文混排支持得十分差劲,尤其是在 ```et al.` 的处理上。幸运地是,有很多热心的大佬在这方面进行了许多探索。

csl 格式的样式文件的下载和安装方法可以查看这一教程:

[利用合适的 CSL,结合设置条目语言解决 et al 和等混排问题](https://gitee.com/zotero-chinese/zotero-chinese/issues/I4YKIN)

:::: tip

对于一般的需求,可以在这个项目中寻找最适合你的样式,然后直接拿来用:

[GB/T 7714 相关的 csl 以及 Zotero 使用技巧及教程](https://github.com/redleafnew/Chinese-std-GB-T-7714-related-csl)

[GB/T 7714 相关的 csl 以及 Zotero 使用技巧及教程](https://gitee.com/redleafnew00/Chinese-STD-GB-T-7714-related-csl)

这里有非常多的常见样式,足以满足几乎所有人的需求。上面的页面里也都附上了相应的使用效果方便挑选。

::::

安装 csl 样式文件中,会有两个弹窗。第一个弹窗请点击 `安装/Install`,第二个弹窗请点击 `确认/OK`

![安装样式](../../assets/image-install-style.png){width=60%}

(上图是第二个弹窗,这个报错不用担心,直接点 `OK` 即可)

安装完 csl 样式文件后,你还 **需要在 Word 中指定当前文档使用的样式**

![文档设置](../../assets/image-word-document-preferences2.png){width=60%}

::: warning

请务必注意, **样式的选择是在 Word 里进行的** ,不是在 Zotero 设置里!Zotero 设置里的列表仅用来安装新样式,不能用作选择默认样式!

:::

### 如果上面现成的样式不能满足你的需求……

你也可以根据你自己的需要修改属于自己的样式文件,可以看一下这个视频教程自行定制样式:

[style csl 文件简单编辑](https://zhuanlan.zhihu.com/p/336009544)

## 注意事项及与样式相关的常见问题

1. 中英文混排的各个样式文件通常是依靠 Zotero 文献条目信息中的 `语言/Language`,你需要在插入参考文献之前 **预先将英文和中文文献的语言设定为相应要求的内容** 。一般来说,常见的中英混排 csl 样式文件通常要求将英文文献 `Info``语言/language` 字段修改为`en`,而中文文献设置成`zh``zh_CN`或其他内容基本都可以。

::: warning

请务必注意,英文文献的语言需要设置为 `en` ,而不是其他任何内容!(即便设置成 english 也不行!)

如果你的文献语言设定不规范,可以通过标题或作者字段对所有文献进行排序,然后分别选中英文文献,将其 [语言] 字段的信息统一为 `en`;取消选中后再选中中文文献,将其 `语言` 字段的信息统一为`zh`或者样式文件要求的样子。

插件 [Linter for Zotero](https://github.com/northword/zotero-format-metadata) 提供了自动识别条目语言并设定语言字段的功能,可前往 [插件商店](https://plugins.zotero-chinese.com)下载安装。

![Linter 自动识别条目语言](../../assets/image-auto-edit-language.jpg){width=60%}

:::

2. 如果你设置了新样式后,样式仍未变更,你可以在 **Word 上 `Zotero` 插件选项卡中的 `Document Preferences`** 随意切换到任何一个其他样式,确定。等待更新完成后,重新进设置里改回你想用的设置,文档会再次刷新,然后就好了。

3. Word 中参考文献的显示内容是 csl 文件决定的。如果你觉得 **参考文献里显示的内容** 不符合你的要求,你需要按照前面的教程修改 csl 文件。

4. 如果你设置的样式全都正确,却发现有的正文角标里的内容多了点东西(页码),可以编辑一下这一处引用,把不必要的信息删掉:

![编辑引文](../../assets/image-word-编辑引文.png)

## 参考文献书目列表的排版

**Word 中参考文献书目列表的排版问题是 Word 段落样式控制的。** 其中包括:是否首行缩进,是否悬挂缩进,编号和后续文字之间的制表位空白大小,字体及文字大小,是否全部加粗,行间距大小……

这部分样式你需要 **在 Word 中修改参考文献对应的样式**[书目] 的样式)。具体方法详见这一教程:

[如何设置 Zotero 生成的参考文献格式,刷新后不变?](https://zhuanlan.zhihu.com/p/58969571)

## 更多教程

关于 Zotero 以及参考文献等问题还有很多很多教程,你可以关注 [青柠学术] 微信公众号,查看历史推文中的更多教程:

[Zotero 文献生态](https://mp.weixin.qq.com/mp/appmsgalbum?__biz=MzAxNzgyMDg0MQ==&action=getalbum&album_id=1319074508795641857&scene=173)

Johnmy 老师也制作了非常多的关于 Zotero 的教程,如果有疑问也请务必在这里多找找多看看:

[GB/T 7714 相关的 csl 以及 Zotero 使用技巧及教程](https://gitee.com/redleafnew00/Chinese-STD-GB-T-7714-related-csl)

[一些软件使用过程中的技巧,如 Endnote, Zotero 等](https://zhuanlan.zhihu.com/c_1071081428967743488)

0 comments on commit 8411f04

Please sign in to comment.