全面的 LaTeX/Packages 教程/手册,包含明确示例和显示结果,而不是像 mathematica 文档中心那样的纯代码

全面的 LaTeX/Packages 教程/手册,包含明确示例和显示结果,而不是像 mathematica 文档中心那样的纯代码

我想使用 latex 中的一些软件包,然后我找到了该软件包的手册。但是我发现所有这些手册都只有代码和解释,没有任何明确的例子和显示结果。我不是计算机科学家。阅读所有纯文本来了解如何使用这个包对我来说相当无聊和低效。有没有什么地方可以找到每个软件包的手册,供像我这样的业余爱好者使用?我希望这个手册/说明(当然不一定是由软件包的作者编写的)具有以下属性:

  1. 不要太粗略,比如只选择几个简单的例子来介绍框架。我希望它是全面的,可以告诉我该包中每个函数、方法或参数的所有细节。

  2. 对我来说最重要的是每个函数/方法/参数都应该有明确的例子和显示结果。这样我就可以快速探索显示的结果,然后啊哈,这就是我想要的样子。

PS:我当然明白 LaTeX 不是付费软件。软件包的作者有权随心所欲地编写。我想知道是否有一些好的讲师可以消化原始的枯燥手册,并以友好的方式为那些不想只了解表面的业余爱好者提供指导。我想要的一个很好的例子是Wolfram Mathematica 文档中心

答案1

不,这样的网站并不存在,而且没有人会仅仅因为您觉得手册很无聊而为您创建这样的网站。

Mathematica 是一款专有应用程序,他们可以控制其软件包的文档编写方式。Python 是开源的,但具有强大的社区道德,他们几乎都同意“应该有一种——最好只有一种——方法来做这件事”。所以好的文档是文化的一部分。LaTeX 不是这些。

我同意评论者的观点,一些软件包文档非常好。 tikz并且pgfplots是我最喜欢的。而大多数文档都不是坏的;它也许没有详细说明你想用它做的每一件可能的事情。

但是,如果您正在寻找大量针对各种 LaTeX(以及 ConTeXt 和核心 TeX)用例的已解答问题资源,那么您可能已经找到了。TeX.SE 上的问题按使用的软件包进行标记,因此您可以浏览和搜索大量示例。TeX.SE 上的页面很容易找到。通常我只是谷歌搜索“latex(我想做的事情)”,最上面的结果通常是来自这个网站的页面。如果您找不到您想要的东西,请询问!

答案2

很抱歉,但我认为你的请求太过雄心勃勃。然而LaTeX 伴侣系列 (LaTeX 伴侣LaTeX 图形伴侣LaTeX 网络伴侣(均由 Addison Wesley 出版)在很大程度上满足了您的要求。至于单个包/类,由开发人员/作者提供他们认为重要的文档。我想在大多数情况下,他们(当然还有我)都认为读者对 LaTeX 有一定的了解,不需要重复任何基本元素。

我是该类的原始开发人员memoir> texdoc memoir),阅读了大约 540 页的手册。其中包括一个 40 页的索引,其中包含该类中的所有宏,所有这些宏都在手册正文中或多或少地进行了描述。给出了使用主要宏的结果示例。我估计,类中每个宏的每次使用示例将使手册的大小增加三倍。谁会读这个?我肯定不会写它。

当您知道自己想要看到的内容时,您是否愿意为您所了解的软件包编写业余级别的文档并将其提交给 CTAN 进行普遍分发?

戈美

相关内容