Vulkan Asciidoc Configuration Files

Macros

The macros in spec-macros.rb and spec-macros/extension.rb are described in the “Vulkan Documentation and Extensions: Procedures and Conventions” document (see the style guide.

Support for Math

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

math-docbook.conf is heavily conditionalized depending on whether the final output format (which should be described in the a2x-format variable) is pdf or not, since Docbook passes through math differently to dblatex vs. the XHTML stylesheets. This could be simplified now that we’re only using Docbook for PDFs.

Stylesheets

khronos.css is the stylesheet used for HTML output.

Chunked Spec Index

chunkindex contains scripts for building and using a search index for the Vulkan chunked HTML specification.