- Install mkdocs on your machine (see [https://www.mkdocs.org/#installation](installation instructions)).
- Install the gitbook theme (
pip3 install mkdocs-gitbook
). - Run the command
mkdocs gh-deploy
(or use deploy.sh).- This command creates (or refreshes) the website for https://geoscience-semantics.org.
- The command must be run from the root directory of this repo.
- Behind the scenes,
mkdocs gh-deploy
builds HTML docs from the Markdown sources, uses theghp-import
tool to commit them to thegh-pages
branch, and pushes thegh-pages
branch to GitHub.