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 和 HTMLAsciidoctor MathematicalAsciiMath Gem 页面中深入了解这些集成。

如果您计划转换为 DocBook 以利用 DocBook 工具链,请在决定在 AsciiDoc 文档中使用哪种 STEM 符号时,务必考虑DocBook 工具链中的 STEM 支持