Skip to content

Format Module Reference

Purpose: Check thesis page layout, heading format, figure/table/equation numbering, and displayed formula layout against GB/T 7713.1 and university template rules.

Chapter Heading & Figure/Table Numbering

这些是校级排版约定(各校自定,非国标强制):常见设定见 ../../templates/generic.md 的"常见校级排版约定"一节; 已知模板时改读 templates/thuthesis.md(图 3-1 连字符风格)或 templates/pkuthss.md(图3.1 点号风格),模板会自动处理格式。

Displayed Formula Layout

公式排版问题(如“公式编号被挤到下一行”“这个长公式是否应该拆成两行”“相邻公式要不要同步拆行”) 属于 format 路由。先读 ../formatting/formula-guide.md,再按学校模板判断。

核心判断:

  • 公式超出版心、贴近页边距、或把编号挤到下一行时,建议受控拆行。
  • 推导链按 = / \approx / \le / \Rightarrow 等关系符号对齐。
  • 方程组、分段条件、成组约束用 aligned / cases 等结构。
  • 已经能正常放下、编号未被挤行、且没有推导/成组语义的公式,不要为视觉统一强行拆分。

Source Hygiene (源码卫生:F-MD / F-NOTE)

check_format.py 默认输出内置两项源码卫生检查(无需额外 flag),仅定位提示、不改写:

CheckRuleSeverity
F-MD可见正文命中 Markdown 加粗 **…**\*\* 转义星号不计)——LaTeX 中按字面星号排版,应改 \textbf{}Major/P1
F-NOTE可见正文命中草稿备注词表(CORE:"此处占位/待补充/待确认/TODO/FIXME")或未定稿对冲词表(HEDGE:"待验证/暂以占位/仍在进行/重跑/复算/不代表…性能")——疑似草稿残留,定稿前应删除或补全Info/P3
F-PLACEHOLDER表体行数据格全为空占位且含 ≥2 个显式占位记号(& --- & --- &)——占位符表格行未填真实数据(单个 -/混真实数据的 N/A 行不报)Major/P1

三项均只扫可见正文(数学环境/verbatim/注释排除);F-NOTE 词表刻意收窄,"仍需实验确认" 一类正常学术让步表述不命中,"复算"带负向断言只命中裸用法。中文图名路径 (\includegraphics{中文名.png})经 strip_path_args 排除,不触发中英标点混用误报。

Key Checks

  • Page margins and layout per university template
  • Heading numbering consistency (chapter-based or sequential)
  • Caption placement (figures below, tables above)
  • Equation numbers right-aligned without being displaced to a separate line
  • Displayed formulas split only when width, alignment, derivation, grouping, or readability requires it
  • Font and size compliance per heading level — 以本校最新格式规范为准

基于 MIT 许可发布