参考 - 云端在线

程序：

您的姓名

参考 - 预处理 groff 的参考书目

概要

参考 [ -benvCPRS [ -an [ -c领域 [ -fn [ -i领域 [ -k部分 [ -l米，n ]
[ -p文件名 [ -s领域 [ -tn [ -B字段宏 [ 文件名...]

商品描述

该文件记录了 GNU 版本的 参考，这是 groff 文档的一部分
格式化系统。 参考 复制内容 文件名...到标准输出，
除了之间的线 .[ 和 .] 被解释为引文，之间的线 .R1
和 .R2 被解释为关于如何处理引文的命令。

每个引文指定一个参考。 引文可以指定一个参考文献
包含在书目数据库中，通过给出一组关键字，只有该参考
包含。 或者，它可以通过在
引文。 这些替代方案的组合也是可能的。

对于每次引用， 参考 可以在文本中产生标记。 这个标记由一些标签组成
可以通过各种方式与文本和其他标签分开。 对于每个
参考它也输出 groff的 宏包可以使用的命令来生成
每个引文的格式化参考。 的输出 参考 因此必须处理
使用合适的宏包。 这 -多发性硬化症 和 -我 宏都适合。 命令
可以在引用后立即输出引用的引用格式，或者
可能会累积引用，并在稍后的某个时间点输出命令。 如果
参考文献被累积，然后对同一参考文献的多次引用将产生一个
单一格式的参考。

之间的界线的解释 .R1 和 .R2 作为命令是 GNU 的一个新特性 参考.
使用这个特性的文档仍然可以被Unix处理，只需添加
线条

。德 R1
.ig R2
..
到文档的开头。 这会导致 的troff 忽略之间的一切 .R1
和 .R2. 一些命令的效果也可以通过选项来实现。 这些选项是
支持主要是为了与 Unix 兼容，请参阅。 通常使用起来更方便
命令。

参考 产生 。如果 行，以便生成的消息中的文件名和行号
读取的命令 参考 输出将是正确的； 它还解释以开头的行
。如果 以便消息中的文件名和行号和 。如果 它产生的线条将
即使输入已由命令预处理，例如 苏林（1）。

配置

命令行选项和它的参数之间可以有空格。

大多数选项等效于命令（有关这些命令的说明，请参见
命令 小节）：

-b 无文本标签； 无标签参考

-e 积累

-n 无默认数据库

-C 兼容

-P 移动标点

-S 标签 ”（安|Q） ', ' (Dy|D)"; 括号标签 " (" ) "; "

-an 反转 An

-c领域
利用 领域

-fn 标签 %n

-i领域
搜索忽略 领域

-k 标签 大~%a

-k部分
标签 部分～%a

-l 标签 A.nD.y%a

-lm 标签 A.n+mDy%a

-l,n 标签 A.n.y-n%a

-lm,n 标签 A.n+mDY-n%a

-p文件名
数据库 文件名

-s规格 分类 规格

-tn 搜索截断 n

这些选项等价于以下命令，除了
在命令行上指定的文件名被处理，就好像它们是
参考书目 命令而不是正常方式：

-B 注释 X 接入点； 无标签参考

-B部分.宏
注释 部分 宏; 无标签参考

以下选项没有等效命令：

-v 打印版本号。

-R 不识别以开头的行 .R1/.R2.

用法

书目 数据库
书目数据库是一个文本文件，由一个或多个分隔的记录组成
空行。 在每个记录字段中，以 % 在一行的开头。 每个
字段有一个单字符名称，紧跟在 %. 最好只使用
字段名称的大写和小写字母。 字段的名称应该是
后跟正好一个空格，然后是字段的内容。 空字段是
忽略。 每个字段的约定含义如下：

%A 作者的名字。 如果名称包含标题，例如 小 最后，它
应该用逗号与姓氏分开。 可以有多个
的发生 %A 场地。 顺序很重要。 总是一个好主意
提供一个 %A 场或 %Q 领域。

%B 对于属于一本书的文章，该书的标题。

%C 出版地（城市）。

%D 出版日期。 应完整指定年份。 如果月份是
指定时，应使用名称而不是月份数，但仅
前三个字母是必需的。 最好总是提供一个 %D
场地; 如果日期未知，则使用一个值，例如 in express or 不明 可以使用。

%E 对于属于一本书的文章，该书的编辑姓名。 在哪里
作品有编辑而没有作者，编辑的姓名应为 %A
领域和 , （编辑） or , （编辑） 应该附加到最后一个作者。

%G 美国政府订购号。

%I 出版商（发行人）。

%J 对于期刊中的文章，期刊名称。

%K 用于搜索的关键字。

%L 标签。

%N 期刊号。

%O 其他信息。 这通常打印在参考的末尾。

%P 页码。 可以将一系列页面指定为 m-n.

%Q 如果作者不是个人，则为作者姓名。 这只会在以下情况下使用
没有 %A 领域。 只能有一个 %Q 领域。

%R 技术报告编号。

%S 系列名称。

%T 标题。 对于书籍或期刊中的文章，这应该是文章的标题
的文章。

%V 期刊或书籍的卷号。

%X 注解。

对于所有字段，除了 %A 和 %E, 如果一个特定的出现不止一次
记录中的字段，只会使用最后一个这样的字段。

如果使用重音字符串，它们应该跟在要重音的字符之后。 这意味着
该 AM 宏必须与 -多发性硬化症 宏。 不应引用重音字符串：
用一个 \ 而不是两个。

参考文献
引文的格式是
.[开场白
标志 关键词
领域
.]结束语

这款 开场白, 结束语 和 标志 组件是可选的。 只有其中之一
关键词 和 领域 需要指定组件。

这款 关键词 组件说要在书目数据库中搜索参考文献
包含所有单词 关键词. 如果找到多个引用，则为错误。

这款 领域 组件指定附加字段以替换或补充指定的字段
在参考。 当参考被累积并且 关键词 组件是
非空，则应仅在第一次出现以下情况时指定其他字段
引用了特定参考文献，并将适用于该参考文献的所有引用。

这款 开场白 和 结束语 组件指定用于括号的字符串
标签而不是指定的字符串 括号标签 命令。 如果其中任何一个
组件是非空的，在指定的字符串 括号标签 命令不会
用过的; 可以使用 [ 和 ] 旗帜。 注意前导和
尾随空格对于这些组件很重要。

这款 标志 组件是一个非字母数字字符列表，每个字符都会修改
处理这个特殊的引用。 Unix 引用会将这些标志视为
关键字等将忽略它们，因为它们是非字母数字。 以下标志是
目前公认：

# 这表示使用指定的标签 短标签 命令，而不是那个
由指定 标签 命令。 如果没有指定短标签，则正常
标签将被使用。 通常短标签与作者日期标签一起使用
仅由日期和可能的消歧字母组成； 这 # 应该
暗示数字类型的标签。

[ 先例 开场白 中指定的第一个字符串 括号标签 命令。

] 关注 结束语 与指定的第二个字符串 括号标签 命令。

使用的优点之一 [ 和 ] 标志而不是包括括号 开场——
文本 和 结束语 是您可以更改文档中使用的括号样式
只需改变 括号标签 命令。 另一个优点是排序和合并
如果使用标志，引用的数量不一定会被禁止。

如果要在文本中插入标签，它将被附加到文本之前的行
.[ 线。 如果没有这样的行，那么会在前面插入一个额外的行 .[ 线
并且会给出警告。

引用多个参考文献没有特殊的符号。 只需使用一个
引文顺序，每个参考文献一个。 不要在引文之间放任何东西。
所有引文的标签将附在第一行之前
引文。 还可以对标签进行排序或合并。 见说明 <> 标签
表达式，以及 排序相邻标签 和 缩写标签范围 命令。 一个标签
如果其引文为非空，则不会合并 开场白 or 结束语。 然而，
引用的标签使用 ] 标志并且没有任何 结束语 立即
其次是引用使用 [ 标志并且没有任何 开场白 可以排序和
即使第一个引用的合并 开场白 或第二个引文的 结束语
是非空的。 （如果您想防止这种情况，只需将第一个引文 结束语
\&.)

命令
命令包含在以开头的行之间 .R1 和 .R2. 承认这些
行可以被阻止 -R 选项。 当一个 .R1 线被识别任何累积
引用被刷新。 两者都不 .R1 也不 .R2 线，它们之间也没有任何东西
输出。

命令由换行符或 ;s. # 引入延伸到最后的注释
行（但不隐藏换行符）。 每个命令都被分解成单词。
单词由空格或制表符分隔。 开头的一句话 " 延伸到下一个 "
没有跟随另一个 "。 如果没有这样的话 " 这个词延伸到结尾
线。 对 " 一句话开头 " 崩溃为一个 "。 也不 # 也不 ;
在里面被认出来 "s。 一行可以通过结束它来继续 \; 这有效
到处都是，除了之后 #.

每个命令 姓名 标有 * 的有一个关联的否定命令 NO-姓名 这
取消效果 姓名， 例如， 无排序 命令指定引用
不应排序。 否定命令不带参数。

在下面的描述中，每个参数必须是一个单词； 部分 用于
命名字段的单个大写或小写字母； 领域 用于这样的序列
信件； m 和 n 用于非负数； 绳子 用于任意
串; 文件名 用于文件名。

简写* 领域 string1 string2 string3 string4
缩写名字 领域. 首封信将是
与另一个首字母隔开 string1，从最后
取名 string2, 以及其他任何东西（例如 的 or de）通过
string3. 这些默认为一​​个句点后跟一个空格。 在一个
带连字符的名字，名字第一部分的首字母
将与连字符分开 string4; 这默认为
时期。 不尝试处理任何可能造成的歧义
缩写的结果。 名称在排序前缩写
在标签构建之前。

缩写标签范围* 绳子
三个或更多相邻的标签，指的是连续的
引用将缩写为由第一个组成的标签
标签，然后是 绳子 紧接着是最后一个标签。 这是
主要用于数字标签。 如果 绳子 省略它
默认为 -.

积累* 累积引用而不是写出每个引用
遇到了。 累积的引用将被写出
每当表单的引用

.[
$列表$
.]

在处理完所有输入文件后遇到
每当 .R1 线被识别。

注释* 部分 绳子 部分 是一个注释； 在参考的末尾打印它作为
行前的段落

.绳子

If 绳子 被省略，它将默认为 AP; 如果 部分 也是
省略它将默认为 X. 只有一个字段可以是
注解。

刊文 绳子... 绳子... 是定冠词或不定冠词，应该是
在开始时被忽略 T 排序时的字段。 最初，
此, a 和 an 被认定为文章。

参考书目 文件名... 写出书目中包含的所有参考文献
数据库 文件名... 这个命令应该放在最后 .R1/.R2
块。

括号标签 string1 string2 string3
在文本中，将每个标签用括号括起来 string1 和 string2。 一个
发生 string2 紧接着 string1 会
转换成 string3. 默认行为是

括号标签 \*([. \*(.] ", "

利用 领域 转化率 领域 大盘和小盘。

兼容* 认出 .R1 和 .R2 即使后面跟着一个其他字符
比空格或换行符。

数据库 文件名... 搜索书目数据库 文件名... 对于每个 文件名
如果一个索引 文件名.i 由...制作 索引(1) 存在，那么它将
改为搜索； 每个索引可以覆盖多个数据库。

日期作为标签* 绳子 绳子 是一个标签表达式，它指定一个字符串
更换 D 构造标签后的字段。 见
标签 表达式 标签描述小节
表达式。 如果您不想显式，此命令很有用
参考列表中的标签，但想要处理任何
通过以某种方式限定日期来消除歧义。 这
文本中使用的标签通常是
作者和日期。 在大多数情况下，您还应该使用 无标签-
参考 命令。 例如，

日期作为标签 D.+yD.y%a*D.-y

将在年份的年份部分附加一封消除歧义的信 D
参考中的字段。

默认数据库* 应搜索默认数据库。 这是默认的
行为，所以这个命令的负面版本更多
有用。 参考 确定默认数据库是否应该是
在第一次需要进行搜索时进行搜索。
因此 无默认数据库 命令必须在此之前发出，在
为了有效。

丢弃* 领域 阅读参考文献时， 领域 应该丢弃； 没有字符串
的定义 领域 将被输出。 最初， 领域 旨在
XYZ.

等人* 绳子 m n 控制使用 et al 在评估 @ 标签中的表达式
表达式。 如果作者数量需要使作者
序列明确是 u 和作者总数是 t
那么最后 t-u 作者将被替换 绳子 提供
这 t-u 不小于 m 和 t 不小于 n。 该
默认行为是

等人 " et al“ 2 3

包括 文件名 包括 文件名 并将内容解释为命令。

联合作者 string1 string2 string3
这说明了作者应该如何连接在一起。 当有
正好是两位作者，他们将加入 string1。 何时
有两个以上的作者，除了最后两个之外的所有作者
加入 string2，最后两位作者将加入
string3。 如果 string3 被省略，它将默认为 string1; 如果
string2 也被省略它也将默认为 string1。 对于
例，

联合作者 " 和 " ", " ", 和 "

将恢复加入作者的默认方法。

参考标签* 输出引用时，定义字符串 [F 是的
参考标签。 这是默认行为； 所以
此命令的否定版本更有用。

文本标签* 对于每个参考输出文本中的一个标签。 标签将是
与周围文本分开，如中所述 括号-
标签 命令。 这是默认行为； 所以消极的
此命令的版本更有用。

标签 绳子 绳子 是一个标签表达式，描述如何标记每个
参考。

分离标签第二部分 绳子
合并两部分标签时，将标签的第二部分分开
第一个标签中的第二个标签 绳子。 请参阅
的描述 <> 标签表达式。

移动标点* 在文本中，将行尾的任何标点符号移到
标签。 给出这个命令通常是个好主意，除非你
使用上标数字作为标签。

反转* 绳子 反转名称所在的字段 绳子. 每个字段名称
后面可以跟一个数字，表示有多少这样的字段
应该反过来。 如果一个字段没有给出数字，所有这样的
字段将被反转。

搜索忽略* 领域 在不存在索引的数据库中搜索键时，
忽略内容 领域. 最初，字段 XYZ 旨在
忽略了。

搜索截断* n 只需要第一个 n 要给出的键的字符。 在
在数据库中搜索给定关键词时的效果是
截断到最大值 n 和密钥的长度。
原来 n 是6。

短标签* 绳子 绳子 是一个标签表达式，指定一个替代
（通常较短）标签样式。 这用于 # 旗
在引文中给出。 使用作者日期样式标签时，
作者或作者的身份有时从
上下文，因此可能需要省略作者或作者
从标签。 这 短标签 命令通常会被使用
指定仅包含日期和可能包含的标签
消除歧义的字母。

分类* 绳子 根据引用排序 绳子. 参考文献将
自动累积。 绳子 应该是一个字段列表
名称，每个名称后跟一个数字，表示有多少个字段
该名称应该用于排序。 + 可以用来表示
应该使用所有具有名称的字段。 还 . 可
用于指示应使用
（暂定）标签。 （这 标签 表达式 小节描述
暂定标签的概念。）

排序相邻标签* 根据标签对文本中相邻的标签进行排序
在参考列表中的位置。 这个命令通常应该是
如果 缩写标签范围 命令已发出，或
如果标签表达式包含一个 <> 表达。 这将有
除非正在累积引用，否则无效。

标签 表达式
标签表达式可以正常和临时评估。 结果正常
评估用于输出。 初步评估的结果，称为 试验
标签, 用于收集正常评估所需的信息以消除歧义
标签。 指定的标签表达式 日期作为标签 和 短标签 命令不是
暂定评价。 正常评估和暂定评估对所有类型的评估都是相同的
表达以外 @, *及 % 表达式。 以下描述适用于正常
评估，除非另有说明。

部分
部分 n
这款 n- 第一部分 部分。 如果 n 省略，默认为 1。

'绳子'
中的字符 绳子 从字面上。

@ 所有作者都按照指定的方式加入 联合作者 命令。 每个的整体
将使用作者的名字。 但是，如果参考文献按作者排序（即
是排序规范开始于 A+)，则将使用作者的姓氏
相反，前提是这不会引入歧义，并且还有一个初始
可以使用作者的子序列代替所有作者，再次提供
这不会引起歧义。 仅使用姓氏 i第
如果有其他参考文献的作者被认为是模棱两可的
参考，这样第一个 i-1 参考文献的作者相同， i第
作者不一样，但 i-th 作者姓氏相同。 正确的
一些参考的作者序列的初始子序列被认为是
如果有一些其他作者序列的引用，则是模棱两可的
将该子序列作为适当的初始子序列。 当初始子序列
使用作者的，其余作者被替换为指定的字符串
此 等人 命令; 此命令还可以指定必须的附加要求
在可以使用初始子序列之前满足。 @ 暂时评估为
作者的规范表示，这样比较的作者
排序目的将具有相同的表示。

%n
%a
%A
%i
%I 参考序列号按照后面的字符格式化
此 %. 参考文献的序号是 1 加上早期参考文献的数量
与此参考具有相同的暂定标签。 这些表达暂定
评估为空字符串。

表达式* 如果还有另一个引用与此引用具有相同的暂定标签，则
表达式, 否则为空字符串。 它暂时评估为空字符串。

表达式+n
表达式-n 首先 （+) 或最后 (-) n 的大写或小写字母或数字 表达式. 特罗夫
特殊字符（如 \（'一种) 算作单个字母。 重音弦是
保留但不计入总数。

表达式.l 表达式 转换为小写。

表达式.u 表达式 转换为大写。

表达式.c 表达式 转换为大写和小写。

表达式.r 表达式 颠倒，使姓氏在前。

表达式.a 表达式 名字缩写。 请注意，在 简写
命令在评估任何标签之前被缩写。 因此 .a 只是有用
当您希望在标签中缩写字段而不是在引用中缩写字段时。

表达式.y 年部分 表达式.

表达式.+y
部分 表达式 年前，或全年 表达式 如果它不包含
一年。

表达式.-y
部分 表达式 在年份之后，或者一个空字符串，如果 表达式 不包含
一年。

表达式.n 姓氏部分 表达式.

表达式1~表达式2
表达式1 除了如果最后一个字符 表达式1 is - 那么它将被替换为
表达式2.

表达式1 表达式2
的串联 表达式1 和 表达式2.

表达式1|表达式2
If 表达式1 那么非空 表达式1 除此以外 表达式2.

表达式1&表达式2
If 表达式1 那么非空 表达式2 否则为空字符串。

表达式1?表达式2:表达式3
If 表达式1 那么非空 表达式2 除此以外 表达式3.

<表达式> 标签分为两部分，由 表达式. 两个相邻的两部分
具有相同第一部分的标签将通过附加第二部分来合并
将第二个标签移到第一个标签上，由 中指定的字符串分隔
分离标签第二部分 命令（最初，逗号后跟一个空格）； 这
结果标签也将是一个由两部分组成的标签，第一部分与以前相同
合并，因此可以将其他标签合并到其中。 请注意，它是
允许第一部分为空； 这对于表达式来说可能是可取的
用于 短标签 命令。

(表达式) 与...相同 表达式. 用于分组。

以上表达式按优先顺序排列（最高在前）； & 和 | 有
相同的优先级。

宏 接口
每个引用都以对宏的调用开始 ]-. 字符串 [F 将被定义为
此参考的标签，除非 无标签参考 命令已下达。
然后是一系列字符串定义，每个字段一个： string [X
对应字段 X. 号码登记表 [P 设置为 1 如果 P 字段包含一个
页的范围。 这 [T, [A 和 [O 编号寄存器设置为 1 根据 T, A 和
O 字段以其中一个字符结尾 。？！。 该 [E 编号寄存器将被设置为 1 如果
此 [E 字符串包含多个名称。 引用之后是调用 ][
宏。 这个宏的第一个参数给出一个数字，表示
参考。 如果引用包含一个 J 字段，它将被归类为类型 1，否则
如果它包含一个 B 字段，它将键入 3，否则如果它包含一个 G or R 领域它会
是类型 4，否则如果包含一个 I 字段为类型 2，否则为类型 0。
第二个参数是类型的符号名称： other, 杂志文章, 书,
书内文章 or 技术报告. 已经积累或正在积累的参考文献组
制作的 参考书目 命令之前是调用 ]< 宏并遵循
通过调用 ]> 宏。

使用在线参考使用 onworks.net 服务