Files
mkdocs-quickstart/docs/tutorial/tldr.md
2020-06-02 22:37:33 +02:00

849 B

TL;DR

A simplified version of the tutorial.

Local setup

  1. Install
    • pip install mkdocs
  2. Setup project
    • mkdocs new . or Use this template
  3. Run
    • mkdocs serve
  4. View on http://localhost:8000

Deploy to remote site

Run deploy command locally

  1. Deploy to Github Pages
    • mkdocs gh-deploy
  2. 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.