makeindex - 云端在线

程序：

您的姓名

makeindex - 一个通用的、独立于格式化程序的索引处理器

概要

制作索引 [-c[-g[-i[-l[-o 工业[-p NUM[-q[-r[-s 文件[-t 日志[-L[-T]
[idx0 idx1 idx2...]

商品描述

该程序 制作索引 是一个通用的分层索引生成器； 它接受一个或
更多输入文件（通常由文本格式化程序生成，例如 TeX (TEX(1L)) 或 的troff（1）
对条目进行排序，并生成一个可以格式化的输出文件。 索引可以有
最多三个级别（0、1 和 2）的子项嵌套。 标记单词的方式
主文档中的索引特定于所使用的格式化程序； 制作索引 不
不能 自动选择这些词的过程。 由于输出索引是分层的，
制作索引 可以认为是补充 AWK(1)基于 制作索引(1L) 系统
Bentley 和 Kernighan，这是特定于 的troff(1)、生成非层次索引，
并使用更简单的语法来指示索引条目。 使用说明
的troff 和 TeX的，请参阅下面的示例部分。

输入和输出文件的格式在样式文件中指定； 默认情况下，输入
被假定为 .idx 文件，由 LaTeX 生成。

除非明确指定，否则第一个输入文件的基本名称 (idx0) 用于
确定其他文件的名称。 对于指定的每个输入文件名，该文件的一个文件
名称被寻求。 如果未找到此文件且文件名没有扩展名，则
延期 .idx 附加。 如果没有找到这个名字的文件， 制作索引 中止。

如果只给出了一个输入文件并且没有使用指定的显式样式文件 -s,
制作索引 使用带有扩展名的文件 .mst 作为默认样式文件（如果存在）。

有关如何选择索引关键字的重要说明，请参阅 Lamport 引用的文档
以下。 作为一个独立于选择索引关键字的问题，一个系统的机制
建议在文档中放置索引词 Index 考前准备 和 处理中，以
下面引用的论文。

配置

-c 压缩中间空白（忽略前导和尾随空白和制表符）。
默认情况下，保留索引键中的空格。

-g 根据 DIN 规定的规则，在索引中使用德语单词排序
5007. 默认情况下， 制作索引 使用一个词序，其中优先级是：
符号、数字、大写字母、小写字母。 德语序列
词序为：符号、小写字母、大写字母、数字。
此外，此选项使 制作索引 识别德国的 TeX 命令
{"a, "o, "u and "s} 作为 {ae, oe, ue 和 ss} 在条目排序期间。
引号字符必须在样式文件中重新定义（例如，重新定义
引用为“+”）。 如果没有重新定义引号字符， 制作索引 将产生
错误消息并中止。

-i 从输入中获取 标准输入. 当这个选项被指定并且 -o 不是，输出是
写入 标准输出.

-l 信函订购； 默认情况下，使用词序（参见 ORDERING 部分）。

-o 工业 采用 工业 作为输出索引文件。 默认情况下，文件名由
附加扩展名 .ind 到第一个输入文件的基本名称 (idx0).

-p NUM 设置输出索引文件的起始页码为 NUM （当
索引文件要单独格式化）。 论据 NUM 可能是数字或
以下之一：

任何 起始页是最后一个源页码加 1。

奇 起始页是最后一个源页之后的第一个奇数页
数。

甚至 起始页是最后一个源之后的第一个偶数页
页码。

最后一个源页面是通过在日志文件中向后搜索获得的
包含在成对方括号内的数字的第一个实例 ([...]）。 如果一个
页码丢失或未找到日志文件，将不会尝试
设置起始页码。 源日志文件名由
附加扩展名 .LOG 到第一个输入文件的基本名称 (idx0).

-q 静音模式; 不发送消息给 斯特德. 默认情况下，进度和错误消息
被送到 斯特德 以及转录文件。

-r 禁用隐式页面范围形成； 页面范围必须通过使用创建
显式范围运算符； 请参阅下面的特殊效果。 默认情况下，三个或更多
连续的页面会自动缩写为一个范围（例如 1-5）。

-s 麦粒肿 采用 麦粒肿 作为样式文件（无默认值）。 环境变量 INDEXSTYLE
定义应在其中找到样式文件的路径。

-t 日志 采用 日志 作为转录文件。 默认情况下，文件名由
附加扩展名 .ilg 到第一个输入文件的基本名称 (idx0).

-L 根据区域设置排序。 并非在所有系统上都可用。

-T 对泰国文件的特殊支持。 并非在所有系统上都可用。

风格 文件

样式文件通知 制作索引 关于格式 .idx 输入文件和预期的
最终输出文件的格式； 示例如下所示。 这个文件可以驻留在任何地方
由环境变量 INDEXSTYLE 定义的路径。 样式文件包含一个列表
的说明符, 属性> 对。 有两种类型的说明符：输入和输出。
对不必以任何特定顺序出现。 以“%”开头的一行是注释。
在以下说明符和参数列表中， 是任意字符串
由双引号 ("...") 分隔， 是由单引号括起来的单个字母
（'...'）， 和是一个非负整数。 最大长度是 2048。
必须对文字反斜杠或引号进行转义（通过反斜杠）。 中未指定的任何内容
样式文件将被分配一个默认值，该值显示在
最右边的列。

INPUT 风格 说明符
实际 '@'
表示下一个条目将出现在输出中的符号
文件中。

arg_close '}'
索引条目参数的结束定界符。

arg_open '{'
索引条目参数的开始分隔符。

封装 '|'
指示参数列表的其余部分的符号
用作页码的封装命令。

逃生 '\\'
转义下一个字母的符号，除非它的前面
信是 逃生。 注意： 报价 用于转义字母
紧随其后，但如果它前面是 逃生， 它是
被视为普通字符。 这两个符号 必须 be
清楚的。

关键词 “\\索引条目”
命令告诉 制作索引 它的参数是一个索引
条目。

水平 '！'
分隔符表示子项的新级别。

页面合成器 “——”
分隔组合页码部分的分隔符（请参阅
特殊效果如下）。

报价 '''
请注意： 报价 用于立即转义字母
跟在它后面，但如果它前面是 逃生，它被视为
普通的性格。 这两个符号 必须 与众不同。

范围关闭 ')'
指示显式页面范围结束的结束定界符。

范围_开放 ´(´
指示显式页面开始的开始分隔符
的特点。

OUTPUT 风格 说明符
前言 "\\begin{索引}\n"
输出文件的序言。

后序 "\n\n\\end{索引}\n"
输出文件的后缀。

设置页面前缀 "\n \\setcounter{page}{"
设置起始页码的命令前缀。

设置页面后缀 "}\n"
设置起始页码的命令后缀。

组跳过 "\n\n \\索引空间\n"
在新组开始之前插入的垂直空间。

标题_标志 0
指示新组头处理的标志，它们是
在新组之前插入（符号、数字和 26
字母）：正值导致大写字母为
在前缀和后缀之间插入，负值会导致
要插入的小写字母（默认为 0，不会产生
头）。

标题前缀 “”
在新字母开始之前插入的字母标题前缀。

标题_后缀 “”
新字母开始时要插入的字母标题后缀。

symhead_积极
“符号”
要插入的符号的标题，如果 标题_标志 是积极的。

符号头负数
“符号”
要插入的符号的标题，如果 标题_标志 是负面的。

numhead_积极
“数字”
要插入的数字的标题，如果 标题_标志 是积极的。

负数
“数字”
要插入的数字的标题，如果 标题_标志 是负面的。

item_0 "\n \\项目"
要在两个主要（0 级）项目之间插入的命令。

item_1 "\n \\子项"
要在两个次要（级别 1）项目之间插入的命令。

item_2 "\n \\子项"
要插入两个级别 2 项之间的命令。

item_01 "\n \\子项"
要插入到级别 0 项和级别 1 项之间的命令。

项目_x1 "\n \\子项"
插入到级别 0 项和级别 1 项之间的命令，
其中 0 级项目没有关联的页码。

item_12 "\n \\子项"
要插入到级别 1 项和级别 2 项之间的命令。

项目_x2 "\n \\子项"
插入到级别 1 项和级别 2 项之间的命令，
其中 1 级项目没有关联的页码。

德利姆_0 "、"
要在 0 级键与其第一页之间插入的分隔符
数字（默认：逗号后跟一个空格）。

德利姆_1 "、"
要在 1 级键与其第一页之间插入的分隔符
数字（默认：逗号后跟一个空格）。

德利姆_2 "、"
要在 2 级键与其第一页之间插入的分隔符
数字（默认：逗号后跟一个空格）。

德利姆_n "、"
要在两个页码之间插入的分隔符
键入任何级别（默认：逗号后跟空格）。

德利姆_r “——”
要在起始页和结束页之间插入的分隔符
一个范围的数字。

德利姆_t “”
要在页面列表末尾插入的分隔符。 这个
分隔符对没有关联页面的条目没有影响
名单。

封装前缀 “\”
封装页面的命令前缀的第一部分
数。

encap_中缀 “{”
封装页面的命令前缀的第二部分
数。

封装后缀 “}”。
封装页码的命令的后缀。

页优先级 “RNARA”。
页面类型优先顺序。 默认指定：小写
罗马，数字/阿拉伯，小写字母，大写罗马，
大写字母。

最大行数 72
输出中一行的最大长度，超出该长度的一行
包裹。

缩进空间 "\t\t"
要在换行前插入的空格（默认值：两个
标签）。

缩进长度 16
的长度 缩进空间 （默认值：16，相当于 2 个标签）。

后缀_2p “”
分隔符替换范围分隔符和第二页
两页列表的编号。 当存在时，它会覆盖 德利姆_r.
示例：“f.”。

后缀_3p “”
分隔符替换范围分隔符和第二页
三页列表的编号。 当存在时，它会覆盖 德利姆_r
和 后缀_mp. 示例：“ff。”。

后缀_mp “”
分隔符替换范围分隔符和第二页
多页列表的编号（三页或更多页）。 什么时候
目前，它覆盖 德利姆_r. 示例：“f.”。

示例

TeX的 例
以下示例显示了一个名为 书友，它定义了一个索引
可以独立于主要来源格式化的书：

前言
"\\documentstyle[12pt]{book}
\\开始{文档}
\\开始{索引}
{\\小\n"
后序
"\n\n}
\\结束{索引}
\\end{文档}\n"

假设特定的书籍风格需要索引（以及任何章节）
从奇数页码开始，并且输入文件被命名为 foo.idx， 以下
命令行在文件中产生输出 脚印:

makeindex -s book.ist -o footmp.ind -p 奇数 foo

这里使用了一个非默认的输出文件名来避免破坏本书的输出
本身（大概 foo.dvi文件，这将是索引输出的默认名称
文件！）。

特洛夫 例
用于创建索引的示例控制文件，我们假设它位于文件中
样本.ist:

关键词“IX：”
前言
".\\\" 索引输出开始
\".\\\" 进入两列模式
.2度
.SH
。这
指数
.XS
指数
.XE
.R
.ps 9p
.vs 11p
.sp
.de I1
.ti 0.25i
..
.de I2
.ti 0.5i
..“
postamble "\n.\\\" 索引输出结束"
setpage_prefix "\n.nr % "
setpage_suffix ""
group_skip "\n.sp 1.0"
标题_标志 1
Heading_prefix "\n.IS\n"
Heading_suffix "\n.IE"
item_0 "\n.br\n"
item_1 "\n.I1\n"
item_2 "\n.I2\n"
item_01 "\n.I1\n"
item_x1 "\n.I1\n"
item_12 "\n.I2\n"
item_x2 "\n.I2\n"
delim_0 ", "
delim_1 ", "
delim_2 ", "
delim_r "-"
delim_t "."
encap_prefix "\\fB"
encap_infix ""
encap_suffix "\\fP"
缩进空间“”
缩进长度 0

本地宏包可能需要修改，如本例中的扩展到
此 -多发性硬化症 宏（请注意，在某些站点上，此宏应该 更换 一个预先存在的宏
同名）：

.
.de 九
.ie '\\n(.z'' .tm IX: \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9 {\\n(PN}
.el \\!.IX \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9 {\\n(PN}
..

（请注意，字符串 {\\n(PN}) 与行的其余部分由制表符分隔。如果您的
本地宏包不包含此扩展名，只需在
文件的开头。 这是一个简单的 的troff(1) 输入文件，我们假设是
命名 样本.txt:

这是一个用于测试 \fImakeindex\ 的示例文件fP（1公升）
程序，然后看
.IX {索引！程序！C 语言}
.IX {makeindex@\fImakeindex\fP(1升)}
.bp
.RS
.IX {克努斯}
.IX {排版！计算机辅助}
它在 \fItroff\ 中的功能如何fP(1)环境。

请注意，索引条目由 .IX 宏，这会导致以下文本
写给 标准输出 连同当前页码。

创作 “ 指数 文件 IN “ 伯恩 SHELL
创建一个输入文件 制作索引, in 此 畛域 壳 环境，做等效的
在您的命令站点：

psroff -ms -Tpsc -t sample.txt > /dev/null 2> sample.tmp

有些网站需要 分流 而不是 关闭. 过滤掉任何真正的错误
消息，调用 grep的（1）：

grep '^IX:' sample.tmp > sample.idx

创作 “ 指数 文件 使用 UCSF 增强 TROFF/转录
通过 UCSF Enhanced troff/TRANSCRIPT， -I 选项 关闭(1L) 可以同时生产
格式化程序输出和索引文件：

psroff -ms -I 样本.inp -Tpsc 样本.txt

如果希望抑制格式化程序输出：

psroff -ms -I sample.inp -Tpsc -t sample.txt > /dev/null

完成 “ 指数
上述任何过程都留下输入 制作索引 in 样本.inp. 下一步
是调用 制作索引:

makeindex -s 样本.ist 样本.idx

这离开 的troff(1)-文件中的就绪输出 样本.ind.

订购

默认情况下， 制作索引 假设 字 订购; 如果 -l 选项有效， 邮件
订购 用来。 在词序中，空格在字母表中的任何字母之前，而
在字母排序中，它根本不算数。 下图说明了这一点
例：

字 秩序 邮件 秩序
海狮海豹
海豹海狮

数字始终按数字顺序排序。 例如，

9 (九), 123
10 (十)，见德里克，博

首先不考虑大小写对字母进行排序； 当单词相同时，大写
版本在其小写对应版本之前。

此处定义的特殊符号是未出现在数字联合中的任何字符
和英文字母字符。 以特殊符号开头的模式在前面
数字，在以字母开头的模式之前。 作为一种特殊情况，一个字符串
以数字开头但与非数字混合被认为是模式开头
具有特殊的性质。

特别 影响

条目如

\indexentry{alpha}{1}
\indexentry{alpha!beta}{3}
\indexentry{alpha!beta!gamma}{10}

在输入文件中将被转换为

\项目阿尔法，1
\subitem 测试版，3
\subsubitem 伽玛，10

在输出索引文件中。 请注意， 水平 符号 (`!') 用于上面的分隔
层级。

可以通过使用使项目以指定的形式出现 实际 (`@')
操作员。 例如，

\indexentry{alpha@{\it alpha\/}}{1}

会变成

\item {\it alpha\/}, 1

处理后。 `@' 前面的模式用作排序键，而
随后将其写入输出文件。 注意同一键的两次出现，
一个有一个没有 实际 运算符，被视为 不同 条目。

item、subitem 和 subsubitem 字段可能有单独的排序键：

\indexentry{aa@{\it aa\/}!bb@{\it bb\/}!cc@{\it cc\/}}{1}

这将被转换为

\item {\it aa}, 1
\subitem {\it bb}, 3
\subsubitem {\it cc}, 10

可以使用指定的命令封装页码 封装
(`|') 运算符：

\indexentry{alpha|粗体}{1}

将被转换为

\item alpha，\粗体{1}

其中，使用 TeX 的合适定义，\bold{n} 将扩展为 {\bf n}。 在这
例如，与页面封装相关的三个输出属性 封装前缀,
encap_中缀及 封装后缀, 对应反斜杠、左大括号和右大括号，
分别。 这种机制允许以不同的字体设置页码。 为了
例如，出现关键字定义的页面可以是一种字体，
主要示例的位置可以使用另一种字体，而其他外观可以使用第三种字体
字体。

封装 运算符还可用于在索引中创建交叉引用：

\indexentry{alpha|参见{beta}}{1}

会变成

\item alpha，\see{beta}{1}

在输出文件中，其中

\见{测试版}{1}

将扩展到

{\it see\/} 测试版

请注意，在这样的交叉引用中，页码消失了。

一对 封装 与 范围_开放 (`|(') 和 范围关闭 (`|)') 创建一个
明确的页面范围：

\indexentry{alpha|(}{1}
\indexentry{alpha|)}{5}

会变成

\项目阿尔法，1-5

由相同键索引的中间页将隐式合并到范围中。 这个
当要索引有关特定主题的整个部分时特别有用，
在这种情况下，只需将范围打开和关闭运算符插入到
部分的开头和结尾。 显式页面范围形成还可以包括额外的
命令以指定字体设置页面范围：

\indexentry{alpha|(粗体}{1}
\indexentry{alpha|)}{5}

会变成

\item alpha, \bold{1--5}

有几个潜在的问题值得一提。 首先，条目像

\indexentry{alpha|(}{1}
\indexentry{alpha|粗体}{3}
\indexentry{alpha|)}{5}

将被解释为

\item alpha, \bold{3}, 1--5

但在抄本中有一条关于遇到不一致页面的警告消息
封装器。 以罗马页码开头并以阿拉伯语结尾的显式范围是
也认为是错误。 在这种情况下，（如果可能）范围被分成两个
子范围，一个是罗马语，另一个是阿拉伯语。 例如，

\indexentry{alpha|(}{i}
\indexentry{alpha}{iv}
\indexentry{alpha}{3}
\indexentry{alpha|)}{7}

将变成

\item alpha, i--iv, 3--7

记录文件中有一条警告消息，抱怨非法范围
形成。

本节中提到的每个特殊符号都可以通过 报价 运算符 (`"')。
从而

\indexentry{alpha"@beta}{1}

实际上会变成

\项目阿尔法@贝塔，1

作为执行的结果 制作索引. 的引用能力 报价 如果是，则消除
紧随其后 逃生 (`\')。 例如，

\indexentry{f\"ur}{1}

成为

\item f\"ur, 1

它代表 TeX 系列处理器的变音符号“u”。

页码可以是一个或多个字段的组合，这些字段由绑定到的定界符分隔
页面合成器 (`-')，例如第 II 章第 12 页的 II-12。 页码可能包含向上
到十个字段。

从 2.11 版开始 制作索引是， 报价 运营商可以报价 任何 范围 1 中的字符
... 255. 字符 0 被排除在外，因为它在内部使用 制作索引 资源
代码作为字符串终止符。 通过此更改，可以为所有八位字节创建排序键
除 0 外的字符。排序顺序为

标点符号（以 ASCII 顺序），
数字，
控制字符（1 ... 31），
空间 (32),
字母（忽略大小写），
字符 127 ... 255。

这是一个示例，显示了所有可打印 ASCII 字符的索引，而不是
字母和数字，假设默认的 TeX 格式。 为方便起见，页码
引用是相应的 ASCII 序号值。

\indexentry{"@"（空格）}{32}
\indexentry{"!@"! （感叹号）}{33}
\indexentry{""@""（引号）}{34}
\indexentry{"#@"\#（尖锐的符号）}{35}
\indexentry{"$@"\$（美元符号）}{36}
\indexentry{"%@"\%（百分号）}{37}
\indexentry{"&@"\&（与号）}{38}
\indexentry{"<@"$<$（左尖括号）}{60}
\indexentry{"=@"=（等于）}{61}
\indexentry{">@"$>$（右尖括号）}{62}
\indexentry{"?@"? （查询）}{63}
\indexentry{"@@"@（在标志处）}{64}
\indexentry{"[@"[ (左方括号)}{91}
\indexentry{"\@"\verb=\=（反斜杠）}{92}
\indexentry{"]@"]（右方括号）}{93}
\indexentry{"^@"\verb=^= (插入符号)}{94}
\indexentry{"_@"\verb=_= (下划线)}{95}
\indexentry{"`@"\verb=~= (重音符)}{96}
\indexentry{"{@"\"{ (左大括号)}{123}
\indexentry{"|@"\verb="|=（竖线）}{124}
\indexentry{"}@"\"}（右括号）}{125}
\indexentry{"~@"\verb=~= (波浪号)}{126}

`@' 字符后的实际字段中具有特殊意义的字符
对 TeX 的重要性必须表示为控制序列，或数学模式字符。
请特别注意 at 符号、左右大括号和垂直
酒吧，被编码。 输出的索引文件 制作索引 对于这个例子看起来像这样：

\begin{索引}

\物品 ！ (感叹号), 33
\item " (引号), 34
\item \#（尖锐符号），35
\item \$（美元符号），36
\item \%（百分号），37
\item \&（与号），38
\item $<$（左尖括号），60
\item = (等于), 61
\item $>$（右尖括号），62
\物品 ？ (查询), 63
\item @（在符号处），64
\item [（左方括号），91
\item \verb=\=（反斜杠），92
\item ]（右方括号），93
\item \verb=^= (插入符号), 94
\item \verb=_= (下划线), 95
\item \verb=~=（重音），96
\item \{（左括号），123
\item \verb=|=（竖线），124
\item \}（右括号），125
\item \verb=~= (波浪号), 126

\索引空间

\item（空格），32

\end{索引}

使用 onworks.net 服务在线使用 makeindex