索引

—为你的书创建一个索引—

如果您想为您的书创建一个索引，您可以使用Sigil来标识要索引的内容，然后自动创建一个包含该索引的新HTML页面。

您可以将文本中的单个单词标记为索引，或者使用索引编辑器来确保该单词的每个出现都被编入索引。

标记索引条目

识别要包含在索引中的条目的第一种方法是标记文本中的特定单词或短语。只有您标记的单词或短语的匹配项才会包含在索引中——如果需要所有匹配项，请使用索引编辑器。

在代码视图中突出显示一个单词或短语，然后选择菜单项工具=>索引=>索引标记或其键盘快捷键（可以更改）。这将打开一个提示，让您输入希望这些单词如何出现在索引中：

您输入的文本作为要在索引中使用的名称将显示在索引中，如下所示：

• [blank]:如果您将名称留空，则索引中将使用您突出显示的确切单词。
• words:如果您输入一个单词或短语，则将使用该单词或短语（例如，Oak而不是oak）。
• heading/words:如果您在名称中使用“/”，则会创建一个分层组(例如，森林/树/橡树会在森林下的树文件下创建一个条目橡树文件)。
• entrya;entryb:如果您使用“；”那么将为该单词或短语创建多个条目。

当您标记要索引的文本时，它只会添加一些特定于Sigil的HTML代码，这些代码会告诉Sigil在创建索引时包含这些单词。在代码视图中，它可能如下所示：

<a class="sigil_index_marker" title="Character/Alice">Alice</a>

如果您不再希望某个单词或短语被Sigil编入索引，则需要删除该单词周围的特殊 HTML 标记。

将条目添加到索引编辑器

识别要索引的单词的第二种方法是将单词添加到列表中。然后，当您创建索引时，该单词的每个匹配项都将自动包含在索引中。您可以同时使用标记为索引的单词和要编制索引的单词列表。

要将特定的单词添加到索引列表中，请突出显示该单词或短语，然后选择菜单项工具=>索引=>添加到索引编辑器。如果您选择的文本包含任何HTML标签，您应该删除它们。

这将打开索引编辑器，将单词添加到要索引的条目列表中。您也可以直接在索引编辑器中输入单词，如下所述。

创建索引

要在标记单词和/或将它们添加到列表中后实际创建索引，只需选择菜单项工具=>索引=>创建索引。

这将创建或更新一个名为index.xhtml的HTML页面。条目按字母顺序列出，使用默认样式，如下所示：

自定义索引样式表

索引页面使用单独的CSS文件（sgc-index.css）来格式化索引。如果该文件已经存在于您的图书中，它将不会被覆盖(因此您可以自定义它，而不会丢失您的更改)。但是如果它不存在，它将在您的首选项目录中查找（sgc-index.css），并使用它作为默认文件。如果您的首选项目录中没有文件，那么Sigil将为索引创建一个默认样式表。

索引编辑器

索引编辑器用于管理将包含在索引中的条目列表。它不包括您标记为索引的单词，它们是自动包含的。

要打开索引编辑器，请选择菜单项工具=>索引=>索引编辑器或其键盘快捷键：

要包含的文本

“要包含的文本”列是您希望Sigil在文本中搜索的模式列表，然后使用“索引条目”列中的格式创建索引条目。“要包含的文本”列中的条目可以使用以下格式：

• 单词：书中的单词必须与列出的单词完全匹配（区分大小写）。不要包含任何HTML标签，只包含预览中显示的文字。
• 正则表达式：你可以输入大多数正则表达式模式——它们将逐段匹配。例如，要在不区分大小写的情况下匹配单词，可以使用[Gg]utenberg”或“(?i)Gutenberg”。

索引条目

“索引条目”列是与“要包含的文本”列匹配的单词在索引中实际出现的内容。

“索引条目”列中的条目可以使用以下格式：

• 空白：如果将条目留空，则在“要包含的文本”列中输入的单词将用作条目的名称。
• 单词：如果您输入一个单词或短语，那么将使用该单词或短语（例如，oak而不是Oak）。
• 标题/单词：如果您在名称中使用“/”，则会创建一个分层组（例如，森林/树/橡树会在森林下的树文件下创建一个条目为橡树文件）。
• 标题/：如果在条目名称的末尾使用“/”，则会创建一个分层组，并且“要包含的文本”列中的单词将用作子条目。

上下文菜单

大多数关于编辑剪辑的操作都可以通过使用上下文菜单来完成。

选择一个或多个条目，然后右键单击以下选项：

• 添加条目：在您单击的条目下添加空白搜索。
• 编辑：编辑条目。
• 剪切：删除一个或多个以后可以粘贴的条目。
• 复制：复制一个或多个稍后可以粘贴的条目。
• 粘贴：粘贴任何剪切/复制的条目。
• 删除：删除条目。
• 打开：用文件（索引文件或文本文件）中的条目替换当前索引列表。
• 重新加载：从上次保存的状态恢复列表。
• 另存为：将所有条目保存到文件中，以便保留每本书的索引条目列表。
• 自动填充：用书中的每一个字填充列表。
• 全选：选择所有条目（以便于删除）。

保存

若要将条目保存到磁盘，请单击Save。

要退出而不保存输入，您只需关闭窗口（使用关闭按钮或Esc键）。您还可以使用上下文菜单重新加载从磁盘重新加载条目，这将删除当前条目。

过滤器

您可以使用“过滤器”文本框来限制显示的搜索列表，以便于查找搜索。

打开或导入文本文件

打开上下文菜单项可用于打开保存的索引文件，但也可以打开文本文件。

您可以只列出文本文件中要包含单词的文本——每行一个。或者，您可以通过用制表符分隔“要包含的文本”和“索引条目”值来包括它们——每行一个。

索引工具栏

若要更快地创建索引，用户可以使用视图=>工具栏=>索引菜单来显示“索引工具栏”。

• 打开索引编辑器
• 将单词添加到索引编辑器
• 标记文本以包含在索引中
• 生成索引HTML文件。