## 概述

你可以使用**笔记模板**来自定义 PDF 注释添加到笔记中的显示格式。

### 如何找到模板设置

1. 打开 Zotero **偏好设置**（Preferences）
    
2. 进入 **高级**（Advanced）面板
    
3. 点击 **配置编辑器**（Config Editor）
    
4. 搜索 `annotations.noteTemplates`
    

### 现有模板类型

目前共有三种可用模板：

|模板名称|用途|
|---|---|
|**高亮注释模板**|控制高亮注释添加到笔记时的格式|
|**便签注释模板**|控制便签/文字注释添加到笔记时的格式|
|**笔记标题模板**|控制从项目所有注释创建笔记时的默认标题|

---

## 模板语法基础

模板支持 **HTML** 标签，变量用 **花括号 `{{}}`** 包裹。

### 默认模板示例

高亮注释的默认模板：

```html
<p>{{:highlight}} {{:citation}} {{:comment}}</p>
```

**效果说明**：

- 高亮注释作为**单个段落**（`<p>`）添加
    
- 顺序为：高亮文本 → 引用信息 → 评论
    
- **引号会自动添加**在高亮文本两端
    

### 自定义示例

如果你希望高亮文本显示为块引用（blockquote）：

```html
<blockquote>{{:highlight}}</blockquote>
<p>{{:citation}} {{:comment}}</p>
```
---

## 条件语句（Conditionals）

条件语句可以根据**注释是否有评论**、**注释的颜色**等不同情况，输出不同的格式。

### 示例1：根据是否有评论，决定是否另起一段

```html

<blockquote>{{:highlight}}</blockquote>
<p>{{:citation}}</p>
{{:if comment}}
    <p>{{:comment}}</p>
{{:endif}}
```

**逻辑说明**：

- 高亮文本：始终放在块引用中
    
- 引用信息：始终单独一段
    
- 评论：**仅当评论存在时**，才另起一段显示
    

### 示例2：根据注释颜色，使用不同的格式


```html
{{:if color == '#ff6666'}}
    <h2>{{:highlight quotes='false'}}</h2>
{{:elseif color == '#2ea8e5'}}
    {{:if comment}}<p>{{:comment}}:</p>{{:endif}}
    <blockquote>{{:highlight}}</blockquote>
    <p>{{:citation}}</p>
{{:else}}
    <p>{{:highlight}} {{:citation}} {{:comment}}
    {{:if tags}} #{{:tags join=' #'}}{{:endif}}</p>
{{:endif}} ```
```




**逻辑说明**：

|颜色|输出格式|
|---|---|
|红色（#ff6666）|高亮文本变成 **二级标题（h2）**，不带引号|
|蓝色（#2ea8e5）|评论（如有）→ 块引用（高亮）→ 引用|
|其他颜色（默认）|单段落：高亮 + 引用 + 评论 + 标签（带 # 前缀）|

---

## 变量列表

以下是模板中可用的所有变量及其支持的参数。

### 1. `highlight`（高亮文本）

|参数|可选值|说明|
|---|---|---|
|`quotes`|`"true"`|**始终**添加引号|
||`"false"`|**绝不**添加引号（需配合块引用使用）|
||`"omitted"`（默认）|除非高亮在块引用内，否则自动添加引号|

**示例**：

```html

{{:highlight quotes='false'}}
```

### 2. `citation`（引用信息）

无参数，直接输出如 `(Author, year, p.X)` 格式。

### 3. `comment`（评论）

你在PDF注释中添加的文字评论。

### 4. `color`（注释颜色）

|颜色名称|颜色代码|
|---|---|
|黄色|`#ffd400`|
|红色|`#ff6666`|
|绿色|`#5fb236`|
|蓝色|`#2ea8e5`|
|紫色|`#a28ae5`|
|品红色|`#e56eee`|
|橙色|`#f19837`|
|灰色|`#aaaaaa`|

> **注意**：`color` 变量主要用于**条件判断**（如根据颜色输出不同格式）。注释颜色本身可以在笔记编辑器的菜单中手动开启/关闭显示。未来版本可能会增加“默认是否显示颜色”的偏好设置。

### 5. `tags`（标签）

| 参数     | 说明             |
| ------ | -------------- |
| `join` | 指定多个标签之间的连接字符串 |

**示例**：

```html

{{:tags join=' #'}}
```

输出效果：`#标签1 #标签2 #标签3`

---

## 快速参考：常用自定义场景

| 你想要的效果        | 模板写法示例                                                                                                  |
| ------------- | ------------------------------------------------------------------------------------------------------- |
| 高亮文本加引号，后跟引用  | `<p>{{:highlight}} {{:citation}}</p>`                                                                   |
| 高亮文本不加引号，用作标题 | `<h2>{{:highlight quotes='false'}}</h2>`                                                                |
| 有评论才显示评论段落    | `{{:if comment}}<p>备注：{{:comment}}</p>{{:endif}}`                                                       |
| 显示标签（带#号）     | `<p>{{:highlight}} #{{:tags join=' #'}}</p>`                                                            |
| 红色高亮变成标题，其他正常 | `{{:if color=='#ff6666'}}<h2>{{:highlight}}</h2>{{:else}}<p>{{:highlight}} {{:citation}}</p>{{:endif}}` |