search

KhronosGroup / Vulkan-Site

Vulkan Documentation Project framework for integrated documentation site with spec, proposals, guide, and more
Other
25 stars 2 forks source link

allow parent ci to be called. #85

Closed gpx1000 closed 5 months ago

gpx1000 commented 6 months ago

This just adds a playbook that can be called from CI from the component CI interfaces. This will allow Samples, Guide, etc to create their own antora site from their CI to validate that the individual sites work. This shouldn't be used to create the larger Vulkan Docs site.

fixes #82

oddhack commented 6 months ago

specmacros.js will be needed when doing a standalone build in the Vulkan-Docs repo, and several of the other .js are only used there as well (- ./js/vuid-expander.js, ./js/genanchorlinks.js, ./js/open_listing_block.js). I am not sure if anything other than Vulkan-Docs uses the asciidoctor-mathjax.js functionality.

It is unfortunate that Antora cannot load .js modules in the component antora.yml so they all get shoved up into the playbook, but it is what it is.

gpx1000 commented 6 months ago

Right, but sadly need to run make on the docs repo for those javascript files to exist. When we're in a project that doesn't need them there's no reason to download the docs repo just to run make and have those javascript files when they aren't even used.