This is an example repository (formerly named skohub-docker-vocabs) to show how you can publish your SKOS vocabulary using GitHub infrastructure (Actions and Pages).
Every time a change is made to a vocabulary a GitHub-workflow-action is triggered to publish the most recent vocabulary to the gh-pages-branch, which is used by GitHub pages.
It spins up a Docker container made from SkoHub Vocabs.
If you want to reuse this repo and have your vocabulary automatically pushed und published via GitHub-Pages, follow these steps:
- Fork this repo. Uncheck the box to only fork the main branch.
- Go to "Actions" tab and if not already activated, activate GitHub Actions.
- Go to "Settings", navigate to the "Pages" setting and select
gh-pagesas the branch your site is being built from. - Go back to the main page of your repo and click the little gear icon in the top right of the "About" section. Check the box at "Use your GitHub Pages website".
- Add a commit to the main branch and your vocabulary will be automatically published (sometimes it takes a little to see the changes, remember to do some hard refreshing).
Any issues? Please open up a issue here
If you want to host your vocabularies under your GitHub pages domain (so no W3 perma-id or purl.org redirect), you have to provide that domain in the config.yaml.
Example:
Your GitHub Pages domain is: https://skohub-io.github.io/skohub-pages/
Then provide https://skohub-io.github.io/skohub-pages/ as custom_domain in your config.yaml.
The base of your concept scheme could then be something like: https://skohub-io.github.io/skohub-pages/colours/
Notice that this will apply to all your hosted vocabularies.
You probably only forked the main branch. You have two options:
- Delete the repo and fork it again, but make sure to uncheck the box to only fork the main branch
- Make sure the GitHub Action is activated ➡️ Go to "Actions" tab and activate it. After that commit changes to a vocabulary in the main branch. This should trigger the build and create a
gh-pagesbranch.
Maybe your GitHub Action is not activated yet. Go to the "Actions" tab and activate GitHub Actions for your repository.
You maybe need to update permissions like described here: peaceiris/actions-gh-pages#744
Go to Settings > Actions > General > Workflow permissions and toggle the Read and write permissions.
09.02.2021:
- In an earlier version, there was the .env variable
PATH_PREFIXset to point to the repository the vocabulary is hosted at. To align with rest of code, this was changed toBASEURL. - The docker image now also support i18n