Draft: Initial cut at the docs site Antora build

KhronosGroup / GLSL

GLSL Shading Language Specification and Extensions

Other

347 stars 101 forks source link

Draft: Initial cut at the docs site Antora build #266

Open oddhack opened 3 weeks ago

oddhack commented 3 weeks ago

This is very crude and not ready for merge yet. The spec build inside Antora mostly works, but there are a bunch of navigation problems to sort out, and there will need to be a few tweaks to the GLSL spec source as well.

oddhack commented 3 weeks ago

Current issues:

no glsl/latest/index.html in the generated tree, so clicking on the component menu lands on a nonexistent URL (but can go to glsl/latest/glsl/index.html to examine the tree)
chapters/interfacematching.adoc and chapters/iocounting.adoc appear to be empty pages
The shift operators (<< and >>) are not processed correctly by antora-prep.py - the are treated as xrefs and generate dead 'xref:' text in the generated HTML