docs: improve the download links in the docs

Author: mvach

.github/scripts/create-versioned-mkdocs-config.sh

@@ -2,41 +2,13 @@
 
 VERSION="${1:-latest}"
 
-# Function to generate download links for a specific version
-generate_download_links() {
-    local version="$1"
-    # Remove 'v' prefix from version for artifact names
-    local version_no_v="${version#v}"
-    
-    if [ "$version" = "latest" ]; then
-        cat << EOF
-!!! info "Development Version"
-    This is the latest development version of the documentation. For stable releases, please check the version selector above.
-    
-    [📋 View all releases](https://github.com/mvach/ctRestClient/releases)
-EOF
-    else
-        cat << EOF
-!!! success "Release ${version}"
-    This documentation is for release version ${version}.
-
-## Downloads for ${version}
-
-The following binaries are available for this version:
+# Remove 'v' prefix from version for artifact names
+VERSION_NO_V="${VERSION#v}"
 
-| Platform | Architecture | Download Link |
-|----------|--------------|---------------|
-| 🐧 Linux | x86_64 | [ctRestClient_${version_no_v}_linux_x86_64.tar.gz](https://github.com/mvach/ctRestClient/releases/download/${version}/ctRestClient_${version_no_v}_linux_x86_64.tar.gz) |
-| 🍎 macOS | Intel (x86_64) | [ctRestClient_${version_no_v}_darwin_x86_64.tar.gz](https://github.com/mvach/ctRestClient/releases/download/${version}/ctRestClient_${version_no_v}_darwin_x86_64.tar.gz) |
-| 🍎 macOS | Apple Silicon (ARM64) | [ctRestClient_${version_no_v}_darwin_arm64.tar.gz](https://github.com/mvach/ctRestClient/releases/download/${version}/ctRestClient_${version_no_v}_darwin_arm64.tar.gz) |
-| 🪟 Windows | x86_64 | [ctRestClient_${version_no_v}_windows_x86_64.tar.gz](https://github.com/mvach/ctRestClient/releases/download/${version}/ctRestClient_${version_no_v}_windows_x86_64.tar.gz) |
-
-[📋 View all release assets](https://github.com/mvach/ctRestClient/releases/tag/${version})
-EOF
-    fi
-}
+echo "Processing documentation for version: $VERSION"
 
 # Create mkdocs.yml file with version-specific content
+echo "Creating mkdocs.yml for version: $VERSION..."
 cat > mkdocs.yml << EOF
 site_name: ctRestClient
 site_description: Documentation for ctRestClient
@@ -47,13 +19,13 @@ theme:
     primary: indigo
     accent: indigo
   features:
-    - navigation.tabs  # This moves the navigation to the top as tabs
-    - navigation.tabs.sticky  # Makes the tabs sticky at the top
-    - navigation.sections  # Renders sections as groups in the sidebar
-    - navigation.expand  # Expands all collapsible sections
-    - toc.follow  # Automatically follows the table of contents on the right
-    - content.code.copy  # Add copy button to code blocks
-    - navigation.top  # Add back to top button
+    - navigation.tabs
+    - navigation.tabs.sticky
+    - navigation.sections
+    - navigation.expand
+    - toc.follow
+    - content.code.copy
+    - navigation.top
 use_directory_urls: true
 plugins:
   - search
@@ -62,8 +34,8 @@ markdown_extensions:
   - pymdownx.details
   - pymdownx.superfences
   - pymdownx.emoji:
-      emoji_index: !!python/name:materialx.emoji.twemoji
-      emoji_generator: !!python/name:materialx.emoji.to_svg
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
   - toc:
       permalink: true
 nav:
@@ -75,35 +47,19 @@ extra:
     default: latest
 EOF
 
-# Prepare documentation files with version-specific content
-# Create a temporary docs directory for processing
+# Process template files (*.md.tmp) to create versioned documentation
 if [ -d "docs" ]; then
-    # Create version info to prepend to documentation files
-    VERSION_INFO="$(generate_download_links "$VERSION")"
-    
-    # Process German manual
-    if [ -f "docs/manual-de.md" ]; then
-        {
-            echo "# ctRestClient - Benutzerhandbuch"
-            echo ""
-            echo "$VERSION_INFO"
-            echo ""
-            # Skip the first line (title) from original file and add the rest
-            tail -n +2 "docs/manual-de.md"
-        } > "docs/manual-de.md.tmp" && mv "docs/manual-de.md.tmp" "docs/manual-de.md"
+    # Process German manual template
+    if [ -f "docs/manual-de.md.tmp" ]; then
+        echo "Processing docs/manual-de.md.tmp -> docs/manual-de.md..."
+        sed -e "s/\${version}/$VERSION/g" -e "s/\${version_no_v}/$VERSION_NO_V/g" "docs/manual-de.md.tmp" > "docs/manual-de.md"
     fi
 
-    # Process English manual
-    if [ -f "docs/manual-en.md" ]; then
-        {
-            echo "# ctRestClient - User Manual"
-            echo ""
-            echo "$VERSION_INFO"
-            echo ""
-            # Skip the first line (title) from original file and add the rest
-            tail -n +2 "docs/manual-en.md"
-        } > "docs/manual-en.md.tmp" && mv "docs/manual-en.md.tmp" "docs/manual-en.md"
+    # Process English manual template
+    if [ -f "docs/manual-en.md.tmp" ]; then
+        echo "Processing docs/manual-en.md.tmp -> docs/manual-en.md..."
+        sed -e "s/\${version}/$VERSION/g" -e "s/\${version_no_v}/$VERSION_NO_V/g" "docs/manual-en.md.tmp" > "docs/manual-en.md"
     fi
 fi
 
-echo "MkDocs configuration created for version: $VERSION"
+echo "Template variables replaced successfully for version: $VERSION"

docs/manual-de.md

@@ -1,11 +1,5 @@
 # ctRestClient - Benutzerhandbuch
 
-!!! info "Development Version"
-    This is the latest development version of the documentation. For stable releases, please check the version selector above.
-    
-    [📋 View all releases](https://github.com/mvach/ctRestClient/releases)
-
-
 ## Überblick
 
 `ctRestClient` ist ein Kommandozeilen-Tool, das den Export von Gruppen aus [ChurchTools](https://church.tools/de/home/) als CSV-Dateien ermöglicht. Dies ist besonders nützlich für die Erstellung von Serienbriefen mit Tools wie Microsoft Word oder Adobe InDesign.
@@ -43,10 +37,15 @@
 ### 1. Executable herunterladen
 
 Laden Sie die entsprechende Version für Ihr Betriebssystem herunter:
-- **Windows**: `ctRestClient-windows-amd64.exe`
-- **macOS (Intel)**: `ctRestClient-darwin-amd64`
-- **macOS (Apple Silicon)**: `ctRestClient-darwin-arm64`
-- **Linux**: `ctRestClient-linux-amd64`
+
+| Plattform | Architektur | Download Link |
+|-----------|-------------|---------------|
+| 🐧 Linux | x86_64 | [ctRestClient_latest_linux_x86_64.tar.gz](https://github.com/mvach/ctRestClient/releases/download/latest/ctRestClient_latest_linux_x86_64.tar.gz) |
+| 🍎 macOS | Intel (x86_64) | [ctRestClient_latest_darwin_x86_64.tar.gz](https://github.com/mvach/ctRestClient/releases/download/latest/ctRestClient_latest_darwin_x86_64.tar.gz) |
+| 🍎 macOS | Apple Silicon (ARM64) | [ctRestClient_latest_darwin_arm64.tar.gz](https://github.com/mvach/ctRestClient/releases/download/latest/ctRestClient_latest_darwin_arm64.tar.gz) |
+| 🪟 Windows | x86_64 | [ctRestClient_latest_windows_x86_64.tar.gz](https://github.com/mvach/ctRestClient/releases/download/latest/ctRestClient_latest_windows_x86_64.tar.gz) |
+
+[📋 Alle Releases anzeigen](https://github.com/mvach/ctRestClient/releases/tag/latest)
 
 ### 2. KeePass-Datenbank einrichten