Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Conversation

oddhack
Copy link
Contributor

@oddhack oddhack commented Nov 4, 2024

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 added a commit to KhronosGroup/Vulkan-Site that referenced this pull request Nov 4, 2024
This is a draft - the GLSL spec pages build, but the navigation is
messed up and will require some tweaking both here and in the paired
KhronosGroup/GLSL#266 before it is ready to be
merged.
@oddhack
Copy link
Contributor Author

oddhack commented Nov 6, 2024

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant