LaTeX 开发代码

LaTeX 的基本文件在多个 GitHub 仓库中进行管理和开发。最重要的仓库是

• latex2e — 核心 LaTeX 格式和基本包（运行 pdflatex、lualatex 等时获得的内容）
  • 此仓库还包含所需的捆绑包，即 amsmath、graphics、tools 以及由于历史原因的 cyrillic。
• latex3 — L3 编程层和 l3backend（于 2020 年集成到 LaTeX 格式中）。
  • 此仓库还包含 LaTeX 其他组件的新代码捆绑包，这些组件尚未集成，因为它们仍在开发中。但是，其中大部分可通过通用 TeX 发行版以 LaTeX 包的形式获得，并且我们清楚地区分实验性代码（供大胆人士使用）和我们认为适合一般用途的包。
  • 有关仓库中包含的软件包的更多信息，请参阅仓库顶层 README。

还有各种其他仓库，例如 babel、hyperref、l3build、luaotfload 等等，所有这些都由 LaTeX 项目团队管理。此外，一些成员拥有自己的仓库，他们从中分发通常使用的更多 LaTeX 包。

l3build

LaTeX 代码使用 l3build 配置文件进行安装和测试。l3build 是一个跨平台的 Lua 程序，用于自动化（主要是）LaTeX 包文件的构建和测试过程，它也由 LaTeX 团队开发。

获取它

大多数 LaTeX 代码都可以直接获得，并通过所有主要的 TeX 发行版自动保持最新，因此您只需通过安装的更新机制自动（或手动）获取它。

还可以使用所谓的 -dev 格式运行下一个版本的版本，这些格式是经过策划的预发布版本（我们认为适合使用和测试）

但是，如果您希望测试 GitHub 上未发布的开发代码，您可以克隆其中一个仓库，例如

git clone git@github.com:latex3/latex3.git

要从开发仓库本地安装软件包，请按如下方式使用 l3build

cd l3kernel
l3build install

在某些情况下（例如对于 l3kernel，因为这是 L3 编程层，因此已加载到格式中），您可能需要在之后更新格式，但在大多数情况下，本地安装就足够了。

重要提示： 通过 l3build install 安装的文件存储在您的本地 texmf 树中，当 TeX 程序查找文件时，首先搜索该树。因此，除非您删除本地文件或设置您的系统以便您可以根据需要切换树，否则您通过正常发行机制收到的后续更新将永远不会被使用！

如果您希望对代码进行更改并通过拉取请求将其贡献回去，您可以选择“fork” GitHub 上的仓库并克隆您的 fork，但请先阅读 LaTeX 贡献指南 和 L3 贡献指南。

错误报告

您可以在 LaTeX2e 问题跟踪器中提出有关 LaTeX 格式代码或核心软件包的任何问题。请先阅读 关于如何以及何时提交错误报告的说明。为了能够做好一份像样的工作，我们需要您在提交错误报告时帮助提供正确类型的信息——提前感谢。

与 L3 编程层直接相关的错误或关于未集成到 LaTeX 格式中的 L3 代码的错误最好在 L3 问题跟踪器中提出。

打开的问题通常旨在报告与代码相关的问题，例如文档澄清、遗漏的功能或错误。请不要使用问题跟踪器来请求有关您的文档的帮助。其他渠道（如 stackexchange）更适合获得帮助。

讨论它

LaTeX 开发代码开发的概念及其实现正在邮件列表“LATEX-L”上进行讨论。您可以加入此列表，该列表仅用于讨论未来版本 LaTeX 的想法和概念，方法是发送邮件至 listserv@URZ.UNI-HEIDELBERG.DE，其中包含以下行

SUBSCRIBE LATEX-L Your Name

Listserv 网络界面

存在一个列表的网络界面，可用于阅读按主题和月份排序的帖子。默认情况下，这以只读模式向公众开放。如果您想使用此界面发帖，您必须订阅该列表，并且需要登录（这是页面上的一个选项）。

存档帖子

此列表已存档，订阅后，您可以通过向上述地址发送邮件来检索较旧的帖子，其中包含如下命令

GET LATEX-L LOGyymm

其中 yy=年份，mm=月份，例如

GET LATEX-L LOG1703

适用于 2017 年 3 月发送的所有消息。