28 lines
1.5 KiB
Markdown
28 lines
1.5 KiB
Markdown
# docs 索引
|
|
|
|
论文本身已完整给出四问的模型、推导与结果分析，因此本目录不再保留算法说明文档，
|
|
只留下复现所需的说明与材料。
|
|
|
|
| 入口 | 内容 |
|
|
| --- | --- |
|
|
| [`../README.md`](../README.md) | **总入口**：环境、运行程序、复现论文数据与插图、编译论文 |
|
|
| [`paper/README.md`](paper/README.md) | 论文工程说明：数据分工、重算与编译步骤、VS Code 配方 |
|
|
| [`paper/REWRITE_NOTES.md`](paper/REWRITE_NOTES.md) | 论文各轮修订与验证记录（含演练数据重采与问题修复） |
|
|
| [`paper/main.tex`](paper/main.tex) | 论文 LaTeX 源文件（正文与附录） |
|
|
| [`paper/data/`](paper/data) | 论文引用的全部数据、宏与整表（由脚本生成） |
|
|
| [`figures/README.md`](figures/README.md) | 论文插图清单：每张图的数据来源与生成命令 |
|
|
| [`figures/manifest.json`](figures/manifest.json) | 插图来源清单（可机读） |
|
|
|
|
## 复现顺序
|
|
|
|
```bash
|
|
python scripts/build_practice_data.py # 演练局复算 → 宏与表格
|
|
python scripts/audit_paper_formal.py --snapshot docs/paper/data/formal-results.json
|
|
python scripts/build_paper_support.py # 附录正式数据表（--package 另出支撑包）
|
|
uv run python scripts/plot_paper_figures.py
|
|
cd docs/paper && latexmk -xelatex -interaction=nonstopmode -halt-on-error -outdir=build main.tex
|
|
```
|
|
|
|
> `docs/paper/data/*.tex` 由脚本生成，一律使用 LF 换行：CRLF 会让 `\input` 进表格的行
|
|
> 在 TeX 缓冲中提前 `\par` 化，触发 booktabs 的 “Misplaced \noalign”。
|