Add versioning

Author: alxvmr

.github/workflows/build.yml

@@ -3,26 +3,48 @@ on:
   push:
     branches:
       - doc
+
 permissions:
   contents: write
 jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
+      - name: Checkout main branch
+        uses: actions/checkout@v4
+        with:
+          ref: main
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Get latest tag
+        id: get-latest-tag
+        run: |
+          echo "TAG_NAME=$(git describe --tags --abbrev=0)" >> $GITHUB_ENV
+
       - uses: actions/checkout@v4
+        with:
+          ref: doc
+          fetch-depth: 0
+          fetch-tags: true
+
       - 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 
+
       - 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 delete latest
+      - run: mike deploy --push ${{ env.TAG_NAME }}

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