docx

# 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)，...