audit-typography

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Audit Typography

排版审核

89 rules across 10 categories for web typography quality. Focuses on concrete issues with concrete fixes.
涵盖10个类别的89条Web排版质量规则,聚焦具体问题并提供明确修复方案。

Audit Workflow

审核流程

Copy and track this checklist during the audit:
text
Audit progress:
- [ ] Step 1: Scope changed surfaces and select relevant categories
- [ ] Step 2: Run CRITICAL checks (punctuation, font setup)
- [ ] Step 3: Run HIGH checks (sizing, spacing)
- [ ] Step 4: Run MEDIUM+ checks for remaining categories in scope
- [ ] Step 5: Report findings with file:line and concrete fixes
  1. Audit only changed files unless a full sweep is requested.
  2. Scan CSS for font-family, @font-face, font-feature-settings, and sizing/spacing properties to identify relevant categories.
  3. Load rule files progressively by category prefix — read only what applies.
  4. Prioritize CRITICAL and HIGH findings before medium-priority polish.
  5. After fixes, rerun the relevant rules before finalizing.
审核期间可复制并跟踪以下检查清单:
text
审核进度:
- [ ] 步骤1:确定变更范围并选择相关类别
- [ ] 步骤2:执行CRITICAL(关键)检查(标点、字体设置)
- [ ] 步骤3:执行HIGH(高优先级)检查(尺寸、间距)
- [ ] 步骤4:对范围内剩余类别执行MEDIUM+(中高优先级)检查
- [ ] 步骤5:结合文件:行号及明确修复方案提交审核结果
  1. 除非要求全面检查,否则仅审核变更文件。
  2. 扫描CSS中的font-family、@font-face、font-feature-settings及尺寸/间距属性,确定相关类别。
  3. 按类别前缀逐步加载规则文件——仅阅读适用内容。
  4. 在处理中优先级的优化项之前,优先解决CRITICAL和HIGH优先级的问题。
  5. 修复完成后,在最终确认前重新运行相关规则。

Rule Categories by Priority

按优先级划分的规则类别

PriorityCategoryImpactPrefixRules
1Punctuation & Special CharactersCRITICAL
punct-
12
2Font Selection & WeightsCRITICAL
font-
10
3Sizing & MeasureHIGH
size-
7
4Spacing & RhythmHIGH
spacing-
10
5OpenType FeaturesMEDIUM-HIGH
opentype-
8
6Hierarchy & ScaleMEDIUM-HIGH
hierarchy-
8
7Alignment & LayoutMEDIUM
layout-
8
8Typeface PairingMEDIUM
pairing-
10
9Brand & IdentityLOW-MEDIUM
brand-
8
10Display & HeadlinesLOW-MEDIUM
display-
8
优先级类别影响程度前缀规则数量
1标点与特殊字符CRITICAL(关键)
punct-
12
2字体选择与字重CRITICAL(关键)
font-
10
3尺寸与行长HIGH(高优先级)
size-
7
4间距与韵律HIGH(高优先级)
spacing-
10
5OpenType特性MEDIUM-HIGH(中高优先级)
opentype-
8
6层级与比例MEDIUM-HIGH(中高优先级)
hierarchy-
8
7对齐与布局MEDIUM(中优先级)
layout-
8
8字体配对MEDIUM(中优先级)
pairing-
10
9品牌与标识LOW-MEDIUM(中低优先级)
brand-
8
10展示字体与标题LOW-MEDIUM(中低优先级)
display-
8

Quick Reference

快速参考

Read only what is needed for the current audit scope:
  • Category map and impact rationale:
    rules/_sections.md
  • Rule-level guidance and examples:
    rules/<prefix>-*.md
Example rule files:
rules/punct-smart-quotes.md
rules/font-true-styles.md
rules/size-line-height.md
Each rule file contains:
  • Why the rule matters
  • Incorrect example
  • Correct example
仅阅读当前审核范围内所需内容:
  • 类别映射及影响说明:
    rules/_sections.md
  • 规则级指南及示例:
    rules/<prefix>-*.md
示例规则文件:
rules/punct-smart-quotes.md
rules/font-true-styles.md
rules/size-line-height.md
每个规则文件包含:
  • 规则重要性说明
  • 错误示例
  • 正确示例

Review Output Contract

审核输出规范

Report findings in this format:
markdown
undefined
按以下格式提交审核结果:
markdown
undefined

Typography Audit Findings

排版审核结果

path/to/file.css

path/to/file.css

  • [CRITICAL]
    punct-smart-quotes
    : Straight quotes used in heading text.
    • Fix: Replace
      "
      with
      &ldquo;
      /
      &rdquo;
      entities.
  • [CRITICAL]
    punct-smart-quotes
    : 标题文本中使用了直引号。
    • 修复方案:将
      "
      替换为
      &ldquo;
      /
      &rdquo;
      实体。

path/to/clean-file.css

path/to/clean-file.css

  • ✓ pass

- Group findings by file.
- Use `file:line` when line numbers are available.
- State issue and propose a concrete fix.
- Include clean files as `✓ pass`.
  • ✓ 审核通过

- 按文件分组展示问题。
- 若有行号,需标注`file:line`。
- 说明问题并提供明确的修复方案。
- 审核通过的文件标注为`✓ 审核通过`。