legal-toa-formatter

Legal TOA Formatter

Overview

规范化法律文书中 Table of Authorities (TOA) 的条目格式。核心功能：将所有TOA条目统一修改为与参考条目相同的点号填充（dot leader）对齐格式，确保引用名称与页码之间的视觉一致性。

When to Use

• 用户要求修改 TOA/Table of Authorities 条目格式
• 条目需要点号填充对齐（dot leader alignment）
• 需要统一多个 TOA 条目的样式
• 触发词：TOA、Table of Authorities、法律文书格式修改、点号对齐

Core Concept

关键理解：Word 的制表符对齐使用 w:leader="dot" 属性，让 Word 自动填充点号，不是在文本中手动添加点号字符。

Workflow

Step 1: 分析源文档

1. 解包 docx 文件：

   unzip -o input.docx -d temp_unpacked
   

2. 找到 TOA 所在 section（通常在 word/document.xml 的 TOX（Table of Start） 字段中）

3. 定位 TOA 条目：搜索 <w:p> 段落中包含制表符 <w:tab/> 的条目

Step 2: 分析参考格式

找到第一个正确格式的条目（通常是 TOA 标题后的第一条），分析其 XML 结构：

<w:p>
  <w:pPr>
    <w:widowControl w:val="0"/>
    <w:tabs>
      <w:tab w:val="right" w:leader="dot" w:pos="9016"/>
    </w:tabs>
    <w:spacing w:line="480" w:lineRule="auto"/>
    <w:jc w:val="both"/>
    <w:rPr>
      <w:rFonts w:hint="default" w:ascii="Times New Roman Regular" .../>
      <w:kern w:val="2"/>
      <w:sz w:val="24"/>
      <w:szCs w:val="24"/>
      <w:lang w:val="en-US" w:eastAsia="zh-CN" w:bidi="ar-SA"/>
    </w:rPr>
  </w:pPr>
  <w:r>
    <w:t>, 486 U.S. 531 (1988)</w:t>
  </w:r>
  <w:r>
    <w:tab/>
  </w:r>
  <w:r>
    <w:t>4, 5, 6, 7</w:t>
  </w:r>
</w:p>

关键元素：

• <w:tabs><w:tab w:val="right" w:leader="dot" w:pos="9016"/></w:tabs> - 定义右对齐点号填充制表位
• <w:tab/> - 在文本中插入制表符位置
• 制表位位置 pos="9016" 是 twips 单位（1/20 点）

Step 3: 修改目标条目

对于每个需要修改的条目：

1. 确保 <w:pPr> 包含正确的 <w:tabs> 定义

2. 如果条目有 <w:tabs> 但 leader 不是 "dot"，修改为 w:leader="dot"

3. 如果条目完全没有 <w:tabs>，在 <w:pPr> 中的适当位置添加：

   <w:tabs>
     <w:tab w:val="right" w:leader="dot" w:pos="9016"/>
   </w:tabs>
   

4. 在引用名称与页码之间插入 <w:tab/> 元素

Step 4: 重新打包

cd temp_unpacked && zip -r ../output.docx . -x "*.DS_Store"

Quick Fix Script

对于批量处理，使用 scripts/fix_toa_format.py：

python3 scripts/fix_toa_format.py input.docx output.docx

脚本会自动：

1. 解包 docx
2. 定位 TOA 条目
3. 应用一致的点号填充格式
4. 重新打包