# 交互式检查文件
aspell check document.txt

# 使用英语（美式）检查
aspell check --lang=en_US document.txt

# 使用德语检查
aspell check --lang=de document.txt

# 使用英式英语检查
aspell check --lang=en_GB document.txt

# 检查 HTML 文件（忽略标签）
aspell check --mode=html page.html

# 检查 TeX/LaTeX 文件
aspell check --mode=tex paper.tex

# 检查 Markdown 文件
aspell check --mode=markdown README.md

# 检查 Email 文件
aspell check --mode=email message.eml

# 检查 Nroff/Troff 文件
aspell check --mode=nroff manpage.1

# 不创建备份文件
aspell check --dont-backup document.txt

# 指定备份文件后缀
aspell check --suffix=.bak document.txt

# 使用大小写敏感模式
aspell check --ignore-case=false document.txt

# 忽略大小写（默认）
aspell check --ignore-case document.txt

# 忽略重音符号
aspell check --ignore-accents document.txt

# 指定个人词典
aspell check --personal=my-dict.pws document.txt

# 指定额外词典
aspell check --extra-dicts=technical.pws document.txt

# 管道模式的基本交互
echo "teh" | aspell -a

# 检查多个单词
cat << 'EOF' | aspell -a
hello world
teh quik brown fox
EOF

# 输出:
# *
# *
# & teh 3 0: the, tea, tee
# & quik 5 0: quick, quirk, quit, quiz, quilt
# *

# 使用英式英语
echo "colour" | aspell -a -d en_GB

# 使用德语
echo "Hallo" | aspell -a -d de

# 指定建议模式
echo "teh" | aspell -a --sug-mode=ultra

# 指定编码
echo "café" | aspell -a --encoding=utf-8

# 指定过滤器
echo "<b>teh</b>" | aspell -a --mode=html

#!/bin/bash
# spell_check.sh — 从管道输出中提取拼写错误

WORDS="teh quik colour programing"
ERRORS=0

while IFS= read -r line; do
    case "$line" in
        \*) ;; # 正确单词，跳过
        \&*|\#*|\!*)
            WORD=$(echo "$line" | cut -d' ' -f2)
            echo "拼写错误: $WORD"
            if [[ "$line" == &* ]]; then
                SUGGESTIONS=$(echo "$line" | cut -d':' -f2)
                echo "  建议: $SUGGESTIONS"
            fi
            ((ERRORS++))
            ;;
    esac
done <<< "$(echo "$WORDS" | aspell -a)"

echo ""
echo "共发现 $ERRORS 个拼写错误"

./spell_check.sh
# 输出:
# 拼写错误: teh
#   建议: the, tea, tee
# 拼写错误: quik
#   建议: quick, quirk, quit, quiz, quilt
# 拼写错误: colour
#   建议: color, colours, coloured
# 拼写错误: programing
#   建议: programming, program ring, program-ring, program
#
# 共发现 4 个拼写错误

# 列出文件中所有拼写错误的单词
aspell list < document.txt

# 等价写法
cat document.txt | aspell list

# 从命令行参数（注意：不支持直接传文件名给 list）
aspell list < /path/to/file

# 使用特定语言
aspell list < document.txt -d en_US

# 使用特定过滤器
aspell list --mode=html < page.html

# 忽略大小写敏感
aspell list --ignore-case < document.txt

# 指定个人词典
aspell list --personal=my-dict.pws < document.txt

# 忽略特定长度的单词（如只报告长度 > 3 的单词）
aspell list --ignore=3 < document.txt

# 不使用任何词典（只返回所有单词）
aspell list --dont-use-other-dicts < document.txt

# 检查所有 Markdown 文件
find . -name "*.md" -exec aspell list --mode=markdown {} \;

# 只列出唯一的拼写错误单词
find . -name "*.md" -exec aspell list --mode=markdown {} \; | sort -u

# 按出现次数排序
find . -name "*.md" -exec aspell list --mode=markdown {} \; | sort | uniq -c | sort -rn

# 找出 doc1.txt 中有但 doc2.txt 中没有的拼写错误
comm -23 \
    <(aspell list < doc1.txt | sort -u) \
    <(aspell list < doc2.txt | sort -u)

# 使用美式英语 + 自定义词典
aspell check -d en_US --personal=project.pws document.txt

# 使用多个额外词典
aspell check --extra-dicts=tech.pws --extra-dicts=names.pws document.txt

# 使用 ultra 模式（最快）
echo "teh" | aspell -a --sug-mode=ultra

# 使用 bad-spellers 模式（最多建议）
echo "teh" | aspell -a --sug-mode=bad-spellers

# -H / --dont-suggest 不显示问候行
echo "teh" | aspell -a -H
# 直接输出: & teh 3 0: the, tea, tee

# -S / --dont-suggest-replacements 不显示建议
echo "teh" | aspell -a -S
# 输出: # teh 0

# 结合 grep 只提取错误行
echo "hello teh world" | aspell -a | grep -v '^\*$' | grep -v '^@'
# 输出: & teh 3 0: the, tea, tee

# 保存检查结果
echo "hello teh world" | aspell -a > check_result.txt

# 只保存错误单词
aspell list < document.txt > misspelled.txt

#!/bin/bash
# check_commit_msg.sh — 检查最新 commit message 拼写

MSG=$(git log -1 --pretty=format:"%s")
ERRORS=$(echo "$MSG" | aspell list -d en_US)

if [ -n "$ERRORS" ]; then
    echo "拼写错误 in commit message:"
    echo "$ERRORS"
    exit 1
else
    echo "拼写检查通过"
    exit 0
fi

#!/bin/bash
# check_readme.sh — 检查项目 README 拼写

FILE="README.md"
if [ ! -f "$FILE" ]; then
    echo "未找到 $FILE"
    exit 1
fi

echo "检查 $FILE ..."
ERRORS=$(aspell list --mode=markdown --personal=./.project-dict.pws < "$FILE" | sort -u)

if [ -n "$ERRORS" ]; then
    echo "发现以下拼写错误:"
    echo "$ERRORS"
    echo ""
    echo "提示：将正确的专有名词加入 .project-dict.pws"
    exit 1
else
    echo "拼写检查通过"
    exit 0
fi

#!/bin/bash
# spell_with_lines.sh — 输出错误单词及其所在行号

FILE="$1"
if [ -z "$FILE" ]; then
    echo "用法: $0 <file>"
    exit 1
fi

# 获取所有拼写错误的单词（去重）
MISSPELLED=$(aspell list < "$FILE" | sort -u)

if [ -z "$MISSPELLED" ]; then
    echo "拼写检查通过: $FILE"
    exit 0
fi

echo "拼写错误: $FILE"
echo "=========="

while IFS= read -r word; do
    # 使用 grep -n 找到行号
    LINE_NUMS=$(grep -n -i -w "$word" "$FILE" | cut -d: -f1 | tr '\n' ',' | sed 's/,$//')
    echo "  \"$word\" (第 $LINE_NUMS 行)"
done <<< "$MISSPELLED"

./spell_with_lines.sh document.txt
# 输出:
# 拼写错误: document.txt
# ==========
#   "teh" (第 3,15 行)
#   "programing" (第 8 行)
#   "recieve" (第 22 行)

# 只检查 .md 文件中非代码块的内容
# （简单实现：排除以 ``` 开头的行之间的内容）
cat README.md | \
    awk 'BEGIN{in_code=0} /^```/{in_code=!in_code; next} !in_code{print}' | \
    aspell list --mode=markdown

# 检查 Markdown 文件中的标题
grep '^#' README.md | sed 's/^#* //' | aspell list

# 默认使用系统 locale 编码
locale charmap

# 明确指定 UTF-8
echo "café résumé" | aspell -a --encoding=utf-8

# 检查 Latin-1 编码文件
iconv -f latin1 -t utf-8 old_file.txt | aspell -a --encoding=utf-8

#!/bin/bash
# spell_check_encoding.sh — 自动检测编码并检查拼写

FILE="$1"
if [ ! -f "$FILE" ]; then
    echo "文件不存在: $FILE"
    exit 1
fi

# 检测文件编码
ENCODING=$(file -bi "$FILE" | sed 's/.*charset=//')
echo "检测到编码: $ENCODING"

# 转换为 UTF-8 后检查
if [ "$ENCODING" != "utf-8" ] && [ "$ENCODING" != "us-ascii" ]; then
    echo "转换编码: $ENCODING -> utf-8"
    iconv -f "$ENCODING" -t utf-8 "$FILE" | aspell list --encoding=utf-8
else
    aspell list < "$FILE"
fi

# 在 ~/.bashrc 或 ~/.zshrc 中添加
alias spellcheck='aspell check --mode=markdown --personal=~/.aspell.pws'
alias spellme='aspell list --mode=markdown'

# 使用
spellcheck article.md
spellme < README.md

# 快速检查函数（添加到 ~/.bashrc）
function spell() {
    if [ -z "$1" ]; then
        echo "用法: spell <file>"
        return 1
    fi

    local errors
    errors=$(aspell list --mode=markdown < "$1" | sort -u)

    if [ -z "$errors" ]; then
        echo "✓ 拼写检查通过: $1"
    else
        echo "✗ 拼写错误 ($1):"
        echo "$errors" | sed 's/^/  /'
        return 1
    fi
}

# 使用
spell README.md
# 输出: ✓ 拼写检查通过: README.md

# ~/.bash_completion.d/aspell
_aspell_modes() {
    local modes="email html markdown nroff tex texinfo url none"
    COMPREPLY=($(compgen -W "$modes" -- "${COMP_WORDS[COMP_CWORD]}"))
}

complete -F _aspell_modes aspell