aspell [options] command
指令
命令可以是以下之一：
|
usage, -?
|
显示常见拼写检查命令和选项的简短摘要。
|
|
help
|
将详细的aspell实用程序帮助消息发送到标准输出。这是完整列表，显示所有命令，选项，过滤器和词典。
|
|
version, -v
|
将aspell库和实用程序的版本号打印到标准输出。
|
|
check file, -c file
|
拼写检查单个文件。
|
|
pipe, -a
|
在“ ispell -a ”兼容模式下运行aspell。
|
|
list
|
产生标准输入中拼写错误的单词的列表。
|
|
[dump] config
|
将所有当前配置选项转储到标准输出。
|
|
config key
|
将键的当前值发送到标准输出。
|
|
soundslike
|
输出与输入的每个单词类似的声音。
|
|
munch
|
从单词输入列表中生成可能的词根和词缀。
|
|
expand [1-4]
|
扩展输入的每个词缀压缩词的词缀标志。
|
|
clean [strict]
|
清除输入单词列表，以便每一行都是有效单词。
|
|
munch-list [simple] [single|multi] [keep]
|
通过词缀压缩减少单词列表的大小。
|
|
conv from to [norm-form]
|
从一种编码转换为另一种。
|
|
norm (norm-map|fromnorm-map to) [norm-form]
|
执行Unicode规范化。
|
|
[dump] dicts|filters|modes
|
列出可用的字典，过滤器或模式。
|
|
dump|create|merge master|personal|replwordlist
|
转储，创建或合并主，个人或替换单词列表。
|
选件
以下选项可用于控制使用哪些词典以及它们的行为方式：
|
--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
|
任何额外的信息，以区分这种字典与其他具有相同语言和大小的字典。
|
|
--jargon=string
|
请使用品种选项，因为它代替行话是更好的选择。将来会删除该行话。
|
|
--word-list-path=list of directories
|
单词列表信息文件的搜索路径。
|
|
--personal=file, -p file
|
要使用的个人单词列表的文件名。
|
|
--repl=file
|
替换列表文件名。
|
|
--extra-dicts=list
|
使用额外的字典。
|
|
--ignore-accents
|
（此选项尚未实现。）
|
以下选项控制检查文档时aspell的行为：
|
--ignore=integer, -W integer
|
忽略长度大于或等于整数字符的单词。
|
|
--ignore-case, --dont-ignore-case
|
检查单词时忽略大小写。
|
|
--ignore-repl, --dont-ignore-repl
|
忽略存储替换对的命令。
|
|
--save-repl, --dont-save-repl
|
将替换单词列表保存在全部保存。
|
|
--sug-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 ”，HTML / Sgml的“ -H ”，Tex的“ -t ”或Nroff的“ -n ”。
|
|
--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=filename
|
主配置文件。该文件将覆盖aspell的全局默认值。
|
|
--conf-dir=directory
|
主配置文件的位置。
|
|
--data-dir=directory
|
语言数据文件的位置。
|
|
--keyboard=keyboard
|
使用此键盘布局建议可能的单词。如果用户不小心按了预期的正确键旁边的键，则会发生这些拼写错误。
|
|
--local-data-dir=directory
|
语言数据文件的替代位置。在data-dir之前搜索此目录。
|
|
--home-dir=directory
|
个人单词列表文件的目录位置。
|
|
--per-conf=filename
|
个人配置文件。该文件将覆盖在全局配置文件中找到的选项。
|
以下选项是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时没有任何命令行选项，它将显示一个简短的帮助屏幕并退出。
组态
aspell可以通过全局或个人配置文件接受选项，因此您无需每次都在命令行中指定它们。
默认的全局配置文件是/etc/aspell.conf（或另一个文件，由选项--conf指定），并首先进行检查。
接下来，将检查位于$ HOME目录（或另一个由选项--per-conf指定的文件）中的默认每用户配置文件〜/ .aspell.conf，并将覆盖在全局配置文件中设置的选项。在命令行或通过环境变量指定的选项将覆盖由配置文件指定的那些选项。
配置文件的每一行具有以下格式：
option [value]
其中option是以上任何标准库选项中的任何一个，没有前导破折号。例如，以下行将默认语言设置为瑞士德语：
lang de_CH
选项和值之间可以有任意数量的空格，但是只能是空格，即选项名称和值之间没有' = '。注释也可以在它们前面加上“ ＃ ”，因为从“ ＃ ”到换行符的任何内容都将被忽略。也允许使用空行。该/etc/aspell.conf文件是如何设置这些选项的一个很好的例子。
aspell [options] command
Commands
command can be one of the following:
|
usage, -?
|
Displays a short summary of common spellcheck commands and options.
|
|
help
|
Send a detailed aspell utility help message to standard output. This is a complete list showing all commands, options, filters and dictionaries.
|
|
version, -v
|
Print version number of aspell library and utility to standard output.
|
|
check file, -c file
|
Spellcheck a single file.
|
|
pipe, -a
|
Run aspell in "ispell -a" compatibility mode.
|
|
list
|
Produce a list of misspelled words from standard input.
|
|
[dump] config
|
Dump all current configuration options to standard output.
|
|
config key
|
Send the current value of key to standard output.
|
|
soundslike
|
Output the soundslike equivalent of each word entered.
|
|
munch
|
Generate possible root words and affixes from an input list of words.
|
|
expand [1-4]
|
Expands the affix flags of each affix compressed word entered.
|
|
clean [strict]
|
Cleans an input word list so that every line is a valid word.
|
|
munch-list [simple] [single|multi] [keep]
|
Reduce the size of a word list via affix compression.
|
|
conv from to [norm-form]
|
Converts from one encoding to another.
|
|
norm (norm-map|fromnorm-map to) [norm-form]
|
Perform Unicode normalization.
|
|
[dump] dicts|filters|modes
|
Lists available dictionaries, filters, or modes.
|
|
dump|create|merge master|personal|replwordlist
|
Dump, create, or merge a master, personal, or replacement word list.
|
Options
The following options may be used to control which dictionaries to use and how they behave:
|
--master=name, -d name
|
Base name of the dictionary to use. If this option is specified then aspell will either use this dictionary or die.
|
|
--dict-dir=directory
|
Location of the main dictionary word list.
|
|
--lang=string, -l string
|
Language to use. It follows the same format of the LANG environmental variable on most systems. It consists of the two letter ISO 639 language code and an optional two letter ISO 3166 country code after a dash or underscore. The default value is based on the value of the LC_MESSAGES locale.
|
|
--size=string
|
The preferred size of the dictionary word list. This consists of a two-character digit code describing the size of the list, with typical values of: 10=tiny, 20=really small, 30=small, 40=somewhat small, 50=med, 60=kinda large, 70=large, 80=huge, 90=enormous.
|
|
--variety=string
|
Any extra information to distinguish this variety of dictionary from other dictionaries which may have the same lang and size.
|
|
--jargon=string
|
Please use the variety option since it replaces jargon as a better choice. The jargon will be removed in the future.
|
|
--word-list-path=list of directories
|
Search path for word list information files.
|
|
--personal=file, -p file
|
File name for the personal word list to use.
|
|
--repl=file
|
Replacements list file name.
|
|
--extra-dicts=list
|
Extra dictionaries to use.
|
|
--ignore-accents
|
(This option is not yet implemented.)
|
The following options control the behavior of aspell when checking documents:
|
--ignore=integer, -W integer
|
Ignore words greater than or equal to integer characters in length.
|
|
--ignore-case, --dont-ignore-case
|
Ignore case when checking words.
|
|
--ignore-repl, --dont-ignore-repl
|
Ignore commands to store replacement pairs.
|
|
--save-repl, --dont-save-repl
|
Save the replacement word list on save all.
|
|
--sug-mode=mode
|
Suggestion mode = ultra|fast|normal|bad-spellers
|
These options modify the behavior of the various filters:
|
--add-filter=list, --rem-filter=list
|
Add or remove a filter.
|
|
--add-filter-path=paths, --rem-filter-path=paths
|
Add or remove paths searched for filters.
|
|
--mode=string, -e, -H, -t, -n
|
Sets the filter mode. Mode is one of none, url, email, html, tex or nroff. The alternative shortcut options are '-e' for email, '-H' for Html/Sgml, '-t' for Tex or '-n' for Nroff.
|
|
--encoding=string
|
The expected encoding of the document. The default depends on the current locale.
|
|
--add-email-quote=list, --rem-email-quote=list
|
Add or Remove a list of email quote characters.
|
|
--email-margin=integer
|
Number of chars that can appear before the quote char.
|
|
--add-html-check=list, --rem-html-check=list
|
Add or remove a list of HTML attributes to always check. For example, look inside "alt=" tags.
|
|
--add-html-skip=list, --rem-html-skip=list
|
Add or remove a list of HTML attributes to always skip while spell checking.
|
|
--add-sgml-check=list, --rem-sgml-check=list
|
Add or remove a list of SGML attributes to always check for spelling.
|
|
--add-sgml-skip=list, --rem-sgml-skip=list
|
Add or remove a list of SGML attributes to always skip while spell checking.
|
|
--sgml-extension=list
|
SGML file extensions.
|
|
--tex-check-comments, --dont-tex-check-comments
|
Check TeX comments (or don't).
|
|
--add-tex-command=list, --rem-tex-command=list
|
Add or Remove a list of TeX commands.
|
The following options may be used to control the behavior of run-together words:
|
--run-together,
--dont-run-together,
-C, -B
|
Consider run-together words valid.
|
|
--run-together-limit=integer
|
Maximum number of words that can be strung together.
|
|
--run-together-min=integer
|
Minimal length of interior words.
|
The following are miscellaneous options that don't fall under any other category:
|
--conf=filename
|
Main configuration file. This file overrides aspell's global defaults.
|
|
--conf-dir=directory
|
Location of main configuration file.
|
|
--data-dir=directory
|
Location of language data files.
|
|
--keyboard=keyboard
|
Use this keyboard layout for suggesting possible words. These spelling errors happen if a user accidently presses a key next to the intended correct key.
|
|
--local-data-dir=directory
|
Alternative location of language data files. This directory is searched before data-dir.
|
|
--home-dir=directory
|
Directory location for personal wordlist files.
|
|
--per-conf=filename
|
Personal configuration file. This file overrides options found in the global config file.
|
The following options are part of the aspell utility and work independently of the library:
|
--backup, --dont-backup, -b, -x
|
The aspell utility creates a backup file by making a copy and appending .bak to file name. This only applies when the command is check file and the backup file is only created if any spelling modifications take place.
|
|
--byte-offsets, --dont-byte-offsets
|
Use byte offsets instead of character offsets.
|
|
--guess, --dont-guess, -m, -P
|
Create missing root/affix combinations not in the dictionary in pipe mode.
|
|
--keymapping=aspell, --keymapping=ispell
|
The keymapping to use, either aspell for the default mapping or ispell to use the same mapping that the Ispell utility uses.
|
|
--reverse, --dont-reverse
|
Reverse the order of the suggestions list in pipe mode.
|
|
--suggest, --dont-suggest
|
Suggest possible replacements in pipe mode. If false, aspell will report the misspelling and make no attempt at suggestions or possible corrections.
|
|
--time, --dont-time
|
Time the load time and suggest a time in pipe mode.
|
If aspell is run without any command line options it displays a brief help screen and quits.
Configuration
aspell can accept options via global or personal configuration files so that you do not need to specify them each time at the command line.
The default global configuration file is /etc/aspell.conf (or another file, specified by option --conf), and is checked first.
The default per-user configuration file ~/.aspell.conf located in the $HOME directory (or another file, specified by option --per-conf) is checked next and overrides options set in the global config file. Options specified at either the command line or via an environmental variable override those specified by either configuration file.
Each line of the configuration file has the format:
option [value]
where option is any one of the standard library options above without the leading dashes. For example, the following line will set the default language to Swiss German:
lang de_CH
There may be any number of spaces between the option and the value, however it can only be spaces, i.e. there is no '=' between the option name and the value. Comments may also be included by preceding them with a '#' as anything from a '#' to a newline is ignored. Blank lines are also allowed. The /etc/aspell.conf file is a good example of how to set these options.