STEM 处理
AsciiDoc 定义了用于将科学、技术、工程和数学 (STEM) 表达式添加到 AsciiDoc 文档的语法元素。与 AsciiDoc 本身非常相似,这种 STEM 符号允许科学家、数学家和工程师用来描述方程式、公式等的图形符号以纯文本格式表示。转换器负责解释这些表达式的源并将其转换为可显示格式。这就是 STEM 处理的用武之地。
在本页中,我们将探讨 AsciiDoc 转换时 STEM 表达式的处理方式,并概述 Asciidoctor 为各种输出格式处理这些表达式的集成。
工作原理
当转换器遇到 AsciiDoc 文档中的 STEM 节点时,它会将表达式的源传递给 STEM 处理库,例如 MathJax。该库要么自己显示渲染后的表达式(例如 MathJax),要么将其转换为转换器可以链接或嵌入到输出文件中的图像(例如 Asciidoctor Mathematical),或者将其翻译成后续处理流程中可以处理的其他格式(例如 AsciiMath)。
当在文档中设置了stem 文档属性,并且(如果需要)安装了相关库时,STEM 集成就会被激活。
STEM 集成
| 库名 | 支持的版本 | 后端 | 加载者 |
|---|---|---|---|
MathJax |
2.7.9 |
html |
客户端 |
Asciidoctor 数学 |
0.3.5 |
any |
处理器 |
AsciiMath (Ruby) |
1.0.x 或 2.0.x |
docbook |
处理器 |
您可以在MathJax 和 HTML、Asciidoctor Mathematical 和AsciiMath Gem 页面中深入了解这些集成。
如果您计划转换为 DocBook 以利用 DocBook 工具链,请在决定在 AsciiDoc 文档中使用哪种 STEM 符号时,务必考虑DocBook 工具链中的 STEM 支持。