This repo contains the GLVis website MkDocs sources.
To clone, including submodules
git clone --recurse-submodules [email protected]:GLVis/web.git
If you've already cloned you can pull submodules with:
git submodule update --init --recursive
To make changes to the website you will need an install of Python 3 with the following libraries:
- use MkDocs v1.0.4 with Markdown v3.0 and the latest PyYAML
pip install --upgrade --user mkdocs==1.0.4
pip install --upgrade --user Markdown==3.0
pip install --upgrade --user PyYAML
- newer versions may not generate correct front page (to see the installed version, use
pip show mkdocs
) - clone this repo,
- edit or add some
.md
files (you may also need to update themkdocs.yml
config), - preview locally with
mkdocs serve
(Windows users may need to specify a port, such asmkdocs serve --dev-addr 127.0.0.1:4000
), - publish with
mkdocs gh-deploy
.