Material for MkDocs is a theme for MkDocs. MkDocs is a static site generator intended to documenting projects.
With Material for MkDocs, you create your website using Markdown language and have access to several features, including a search bar.
This repository groups my experiences with Material for MkDocs and (possibliy) other static site generators.
The project in the main branch is based on James Willett's excellent tutorial on setting Material for MkDocs.
You can check the result at https://gabrielcostasilva.github.io/doc-mkdocs/
- Ensure Python is installed and working.
- Create a folder and go into it.
- Create a virtual environment with:
python -m venv venv
source venv/bin/activate
- Install MkDocs with:
pip install mkdocs-material
- Create a website project with:
mkdocs new .
- Run your website locally with:
mkdocs serve
- Customise your configuration at your will, then build your website for deployment with:
mkdocs build
To build the website, I used documentation from several repositories on my Github account.
James Willett's tutorial teaches how to deploy to Github sites. But can also deploy your static website on Amazon S3. Checkout this video to find out how.