mirror of
https://github.com/MichaelCurrin/mkdocs-quickstart.git
synced 2026-03-28 17:42:47 +01:00
849 B
849 B
TL;DR
A simplified version of the tutorial.
Local setup
- Install
pip install mkdocs
- Setup project
- Run
mkdocs serve
- View on http://localhost:8000
Deploy to remote site
Run deploy command locally
- Deploy to GitHub Pages
mkdocs gh-deploy
- View published site on GitHub Pages at
https://USERNAME.github.io/REPO-NAME/
Run continuous integration
For CI/CD deploy, use GitHub Actions with an action such as Deploy MkDocs. Or use Netlify.
This is not covered in this tutorial.