The macros in vulkan-macros.rb and vulkan-macros/extension.rb are described in the “Vulkan Documentation and Extensions: Procedures and Conventions” document in the Vulkan Registry. They are not currently used, but included as examples.

Asciidoctor is customized to insert KaTeX <script> tags from math.js for HTML5, and properly pass through math which has \begin{}\/end{} delimiters instead of $$\[\]\(\).

For PDF builds, asciidoctor-mathematical is used to generate images.

We use a number of Asciidoctor customizations written in Ruby, described briefly below.

• katex_replace.rb - substitute KaTeX for MathJax in output HTML