我正在寻找一些标准或良好的实践来记录 LaTeX 源代码。
doc
我知道管理文件的包sty
,但我正在寻找如何在文档本身(tex
文件)中添加注释。
我看到很多文档都使用以 开头的元注释,%!
而且它似乎非常依赖于工具,例如 TeXStudio 注释与 IntelliJ 中的注释不同。
这是来自 TeXStudio 的:
% ! TeX program = pdfduallist.sh % | txs:///view
这是来自 IntelliJ Idea 的:
%! suppress = MightBreakTexify
%! suppress = FileNotFound
%! Package = LINGUAGEM
%! Author = Jander
%! Date = 23/04/2022
这类评论有共同点吗?我找不到相关参考资料。
也欢迎其他选择。
(我目前正在使用IntelliJ IDEA)。
答案1
我不太确定您的问题,尤其是在阅读了您的评论之后。
该doc
系统是记录 LaTeX(包/类)文件、混合代码和解释的标准方式,尽管它似乎已经过时了,许多作者也这么认为。
许多年前,我创建了该docmfp
系统作为其扩展,doc
主要目的是提供类似文档的 Metafont/Metapost 注释代码。
我还用它来创建和记录C
(express
ISO信息建模语言)代码。docmfp
创建它的目的是能够以单一方式记录任何编程代码。输出是ASCII文本文件。
看一下docmfp
,看看它是否能满足您的要求。任何编辑器都应该能够处理 ASCII 文本文件。