有没有关于如何阅读 LaTeX 包注释源的指南?

有没有关于如何阅读 LaTeX 包注释源的指南?

我试图在命令行上阅读source2e.pdf( ),但我被难住了。对我来说,这似乎是一本相当神秘的书。据我了解texdoc source2e这个答案是关于命令需要什么参数,源文件在某种程度上是事实上特定软件包提供的 LaTeX 宏的“完整参考”。source2e.pdf没有提供从哪里开始阅读的线索。开头的章节ltdirchk.dtxltplain.dtx等似乎没有帮助。

是否有关于如何阅读源文件的指南?或者我可能遗漏了哪些必备知识?我熟悉语法,我想知道特定命令有哪些可用的选项和参数。

回应 TH 的回答:
我有编程背景。我发现 LaTeX 有很多编程元素,比如宏、命令、参数等。所以我用学习新编程语言的方式来学习它。

简而言之:
如果在教程中我读到斜体文本使用\textit。出于某种奇怪的原因,教程没有提到如何制作大胆的文本。作为一名程序员,我本能地想查找参考资料库,转到文本格式部分,然后,“啊哈!这里有所有用于格式化文本的宏!”。在那里,我会找到斜体、粗体、下划线、删除线、上标、下标等内容,以及语法指南和一些实例。

另一个例子:
当我得知某个包有一个\author宏时,我会说,“啊哈!这个包有能力让编写前页更容易。”所以我想查找参考资料库,然后查看所有其他功能,例如日期,甚至指定单独的标题页。

关于教程和参考库:
对我来说,教程是我所说的“线性”学习模式,例如循序渐进或维多。它们是一个很好的起点,让我可以了解某个特定工具的功能。在上面的例子中,我了解到 LaTeX 可以将文本变为斜体。我心想“哦,LaTeX 可以进行一些花哨的文本格式化,因此它一定能够做其他相关的事情。”

此时,我转向“分层”学习模式。我开始将能力分为以下几类:文本格式, 或者前页,然后我就会知道如何在参考资料库中查找它。

我想从阅读评论来源获得的信息:
我想了解 LaTeX 宏是如何相互关联的,然后我就能有效地使用我的“分层”学习方法。也可以看看这里(与问题开头的链接相同)。我希望能够读懂所有的@'s 和{#1}%'s 和{#2}%'s。所以我也在寻找有关所有这些符号含义的指南。

答案1

您希望从阅读 LaTeX 源代码中得到什么?阅读源代码时可能很重要的一条信息是doc/ 的docstrip工作原理。这解释了所有类似行的<initex>出现。除此之外,source2e.pdf它只是文档和 LaTeX2e 源代码的组合。它是可读的,但更重要的是,它是可搜索的。

我经常搜索我感兴趣的宏来了解它是如何工作的。

编辑:回答您更新后的问题,我想说阅读 LaTeX 源代码类似于阅读 GCC(或 C 库)的源代码来学习如何编写 C 程序,这是一项令人沮丧且可能毫无结果的努力。

您对线性和分层学习以及学习如何使用 TeX 编程的一般方法有正确的想法,但我认为您在错误的地方寻找答案。对于单个软件包(例如geometry),您应该阅读软件包文档。如果您使用 TeX Live,则已安装此文档。texdoc packagename在终端中运行以查看文档。对于标准 LaTeX 宏和环境,我不确定最好的信息来源是什么。有 Lamport 的书,但我觉得它不够好。LaTeX Companion 很好,但很多信息包含在单个软件包文档中。请参阅答案这个问题以获得一份良好参考的列表。

如果你想要学习 TeX 编程,我认为没有比 Knuth 的 TeXbook 更好的书了。它或多或少详细地描述了有关 TeX 的所有知识。人们通常也会推荐 TeX by Topic,但我还没有读过它。

相关内容