add github url

.github/workflows/ci-docs.yml

@@ -47,6 +47,12 @@ jobs:
         run: |
           set -euo pipefail
           echo "Strict is set to ${MKDOCS_STRICT}"
+          REPO_SLUG="${GITHUB_REPOSITORY#*/}"
+          MKDOCS_SITE_URL="https://${GITHUB_REPOSITORY_OWNER}.github.io/${REPO_SLUG}/"
+          MKDOCS_REPO_URL="https://github.com/${GITHUB_REPOSITORY}/tree/${GITHUB_REF_NAME}"
+          MKDOCS_REPO_NAME="${GITHUB_REPOSITORY}"
+          export MKDOCS_SITE_URL MKDOCS_REPO_URL MKDOCS_REPO_NAME
+
           FLAGS=()
 
           if [ "${MKDOCS_STRICT}" = "true" ]; then
@@ -54,4 +60,4 @@ jobs:
           fi
           MKDOCS_OUTPUT_DIR="${RUNNER_TEMP:-${TMPDIR:-/tmp}}/dist"
            
-          mkdocs build "${FLAGS[@]}" -f "${MKDOCS_CONFIG}" -d "${MKDOCS_OUTPUT_DIR}"
+          mkdocs build "${FLAGS[@]}" -f "${MKDOCS_CONFIG}" -d "${MKDOCS_OUTPUT_DIR}"

.github/workflows/release.yml

@@ -48,6 +48,21 @@ jobs:
         run: |
           set -euo pipefail
 
+          REPO_SLUG="${GITHUB_REPOSITORY#*/}"
+          BASE_SITE_URL="https://${GITHUB_REPOSITORY_OWNER}.github.io/${REPO_SLUG}/"
+          MKDOCS_REPO_URL="https://github.com/${GITHUB_REPOSITORY}/tree/${GITHUB_REF_NAME}"
+          MKDOCS_REPO_NAME="${GITHUB_REPOSITORY}"
+
+          if [[ "${GITHUB_REF_NAME}" == draft* ]]; then
+            MKDOCS_SITE_URL="${BASE_SITE_URL}draft/"
+          elif [[ "${GITHUB_REF_NAME}" == rc* ]]; then
+            MKDOCS_SITE_URL="${BASE_SITE_URL}rc/"
+          else
+            MKDOCS_SITE_URL="${BASE_SITE_URL}"
+          fi
+
+          export MKDOCS_SITE_URL MKDOCS_REPO_URL MKDOCS_REPO_NAME
+
           FLAGS=()
           if [ "${MKDOCS_STRICT}" = "true" ]; then
             FLAGS+=(--strict)
@@ -168,4 +183,4 @@ jobs:
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
           git commit -m "Deploy draft preview ${GITHUB_REF_NAME}" || echo "No changes to commit"
-          git push origin gh-pages
+          git push origin gh-pages

mkdocs/mkdocs.yml

@@ -1,4 +1,7 @@
 site_name: CMBA Bylaws, Policy, and Playing Rules
+site_url: !ENV [MKDOCS_SITE_URL, ""]
+repo_url: !ENV [MKDOCS_REPO_URL, ""]
+repo_name: !ENV [MKDOCS_REPO_NAME, ""]
 docs_dir: ../docs
 
 # Prevent accidental publishing of repo/CI/dev clutter