Merge pull request #18 from modelix/docs/release/23.2

Docs/release/23.2

antora-playbook-develop.yml

@@ -4,33 +4,34 @@ site:
   start_page: modelix::index.adoc
 
 content:
+  branches: [ HEAD, 'docs/release/*' ]
   sources:
 
   #
   # GLOBAL REPOSITORIES
   #
   # - url: https://github.com/modelix/modelix.doc
   - url: ./
-    branches: HEAD
-    tags: modelix-2@({0..9}).+({0..9})
+    version:
+      'docs/release/(*)': '$1'
     start_path: docs
 
   # - url: https://github.com/modelix/modelix.samples
   - url: ./../modelix.samples-main
-    branches: HEAD
-    tags: modelix-2@({0..9}).+({0..9})
+    version:
+      'docs/release/(*)': '$1'
     start_path: docs/global
 
   # - url: https://github.com/modelix/modelix.core
   - url: ./../modelix.core-main
-    branches: HEAD
-    tags: modelix-2@({0..9}).+({0..9})
+    version:
+      'docs/release/(*)': '$1'
     start_path: docs/global
 
   # - url: https://github.com/modelix/modelix.platform
   - url: ./../modelix.platform
-    branches: HEAD
-    tags: modelix-2@({0..9}).+({0..9})
+    version:
+      'docs/release/(*)': '$1'
     start_path: docs/global
 
 
@@ -39,20 +40,20 @@ content:
   #
   # - url: https://github.com/modelix/modelix.samples
 #  - url: ./../modelix.samples-main
-#    branches: HEAD
-#    tags: modelix-2@({0..9}).+({0..9})
+#    version:
+#      'docs/release/(*)': '$1'
 #    start_path: docs/local
 #
 #  # - url: https://github.com/modelix/modelix.core
 #  - url: ./../modelix.core-main
-#    branches: HEAD
-#    tags: modelix-2@({0..9}).+({0..9})
+#    version:
+#      'docs/release/(*)': '$1'
 #    start_path: docs/local
 #
 #  # - url: https://github.com/modelix/modelix.platform
 #  - url: ./../modelix.platform
-#    branches: HEAD
-#    tags: modelix-2@({0..9}).+({0..9})
+#    version:
+#      'docs/release/(*)': '$1'
 #    start_path: docs/local
 
 
@@ -70,8 +71,11 @@ antora:
   - require: '@antora/lunr-extension'
 
 asciidoc:
+  sourcemap: true
   attributes:
     page-pagination: true
     page-partial: true
 
-
+runtime:
+  log:
+    failure_level: error

antora-playbook.yml

@@ -4,30 +4,37 @@ site:
   start_page: modelix::index.adoc
 
 content:
+  branches: [ HEAD, 'docs/release/*' ]
   sources:
 
   #
   # GLOBAL REPOSITORIES
   # These are tied to the single 'Modelix Documentation'
   #
+  - url: ./
+    branches: HEAD # For CI builds want to use the current branch as `main` version
+    version: 'main'
+    start_path: docs
+
   - url: https://github.com/modelix/modelix.doc
-    branches: HEAD
-    tags: modelix-2@({0..9}).+({0..9})
+    branches: ['docs/release/*']
+    version:
+      'docs/release/(*)': '$1'
     start_path: docs
 
   - url: https://github.com/modelix/modelix.samples
-    branches: HEAD
-    tags: modelix-2@({0..9}).+({0..9})
+    version:
+      'docs/release/(*)': '$1'
     start_path: docs/global
 
   - url: https://github.com/modelix/modelix.core
-    branches: HEAD
-    tags: modelix-2@({0..9}).+({0..9})
+    version:
+      'docs/release/(*)': '$1'
     start_path: docs/global
 
   - url: https://github.com/modelix/modelix.platform
-    branches: HEAD
-    tags: modelix-2@({0..9}).+({0..9})
+    version:
+      'docs/release/(*)': '$1'
     start_path: docs/global
 
 
@@ -36,18 +43,18 @@ content:
   # Provides individual per repository documentation
   #
 #  - url: https://github.com/modelix/modelix.samples
-#    branches: HEAD
-#    tags: modelix-2@({0..9}).+({0..9})
+#    version:
+#      'docs/release/(*)': '$1'
 #    start_path: docs/local
 #
 #  - url: https://github.com/modelix/modelix.core
-#    branches: HEAD
-#    tags: modelix-2@({0..9}).+({0..9})
+#    version:
+#      'docs/release/(*)': '$1'
 #    start_path: docs/local
 #
 #  - url: https://github.com/modelix/modelix.platform
-#    branches: HEAD
-#    tags: modelix-2@({0..9}).+({0..9})
+#    version:
+#      'docs/release/(*)': '$1'
 #    start_path: docs/local
 
 
@@ -65,8 +72,11 @@ antora:
   - require: '@antora/lunr-extension'
 
 asciidoc:
+  sourcemap: true
   attributes:
     page-pagination: true
     page-partial: true
 
-
+runtime:
+  log:
+    failure_level: error

docs/antora.yml

@@ -1,7 +1,5 @@
 name: modelix
 title: Modelix Documentation
-version:
-  (v2@({0..9}).+({0..9})): $1
 nav:
 - modules/ROOT/partials/nav-global.adoc
 

docs/modules/ROOT/pages/tutorial/build-component.adoc

@@ -21,7 +21,8 @@ gradlew.bat build   # windows
 == IntelliJ Idea
 
 Wherever possible we use the latest https://www.jetbrains.com/idea/[IntelliJ IDEA] IDE to manage projects in our repositories.
-Consequently, opening any repository with IntelliJ will also allow you to build and eventually xref:main/contribute.adoc[contribute].
+Consequently, opening any repository with IntelliJ will also allow you to build and eventually xref:{page-component-latest-version}@modelix:ROOT:main/contribute.adoc[contribute].
+// Explicitly link to the latest contribution page
 
 
 == modelix Artifact Publication