typography-audit

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Typography Audit

排版审计

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

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
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. 除非要求全面检查,否则仅审计有变更的文件。
  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

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
    : Straight quotes used in heading text.
    • Fix: Replace
      "
      with
      &ldquo;
      /
      &rdquo;
      entities.

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`.
  • ✓ pass

- 按文件分组展示问题。
- 若有行号,使用`file:line`格式标注。
- 说明问题并提出明确修复方案。
- 无问题的文件标记为`✓ pass`。