GitHub Pages made with Material for MkDocs
To learn how to utilise the markdown syntax reference this markdown guide
To learn how to use github reference this short video or if you would like to learn more reference this long video
To start a locally hosted development site first make sure that you have the latest python installed and it is in your path.
- Clone the repository.
git clone https://github.com/Kptweedy/Tutorials.git
- Inside the repository create a virtual environment.
python -m venv venv
-
Activate the virtual environment.
- Windows
.\venv\Scripts\Activate.ps1
- Linux
source /venv/bin/activate
-
Upgrade pip.
python -m pip install --upgrade pip
- Install mkdocs-material and the plugins it needs.
python -m pip install mkdocs-material mkdocs-open-in-new-tab mkdocs-glightbox
- Run the server and head to http://localhost:8000
mkdocs serve
- Submit a Pull Request This can be done with github desktop (or git if you know how to)