3c84f8fe4d
|
||
|---|---|---|
| .. | ||
| 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 | ||
| 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.