在邮件列表(注册,赶快行动!)TeX - LaTeX Stack Exchange(缩写:TeX.SX) 我经常看到有人抱怨 ConTeXt 文档不好/旧/不完整。我完全不同意。然而,我不得不承认,ConTeXt 文档实际上相当很难找到。这就是为什么我得出结论,我认为需要一份权威指南来介绍我认为非常出色的 ConTeXt 文档。我以这样的方式构建了本指南,让初学者可以从上到下阅读链接的资源。
尽管您在很多地方都看到“beta”和“实验”字样,但提供的版本可以视为生产质量,因为 Pragma ADE 依赖这些版本用于商业目的。如果您有即将到来的最后期限,我建议您在完成工作之前不要更新 ConTeXt,因为有些机制无论如何都是不断变化的。
答案1
介绍材料
这是 ConTeXt 文档中严重缺乏的部分。目前没有多少好的、完整的 ConTeXt 入门书籍,而关于乳胶。但不要绝望,初学者仍然有办法开始进入 ConTeXt,方法如下。
- 对 ConTeXt 的简要介绍这篇入门教材最初由 Joaquín Ataz-López 以西班牙语撰写,但后来作为社区努力成果被翻译成多种语言。本书不假设读者对 TeX/LaTeX/ConTeXt 有任何了解,因此对于有经验的读者来说,一开始可能会有点慢。除此之外,它完全符合您对入门教科书的期望,因为它有大量示例,并且深入而广泛地介绍了大量可从宏观层面访问的 ConTeXt 功能。
当我第一次学习 ConTeXt 时,这本书还不存在,我不得不求助于其他资源,即使现在回想起来,我仍然认为这些资源非常有价值:
- ConTeXt Mark IV 之旅这是游览经常被当作初学者的指南。然而,游览 是 1999 年为 ConTeXt MkII 编写的,因此包含了很多在 MkIV 中已经过时的信息。有些人抱怨布局太糟糕了,但我认为这份文档对大约 100 页的最常用命令进行了非常好的概述。不幸的是,读完这篇文章后,我仍然无法排版 ConTeXt 文档。我现在知道了构建块是什么,但我仍然不知道如何将它们组合在一起。这就是下一个资源的用武之地……
- 用 40 次提交创建简洁的演示风格
Aditya Mahajan 的精彩教程,其中逐步构建了一组演示幻灯片。您可以浏览 GitHub 上的提交,使用该
git-walk
工具(在Aditya 的博客)或查看所有详细信息在单个页面上.本教程使我对如何自定义文档中最相关的元素有了基本的了解。
- ConTeXt 命令参考现在您知道如何自定义文档,您当然想尝试所有不同的设置。但等等,实际上全部设置?可能的键是什么,例如
\setuphead
?这就是 ConTeXt 命令参考的用武之地。这个极其简约的文档是我迄今为止遇到的最有用的文档。在超过 300 页的文档中,列出了每个设置命令及其所有可接受的键。
介绍材料部分到此结束。从这里开始,我们将深入探讨更复杂的主题。不过,在阅读了参考文献 (1) 和 (2) 并准备好 (3) 后,您应该能够编写您的第一份文档。
先进的
我不建议你尝试通读这些参考资料。你不可能记住所有这些东西。只需浏览一下,了解一下内容,这样当你真正需要时,就可以回过头来详细阅读。
您可能已经开始编写自己的宏,并开始接触 ConTeXt 核心,并且想知道那些奇怪的
\s!
、\c!
、\v!
和\??
是什么\@@
。那么您可能会喜欢
系统宏ConTeXt Garden Wiki 中的页面。
字体
- ConTeXt 之外的字体又名“新字体手册”取代了旧字体章节。有时,您想要调整连字、字距调整、突出等内容,甚至想要做一些复杂的事情,例如定义虚拟字体来显示您的自定义字符。这是解决所有与字体相关的复杂问题的首选资源。
- Typescript 文件如果你只想为没有提供的字体实现一个打字稿,那么最好只是浏览 ConTeXt 源代码
type-imp-*.mkiv
文件并查看它是如何在那儿完成的。
数学
- ConTeXt 数学成瘾康复中心这是一篇短文,发表于 2006 年荷兰 TeX 用户组的 MAPS 期刊。它详细介绍了如何实现与 LaTeX
amsmath
包中已知的对齐方式类似的对齐方式。(本文也发表于我的方式)
- 数学本手册讨论了一些高级数学内容,例如自动替换(输入
/=
自动转换为≠
)、与网格排版的相互作用、自定义编号以及一些针对缺陷数学字体的技巧。
参考书目 (BibTeX)
- ConTeXt 方式的参考书目
\setupbibtex
您可能读过ConTeXt Mark IV 之旅。此机制已被新机制取代,新btx
机制充当 BibTeX 的替代品,完全在 Lua 中实现。得益于btx
ConTeXt,它不依赖外部程序来处理参考书目。但是,它仅提供两种不同的样式:apa
作者年份样式和aps
数字样式。详细样式名为ieee
正在开发中。
与 Lua 交互
- ConTeXt Lua 文档ConTeXt MkIV 基于 LuaTeX,而 LuaTeX 的开发完全由 ConTeXt 推动。ConTeXt 和 Lua 之间存在着惊人的交互,原则上您可以在 Lua 中排版整个文档,这并不奇怪。有些东西,如 PDF 后端,有多余的或根本没有宏级接口。这种低级机制通常可以在 Lua 中访问。
显卡
元乐趣Metafun 是一组 MetaPost 宏,专门为与 ConTeXt 交互而定制。您可以做很多有趣的事情,例如叠加、绘制字体轮廓或只是基本形状。LaTeX 用户可以使用 Ti钾Z 就是这样的(ConTeXt 中也有),但是 Metafun 的运行速度要快几个数量级,并且可以非常自然地与与框架相关的所有内容(当然还有背景、表格和普通框架)集成。
流程图用于在 Metafun 中绘制流程图的宏观层面接口。流程图不是核心功能的一部分,必须使用 导入
\usemodule[chart]
。节点用于绘制交换图的宏观层面和 MetaPost 接口。
布局
- 细节决定成败我认为这是高级 ConTeXt 用户最重要的文档之一。它是一份视觉指南,介绍了所有让您从 LaTeX 切换到 ConTeXt 的酷炫功能,即网格排版和侧浮点。如前所述,这是一个视觉指南,而不是一本解释很多事情的手册。相反,它列出了不同的选项并展示了设置这些选项的视觉效果。
- 页面在这个颇具误导性的标题背后隐藏着一本关于如何排版杂志风格列的手册,其中的浮动字符可以跨越多列。
专家
进度报告ConTeXt 中添加的许多功能都很小,或者直接影响核心,因此没有专门的手册。尽管如此,Hans 还是孜孜不倦地在他的 LuaTeX 和 ConTeXt 开发进度报告中记录了这些功能。按时间顺序排列如下:
- LuaTeX 的历史
- MkIV 混合动力技术
- 关于LuaTeX 和 ConTeXt
- 仍在继续
- 不断
- 跟进
- 估计的正好(当前工作报告)
LuaTeX 的历史主要具有历史意义,因为其中描述的许多特征在其他地方都有更详细的记录,例如OpenType 字体, 元乐趣, 和XML。
其他文档对 ConTeXt MkIV 和 LMTX 的所有内部结构进行了非常深入的介绍,绝对值得浏览一下,看看有哪些可用内容。每当我打开这些手册并阅读几段文字时,我都会发现新的隐藏功能。
- 在 ConTeXt MkIV 中处理 XMLConTeXt 可以将文档导出为 XML。这得益于整体核心和统一接口。它还可以从 XML 输入生成排版输出。本手册详细介绍了 XML 与宏和 Lua 级别的所有交互。
- LuaTeX和LuaMetaTeX由于 ConTeXt MkIV 和 Lua(Meta)TeX 之间的关系非常密切,因此专家用户绝对有必要了解底层引擎的详细信息。链接指向 Pragma ADE 上托管的 LuaTeX 和 LuaMetaTeX 手册,该手册始终涵盖分别用作 ConTeXt MkIV 和 LMTX 基础的最新开发版本。
更多资源
以上列出的所有手册也随 ConTeXt 独立版和 TeX Live 一起提供。PDF 可在以下位置找到
doc/context/documents/general/manuals/
,相应的来源doc/context/sources/general/manuals/
(链接指向 ConTeXt GitHub 镜像)。
在 TeX Live 中,还可以使用该texdoc
工具通过提供 PDF 名称作为参数来打开手册,例如texdoc metafun-p
将打开 MetaFun 手册。
我看到有些地方提到了另外两本手册,我想对它们发表一下我的评论。
排版编程这本书应该会成为一本关于文档设计一般方面以及如何通过自动排版将设计转化为风格的手册。目前它尚未完成,主要涉及微排版功能和页面布局,但并没有超越更完整的ConTeXt 之外的字体和 细节决定成败。它也已经有一段时间没有更新了。
ConTeXt 参考手册这本应是 ConTeXt 的全面介绍,并可以发展成为完整的入门用户手册,但却卡在了 MkII 和 MkIV 之间,缺少了几章。我不建议在充分了解 MkII 和 MkIV 之间的区别之前阅读它,因为否则它会让人感到困惑。
还有命令参考在 ConTeXt Garden Wiki 上。这完全是碰运气,因为有些命令的文档记录得很好,而其他命令则根本没有。好消息是它是公开可编辑的,所以如果你遇到不好的文档,你应该登录并修复它。
答案2
绝对“ConTeXt 的简短介绍”。有英文版、法文版和西班牙文版。虽然不是官方的,但我觉得已经够好了。
这肯定是受到启发“LATEX2ε 的简短介绍”