josh/doa_doppler_est
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

meta: CLAUDE.md 编译规则补 -synctex=1

Browse Source 
验证编译统一改为 xelatex -synctex=1，并新增一条：裸 xelatex 会覆盖 PDF
却不更新 .synctex.gz，破坏 VS Code 源码↔PDF 双向索引；若已用裸命令编过，
补跑一次 xelatex -synctex=1 重建即可。
This commit is contained in:
josh
2026-06-17 13:47:20 +08:00
parent f143a5ddad
commit b1517bc752
1 changed files with 2 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+2 -1
View File
@@ -28,7 +28,8 @@ LaTeX 学习笔记：相控阵 DoA + Doppler 估计与 CRB 推导。作者 Josh
# LaTeX 操作约束
- **默认不编译**。阶段性收尾或涉及交叉引用/宏定义的改动后用 `xelatex` 验证：至少跑两次让 ref 稳定，有 bib 引用时夹一次 `biber`；检查 log 里的 `! `、`undefined references`、`label(s) may have changed`，全部消除后再 commit。
- **默认不编译**。阶段性收尾或涉及交叉引用/宏定义的改动后用 `xelatex -synctex=1` 验证：至少跑两次让 ref 稳定，有 bib 引用时夹一次 `biber`；检查 log 里的 `! `、`undefined references`、`label(s) may have changed`，全部消除后再 commit。
- **编译一律带 `-synctex=1`**：裸 `xelatex` 会覆盖 PDF 却不更新 `.synctex.gz`，使 VS Code 源码↔PDF 双向索引（SyncTeX）失效。若已用裸命令编过，补跑一次 `xelatex -synctex=1` 重建 synctex 即可。
- **编译产物在 .gitignore，不主动 add，也不主动 rm**：用户在本地可能反复使用。
- **不读编译产物**：`*.aux`、`*.log`、`*.bbl`、`*.bcf`、`*.synctex.gz`、`*.run.xml`、`*.toc`、`*.ist`、`*.glo`、`*.acn`、根目录历史 PDF（`doa_doppler_est_*.pdf`）、`*.zip`。
- **preamble 指主文件 `\documentclass` 到 `\begin{document}` 之间的宏包/计数器/glossary 等设置**。新增或修复 `\newacronym` 词条不算改 preamble，按 `fix(preamble)` 处理。`\input` 列表可按重构需要调整。