Deploy MkDocs to GitHub Pages (github.io)

# Create MkDocs virtual environment
python3 -m venv mkdoc_venv

# Activate venv
source mkdoc_venv/bin/activate

# Deactivate venv
deactivate

# Install MkDocs + Material theme
pip3 install mkdocs mkdocs-material

# Install Mermaid plugin
pip install mkdocs-mermaid2-plugin

# Create a new MkDocs project
mkdocs new duke-note

# Run MkDocs local server
mkdocs serve

# Run server for external access
mkdocs serve --dev-addr=0.0.0.0:8000

# Run in your notes directory
git init
git add .
git commit -m "Initial commit of my study notes"

# Format:
# git remote set-url origin https://<token>@github.com/<owner>/<repository>.git

# Example:
git remote set-url origin https://ghp_yourTokenHere@github.com/dukehug/mkdocs_dknotes.git

git branch -M main
git push -u origin main

# Deploy to GitHub Pages
mkdocs gh-deploy

#!/bin/bash

# Stop if any error happens
set -e

# Build site
mkdocs build
sleep 10

# Push updates
git add .
git commit -m "update notes: $(date)"
git push origin main
sleep 10

# Deploy to GitHub Pages
mkdocs gh-deploy