Skip to content

Fix vscode setting for Latex-Workshop magic comments#1049

Merged
zepinglee merged 6 commits intotuna:masterfrom
atomiechen:master
Mar 5, 2026
Merged

Fix vscode setting for Latex-Workshop magic comments#1049
zepinglee merged 6 commits intotuna:masterfrom
atomiechen:master

Conversation

@atomiechen
Copy link
Contributor

Latex-Workshop 从 10.13.0 开始,默认使用 magic comments 而非 recipe 设置。当前默认的配置在vscode下编译会使用xelatex,而非完整编译链,导致PDF结果中引用全变?。

解决方案:显式设置 enableMagicCommentsfalse

参考链接:James-Yu/LaTeX-Workshop#4813

Starting from Latex-Workshop 10.13.0, magic comments are prioritized over recipe settings. Default settings will break.

See James-Yu/LaTeX-Workshop#4813
@Harry-Chen
Copy link
Member

可以考虑全局修改 magic comments 来使其调用 latexmk

@atomiechen
Copy link
Contributor Author

可以考虑全局修改 magic comments 来使其调用 latexmk

已改为全局调用 latexmk:% !TeX program = latexmk ;revert 了对settings的更改。

@zepinglee
Copy link
Contributor

zepinglee commented Mar 3, 2026

可以考虑全局修改 magic comments 来使其调用 latexmk

James-Yu/LaTeX-Workshop#4792 的修改。

我考究了一下,LaTeX 的 magic comments 源自 TeXShop。但 TeXShop 不支持 % !TeX program = latexmk,只支持 pdflatex、xelatex 之类。所以我建议还是修改 LaTeX-Workshop 的配置,保留原来的 = xelatex

其实我个人感觉更好的解决方案是:1. 由 latexmk 读取 magic comments 并配置引擎(该选择的优先级低于 latexmkrc 配置和命令行参数选择的引擎);或者 2. 由 LaTeX-Workshop 读取 magic comments,并将选择的引擎以命令行参数传给 latexmk。

另外我发现 TeXShop 只接受 % !TEX,必须是大写的 TEX。顺便也修一下这个。

For consistency and improved compatibility with various TeX editors and build systems.
@atomiechen
Copy link
Contributor Author

我考究了一下,LaTeX 的 magic comments 源自 TeXShop。但 TeXShop 不支持 % !TeX program = latexmk,只支持 pdflatex、xelatex 之类。所以我建议还是修改 LaTeX-Workshop 的配置,保留原来的 = xelatex

已按照这一建议改回。

另外我发现 TeXShop 只接受 % !TEX,必须是大写的 TEX。顺便也修一下这个。

已修改样例文档源码中全部小写为大写。

其实我个人感觉更好的解决方案是:1. 由 latexmk 读取 magic comments 并配置引擎(该选择的优先级低于 latexmkrc 配置和命令行参数选择的引擎);或者 2. 由 LaTeX-Workshop 读取 magic comments,并将选择的引擎以命令行参数传给 latexmk。

这两个方案我没做深入调研,初步看都没有现成的功能接口。

@zepinglee
Copy link
Contributor

非常感谢!

@zepinglee zepinglee merged commit cb132b3 into tuna:master Mar 5, 2026
2 of 10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants