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".