skills/minimax-docx/references/cjk_university_template_guide.md

Chinese University Thesis Template Guide (中国高校论文模板指南)

Why This Guide Exists

Chinese university thesis templates (.docx) have structural patterns that differ significantly from Western templates. Agents that assume Western conventions (Heading1/Heading2/Normal) will fail repeatedly. This guide documents the ACTUAL patterns found in Chinese templates.

Common StyleId Patterns

Pattern A: Numeric IDs (most common in Chinese Word templates)

Style Purpose	styleId	w:name	w:basedOn
Normal body	a	"Normal"	—
Default paragraph font	a0	"Default Paragraph Font"	—
Heading 1 (章标题)	1	"heading 1"	a
Heading 2 (节标题)	2	"heading 2"	a
Heading 3 (小节标题)	3	"heading 3"	a
TOC 1	11	"toc 1"	a
TOC 2	21	"toc 2"	a
TOC 3	31	"toc 3"	a
Header	a3	"header"	a
Footer	a4	"footer"	a
Table of Contents heading	10	"TOC Heading"	1

Pattern B: English IDs (less common, usually from international templates)

Standard Heading1/Heading2/Heading3/Normal — these follow the Western pattern.

Pattern C: Mixed (some Chinese, some English)

Some templates define custom styles with Chinese names:

Style Purpose	styleId	w:name
论文标题	lunwenbiaoti	"论文标题"
章标题	zhangbiaoti	"章标题"
正文	zhengwen	"正文"

How to Identify Which Pattern

# Extract all styleIds from the template
$CLI analyze --input template.docx --styles-only

# Or manually:
# unzip template.docx word/styles.xml
# Search for w:styleId= in the extracted file

Look at the first few styleIds. If you see 1, 2, 3, a, a0 → Pattern A. If you see Heading1, Normal → Pattern B.

Standard Thesis Structure

Chinese university theses follow a highly standardized structure:

┌─────────────────────────────────────┐
│ 封面 (Cover Page)                    │  ← Usually 1-2 pages
│   - 校名、校徽                       │
│   - 论文题目 (title)                  │
│   - 作者、导师、院系、日期             │
├─────────────────────────────────────┤
│ 学术诚信承诺书 / 独创性声明            │  ← 1 page
│   (Academic Integrity Declaration)   │
├─────────────────────────────────────┤
│ 中文摘要 (Chinese Abstract)          │  ← 1-2 pages
│   - "摘 要" heading                  │
│   - Abstract body                    │
│   - "关键词：" line                  │
├─────────────────────────────────────┤
│ 英文摘要 (English Abstract)          │  ← 1-2 pages
│   - "ABSTRACT" heading              │
│   - Abstract body                    │
│   - "Keywords:" line                 │
├─────────────────────────────────────┤
│ 目录 (Table of Contents)             │  ← 1-3 pages
│   - Often inside SDT block           │
│   - Static example entries           │
│   - TOC field code                   │
├─────────────────────────────────────┤
│ 正文 (Body)                          │  ← Main content
│   第1章 绪论                          │
│   1.1 研究背景                        │
│   1.2 研究目的和意义                   │
│   第2章 文献综述                       │
│   ...                                │
│   第N章 结论与展望                     │
├─────────────────────────────────────┤
│ 参考文献 (References)                │  ← Styled differently
├─────────────────────────────────────┤
│ 致谢 (Acknowledgments)              │  ← Optional
├─────────────────────────────────────┤
│ 附录 (Appendices)                    │  ← Optional
└─────────────────────────────────────┘

Identifying Zone Boundaries in Templates

Templates contain EXAMPLE content that must be replaced. Here's how to find the zones:

Zone A (Front matter) — KEEP from template

• Starts at: paragraph 0
• Ends at: the paragraph BEFORE the first chapter heading
• Contains: cover, declaration, abstracts, TOC
• How to detect end: search for first paragraph with style 1 (or Heading1) containing "第1章" or "绪论"

Zone B (Body content) — REPLACE with user content

• Starts at: first chapter heading ("第1章...")
• Ends at: "参考文献" heading (inclusive) or last body paragraph before acknowledgments
• How to detect:

  for i, el in enumerate(body_elements):
      text = get_text(el)
      style = get_style(el)
      if style in ('1', 'Heading1') and ('第1章' in text or '绪论' in text):
          zone_b_start = i
      if '参考文献' in text:
          zone_b_end = i
  

Zone C (Back matter) — KEEP from template (or remove)

• Starts after: 参考文献
• Contains: 致谢, 附录, final sectPr

Font Expectations in Chinese Thesis Templates

Element	Font	Size (字号)	Size (pt)	w:sz
论文标题	华文中宋 or 黑体	二号 or 小二	22pt or 18pt	44 or 36
章标题 (H1)	黑体	三号	16pt	32
节标题 (H2)	黑体	四号	14pt	28
小节标题 (H3)	黑体	小四	12pt	24
正文	宋体	小四	12pt	24
页眉	宋体	五号	10.5pt	21
页脚/页码	宋体	五号	10.5pt	21
表格内容	宋体	五号	10.5pt	21
参考文献条目	宋体	五号	10.5pt	21

RunFonts for CJK Body Text

<w:rFonts w:ascii="Times New Roman" w:hAnsi="Times New Roman"
          w:eastAsia="宋体" w:cs="Times New Roman"/>

For headings:

<w:rFonts w:ascii="Times New Roman" w:hAnsi="Times New Roman"
          w:eastAsia="黑体" w:cs="Times New Roman"/>

IMPORTANT: When cleaning direct formatting, ALWAYS preserve w:eastAsia. Removing it causes Chinese text to fall back to the wrong font.

Common Mistakes with Chinese Templates

1. Searching for Heading1 — Chinese templates use 1, not Heading1
2. Clearing all rFonts — Must keep eastAsia font declarations
3. Assuming "第1章" is the first paragraph — It's typically paragraph 100+ after cover/abstract/TOC
4. Ignoring SDT blocks in TOC — The TOC is wrapped in an SDT, not just field codes
5. Wrong line spacing — Chinese theses typically use fixed 20pt (line="400") or 22pt (line="440"), not the 28pt used in government documents
6. Missing section breaks — Each zone (abstract, TOC, body) usually has its own sectPr for different headers/footers

Style Mapping Quick Reference

When source document uses Western IDs and template uses Chinese numeric IDs:

{
  "Heading1": "1",
  "Heading2": "2",
  "Heading3": "3",
  "Heading4": "3",
  "Normal": "a",
  "BodyText": "a",
  "ListParagraph": "a",
  "Caption": "a",
  "TOC1": "11",
  "TOC2": "21",
  "TOC3": "31"
}

When source uses Chinese numeric IDs and template uses Western IDs — reverse the mapping.