DOCX工具

Files (66)

• LICENSE.txt
• SKILL.md
• __init__.py · scripts/
• accept_changes.py · scripts/
• check_env.py · scripts/
• comment.py · scripts/
• equations.py · scripts/
• inspect_template_format.py · scripts/
• __init__.py · scripts/office/helpers/
• merge_runs.py · scripts/office/helpers/
• simplify_redlines.py · scripts/office/helpers/
• pack.py · scripts/office/
• dml-chart.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• dml-chartDrawing.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• dml-diagram.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• dml-lockedCanvas.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• dml-main.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• dml-picture.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• dml-spreadsheetDrawing.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• dml-wordprocessingDrawing.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• pml.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• shared-additionalCharacteristics.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• shared-bibliography.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• shared-commonSimpleTypes.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• shared-customXmlDataProperties.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• shared-customXmlSchemaProperties.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• shared-documentPropertiesCustom.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• shared-documentPropertiesExtended.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• shared-documentPropertiesVariantTypes.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• shared-math.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• shared-relationshipReference.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• sml.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• vml-main.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• vml-officeDrawing.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• vml-presentationDrawing.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• vml-spreadsheetDrawing.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• vml-wordprocessingDrawing.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• wml.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• xml.xsd · scripts/office/schemas/ISO-IEC29500-4_2016/
• opc-contentTypes.xsd · scripts/office/schemas/ecma/fouth-edition/
• opc-coreProperties.xsd · scripts/office/schemas/ecma/fouth-edition/
• opc-digSig.xsd · scripts/office/schemas/ecma/fouth-edition/
• opc-relationships.xsd · scripts/office/schemas/ecma/fouth-edition/
• mc.xsd · scripts/office/schemas/mce/
• wml-2010.xsd · scripts/office/schemas/microsoft/
• wml-2012.xsd · scripts/office/schemas/microsoft/
• wml-2018.xsd · scripts/office/schemas/microsoft/
• wml-cex-2018.xsd · scripts/office/schemas/microsoft/
• wml-cid-2016.xsd · scripts/office/schemas/microsoft/
• wml-sdtdatahash-2020.xsd · scripts/office/schemas/microsoft/
• wml-symex-2015.xsd · scripts/office/schemas/microsoft/
• soffice.py · scripts/office/
• unpack.py · scripts/office/
• validate.py · scripts/office/
• __init__.py · scripts/office/validators/
• base.py · scripts/office/validators/
• docx.py · scripts/office/validators/
• pptx.py · scripts/office/validators/
• redlining.py · scripts/office/validators/
• paper_format.py · scripts/
• …and 6 more

SKILL.md (first lines)

# DOCX 工具

## 路径与写入

- 当前目录为本工具根目录，只读。
- 模板和脚本从本目录读取。
- 生成或修改后的 DOCX 必须写入用户 `PROJECT_ROOT`。
- 默认不覆盖输入文件或 Skill 文件。

## 数学建模论文推荐流程

采用“当届官方参考模板 + `python-docx` 构建 + OMML 公式 + OOXML 校验 + 渲染抽检”。官方模板控制页面、样式、分节、页眉页脚和编号；代码负责稳定写入内容。

```python
from pathlib import Path
import sys

scripts = Path("<SKILL_ROOT>") / "tools" / "docx" / "scripts"
sys.path.insert(0, str(scripts))
import paper_format as pf

doc = pf.new_document(
    contest="cumcm",
    template_path=Path("<PROJECT_ROOT>") / "当届官方模板.docx",
    preserve_template_content=False,
)
# 此示例只借用模板样式后追加正文。
# 若官方模板包含固定摘要页或编号页，应改为 True 并在原位置填充。
pf.title(doc, "论文题目")
pf.abstract_title(doc)
pf.body(doc, "摘要正文。")
pf.keywords(doc, "优化；预测")
pf.equation(doc, r"\min f(x)=\sum_{i=1}^{n}x_i^2")
pf.three_line_table(doc, [["符号", "说明"], ["x", "决策变量"]])
pf.save_document(doc, Path("<PROJECT_ROOT>"), contest="cumcm")
```

## 公式

### 直接写入

`scripts/equations.py` 把常用 LaTeX 子集转成 Word 原生 OMML。未知命令、未闭合分组和不支持环境会报错，不会静默生成错误文本。

```powershell
python scripts/equations.py replace "输入.docx" `
  --replace "EQ_OBJECTIVE" "\min f(x)=\sum_{i=1}^{n}x_i^2" `
  --output "<PROJECT_ROOT>/输出.docx"
```

同一占位符出现多次时会全部替换。支持分式、上下标、根式、n 次根、常用希腊字母与关系符号、反三角函数和常见矩阵，包括 `\nu`、`\mu`、`\approx`、`\arcsin`、`\arccos`、`\arctan`。

### 复杂公式

复杂 LaTeX 优先使用 Pandoc 的成熟转换：

```powershell
python scripts/equations.py generate "论文.md" `
  --output "<PROJECT_ROOT>/论文.docx" `
  --template "官方模板.docx"
```

转换后仍须校验和渲染抽检。

## 完整 LaTeX 论文转 DOCX

此功能需要预先安装 [Pandoc](https://pandoc.org/installing.html)，并保证 `pandoc` 命令可用；可先运行 `python scripts/check_env.py` 检查。工具将 `.tex` 主入口转换为 DOCX，从 LaTeX 项目目录读取相对图片，使用 citeproc 处理 BibTeX 引用，并把公式写为可编辑 OMML。传入当届官方 DOCX 作为参考模板，以继承 Word 样式和页面设置：

```powershell
python scripts/equations.py convert-latex `
  "<PROJECT_ROOT>/完整论文-LaTeX/main.tex" `
  --output "<PROJECT_ROOT>/完整论文.docx" `
  --template "<PROJECT_ROOT>/当届官方模板.docx" `
  --timeout 120
```

工具会在转换前递归展开项目内的 `\input` 与 `\include`，但保留注释和字面量环境中的原文，拒绝越界路径和循环包含；转换成功后生成同名 `.conversion.json`，记录全部输入文件、输入/输出/模板哈希、Pandoc 路径与版本、命令、耗时和警告。DOCX 与清单成对替换，失败时恢复旧版本。默认拒绝覆盖已有输出；确认替换旧版本时才使用 `--overwrite`。

Pandoc 向标准错误输出的任何警告都会默认阻断发布，失败时不会留下 DOCX。只有逐项检查后，才能用精确正则和具体理由覆盖：

```powershell
python scripts/equations.py convert-latex `
  "<PROJECT_ROOT>/完整论文-LaTeX/main.tex" `
  --output "<PROJECT_ROOT>/完整论文.docx" `
  --template "<PROJECT_ROOT>/当届官方模板.docx" `
  --allow-warning "<已核对的精确警告正则>" `
  --override-reason "<不影响交付的证据>"
```

自定义宏、LaTeX 专用环境、浮动体位置、交叉引用和参考文献样式可能需要在 Word 中修正。未提供 CSL 时 citeproc 使用 Pandoc 默认引文样式，因此竞赛要求特定引文格式时仍须在 Word 中核对。转换完成后必须执行 DOCX 结构校验、清单核对和渲染抽检，不能把“成功生成文件”等同于版式合格。

转换后以及交付前都要重新验证清单；源码、任一子文件、图片、BibTeX、参考模板、DOCX 或清单发生变化后必须重新转换：

```powershell
python scripts/equations.py verify-conversion `
  "<PROJECT_ROOT>/完整论文.docx"
```

## 解包、校验与重打包

DOCX/XLSX 共用的 OOXML 基础工具只保留在 `scripts/office/`：

```powershell
python scripts/office/unpack.py "输入.docx" "<PROJECT_ROOT>/unpacked"
python scripts/office/validate.py "<PROJECT_ROOT>/输出.docx"
python scripts/office/pack.py "<PROJECT_ROOT>/unpacked" "<PROJECT_ROOT>/输出.docx" --original "输入.docx"
```

不要在不理解 OOXML 关系和内容类型的情况下直接修改压缩包。

## 修订

```powershell
python scripts/accept_changes.py "输入.docx" "<PROJECT_ROOT>/已接受修订.docx"
```

工具使用隔离的 LibreOffice 配置。超时、非零退出或残留修订标记都会失败，失败时不发布输出文件。

## 批注

From rootkiller6788/mathmodel-skill, MIT.

More from rootkiller6788/mathmodel-skill