Skip to content

Commit

Permalink
Fix Lint
Browse files Browse the repository at this point in the history
  • Loading branch information
@northword
northword committed Sep 13, 2023
1 parent 1fc15ce commit fe306aa
Show file tree
Hide file tree
Showing 5 changed files with 55 additions and 51 deletions.
2 changes: 1 addition & 1 deletion package.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
"docs:dev-debug": "vuepress dev src --debug",
"docs:update-package": "npx vp-update",
"lint:md": "markdownlint-cli2-fix src/**/*.md",
"lint-md": "lint-md src/**/*.md"
"lint-md": "lint-md src/**/*.md --fix"
},
"devDependencies": {
"@lint-md/cli": "^2.0.0",
Expand Down
14 changes: 7 additions & 7 deletions src/about/contributing/build.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -32,19 +32,19 @@ updated: 2023-07-21 17:20:22

@tab Fedora

```
```bash
sudo dnf install git
```

@tab Ubuntu/Debian

```
```bash
sudo apt install git
```

@tab macOS

```
```bash
brew install git
```

Expand All @@ -58,7 +58,7 @@ brew install git

（将 "zotero-user" 和 "<zotero-user@gmail. com>" 替换成个人对应的信息）:

```
```bash
# 设置用户姓名和邮箱
$ git config --global user.name "zotero-user"
$ git config --global user.email "zotero-user@gmail.com"
Expand Down Expand Up @@ -204,7 +204,7 @@ npm install

1. 推送 pr-workflow 分支至个人 GitHub 帐号下的复制仓库:

```
```bash
git push origin pr-workflow
```

Expand All @@ -230,7 +230,7 @@ npm install

更新本地和个人 GitHub 中的 main 分支:

```
```bash
# 切换回本地 main 分支
$ git checkout main

Expand All @@ -243,7 +243,7 @@ npm install

删除本地和个人 GitHub 中的 pr-workflow 分支:

```
```bash
# 删除本地 pr-workflow 分支
$ git branch -D pr-workflow

Expand Down
2 changes: 1 addition & 1 deletion src/about/contributing/markdown-demo.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -233,7 +233,7 @@ updated: 2023-07-21 18:15:30

缩进代码:

```
```plain
// Some comments
line 1 of code
line 2 of code
Expand Down
6 changes: 3 additions & 3 deletions src/user-guide/01-快速开始/03-管理文献库.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -133,15 +133,15 @@ Zotero 支持最多 9 种彩色标签。通过为标签赋予颜色，可以：
1. 通过前述添加标签的方法添加你需要的标签到任意一个文献（例如，⭐）
2. 此时可以在主界面左下角的标签管理器中看到这个标签。右键单击，选择“指派颜色”。

![image.png](../../assets/image-添加标签-添加颜色.png)
![添加标签](../../assets/image-添加标签-添加颜色.png)

3. 在弹出窗口中设置一个颜色与快捷键位置（不能重复）。

![image.png](../../assets/image-选择标签颜色及位置.png)
![选择标签颜色及位置](../../assets/image-选择标签颜色及位置.png)

4. 此时在库中可以看到标签颜色或 emoji 图形。

![image.png](../../assets/image-标签-星标或颜色.png)
![星标或颜色](../../assets/image-标签-星标或颜色.png)

### 自动未读与批量增删标签

Expand Down
82 changes: 43 additions & 39 deletions src/user-guide/02-参考文献/02-在Word中插入参考文献.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,34 +6,34 @@ updated: 2023-07-21 19:01:31

这些是使用 Zotero for MS Office Word 插件的说明。

> 要在 WPS 中使用插件，请参见 [【引文|插件】在WPS中使用Zotero Word插件](https://zotero.yuque.com/staff-gkhviy/zotero/dh3ahi?view=doc_embed)
要在 WPS 中使用插件，请参见 [【引文|插件】在 WPS 中使用 Zotero Word 插件](https://zotero.yuque.com/staff-gkhviy/zotero/dh3ahi?view=doc_embed)

## Zotero Word 插件选项卡

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

一般情况下，Zotero 安装时会安装 Zotero Word 插件，其会在 Microsoft Word 里添加一个 Zotero 选项卡。如果你的 Word 里没有 Zotero 选项卡，请参与 [故障排除 | 安装 Zotero 的 word 插件](https://zotero.yuque.com/books/share/93bfca90-00d8-4228-8d3a-305863c70f50/bqx0x4#x1CYu) 。

Zotero 选项卡包含以下图标：

| 名称 | 图标 | 描述 |
| --- | --- | --- |
| 添加/编辑引注 | ![](../../assets/icon-word-插入引文-large.png)| 在光标位置添加新引注或编辑文档中的现有引注。 |
| 添加/编辑参考文献表 | ![](../../assets/icon-word-添加参考文献表-larger.png)| 在光标位置插入参考文献表或编辑现有书目。 |
| 添加/编辑引注 | ![插入引文](../../assets/icon-word-插入引文-large.png)| 在光标位置添加新引注或编辑文档中的现有引注。 |
| 添加/编辑参考文献表 | ![添加参考文献表](../../assets/icon-word-添加参考文献表-larger.png)| 在光标位置插入参考文献表或编辑现有书目。 |
| 添加笔记 | | |
| 文档首选项 | ![](../../assets/icon-word-文档首选项.png)| 打开“文档首选项”窗口，例如更改引文样式。 |
| 刷新 | ![](../../assets/icon-word-刷新.png)| 立即刷新所有引注和参考文献表，更新 Zotero 库中已更改的项目元数据。 |
| 取消链接引注 | ![](../../assets/icon-word-unlink.png)| 通过删除域代码来取消文档中 Zotero 引文的链接。这可以防止引文和书目的任何进一步自动更新。请注意，删除域代码是不可逆的，通常只能在文档的最终副本中完成。 |
| 文档首选项 | ![文档首选项](../../assets/icon-word-文档首选项.png)| 打开“文档首选项”窗口，例如更改引文样式。 |
| 刷新 | ![刷新](../../assets/icon-word-刷新.png)| 立即刷新所有引注和参考文献表，更新 Zotero 库中已更改的项目元数据。 |
| 取消链接引注 | ![unlink](../../assets/icon-word-unlink.png)| 通过删除域代码来取消文档中 Zotero 引文的链接。这可以防止引文和书目的任何进一步自动更新。请注意，删除域代码是不可逆的，通常只能在文档的最终副本中完成。 |

## 文档首选项

![image.png](../../assets/image-word文档首选项窗格.png)
![word文档首选项窗格](../../assets/image-word文档首选项窗格.png)

“文档首选项”窗口允许您设置以下针对该文档的设置：

1. **引文样式**

> 一般情况下，你只需要修改这一项，其余设置均保持默认即可。
一般情况下，你只需要修改这一项，其余设置均保持默认即可。

2. 设置引注和参考文献表的格式的语言。
3. 对于基于注释的样式，例如“China National Standard GB/T 7714-2015（note，Chinese）”，引文是插入为脚注还或尾注。
Expand All @@ -53,29 +53,29 @@ Zotero 选项卡包含以下图标：

## 添加引注

您可以通过单击“添加/编辑引注”（![](../../assets/icon-word-插入引文.png)）按钮开始添加/编辑引用。
您可以通过单击“添加/编辑引注”（![插入引文](../../assets/icon-word-插入引文.png)）按钮开始添加/编辑引用。

在一个未添加过引文的文档中，按下按钮将首先显示“文档首选项”窗口以让用户选择一个样式文件，之后按下按钮将显示引文对话框。

引文对话框用于从 Zotero 库中选择项目，并创建引文。

开始在对话框中键入标题的一部分、一个或多个作者的姓氏和/或年份。匹配项将立即显示在对话框下方。

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

通过单击项目或在项目突出显示时按 Enter/Return 键来选择该项目。该项目将以阴影气泡的形式显示在对话框中。再次按 Enter/Return 键以插入引文并关闭“添加引文”框。

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

在“添加引文”对话框中，您可以单击被引用项目的气泡，然后单击“在我的库中打开（或组库的名称）”以在 Zotero 中查看该项目。

孤立的项目（未连接到 Zotero 数据库中的任何项目）将没有“在我的库中打开”按钮。如果孤立项目是由协作者从其“我的媒体库”或您无权访问的群组中插入的，或者您已从 Zotero 资料库中删除了这些项目，则这些项目可能存在。

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

## 添加参考文献表

单击“添加/编辑参考文献表”（![](../../assets/icon-word-添加参考文献表.png)）按钮会在光标位置插入参考文献表。
单击“添加/编辑参考文献表”（![添加参考文献表](../../assets/icon-word-添加参考文献表.png)）按钮会在光标位置插入参考文献表。

Zotero 将根据文档中的引文自动更新参考书目。

Expand All @@ -85,23 +85,23 @@ Zotero 将根据文档中的引文自动更新参考书目。

“添加/编辑引注”对话框有默认版与经典版两种，下图为经典版的示例：

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

您可以通过单击“添加引文对话框”左侧的“Z”图标并选择“经典视图”来切换到“经典视图”引文对话框。

![image.png](../../assets/image-word-切换经典视图.png)
![切换经典视图](../../assets/image-word-切换经典视图.png)

要永久切换到经典视图，请勾选 Zotero -> 编辑 -> 首选项 -> “引用”选项卡 -> 使用经典添加引文对话框。
要永久切换到经典视图，请勾选 Zotero -编辑 -首选项 -“引用”选项卡 -使用经典添加引文对话框。

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

### 经典视图下使用多来源引用

单击引文选取对话框左下角“多重来源”，右侧会出现多重来源列表，将引文从左侧拾取到右侧即可。

### 经典视图下多重来源的引文排序

![image.png](../../assets/image-word-引文对话框-经典-添加多来源.png)
![经典引文对话框-添加多来源](../../assets/image-word-引文对话框-经典-添加多来源.png)

Keep Source Order

Expand All @@ -113,33 +113,33 @@ Keep Source Order

可以通过引文对话框进行其他自定义。单击文档中的现有引文，然后单击“添加/编辑引文”以打开引文对话框，然后单击引文气泡以打开引文选项窗口，您可以在其中进行以下更改。

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

##### 页码和其他定位器（图、表等）
### 页码和其他定位器（图、表等）

在某些情况下，您希望引用项目的某个部分，例如某个页面，页码范围或卷。这种额外的引文特定信息（例如，引文“Doe et al.，2001 年，page 4-7”中的“page 4-7”）被称为“定位器”。

引用选项窗口具有不同定位器类型的下拉列表（默认为“page”），以及一个可在其中输入定位器值（例如“4-7”）的文本框。要引用除所列定位符以外的定位符（例如“表”），请使用“后缀”字段。

您还可以在插入引文时添加页码。搜索项目，在选择项目之前或之后，但在按 Enter 将引文插入到文档中之前，键入“p.34”、“p34”，甚至只是键入“34”，页码将添加到引文中。

##### 前缀和后缀
### 前缀和后缀

“前缀”和“后缀”文本框允许您指定文本，分别位于自动生成的引用之前和之后。例如，您可能想要“cf. Tribe 1999， see also see…”，而不是“Tribe 1999”。
“前缀”和“后缀”文本框允许您指定文本，分别位于自动生成的引用之前和之后。例如，您可能想要“cf. Tribe 1999， see also see……”，而不是“Tribe 1999”。

前缀和后缀字段中的任何文本都可以使用 HTML 标记 `<i>（斜体）、<b>（粗体）、<子>（下标）和<up>（上标）` 进行格式设置。例如，键入 `<i>cf</i>`。`example` 将显示为 `_cf_. example`。

前缀和后缀可以应用于引文中的每个项目，以创建复杂的引文。例如：“（参见 Smith 1776 的经典例子; 马克思 1867 年提出和另一种观点）”。通过在“前缀”和“后缀”字段中输入文本来修改引文始终比直接在 Word 中的引文字段中键入内容更可取。手动修改将阻止 Zotero 自动更新引文。

##### 省略作者：在文本中使用作者
### 省略作者：在文本中使用作者

使用作者日期样式，作者经常被移到文本中，并从以下括号括起来的引文中省略，例如：“……根据史密斯（1776）的说法，劳动分工至关重要……“。要从引用中省略作者，请选中“省略作者”框（这将导致引用类似于“（1776）”而不是“（Smith，1776）”），并将作者的姓名（“Smith”）作为文档中常规文本的一部分。

#### 包含多个被引用项目的引文

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

要创建包含多个引文的引文（例如，数字样式为“[2，4-6]”，作者日期样式为“（Smith 1776， Schumpeter 1962）”），请在“添加引文”框中一个接一个地添加它们。选择第一个项目后，不要按 Enter/Return 键，而是键入下一个项目的作者、标题或年份。
要创建包含多个引文的引文（例如，数字样式为`[2，4-6]`，作者日期样式为“（Smith 1776， Schumpeter 1962）”），请在“添加引文”框中一个接一个地添加它们。选择第一个项目后，不要按 Enter/Return 键，而是键入下一个项目的作者、标题或年份。

某些引文样式要求一个文本内引文中的项目按字母顺序排序（例如，“（Doe 2000， Grey 1994， Smith 2008）”）或按时间顺序排序（“（Grey 1994， Doe 2000， Smith 2008）”）。Zotero 将自动遵循这些排序规则。

Expand All @@ -155,15 +155,15 @@ Keep Source Order

当您在文档中添加和删除引文时，Zotero 将自动更新参考书目以反映您的更改。一般来说，这就是你所要做的。

但是，在极少数情况下，您可能希望将未引用的来源添加到参考书目中（例如，综述中包含的项目，但论文中未引用的项目）或删除文本中引用但不应包含在参考书目中的项目（例如，个人通信）。为此，请再次单击“添加/编辑书目”（![](../../assets/icon-word-添加参考文献表.png)）按钮以打开“编辑书目”窗口：
但是，在极少数情况下，您可能希望将未引用的来源添加到参考书目中（例如，综述中包含的项目，但论文中未引用的项目）或删除文本中引用但不应包含在参考书目中的项目（例如，个人通信）。为此，请再次单击“添加/编辑书目”（![添加参考文献表](../../assets/icon-word-添加参考文献表.png)）按钮以打开“编辑书目”窗口：

![](../../assets/image-word-编辑参考文献表.png)
![编辑参考文献表](../../assets/image-word-编辑参考文献表.png)

然后，您可以使用箭头添加或删除项目。

虽然也可以在此窗口中编辑书目参考文献的文本或格式，但不鼓励这样做。如果您更改了库中的数据，Zotero 不会自动更新此处编辑的引用。在这里编辑参考文献也有些不可靠; 一些用户报告说，当 Zotero 引用时，此处所做的修改有时不会持续存在，以及其他问题。

如果您需要编辑书目中的项目，最好在提交文档之前将其作为最后一步。首先，保存文档的备份副本。然后，单击“取消链接引文”按钮（![](../../assets/icon-word-unlink.png)）以断开文档与 Zotero 的连接，并将所有引文和书目转换为常规文本。最后，对参考书目文本进行调整。
如果您需要编辑书目中的项目，最好在提交文档之前将其作为最后一步。首先，保存文档的备份副本。然后，单击“取消链接引文”按钮（![icon-word-unlink](../../assets/icon-word-unlink.png)）以断开文档与 Zotero 的连接，并将所有引文和书目转换为常规文本。最后，对参考书目文本进行调整。

此过程可用于对参考书目进行各种细微的修改，包括：

Expand All @@ -172,17 +172,21 @@ Keep Source Order
- 添加有关项目的批注或注释
- 为书目子部分添加标题（例如，主要来源与次要来源）

> **注意：**
>
> - 对样式格式的一般更正应在 [CSL 引文样式](https://www.zotero.org/support/styles) 进行，而不是在此处进行。
> - 对项目数据的更正应该在 Zotero 库中进行，而不是在这里。
::: warning

- 对样式格式的一般更正应在 [CSL 引文样式](https://www.zotero.org/support/styles) 进行，而不是在此处进行。
- 对项目数据的更正应该在 Zotero 库中进行，而不是在这里。

:::

## 注意事项

>
> ❗ 注意：
> 所有的引注顺序更改都应在 Word “引文编辑对话框”中进行，而不是直接在 Word 里手动修改！
> 所有的引注/参考文献表的样式修改都应在 CSL 文件中进行，而不是直接在 Word 里手动修改！
> 所有的条目信息，如作者、标题、期刊、期卷页等，都应在 Zotero 中更新条目信息，而不是直接在 Word 里手动修改！
::: waring

所有的引注顺序更改都应在 Word “引文编辑对话框”中进行，而不是直接在 Word 里手动修改！
所有的引注/参考文献表的样式修改都应在 CSL 文件中进行，而不是直接在 Word 里手动修改！
所有的条目信息，如作者、标题、期刊、期卷页等，都应在 Zotero 中更新条目信息，而不是直接在 Word 里手动修改！

:::

另有一些 Word 加载项的问题解决可见 常见问题 > Word 加载项相关问题 [https://zotero.yuque.com/staff-gkhviy/zotero/bqx0x4](https://zotero.yuque.com/staff-gkhviy/zotero/bqx0x4) 。
另有一些 Word 加载项的问题解决可见 常见问题 Word 加载项相关问题 [https://zotero.yuque.com/staff-gkhviy/zotero/bqx0x4](https://zotero.yuque.com/staff-gkhviy/zotero/bqx0x4) 。

0 comments on commit fe306aa

Please sign in to comment.