add latest version warning; new workflow for version releases; change…

… it to be a main version

.github/workflows/build-documentation.yml

@@ -36,6 +36,4 @@ jobs:
         run: |
           git config user.name sage-wright
           git config user.email [email protected] 
-          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/theiagen/public_health_bioinformatics/releases/latest | jq -r ".tag_name")
-          mike deploy --push --update-aliases ${LATEST_RELEASE} latest
-          mike set-default --push latest
+          mike deploy --push --update-aliases main

.github/workflows/build-version-release.yml

@@ -0,0 +1,39 @@
+name: build-documentation
+on:
+ release:
+   types: [published]
+
+permissions: 
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout main
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Setup python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.x
+
+      - name: Cache dependencies
+        uses: actions/cache@v2
+        with:
+          key: ${{ github.ref }}
+          path: .cache
+
+      - name: Install dependencies
+        run: |
+          pip install mkdocs-material mkdocs-material-extensions mkdocs-git-revision-date-localized-plugin mike mkdocs-glightbox
+      
+      - name: Build documentation
+        run: |
+          git config user.name sage-wright
+          git config user.email [email protected] 
+          LATEST_RELEASE=$(curl -sL https://api.github.com/repos/theiagen/public_health_bioinformatics/releases/latest | jq -r ".tag_name")
+          mike deploy --push --update-aliases main
+          mike set-default --push latest

overrides/main.html

@@ -0,0 +1,8 @@
+{% extends "base.html" %}
+
+{% block outdated %}
+  You're not viewing the latest version.
+  <a href="{{ '../' ~ base_url }}"> 
+    <strong>Click here to go to the latest version.</strong>
+  </a>
+{% endblock %}