Deploying Documentation
Easily publish your documentation site for sluggi
using MkDocs and GitHub Pages.
Deploy to GitHub Pages (Manual)
- Ensure
mkdocs-material
is installed:bash pip install mkdocs-material
- Commit all changes to your repository.
- Deploy:
bash mkdocs gh-deploy
This will build and deploy your docs to GitHub Pages.
Your documentation will be available at:
https://blip-box.github.io/sluggi/
Deploy Automatically with GitHub Actions (Recommended)
- Use the official MkDocs Deploy Action for CI/CD.
- Example workflow:
.github/workflows/deploy-docs.yml
Local preview & troubleshooting
- Preview locally with
mkdocs serve
- For advanced configuration, see
mkdocs.yml
and the MkDocs Material documentation.