第 7 章：MkDocs 格式规范检查清单¶

#!/usr/bin/env python3
"""检查 MkDocs 教程中粗体标记与 CJK 汉字的间距问题。

用法：
  python check_bold.py          # 检查 docs/ 目录
  python check_bold.py --fix    # 自动修复
"""

import re
import os
import sys

CJK = r'[一-鿿㐀-䶿豈-﫿]'
CJK_RE = re.compile(CJK)

def is_cjk(ch):
    return bool(CJK_RE.match(ch))

def fix_line(line):
    """修复一行中的粗体间距问题（状态机方式）。"""
    result = []
    i = 0
    in_bold = False
    n = len(line)
    while i < n:
        if i + 1 < n and line[i] == '*' and line[i + 1] == '*':
            if not in_bold:
                if i > 0 and is_cjk(line[i - 1]):
                    result.append(' ')
                result.append('**')
                in_bold = True
            else:
                result.append('**')
                if i + 2 < n and is_cjk(line[i + 2]):
                    result.append(' ')
                in_bold = False
            i += 2
        else:
            result.append(line[i])
            i += 1
    return ''.join(result)

def check_file(filepath):
    """返回文件中的问题行列表。"""
    with open(filepath, 'r', encoding='utf-8') as f:
        lines = f.read().split('\n')
    issues = []
    in_code = False
    for lineno, line in enumerate(lines, 1):
        stripped = line.strip()
        if stripped.startswith('```') or stripped.startswith('~~~'):
            in_code = not in_code
            continue
        if in_code:
            continue
        fixed = fix_line(line)
        if fixed != line:
            issues.append(lineno)
    return issues

def main():
    root = 'docs'
    fix_mode = '--fix' in sys.argv
    total = 0

    for dirpath, _, filenames in os.walk(root):
        for f in sorted(filenames):
            if not f.endswith('.md'):
                continue
            filepath = os.path.join(dirpath, f)
            issues = check_file(filepath)
            if issues:
                total += len(issues)
                print(f"  {len(issues):>3} issues: {filepath}")
                if fix_mode:
                    # Apply fix
                    with open(filepath, 'r', encoding='utf-8') as fp:
                        content = fp.read()
                    lines = content.split('\n')
                    in_code = False
                    new_lines = []
                    for line in lines:
                        s = line.strip()
                        if s.startswith('```') or s.startswith('~~~'):
                            in_code = not in_code
                            new_lines.append(line)
                            continue
                        if in_code:
                            new_lines.append(line)
                            continue
                        new_lines.append(fix_line(line))
                    with open(filepath, 'w', encoding='utf-8') as fp:
                        fp.write('\n'.join(new_lines))

    print(f"\nTotal: {total} issues found")
    if not fix_mode:
        print("Run with --fix to auto-fix all issues.")

if __name__ == '__main__':
    main()