aspell - 参考手册、选项、命令示例


姓名

aspell - 交互式拼写检查器

概要

aspell [options] <command>

描述

aspell 是一个连接到 Aspell 库的实用程序,因此它可以作为 ispell -a 的替代品,作为独立的拼写检查器,作为测试实用程序来测试Aspell 库功能,并作为管理库使用的字典的实用程序。

Aspell 库包含一个接口,允许其他程序直接访问其功能,从而将拼写检查的复杂任务减少为简单的库调用。默认库不包含词典单词列表。要添加语言词典,请首先检查您的发行版是否有修改过的词典,否则请在此处查找基本语言词典 。

以下信息描述了 Aspell 实用程序使用的命令和选项。

本手册页与官方文档分开维护,因此可能已过时或不完整。官方文档作为 Texinfo 手册进行维护。请参阅 info 中的“ aspell ”条目以获取更完整的文档。

命令

<命令> 是以下之一:

usage, -?

将简短的 Aspell 实用程序使用消息发送到标准输出。这是一个简短的摘要,列出了更常见的拼写检查命令和选项。

help

将详细的 Aspell Utility 帮助消息发送到标准输出。这是显示所有命令、选项、过滤器和字典的完整列表。

version, -v

将 Aspell 库和实用程序的版本号打印到标准输出。

check <file>, -c <file>

对单个文件进行拼写检查。

pipe, -a

在 ispell -a 兼容模式下运行 Aspell。

list

从标准输入生成拼写错误的单词列表。

[dump] config

将所有当前配置选项转储到标准输出。

config <key>

将 <key> 的当前值发送到标准输出。

soundslike

输出输入的每个单词的相似发音。

munch

从输入单词列表生成可能的词根和词缀。

expand [1-4]

扩展输入的每个词缀压缩单词的词缀标志。

clean [strict]

清理输入单词列表,使每一行都是有效单词。

munch-list [simple] [single|multi] [keep]

通过词缀压缩来减小单词列表的大小。

conv <from> <to> [<norm-form>]

将<from>一种编码<to>转换为另一种编码。

norm (<norm-map>|<from> <norm-map> <to>) [<norm-form>]

执行 Unicode 标准化。

[dump] dicts|filters|modes

列出可用的词典、过滤器或模式。

dump|create|merge master|personal|repl <wordlist>

转储、创建或合并主、个人或替换单词列表。

字典选项

以下选项可用于控制要使用的字典及其行为方式。

--master=<name>, -d <name>

要使用的字典的基本名称。如果指定了此选项,则 Aspell 将使用此字典或死亡。

--dict-dir=<directory>

主词典单词列表的位置。

--lang=<string>, -l <string>

使用的语言。它遵循大多数系统上 LANG 环境变量的相同格式。它由两个字母的 ISO 639 语言代码和破折号或下划线后面的可选的两个字母的 ISO 3166 国家/地区代码组成。默认值基于 LC_MESSAGES 区域设置的值。

--size=<string>

字典单词列表的首选大小。它由描述列表大小的两个字符数字代码组成,典型值为:10=微小、20=非常小、30=小、40=中小、50=中、60=中大、70 =大,80=巨大,90=疯狂。

--variety=<string>

任何额外的信息可以将这种字典与其他可能具有相同lang和大小的字典区分开来。

--jargon=<string>

请使用variety选项,因为它取代jargon作为更好的选择。 行话将来将会被删除。

--word-list-path=<list of directories>

单词列表信息文件的搜索路径。

--personal=<file>, -p <file>

个人单词列表文件名。

--repl=<file>

替换列表文件名。

--extra-dicts=<list>

使用额外的词典。

--ignore-accents

该选项尚未实施。

检查选项

这些选项控制 Aspell 在检查文档时的行为。

--ignore=<integer>, -W <integer>

忽略长度 <= <integer> 个字符的单词。

--ignore-case, --dont-ignore-case

检查单词时忽略大小写。

--ignore-repl, --dont-ignore-repl

忽略存储替换对的命令。

--save-repl, --dont-save-repl

在全部保存时保存替换单词列表。

--sug-mode=<mode>

建议<mode>=超|快速|正常|拼写错误

过滤器选项

这些选项修改各种过滤器的行为。

--add-filter=<list>, --rem-filter=<list>

添加或删除过滤器。

--add-filter-path=<paths>, --rem-filter-path=<paths>

添加或删除搜索过滤器的路径。

--mode=<string>, -e, -H, -t, -n

设置过滤器模式。 模式 是 none、url、email、html、tex 或 nroff 之一。替代快捷方式选项是“-e”(针对电子邮件)、“-H”(针对 Html/Sgml)、“-t”(针对 Tex)或“-n”(针对 Nroff)。

--encoding=<string>

文档的预期编码。默认值取决于当前区域设置。

--add-email-quote=<list>, --rem-email-quote=<list>

添加或删除电子邮件引用字符列表。

--email-margin=<integer>

引号字符之前可以出现的字符数。

--add-html-check=<list>, --rem-html-check=<list>

添加或删除要始终检查的 HTML 属性列表。例如,查看 alt= 标签内部。

--add-html-skip=<list>, --rem-html-skip=<list>

添加或删除 HTML 属性列表以在拼写检查时始终跳过。

--add-sgml-check=<list>, --rem-sgml-check=<list>

添加或删除 SGML 属性列表以始终检查拼写。

--add-sgml-skip=<list>, --rem-sgml-skip=<list>

添加或删除 SGML 属性列表以在拼写检查时始终跳过。

--sgml-extension=<list>

SGML 文件扩展名。

--tex-check-comments, --dont-tex-check-comments

检查 TeX 注释。

--add-tex-command=<list>, --rem-tex-command=<list>

添加或删除 TeX 命令列表。

一起运行单词选项

这些可用于控制组合词的行为。

--run-together, --dont-run-together, -C, -B

认为连词有效。

--run-together-limit=<integer>

可以串在一起的最大单词数。

--run-together-min=<integer>

内部词的最小长度。

其他选项

不属于任何其他类别的其他选项。

--conf=<file name>

主要配置文件。该文件覆盖 Aspell 的全局默认值。

--conf-dir=<directory>

主配置文件的位置。

--data-dir=<directory>

语言数据文件的位置。

--keyboard=<keyboard>

使用此键盘布局来建议可能的单词。如果用户不小心按下了正确按键旁边的按键,就会发生这些拼写错误。

--local-data-dir=<directory>

语言数据文件的替代位置。在 data-dir 之前搜索此目录。

--home-dir=<directory>

个人单词列表文件的目录位置。

--per-conf=<file name>

个人配置文件。该文件覆盖全局配置文件中的选项。

ASpell 实用程序选项

这些选项是aspell实用程序的一部分,并且独立于库工作。

--backup, --dont-backup, -b, -x

aspell 实用程序通过制作副本并将 .bak 附加到文件名来创建备份文件。这仅适用于命令为检查<文件>的情况,并且仅在发生任何拼写修改时才创建备份文件。

--byte-offsets, --dont-byte-offsets

使用字节偏移量而不是字符偏移量。

--guess, --dont-guess, -m, -P

在管道模式下创建字典中没有的缺失根/词缀组合。

--keymapping=aspell, --keymapping=ispell

要使用的键映射,aspell 用于默认映射,或者 ispell 使用 Ispell 实用程序使用的相同映射。

--reverse, --dont-reverse

在管道模式下反转建议列表的顺序。

--suggest, --dont-suggest

建议在管道模式下可能的替换。如果错误,Aspell 将仅报告拼写错误,并且不会尝试提供建议或可能的更正。

--time, --dont-time

计算加载时间并建议管道模式下的时间。

此外,Aspell 将尝试理解 Ispell 的命令行选项,以便它可以作为 Ispell 的替代品。如果 Aspell 在没有任何命令行选项的情况下运行,它将显示一个简短的帮助屏幕并退出。

配置

Aspell 可以通过全局或个人配置文件接受选项,这样您就不需要每次在命令行中指定它们。默认的全局配置文件是/etc/aspell.conf或由选项--conf指定的另一个文件,并且首先被检查。默认的每用户配置文件 ~/.aspell.conf 位于 $HOME 目录中(或由选项 --per-conf 指定的另一个文件>) 接下来检查并覆盖全局配置文件中设置的选项。在命令行或通过环境变量指定的选项将覆盖任一配置文件指定的选项。

配置文件的每一行的格式为:

option [value]

其中 option 是上面任何一个标准库选项,不带前导破折号。例如,以下行将默认语言设置为瑞士德语:

lang de_CH

选项和值之间可以有任意数量的空格,但只能是空格,即选项名称和值之间没有“=”。注释也可以通过在注释前添加“#”来包含,因为从“#”到换行符的任何内容都会被忽略。空行也是允许的。 /etc/aspell.conf 文件是如何设置这些选项的一个很好的示例,Aspell 手册有更详细的信息。

也可以看看

aspell-import(1), prezip-bin(1), run-with-aspell(1), word-list-compress(1)

Aspell is fully documented in its Texinfo manual. See the ` aspell ' entry in info for more complete documentation.

支持

可以在 Aspell 邮件列表中找到对 Aspell 的支持。加入各种邮件列表(及其存档)的说明可以在 Aspell 主页 上找到。 Bug 报告应通过 GitHub Issues 提交,而不是发布到邮件列表。

作者

本手册页由 Brian Nelson 根据 Aspell 用户手册编写,版权所有 © 2002 Kevin Atkinson。由 Jose Da Silva 于 2006 年 11 月更新,由 Kevin Atkinson 于 2006 年 12 月更新。