其中一项列出的是如何为 TeX 社区提供帮助TUG 网站的页面为:
我们希望有一份“LaTeX 简介”文档,其简洁性
sample2e.tex
和完整性介于“不那么简短的简介”之间,并且重点注重示例而不是散漫的解释。
你认为这样的文件需要包含哪些内容?如果你正在写这样的文件LaTeX 简介,比如说 20 页,您会如何组织它?
希望幸运的是,这个问题能让我写出一篇介绍 LaTeX 的文档。我稍后会建立一个 github……
答案1
以下是我认为应该包含在入门级教程:
限制注意力于
pdflatex
:- 没有提及
dvi
输出文件和查看器,或、、、XeTeX
或LuaTeX
任何其他 TeX 化身。Plain TeX
LaTeX2.09
- 选择极少数可能的 TeX 发行版进行讨论,例如 TexLive(及其 MacOS 实现 MacTeX)和 MiKTeX。提供有关这两个发行版的易于理解的信息,包括如何获取和安装它们。
- 简要介绍适合的 LaTeX 感知文本编辑器,包括一些可在 Unix、MacOS 和 Windows 计算机上运行的编辑器。建议仅使用可以正确处理 Unicode 输入的编辑器。
- 没有提及
一个非常简短的“Hello World!”类型的“初始文档”,解释了(i)如何通过 pdfLaTeX 编译 tex 文件以及(ii)每行代码的作用 - 包括使用字符
%
创建注释:\documentclass{article} % 3 main document classes of every LaTeX2e distribution: % article, report, and book \begin{document} % LaTeX has many environments, the most fundamental % being the "document" environment Hello World! % The body of this document \end{document} % When LaTeX encounters this instruction, all final % processing occurs and the output file is created.
MWE 还应解释 TeX 的“宏”的基本概念:(i) 控制序列或宏是以 开头的字符串
\
,以及 (ii) 宏可以接受参数。在上面的 MWE 中,有三个宏(\documentclass
、\begin
和\end
),每个宏都接受一个用花括号和 分隔的参数{
。}
相比之下,字符串“Hello World!”是不是TeX 意义上的宏。声明 LaTeX 文档是程序因此必须满足一些一致性标准,以便有合理的机会产生预期的输出。
- 例如,宏中的任何拼写错误都会生成错误和/或警告消息。
- 解释为什么一份“好的” LaTeX 文档会将文档的内容尽可能多地控制格式化的内容。
在此非常基础的文档的基础上,提供以下主题的扩展(并附有大量示例):
- 如何构建文档使用各种与切片相关的命令
- 如何选择字体除了 Computer Modern,
- 如何控制页面布局(
geometry
), - 行距(
setspace
)等等。
解释许多有用的功能并非“内置于” LaTeX,但可以通过加载各种“包”轻松访问。解释如何通过命令加载包
\usepackage
。在此类入门级教程中涵盖以下几个部分:
- 数学符号和数学环境的基础知识,
amsmath
包的提及; figure
和table
浮动,包括浮动环境的基本知识以及如何控制浮动的位置;graphicx package
和\includegraphics
命令;以及tabular
和环境的基础知识array
。
- 数学符号和数学环境的基础知识,
答案2
以下顺序通常效果很好,适合作为普通学生(例如大学学生)的实践介绍和讲义:
- MWE 书籍 - 从 koma 类或回忆录开始。解释标准类、书籍文章等(用户很快不再需要标准类、回忆录和 koma 的原因在于它们具有出色的灵活性和出色的文档)。
- MWE 添加 lipsum + chapter +sections(原因快速介绍包和文档结构)。
- MWE 添加目录(新用户看到目录会很兴奋)。
- MWE 添加索引(新用户可尽早看到 LaTeX 的强大功能,从而保持他们的积极性)。
- MWE 添加数学。(大多数用户很早就被 LaTeX 的数学所吸引)。
- MWE 添加参考书目。(另一个易于理解、强大的功能)。
- MWE 添加 amsmath + 少量额外的数学运算。(取决于受众,用于扩展包的使用)。
- MWE 添加图像。(MWE 开始看起来更像一本书)。
- MWE 添加表格(每个人都讨厌表格,这是一项必须教授的苦差事,可能会强化包装的使用并添加书签。关于排版的短文)。
- MWE 与其他标准组件、列表、引文、小页面、基本格式。(有关文本格式的更多信息)。
- MWE 使用 添加包和查找信息
textdoc
。(用户很快就能独立使用,让他们自己找到东西)。 - MWE 3 页文本在上面排版。总结。
- MWE Beamer 大多数用户可能会发布一篇文章并需要一个演示文稿。
以上都是渐进式练习。始终使用以前的 MWE。以上所有内容旨在让初学者有足够的动力继续自己学习并能够创建出版物。您不必用这样的介绍来涵盖所有内容。
答案3
我很惊讶之前没有提到过这一点:
调试、故障排除
- 如何?
- 移至
\end{document}
源中的较早点。 - 评论:
%
- 通过创建所谓的 MWE 来查找问题的根源。
- 移至
- 错误消息
- 经常出现但几乎没有帮助的错误信息(
perhaps a missing \item
) - 尽管语法看起来不错,但错误消息是正确的。(LaTeX:带方括号的可选参数)
- 经常出现但几乎没有帮助的错误信息(
- 新手经常遇到的问题
\protect
\section
命令等中的内容(为什么?)
LaTeX 不是什么?
过时的软件包或者注意事项
不,不应该解释但新手应该注意。你经常会碰到一些互联网教程或一些旧书,它们解释和推荐的东西已经过时了。
包装手册或者该做的
RTFM,该死的!
保持冷静,但实际上,答案往往就在某些手册中,你甚至可以学到一些你根本不知道的东西!有时他们甚至会在排版上添加一些有用的东西(例如booktabs
),
有时...它们实在是太让人难以忍受了(TikZ?整个 PGF 家族!)。
答案4
令我惊讶的是,有些事情没有被(明确)提及:
- 指出良好且详尽的文档谷歌搜索 LaTeX 问题几乎总是会得到过时的信息。包括对加拿大运输安全局,tex.SE,解毒并且——如果你包括 TikZ——手册。
- 工具很重要。确保突出一两个好的编辑器/IDE,并针对主要平台分别构建工具。
- (交叉)参考与文字处理器相比,这是一个杀手级功能。一定要介绍这些功能,并明确说明您需要多次运行才能正确使用它们(可能适用于其他功能)。
- 排版对初学者来说,这只是一个小小的问题,但我发现,只要对排版有最低限度的了解,你就能更好地欣赏 LaTeX。所以你可能想加入一个部分,重点介绍一些基本的东西,并提供更多参考。
- 演示幻灯片可能
beamer
是一个很好的高级示例。它表明为撰写文章而开发的技能可以立即用于其他文档。其他可能性包括信件或简历(moderncv
)。