帮助
网站导航
每个课程都有一个链接指向相同主题的相关课程，这些相关课程会更深入地探讨该主题。你应该能够在 无需 阅读额外课程的情况下完成全部16个课程。
在课程结束时，有一个或多个针对当前所用语言的特定课程，最后还有一个展示各种宏包的示例库，展示了本课程未涵盖的 LaTeX 用法。
示例
运行示例
每个示例都是一个完整的小型 LaTeX 文档，在页面中显示如下：
% !TEX program= LuaLaTeX
\documentclass{ctexart}
\begin{document}
示例文本。
\end{document}
当你使用 ctexart（或其他ctex文档类）时，无需加载 xeCJK 宏包（`\usepackage{xeCJK}`）。现代 TeX 引擎会根据需要自动加载对应的CJK 宏包，简单的ctexart文档应该在所有引擎上都能正常工作。在编译LaTeX文档时最好使用 LuaLaTeX 引擎，不仅因为它在处理大型文档时更快，而且它是被推荐的编译引擎(https://www.texdev.net/2024/11/05/engine-news-from-the-latex-project)。
每个示例都是完整的。但是你可能希望编辑它来做一些小的改动，也许是作为课程末尾的练习集的一部分。
编辑器使用的是ACE。
你可以在网站设置页面自定义编辑器使用的主题（例如使用深色主题，即在深色背景上显示浅色文本）。在网站的任何示例中使用Ctrl+,（Mac上使用⌘+,）是一种尝试不同主题的便捷方式。这会显示一个面板，允许你更改所有ACE设置。
ACE代码库有一个有用的编辑器快捷键页面。
运行示例的三种方式
- 使用 Overleaf 服务
- 使用 TeXLive.net 服务
- 使用本地安装的 TeX 系统
使用Overleaf服务
Overleaf 是最受欢迎的在线 LaTeX 编辑服务之一。示例下方的按钮会将代码提交到Overleaf。
如果你没有账号，或者浏览器中没有缓存账号信息，你将被重定向到登录页面，在那里你可以登录或注册 Overleaf。这是一个免费服务，但需要你提供一些详细信息并同意使用条款和条件。
如果你的 Overleaf 账号已经在浏览器中缓存，Overleaf 将在新标签页中打开，其中包含代码的新项目。你可以在 Overleaf 中编辑它，Overleaf 会同时运行 LaTeX 处理你的代码，显示输出结果或错误日志。
与在 TeXLive.net 处理的文档不同，你可以将项目保存在 Overleaf 账号中，以后再回来继续编辑。
使用TeXLive.net服务
示例下方的按钮会将代码提交到 TeXLive.net服务1。
TeXLive.net 服务是专门为支持本网站而开发的，特别是利用了 PDF.js来实现在移动设备和其他没有内置 PDF 阅读器的浏览器上显示 PDF。
生成的 PDF 文档（或错误日志的部分内容）将立即显示在示例下方。会提供一个按钮，这样你可以移除这个输出（或者你可以将它留在原处，继续学习下面的课程内容）。
注意，TeXLive.net 不需要任何登录或注册，所以它对小型示例来说非常方便，但本网站不提供保存你文档的机制。如果你离开页面，你对示例所做的任何更改都会丢失。
本地安装的TeX系统
如果你已经在本地安装了TeX系统，那么你可以复制示例代码，可以通过显式选择它，也可以使用编辑器中的全选键盘快捷键（例如在 Windows 中使用Ctrl+A Ctrl+C）。这会将代码放入你的操作系统剪贴板，这样你就可以使用本地编辑器启动一个空白文档，然后粘贴文本。
故障排除
我们的示例是基于使用最新的 LaTeX 安装。它们都能在我们的两个在线演示系统中运行，所以如果你在我们提供的示例中遇到错误，你可能需要检查你的 LaTeX 系统是否需要更新。
选择TeX引擎
提交示例文档时，默认将使用pdflatex引擎。
你可以通过使用以下形式的注释来强制选择latex、pdflatex、 XeLaTeX 、 LuaLaTeX 、platex或uplatex：
% !TEX 任意文本 ` LuaLaTeX `
其中开头的空格是可选的，大小写不敏感，第一个和最后一个单词之间的_任意文本_也会被忽略。
这允许使用某些TeX编辑器使用的形式% !TEX program=pdflatex，但不要求program=，目前仅限于指定在线系统支持的引擎之一。
你可以在本网站的一些示例中看到使用注释来指定 LuaLaTeX 的例子。
如果指定了platex或uplatex，那么还会使用dvipdfmx程序来从这些变体生成的DVI文件生成 PDF 结果。类似地，如果指定了latex，则会使用dvips和ps2pdf。
如果在% !TeX注释中未指定引擎，则将使用pdflatex，除非你在网站设置页面上指定了默认TeX引擎。
选择如何显示输出
如果你使用 TeXLive.net 系统，则默认情况下使用 PDF.js显示运行示例的 PDF 输出。这在各种浏览器中提供了一致的行为。
如果你更喜欢使用浏览器的默认 PDF 阅读器（无论是内置的还是你配置的外部应用程序），请添加以下形式的注释：
% !TEX 任意文本 pdf
默认行为可以通过使用pdfjs作为最后一个标记来显式指定。出于调试目的，即使文档没有错误地生成了 PDF，有时你也可能想要返回日志文件。这可以通过在注释中使用log作为最后一个标记来指定。
作为使用% !TeX注释的替代方法，你可以在网站设置页面上指定网站默认返回参数。这些设置是特定于每个浏览器的，因此例如你可以在移动设备上使用默认的pdfjs设置，但在桌面浏览器上使用pdf来使用其默认的 PDF 渲染。
HTML输出（make4ht、LaTeXML、lwarp）
如果使用 TeXLive.net 系统，则可以指定额外的返回选项：make4ht、LaTeXML或lwarp。这些会在页面内的框架中返回一个或多个 HTML 页面。它们可以与 XeLaTeX 或 LuaLaTeX 以及默认的pdflatex处理一起指定。
要启用此输出，请添加以下形式的注释：
% !TeX make4ht
将make4ht替换为LaTeXML或lwarp来指定这些系统。
或者，你可以在网站设置页面上将make4ht、LaTeXML或lwarp指定为默认返回选项。
如果使用本地安装的 TeX 系统，可以通过执行以下命令获得与make4ht选项相同的输出：
make4ht document.tex "learnlatex4ht,2,mathml,mathjax,svg"
如果指定了 XeLaTeX 或 LuaLaTeX ，则需要添加-x或-l选项。
在本地运行时，可以使用其他配置。请参阅make4ht手册。
对于LaTeXML，你需要安装 LaTeXML（它不是 TeX Live 或 MiKTeX 的一部分）并使用：
latexml document.tex > document.xml
latexmlpost --format=html5 \
--javascript='https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js' \
--destination=document.html" document.tex
可以使用许多其他 LaTeXML 配置，如手册中所述。
lwarp配置在这里没有记录，它有点实验性并且可能会改变。当前版本可以在源代码库中看到。
注意，在网站开发期间，我们还使用了 LaTeX.Online和 LaTeX-on-HTTP，我们感谢这些服务的开发者在早期阶段使本网站的示例可用。 ↩