Deploying Documentation

Easily publish your documentation site for sluggi using MkDocs and GitHub Pages.


Deploy to GitHub Pages (Manual)

  1. Ensure mkdocs-material is installed: bash pip install mkdocs-material
  2. Commit all changes to your repository.
  3. 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/

  • Use the official MkDocs Deploy Action for CI/CD.
  • Example workflow: .github/workflows/deploy-docs.yml

Local preview & troubleshooting