Skip to main content

Tutorial: deploy the KOS Kit Explorer as a statically-generated GitHub Pages site

This tutorial will guide you in deploying the KOS Kit Explorer as a statically-generated site using GitHub Actions and GitHub Pages.

You should only use static site generation for relatively small datasets (thousands of concepts).

Create and configure a GitHub repository​

Copy the template GitHub repository​

Follow these instructions on creating a GitHub repository from a template, using this template repository.

Configure GitHub Pages​

Follow these instructions on publishing GitHub Pages with a custom GitHub Actions workflow.

Replace data.nt in your repository with your SKOS taxonomy​

Your taxonomy can serialized be in any RDF format supported by N3.js:

Generate the site​

The site will be regenerated whenever you push commits to the repository.

You can also manually generate the site by manually running the GitHub Actions workflow. The name of the workflow is "Continuous Deployment".