This repository contains the source files for my MkDocs documentation project, using the Material for MkDocs theme.
- MkDocs: A fast, simple static site generator for building project documentation.
- Material for MkDocs: A professional, responsive theme built on Google's Material Design principles.
You can view the live version of this documentation at: https://github.com/ADORSYS-GIS/mk-docs
To run the project locally and preview the documentation:
-
Clone the repository:
git clone https://github.com/ADORSYS-GIS/mk-docs cd my-mkdocs-project
-
Install MkDocs and dependencies:
pip install mkdocs
-
Run the MkDocs development server:
mkdocs serve
Open your browser and navigate to
http://127.0.0.1:8000
to view the documentation locally.
-
Build the site:
mkdocs build
This will generate static files in the
site/
directory. -
Deploy to GitHub Pages: The project is set up to automatically deploy via GitHub Actions when changes are pushed to the
main
branch.To manually deploy:
mkdocs gh-deploy
This project is licensed under the MIT License - see the LICENSE file for details.