admin-guide: add back the dynamic version info support

Signed-off-by: Hofi <hofione@gmail.com>

Author: HofiOne

.github/workflows/jekyll-gh-pages.yml

@@ -68,6 +68,10 @@ jobs:
           ./_tools/pack debug
           ls -AlR assets/js
 
+          # Update the site.config.version info in the _config.yml based on the current syslog-ng version
+          #
+          ./_tools/update_config_version
+
       - name: Build with Jekyll
         # Outputs to the './_site' directory by default
         run: |
@@ -97,6 +101,8 @@ jobs:
           ls -AlR _site/assets/js
 
           # Generate and add Doxygen source documentation
+          #
+          echo "Generating Doxygen source documentation"
           sudo apt-get install doxygen graphviz -y
 
           OSE_SRC_REPO=https://github.com/syslog-ng/syslog-ng.git
@@ -111,6 +117,8 @@ jobs:
           rm -Rf ./_work
 
           # Generate final manpages from the pre-generated special markdown files
+          #
+          echo "Generating manpages"
           INPUT_DIRECTORY=./_data/manpages
           OUTPUT_DIRECTORY=./_site/manpages
           ./_tools/mangen "${INPUT_DIRECTORY}" "${OUTPUT_DIRECTORY}"

_config.yml

@@ -258,6 +258,7 @@ footer:
 product:
   name: 'syslog-ng Open Source Edition'
   short_name: 'syslog-ng OSE'
+  # NOTE: This is updated automatically in the GitHub workflow (jekyll-gh-pages.yml) from the current syslog-ng version
   version: '4.9.0'
 
 repository: syslog-ng/syslog-ng.github.io

_tools/update_config_version

@@ -0,0 +1,9 @@
+echo "Updating version info"
+
+VERSION=$(curl -s https://raw.githubusercontent.com/syslog-ng/syslog-ng/develop/VERSION.txt)
+sed -E "s/(version: ')[0-9]+\.[0-9]+\.[0-9]+(')/\1$VERSION\2/" _config.yml > _config.yml.new
+
+mv -f _config.yml.new _config.yml
+
+echo "Version set to $VERSION"
+grep 'version:' _config.yml

doc/_admin-guide/README.md

@@ -2,7 +2,7 @@
 title: syslog-ng Open Source Edition Administration Guides
 id: adm-guide
 description: >-
-    Welcome to the {{ site.product.name }} 4.8.1 Administration Guide. This document describes how to configure and manage {{ site.product.name }} ({{ site.product.short_name }}). Background information for the technology and concepts used by the product is also discussed. 
+    Welcome to the {{ site.product.name }} {{ site.product.version }} Administration Guide. This document describes how to configure and manage {{ site.product.name }} ({{ site.product.short_name }}). Background information for the technology and concepts used by the product is also discussed.
 ---
 
 ## Target audience