As discussed in #36 it would be nice to host the book on github pages. This pull request enables this. Some further setup is still needed, though.
What is still needed (I did these on my own repo, I can do it here as well):
[X] github pages must be enabled on this repository, using github actions.
[X] A second repository must be created which we will use for hosting preview versions. This repository must have the same name, but with '-staging' appended.
[X] Make it such that the workflow works independent of the repository in which it is used.
[x] An ssh key must be created which this repository uses to deploy preview versions to the second repository.
[x] It might be that the github repository name needs to be changed to knowledge-graphs-book.github.io , but I am not certain this is needed.
[x] The kgbook DNS must be updated such that it points here.
[ ] optionally, I suggest we block direct pushes to main.
What this does:
Whenever a change is made to the main branch, a process starts which compiles the index.html file and deploys it together with the other resources (now fixed to css fonts images js bib). This would then become immediately visible on kgbook.org .
When working on something, you should work in a branch. When a push to a branch occurs, a process is started which compiles the index.html file and places it together with the other resources (now fixed to css fonts images js bib) into another repository.
That repository is also hosted, but under a different URL or path, and hence it is possible to preview the changes.
Once we are happy with the changes, open a pull request, merge that in and rule 1 above kicks in to deploy on the webpage.
As discussed in #36 it would be nice to host the book on github pages. This pull request enables this. Some further setup is still needed, though.
What is still needed (I did these on my own repo, I can do it here as well):
What this does:
When working on something, you should work in a branch. When a push to a branch occurs, a process is started which compiles the index.html file and places it together with the other resources (now fixed to css fonts images js bib) into another repository.