e1c0e426f3
dirtree reorganization, changing paths in build scripts and other spec-adjacent material. |
||
|---|---|---|
| .. | ||
| extension-highlighter | ||
| katex_replace | ||
| themes | ||
| vu-to-json | ||
| vulkan-macros | ||
| .gitignore | ||
| README.md | ||
| asciidoctor-mathematical-ext.rb | ||
| attribs.txt | ||
| extension-highlighter.rb | ||
| katex_replace.rb | ||
| khronos.css | ||
| makeSubmit.py | ||
| mathtest.txt | ||
| optimize-pdf | ||
| tilde_open_block.rb | ||
| vu-to-json.rb | ||
| vulkan-macros.rb | ||
README.md
Vulkan Asciidoc Configuration Files
Macros
The macros in vulkan-macros.rb and vulkan-macros/extension.rb are
described in the "Vulkan Documentation and Extensions: Procedures and
Conventions" document (see the styleguide).
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.