Add versioning

Author: alxvmr

.github/workflows/build.yml

@@ -3,26 +3,39 @@ on:
   push:
     branches:
       - doc
+
 permissions:
   contents: write
 jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
       - name: Configure Git Credentials
         run: |
           git config user.name github-actions[bot]
           git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+
       - uses: actions/setup-python@v5
         with:
           python-version: 3.x
       - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV 
+
+      - name: Get latest tag from main branch
+        id: get_latest_tag
+        run: |
+          TAG=$(git describe --tags --abbrev=0)
+          echo "latest_tag=$TAG" >> $GITHUB_ENV
+
       - uses: actions/cache@v4
         with:
           key: mkdocs-material-${{ env.cache_id }}
           path: .cache
           restore-keys: |
             mkdocs-material-
       - run: pip install -r requirements.txt 
-      - run: mkdocs gh-deploy --force
+      # - run: mkdocs gh-deploy --force
+      - run: mike deploy --update-aliases --push --rebase ${{ env.latest_tag }} latest

mkdocs.yml

@@ -13,6 +13,10 @@ theme:
   palette:
     - primary: custom
 
+extra:
+  version:
+    provider: mike
+
 extra_css:
   - stylesheets/extra.css
 
@@ -28,4 +32,10 @@ plugins:
           build: true
         - locale: en
           name: English
-          build: true
+          build: true
+  - mike:
+      alias_type: symlink
+      redirect_template: null
+      deploy_prefix: ''
+      canonical_version: null
+      version_selector: true

requirements.txt

@@ -1,3 +1,4 @@
 mkdocs
 mkdocs-material
-mkdocs-static-i18n
+mkdocs-static-i18n
+mike