HTML-Demos

The HTML for this page is generated in build.py via GitHub Actions, which are configured in the custom workflow file static.yml. The build.py script generates links to all index.html files in the demos folder, and its subdirectories, allowing the project to grow exponentially without need for manually adding each link to the body of the root index.html.

Because the root index.html for this page is built and not written, it is not tracked by the repository to avoid need for extra syncing. It is inaccessible via GitHub and exists only in the deployed version.

The reason build.py is needed is that sites hosted on GitHub Pages do not offer easy directory access and rely on relative or absolute links to pages in the site structure.

If testing locally, this page is not needed, you can instead set up a local server via python -m http.server in the demos folder. Doing so opens demos as a directory and will give easy access to all demo sites.

Links