Try use gl-branch for the spec web site multi version

generateChangemarks/.gitlab-ci.yml

@@ -76,9 +76,67 @@ Publish spec:
     paths:
       - "*_${CI_COMMIT_TAG}.docx"
 
+# pages:
+#   stage: web
+#   when: on_success
+#   rules:
+#     - if: ($CLEAN_WEB_PAGES == 'false' || $CLEAN_WEB_PAGES == 'true') && $CI_COMMIT_TAG
+#       variables:
+#         TAG_NAME: $CI_COMMIT_TAG
+#     - if: ($CLEAN_WEB_PAGES != "false" && $CLEAN_WEB_PAGES != "true") && $CI_PIPELINE_SOURCE == "web"
+#       variables:
+#         TAG_NAME: $CLEAN_WEB_PAGES
+#     - if: $CI_PIPELINE_SOURCE == "trigger"
+#       variables:
+#         TAG_NAME: "upgrade"
+#   before_script:
+#     - |
+#      curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/publish_on_pages%2Esh/raw?ref=toMkdocs" >> publish_on_pages.sh
+#     - chmod +x publish_on_pages.sh
+#     - |
+#      curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/updateIndex%2Epy/raw?ref=toMkdocs" >> updateIndex.py
+#     - |
+#      curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/index%2Ehtml/raw?ref=master" >> index.html
+#     - |
+#      export SPEC_NAME=$(ls | grep T*.md | cut -d'.' -f1)
+#     - |
+#      sed -i 's/PROJECT/'${CI_PROJECT_NAME^^}'/g' index.html
+#     - |
+#      curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/toMkdocs%2Fimages%2Ffavicon%2Eico/raw?ref=toMkdocs" >> favicon.html
+#     - mkdir -p docs/images && mv favicon.html docs/images/
+#     - |
+#      curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/toMkdocs%2Fimages%2Fonem2m%2Epng/raw?ref=toMkdocs" >> onem2m.png
+#     - mv onem2m.png docs/images/
+#     - |
+#      curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/toMkdocs%2Fimages%2Fonem2m_sq%2Epng/raw?ref=toMkdocs" >> onem2m_sq.png
+#     - mv onem2m_sq.png docs/images/
+#     - |
+#      curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/toMkdocs%2Fstylesheets%2Fextra%2Ecss/raw?ref=toMkdocs" >> extra.css
+#     - mkdir -p docs/stylesheets && mv extra.css docs/stylesheets/
+#     - |
+#      curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/toMkdocs%2Fmkdocs%2Eyml/raw?ref=toMkdocs" >> mkdocs.yml
+#     - |
+#      curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/toMkdocs%2Findex%2Emd/raw?ref=toMkdocs" >> index.md
+#     - mv index.md docs/
+#     - |
+#      curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/toMkdocs%2FtoMkdocs%2Epy/raw?ref=toMkdocs" >> toMkdocs.py
+#   script:
+#     - echo 'Publishing on pages'
+#     - ./publish_on_pages.sh updateIndex.py $CI_PAGES_URL ${CI_PROJECT_NAME} $TAG_NAME index.html $CLEAN_WEB_PAGES $SPEC_NAME toMkdocs.py;
+#   artifacts:
+#     paths:
+#       - public
+#
 pages:
   stage: web
-  when: on_success
+  image: python:3.9.18-slim-bullseye
+  tags:
+    - docker
+  variables:
+    PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"
+    PAGES_BRANCH: gl-pages
+    HTTPS_REMOTE: https://gitlab-ci-token:${ACCESS_TOKEN}@${CI_SERVER_HOST}/rep/${CI_PROJECT_PATH}.git
+
   rules:
     - if: ($CLEAN_WEB_PAGES == 'false' || $CLEAN_WEB_PAGES == 'true') && $CI_COMMIT_TAG
       variables:
@@ -89,18 +147,10 @@ pages:
     - if: $CI_PIPELINE_SOURCE == "trigger"
       variables:
         TAG_NAME: "upgrade"
+
   before_script:
-    - |
-     curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/publish_on_pages%2Esh/raw?ref=toMkdocs" >> publish_on_pages.sh
-    - chmod +x publish_on_pages.sh
-    - |
-     curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/updateIndex%2Epy/raw?ref=toMkdocs" >> updateIndex.py
-    - |
-     curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/index%2Ehtml/raw?ref=master" >> index.html
-    - |
-     export SPEC_NAME=$(ls | grep T*.md | cut -d'.' -f1)
-    - |
-     sed -i 's/PROJECT/'${CI_PROJECT_NAME^^}'/g' index.html
+    - pip install -q mkdocs-material mike
+    - apt-get update -qq && apt-get -qq install -y git curl > /dev/null
     - |
      curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/toMkdocs%2Fimages%2Ffavicon%2Eico/raw?ref=toMkdocs" >> favicon.html
     - mkdir -p docs/images && mv favicon.html docs/images/
@@ -120,9 +170,31 @@ pages:
     - mv index.md docs/
     - |
      curl "${CI_API_V4_URL}/projects/$TOOLS_SCRIPTS_PROJECT_ID/repository/files/toMkdocs%2FtoMkdocs%2Epy/raw?ref=toMkdocs" >> toMkdocs.py
+    - |
+     export SPEC_NAME=$(ls | grep T*.md | cut -d'.' -f1)
+    - git config --global --replace-all user.name $GITLAB_USER_NAME
+    - git config --global --replace-all user.email $GITLAB_USER_EMAIL
+    - git fetch origin $PAGES_BRANCH && git checkout $PAGES_BRANCH || git checkout -b $PAGES_BRANCH origin/$PAGES_BRANCH || echo "Pages branch not deployed yet."
+    - git checkout $CI_COMMIT_SHA
   script:
-    - echo 'Publishing on pages'
-    - ./publish_on_pages.sh updateIndex.py $CI_PAGES_URL ${CI_PROJECT_NAME} $TAG_NAME index.html $CLEAN_WEB_PAGES $SPEC_NAME toMkdocs.py;
+    - python3 toMkdocs.py --title ${CI_PROJECT_NAME^^} "./$SPEC_NAME.md"
+    - mv ${CI_PROJECT_NAME^^}/ docs/
+    - cat _nav.yml >> mkdocs.yml
+    - |
+      if [ -n "$TAG_NAME" ]; then
+        mike deploy --deploy-prefix public -r $HTTPS_REMOTE -p -b $PAGES_BRANCH -u $TAG_NAME latest
+        mike set-default --deploy-prefix public -r $HTTPS_REMOTE -p -b $PAGES_BRANCH latest
+      elif [ "$CI_COMMIT_REF_NAME" == "develop" ]; then
+        mike deploy --deploy-prefix public -r $HTTPS_REMOTE -p -b $PAGES_BRANCH -u $CI_COMMIT_BRANCH
+      fi
+    - git checkout $PAGES_BRANCH -- public/
   artifacts:
     paths:
-      - public
+      - public/
\ No newline at end of file
+  rules:
+    - if: '$CI_PIPELINE_SOURCE == "web"'
+      when: always
+    - if: '$CI_COMMIT_TAG'
+    - if: '$CI_COMMIT_REF_NAME == "develop"'
+      when: always
+    - when: never

toMkdocs/mkdocs.yml

@@ -87,5 +87,5 @@ extra:
     provider: mike
 
 nav:
-  - 'index.md'
+#  - 'index.md'