注释与笔记

您可以在文本中添加不属于故事内容的注释。常规注释用于在文本中为自己添加备注，这在修改草稿时可能很有用。不过，您还可以使用多种注释类型。

本节介绍基础注释类型。还有几项高级功能也使用注释语法，但将在后续章节中介绍。

纯文本注释

普通注释是以字符 % 开头的行或段落。您可以在文档中任意位置添加注释，并可选择将其包含或排除在最终稿件中。

小说写作工具基本忽略这些注释。它们既不计入字数统计也不计入字符统计，仅在您启用显示功能时才会出现在文档查看面板中。

示例

### 场景

场景中的常规文本段落。

% 您添加的个人备注。

场景中的另一段常规文本。

梗概与简短描述注释属于特殊类型的注释。它们与普通注释的区别在于，可与场景、角色或其他故事元素的其他信息并列显示于笔记中。与普通注释相同，它们可包含在您的手稿中，但格式与普通注释不同。

!> 注意

每条标题下仅允许添加一条摘要或描述性注释，因其被视为该标题下文本内容的说明。若在同一标题下添加两条此类注释，则仅保留最后一条。

剧情概要注释用于添加章节和场景的摘要。

示例

### 场景

%Synopsis：场景内容的摘要。

场景正文内容。

简短描述注释与剧情梗概注释完全相同，但专用于描述故事元素（如角色）。

示例

# 角色

## 达斯·维达

%Short：曾是绝地武士的西斯尊主。

角色相关描述文本。

## 卢克·天行者

%Short：绝地武士。达斯·维达之子。

角色相关描述文本。

!> 注意

%Synopsis: 和 %Short: 注释前缀可互换使用，但在稿件中包含它们时，会根据前缀进行标记，因此后者用于角色注释可能比前者更合理。

脚注通过短代码添加，并配有对应的实际脚注文本注释。匹配通过关联两者的键值实现。若从插入菜单插入脚注，系统将自动生成唯一键值。短代码的详细说明请参阅短代码格式化指南。

插入脚注功能会在编辑器光标位置添加脚注短代码标记，并在段落末尾自动创建对应的脚注注释。随后光标将自动跳转至该位置，您可立即输入脚注内容。

脚注注释可在文档任意位置存在，若需将其移至文末等位置，可自由调整。

脚注键值仅需在单篇文档内唯一，因此复制、移动或合并文本时，务必确保键值不重复。若使用插入菜单自动生成的键值，则在所有索引文档中具有唯一性。但无法保证与存档或回收站文件夹中的脚注键值不冲突，不过项目内重复生成相同键值的概率较低。

示例

### 场景

此段落中部包含脚注[footnote:fn1]。

%Footnote.fn1: 此处为脚注正文。

2.5版新增功能

若需完全忽略文档中的部分文本但尚未准备删除，可在文本段落或行前添加 %~。此操作将使 novelWriter 在生成预览或构建文稿时完全跳过该文本。

相较于将文本转换为常规注释，此方法更优——因为您可能希望在预览或草稿文稿中保留常规注释。

在段落内任意位置按下键盘上的 Ctrl+Shift+D 即可为该段落启用或关闭忽略文本功能。

示例

### 场景

%~ 此文本将被忽略。

此文本为常规段落。