AsciiDoc 定义了用于在 AsciiDoc 文档中添加 科学、技术、工程和数学(STEM)表达式 的语法元素。很像 AsciiDoc 本身,这种 STEM 符号允许以纯文本格式表示科学家、数学家和工程师用于描述方程式、公式等的图形符号。转换器负责解释和转换这些表达式的来源,使其可以显示。这就是 STEM 处理的用武之地。
在这个页面上,我们将探讨在将AsciiDoc转换时如何处理STEM表达式,并概述Asciidoctor为处理各种输出格式所提供的集成方案。
它是如何工作的
当转换器在AsciiDoc文档中遇到STEM节点时,它会将表达式的源码传递给STEM处理库,比如MathJax。该库要么自己显示渲染后的表达式(例如,MathJax),要么将其转换成图片让转换器链接或嵌入输出文件(例如,Asciidoctor Mathematical),或者将其翻译成其他格式,以便流程线下游的某些东西可以处理(例如,AsciiMath)。
当文档设置了stem文档属性,并且如果需要,相关的库已安装,STEM集成就会被激活。
STEM 整合
Library Name | Supported Versions | Backends | Loaded By |
---|---|---|---|
MathJax |
2.7.9 |
html |
client |
Asciidoctor Mathematical |
0.3.5 |
any |
processor |
AsciiMath (Ruby) |
1.0.x or 2.0.x |
docbook |
processor |
您可以在mathjax.html、mathematical.html和asciimath-gem.html页面中深入探索这些集成。
如果你计划转换为DocBook以利用DocBook工具链,请在决定在你的AsciiDoc文档中使用哪种STEM符号表示法时,务必考虑docbook.html。