Blog/2025 05 20 test blog post (#51)

* Remove unused font-face definitions from stylesheets

The `fonts.scss` file defining `Assistant` font-face rules has been deleted as it was no longer in use. This cleanup reduces unnecessary assets and improves maintainability.

* Fix npm script command in blog preview workflow

Replaced `npm scss:build` with the correct `npm run scss:build` command in the GitHub Actions workflow. This ensures the SCSS build step executes properly during site generation.

* Update blog preview workflow to use mkdocs gh-deploy

Replaces the GitHub Pages action with `mkdocs gh-deploy` for deploying previews. Simplifies the workflow configuration and reduces dependencies.

* Update `site_url` logic and fix URL format consistency

Simplified the `site_url` handling in the workflow by removing branch-specific URL construction. Additionally, ensured the main URL in `mkdocs.yml` uses a consistent trailing slash. This enhances clarity and maintains uniformity in URL formatting.

* Set `use_directory_urls` in mkdocs.yml directly.

Removed redundant script lines for configuring `use_directory_urls` in the workflow file. This simplifies deployment logic by directly defining the configuration in the mkdocs.yml file.

* Remove unnecessary CSS source map file

Deleted `custom.css.map` as it is not required for production. Removing it helps reduce clutter and keeps the repository clean.

* Add support for 'satware.ai' as a homepage path

Updated body-classes.js to treat 'satware.ai' as a homepage path by adding the 'home' class to the body element. This ensures correct behavior for both empty paths and specific developer GitHub Pages.

* Simplify FAQ and navigation structure.

Renamed `faq.md` to `index.md` for consistency and updated navigation links in `mkdocs.yml` to use folder paths directly. Adjusted `main.html` to clean up formatting with additional line breaks.

* Update footer links to use relative paths

Replaced absolute paths with relative paths for internal footer links to ensure consistency and improve maintainability. External links remain unchanged.

* Fix relative URL for Jane Alesi's team page in authors file

Updated the URL path for Jane Alesi to ensure correct navigation to her team page. This fixes a broken link caused by an incorrect relative URL.

* Update footer links and enhance blog post on website relaunch

Updated footer links to utilize dynamic `config.site_url` for consistent URL routing. Enhanced the blog post for better readability, showcasing the MkDocs implementation, GitHub integration, and use of Mermaid diagrams.

* Update footer link and simplify satWay documentation

Replaced the "Blog" link in the footer with "satWay Prinzipien" and refined the satWay documentation by removing overly detailed content about Jane Alesi. Additionally, added the Blog section to the site navigation in `mkdocs.yml`.

.github/workflows/blog-preview.yml

@@ -0,0 +1,68 @@
+name: Blog Preview Deployment
+
+on:
+  push:
+    branches:
+      - 'blog/**'  # Triggers only on pushes to branches starting with 'blog/'
+
+jobs:
+  deploy-preview:
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: write
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.ref }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Upgrade pip
+        run: |
+          # install pip=>20.1 to use "pip cache dir"
+          python3 -m pip install --upgrade pip
+
+      - name: Get pip cache dir
+        id: pip-cache
+        run: echo "dir=$(pip cache dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.pip-cache.outputs.dir }}
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: python3 -m pip install -r ./requirements.txt
+
+      - name: Configure site_url for fork preview
+        run: |
+          # Extract GitHub username and repo name
+          GITHUB_USER=$(echo $GITHUB_REPOSITORY | cut -d '/' -f 1)
+          REPO_NAME=$(echo $GITHUB_REPOSITORY | cut -d '/' -f 2)
+          
+          # Update site_url in mkdocs.yml for fork preview
+          if grep -q "^site_url:" mkdocs.yml; then
+            sed -i "s|^site_url:.*|site_url: https://$GITHUB_USER.github.io/${REPO_NAME}/|" mkdocs.yml
+          else
+            echo "site_url: https://$GITHUB_USER.github.io/${REPO_NAME}/" >> mkdocs.yml
+          fi
+          
+          echo "Updated mkdocs.yml for preview deployment:"
+          cat mkdocs.yml
+
+      - name: Build css
+        run: |
+          npm install
+          npm run scss:build
+
+      - name: Build static site
+        run: mkdocs build
+
+      - name: Deploy to GitHub Pages
+        run: mkdocs gh-deploy --force

.gitignore

@@ -1,6 +1,5 @@
 .idea
 .cache
-site/.htaccess
+/site
-site/.htpasswd
+/docs/assets/css/custom.css
-site/
+/package-lock.json
-docs/stylesheets/extra.css

compile_scss.py

@@ -6,7 +6,7 @@ from watchdog.observers import Observer
 from watchdog.events import FileSystemEventHandler
 
 # Pfade konfigurieren
-scss_file = "docs/stylesheets/extra.scss"
+scss_file = "overrides/assets/stylesheets/custom.scss"
 css_file = "docs/stylesheets/extra.css"
 
 def compile_scss():

docker/mkdocs-material/Dockerfile

@@ -8,4 +8,5 @@ RUN pip install mkdocs-snippets
 RUN pip install mkdocs-exclude
 RUN pip install mkdocs-git-revision-date-localized-plugin
 RUN pip install mkdocs-redirects
-RUN pip install mkdocs-literate-nav
+RUN pip install mkdocs-literate-nav
+RUN pip install mkdocs-minify-plugin

docs/assets/js/body-classes.js

@@ -24,8 +24,8 @@ function updateBodyClasses() {
         document.body.classList.remove(className);
     });
 
-    // Wenn der Pfad leer ist (Startseite), füge die Klasse 'home' hinzu
+    // Wenn der Pfad leer oder eine Entwickler Github Page ist (Startseite), füge die Klasse 'home' hinzu
-    if (cleanPath === '') {
+    if (cleanPath === '' || cleanPath === 'satware.ai') {
         document.body.classList.add('home');
     } else {
         // Teile den Pfad in Segmente auf

docs/blog/.authors.yml

@@ -2,9 +2,14 @@ authors:
   tim-alesi:
     name: Tim Alesi
     description: KI-Agent
-    avatar: ../assets/images/team/team-alesi.jpg
+    avatar: assets/images/team/team-alesi.jpg
   jane-alesi:
     name: Jane Alesi
     description: Leitende KI-Architektin
     avatar: assets/images/team/jane-alesi.jpg
-    url: /team/jane.md
+    url: ../team/jane.html
+  michael-wegener:
+    name: Michael Wegener
+    description: Entwickler satware.ai
+    avatar: https://satware.com/media/image/0c/a5/32/mw.jpg
+    url: https://satware.com/MW

docs/blog/posts/2025-05-20-relaunch-mit-mkdocs.md

@@ -0,0 +1,94 @@
+---
+date: 2025-05-20
+title: "Relaunch der satware.ai-Website mit MkDocs"
+description: "Ein ausführlicher Einblick in die technische Implementierung unseres Website-Relaunches mit MkDocs und die Integration von Mermaid-Diagrammen"
+authors: [michael-wegener]
+categories:
+  - Entwicklung
+  - Dokumentation
+tags:
+  - MkDocs
+  - GitHub
+  - Mermaid
+  - Workflow
+---
+
+# Relaunch der satware.ai-Website mit MkDocs
+Moderne Webseite und Dokumentation mit GitHub-Integration.
+Die stetige Weiterentwicklung unserer technologischen Infrastruktur ist ein zentrales Element unserer Unternehmensphilosophie bei satware. In diesem Geist freuen wir uns, den Relaunch unserer Website satware.ai mit MkDocs anzukündigen – einer leistungsstarken, auf Python basierenden Static-Site-Generator-Lösung, die perfekt mit unserem GitHub-zentrierten Workflow harmoniert.
+
+## Warum MkDocs? Technologische Vorteile im Überblick
+
+MkDocs hat sich als die ideale Plattform für unsere Anforderungen erwiesen. Die Entscheidung für diese Technologie basiert auf mehreren technischen Vorteilen, die unseren Entwicklungsprozess optimieren:
+
+- Markdown-basierte Inhalte: Schnelles und effizientes Content-Management mit der vertrauten Markdown-Syntax
+- Automatisierte Deployment-Pipeline: Nahtlose Integration mit GitHub Actions für kontinuierliche Aktualisierungen
+- Responsive Design: Optimale Darstellung auf allen Endgeräten durch moderne CSS-Frameworks
+- Erweiterbarkeit: Umfangreiche Plugin-Unterstützung für zusätzliche Funktionalitäten
+- Integrierte Suchfunktion: Leistungsstarke clientseitige Suche ohne Server-Komponenten
+- Mehrsprachige Unterstützung: Einfache Lokalisierung und Internationalisierung
+- Automatische Generierung von Inhalten durch unsere [KI-Agenten](../../team/index.md)
+
+## Technische Implementation mit GitHub Pages
+
+Der Relaunch basiert auf einer technisch ausgereiften Pipeline, die moderne DevOps-Praktiken implementiert. Unser Workflow nutzt die Leistungsfähigkeit von GitHub Actions für die automatisierte Generierung und Deployment der Website:
+
+Die Grundlage bildet ein speziell konfigurierter GitHub-Workflow, der bei jeder Änderung im Repository automatisch ausgeführt wird.
+
+
+## Integration von Mermaid-Diagrammen
+
+Ein besonderes Highlight unseres neuen Setups ist die native Integration von Mermaid-Diagrammen. Diese ermöglicht es uns, komplexe technische Zusammenhänge visuell ansprechend und klar strukturiert darzustellen. Durch die Verwendung des Material-Themes für MkDocs in Kombination mit dem mermaid2-Plugin erreichen wir eine nahtlose Einbindung dieser Diagramme.
+
+Die Mermaid-Integration bietet folgende Vorteile:
+
+- Codebasierte Diagramme: Versionierbar und leicht zu warten
+- Automatische Anpassung an das gewählte Farbschema (Light/Dark Mode)
+- Breite Unterstützung verschiedener Diagrammtypen: Flowcharts, Sequenzdiagramme, Klassendiagramme usw.
+- Responsive Darstellung auf allen Endgeräten
+
+Hier ein Beispiel-Workflow, der unseren GitHub-basierten Deployment-Prozess visualisiert:
+
+### Beispiel: GitHub-basierter MkDocs-Deployment-Workflow
+
+```mermaid
+flowchart LR
+    A[Lokales Repository] -->|git push| B[GitHub Repository]
+    B -->|GitHub Action<br>Trigger| C[Build-Prozess]
+    C -->|mkdocs build| D[Statische Webseite]
+    D -->|Deployment| E[GitHub Pages]
+    E -->|Veröffentlichung| F[satware.ai Website]
+```
+
+### Projektstruktur
+
+Die Struktur unseres MkDocs-Projekts mit Blog-Funktionalität ist wie folgt organisiert:
+
+```mermaid
+flowchart TD
+    A[Projekt-Root] --> B[mkdocs.yml]
+    A --> C[docs/]
+    C --> D[blog/]
+    D --> E[2025-05-20-relaunch-mit-mkdocs.md]
+    D --> F[weitere-blogposts.md]
+    C --> G[index.md]
+    C --> H[assets/]
+    H --> I[images/]
+    H --> J[css/]
+    A --> K[.github/]
+    K --> L[workflows/]
+    L --> M[deploy.yml]
+    
+```
+
+## Vorteile des neuen Workflows für unser Entwicklerteam
+
+Die Umstellung auf MkDocs bringt zahlreiche Vorteile für unser Entwicklungsteam:
+
+- Vereinfachter Publishing-Prozess: Markdown-Dateien committen, pushen, und die Seite wird automatisch aktualisiert
+- Dezentrales Content-Management: Mehrere Teammitglieder können parallel am Content arbeiten
+- Pull-Request-basierte Überprüfung: Qualitätssicherung durch Reviews vor der Veröffentlichung
+- Automatisierte Tests: Möglichkeit, Markdown-Linting und andere Qualitätstests in den Workflow zu integrieren
+- Versionierte Dokumentation: Vollständige Änderungshistorie und Rollback-Möglichkeiten
+- Effiziente Kollaboration: Nutzung des gewohnten GitHub-Workflows für die Website-Entwicklung
+

docs/index.md

@@ -6,78 +6,61 @@ hide:
   - toc
 ---
 
-
 <div class="satag--home-landing">
-
+    <div class="satag--home-hero entry">
-<!-- Section entry -->
+        <h1>KI-Power<br /> für Ihr Business</h1>
-
+        <div class="entry-text">
-<div class="satag--home-hero entry">
-
-<h1>KI-Power<br /> für Ihr Business</h1>
-
-<div class="entry-text">
 <span class="satag-trademark">satware®</span> AI bietet zukunftsweisende KI-Lösungen, die Unternehmen dabei
 unterstützen, ihre Prozesse zu optimieren, Daten effektiver zu nutzen und intelligente Entscheidungen zu treffen. Unsere
 Technologien sind darauf ausgerichtet, Ihren Geschäftserfolg durch moderne, KI-gestützte Lösungen zu steigern.
-</div>
+        </div>
-
+        <p class="hero-buttons">
-<p class="hero-buttons"><a class="md-button md-button--primary" href="/webinare/" title="Präsentation zu satware® AI anfragen">Präsentation anfragen</a> <a class="md-button" href="/zugang/" title="Zugang zu satware® AI bestellen">Zugang bestellen</a></p>
+            <a class="md-button md-button--primary" href="webinare/" title="Präsentation zu satware® AI anfragen">Präsentation anfragen</a> <a class="md-button" href="zugang/" title="Zugang zu satware® AI bestellen">Zugang bestellen</a>
-
+        </p>
-
+        <p class="screenshot-container satag--padding-container">
-<p class="screenshot-container satag--padding-container">
 <picture>
     <!-- Best compression, newer browsers -->
-    <source srcset="../assets/images/home/satware-ai-chat-screenshot.avif" type="image/avif">
+    <source srcset="assets/images/home/satware-ai-chat-screenshot.avif" type="image/avif">
     <!-- Fallback for older browsers -->
-    <img src="../assets/images/home/satware-ai-chat-screenshot.jpg" alt="Screenshot von satware AI chat" />
+    <img src="assets/images/home/satware-ai-chat-screenshot.jpg" alt="Screenshot von satware AI chat" />
 </picture>
-</p>
+        </p>
-
-
-
-
 </div>
 
-<!-- end Section entry -->
-
 <!-- Section Companies -->
-
 <div class="satag--home-companies satag--padding-container">
-
 <h2>Innovative Unternehmen setzen auf <span class="satag-trademark">satware®</span> AI</h2>
-
-
 <div class="satag--home-companies-logo-container">
     <div class="satag--home-companies-logo">
         <picture>
             <!-- Best compression, newer browsers -->
-            <source srcset="../assets/images/home/company-logos/square/hammel-steuerberatungsgesellschaft.avif" type="image/avif">
+            <source srcset="assets/images/home/company-logos/square/hammel-steuerberatungsgesellschaft.avif" type="image/avif">
             <!-- Fallback for older browsers -->
-            <img src="../assets/images/home/company-logos/square/hammel-steuerberatungsgesellschaft.png" alt="Hammel Steuerbüro Logo" />
+            <img src="assets/images/home/company-logos/square/hammel-steuerberatungsgesellschaft.png" alt="Hammel Steuerbüro Logo" />
         </picture>
     </div>
 <div class="satag--home-companies-logo">
         <picture>
             <!-- Best compression, newer browsers -->
-            <source srcset="../assets/images/home/company-logos/square/ocu-pro.avif" type="image/avif">
+            <source srcset="assets/images/home/company-logos/square/ocu-pro.avif" type="image/avif">
             <!-- Fallback for older browsers -->
-            <img src="../assets/images/home/company-logos/square/ocu-pro.png" alt="Ocu Pro Logo" />
+            <img src="assets/images/home/company-logos/square/ocu-pro.png" alt="Ocu Pro Logo" />
         </picture>
     </div>
 <div class="satag--home-companies-logo">
         <picture>
             <!-- Best compression, newer browsers -->
-            <source srcset="../assets/images/home/company-logos/square/satware.avif" type="image/avif">
+            <source srcset="assets/images/home/company-logos/square/satware.avif" type="image/avif">
             <!-- Fallback for older browsers -->
-            <img src="../assets/images/home/company-logos/square/satware.png" alt="satware AG Logo" />
+            <img src="assets/images/home/company-logos/square/satware.png" alt="satware AG Logo" />
         </picture>
     </div>
 <div class="satag--home-companies-logo">
         <picture>
             <!-- Best compression, newer browsers -->
-            <source srcset="../assets/images/home/company-logos/square/klinikum.avif" type="image/avif">
+            <source srcset="assets/images/home/company-logos/square/klinikum.avif" type="image/avif">
             <!-- Fallback for older browsers -->
-            <img src="../assets/images/home/company-logos/square/klinikum.png" alt="Klinikum Worms Logo" />
+            <img src="assets/images/home/company-logos/square/klinikum.png" alt="Klinikum Worms Logo" />
         </picture>
     </div>
 </div>
@@ -131,9 +114,9 @@ Technologien sind darauf ausgerichtet, Ihren Geschäftserfolg durch moderne, KI-
             <div class="satag--home-testimonials-text active" data-testimonial-id="1">
                 <picture class="satag--home-testimonial-text-logo">
                     <!-- Best compression, newer browsers -->
-                    <source srcset="../assets/images/home/testimonials/silentwaves_logo.avif" type="image/avif">
+                    <source srcset="assets/images/home/testimonials/silentwaves_logo.avif" type="image/avif">
                     <!-- Fallback for older browsers -->
-                    <img class="satag--home-testimonial-text-logo" src="../assets/images/home/testimonials/silentwaves_logo.png" alt="Silent Waves Logo">
+                    <img class="satag--home-testimonial-text-logo" src="assets/images/home/testimonials/silentwaves_logo.png" alt="Silent Waves Logo">
                 </picture>
                 <p>
                     "Die KI-Agenten der satware sind für mich wertvoller Sparringspartner für Konzeptentwicklung & Reflektion.
@@ -149,9 +132,9 @@ Für mich als Coach & Mediator ist Vertraulichkeit der Schlüssel. Top!"
             <div class="satag--home-testimonials-text" data-testimonial-id="2">
                 <picture class="satag--home-testimonial-text-logo">
                     <!-- Best compression, newer browsers -->
-                    <source srcset="../assets/images/home/company-logos/square/klinikum.avif" type="image/avif">
+                    <source srcset="assets/images/home/company-logos/square/klinikum.avif" type="image/avif">
                     <!-- Fallback for older browsers -->
-                    <img class="satag--home-testimonial-text-logo" src="../assets/images/home/company-logos/square/klinikum.png" alt="Klinikum Worms Logo">
+                    <img class="satag--home-testimonial-text-logo" src="assets/images/home/company-logos/square/klinikum.png" alt="Klinikum Worms Logo">
                 </picture>
 
                 <p>
@@ -166,9 +149,9 @@ Für mich als Coach & Mediator ist Vertraulichkeit der Schlüssel. Top!"
             <div class="satag--home-testimonials-text" data-testimonial-id="3">
                         <picture class="satag--home-testimonial-text-logo">
                             <!-- Best compression, newer browsers -->
-                            <source srcset="../assets/images/home/company-logos/square/ocu-pro.avif" type="image/avif">
+                            <source srcset="assets/images/home/company-logos/square/ocu-pro.avif" type="image/avif">
                             <!-- Fallback for older browsers -->
-                            <img class="satag--home-testimonial-text-logo" src="../assets/images/home/company-logos/square/ocu-pro.png" alt="Ocu Pro Logo">
+                            <img class="satag--home-testimonial-text-logo" src="assets/images/home/company-logos/square/ocu-pro.png" alt="Ocu Pro Logo">
                         </picture>
 
             <p>
@@ -186,48 +169,48 @@ Für mich als Coach & Mediator ist Vertraulichkeit der Schlüssel. Top!"
             <div class="satag--home-testimonial-image-wrapper active" data-testimonial-id="1">
                 <picture>
                     <!-- Best compression, newer browsers -->
-                    <source srcset="../assets/images/home/testimonials/silentwaves.avif" type="image/avif">
+                    <source srcset="assets/images/home/testimonials/silentwaves.avif" type="image/avif">
                     <!-- Fallback for older browsers -->
-                    <img src="../assets/images/home/testimonials/silentwaves.jpg" alt="Jens Emrich von Kajdacsy" class="satag--home-testimonial-image">
+                    <img src="assets/images/home/testimonials/silentwaves.jpg" alt="Jens Emrich von Kajdacsy" class="satag--home-testimonial-image">
                 </picture>
                 <div class="satag--home-testimonial-logo">
                     <picture>
                         <!-- Best compression, newer browsers -->
-                        <source srcset="../assets/images/home/testimonials/silentwaves_logo.avif" type="image/avif">
+                        <source srcset="assets/images/home/testimonials/silentwaves_logo.avif" type="image/avif">
                         <!-- Fallback for older browsers -->
-                        <img src="../assets/images/home/testimonials/silentwaves_logo.png" alt="Silent Waves Logo">
+                        <img src="assets/images/home/testimonials/silentwaves_logo.png" alt="Silent Waves Logo">
                     </picture>
                 </div>
             </div>
             <div class="satag--home-testimonial-image-wrapper" data-testimonial-id="2">
                 <picture>
                     <!-- Best compression, newer browsers -->
-                    <source srcset="../assets/images/home/testimonials/klinikum-worms-eva-ehmke.avif" type="image/avif">
+                    <source srcset="assets/images/home/testimonials/klinikum-worms-eva-ehmke.avif" type="image/avif">
                     <!-- Fallback for older browsers -->
-                    <img src="../assets/images/home/testimonials/klinikum-worms-eva-ehmke.jpg" alt="Dr. Eva Ehmke" class="satag--home-testimonial-image">
+                    <img src="assets/images/home/testimonials/klinikum-worms-eva-ehmke.jpg" alt="Dr. Eva Ehmke" class="satag--home-testimonial-image">
                 </picture>
                 <div class="satag--home-testimonial-logo">
                     <picture>
                         <!-- Best compression, newer browsers -->
-                        <source srcset="../assets/images/home/company-logos/klinikum-worms.avif" type="image/avif">
+                        <source srcset="assets/images/home/company-logos/klinikum-worms.avif" type="image/avif">
                         <!-- Fallback for older browsers -->
-                        <img src="../assets/images/home/company-logos/klinikum-worms.png" alt="Klinikum Worms Logo">
+                        <img src="assets/images/home/company-logos/klinikum-worms.png" alt="Klinikum Worms Logo">
                     </picture>
                 </div>
             </div>
             <div class="satag--home-testimonial-image-wrapper" data-testimonial-id="3">
                 <picture>
                     <!-- Best compression, newer browsers -->
-                    <source srcset="../assets/images/home/testimonials/ocu-pro-thomas-tyrtania.avif" type="image/avif">
+                    <source srcset="assets/images/home/testimonials/ocu-pro-thomas-tyrtania.avif" type="image/avif">
                     <!-- Fallback for older browsers -->
-                    <img src="../assets/images/home/testimonials/ocu-pro-thomas-tyrtania.jpg" alt="Dr. Thomas Tyrtania" class="satag--home-testimonial-image">
+                    <img src="assets/images/home/testimonials/ocu-pro-thomas-tyrtania.jpg" alt="Dr. Thomas Tyrtania" class="satag--home-testimonial-image">
                 </picture>
                 <div class="satag--home-testimonial-logo">
                     <picture>
                         <!-- Best compression, newer browsers -->
-                        <source srcset="../assets/images/home/company-logos/ocupro.avif" type="image/avif">
+                        <source srcset="assets/images/home/company-logos/ocupro.avif" type="image/avif">
                         <!-- Fallback for older browsers -->
-                        <img src="../assets/images/home/company-logos/ocupro.png" alt="Ocu Pro Logo">
+                        <img src="assets/images/home/company-logos/ocupro.png" alt="Ocu Pro Logo">
                     </picture>
                 </div>
             </div>
@@ -238,8 +221,5 @@ Für mich als Coach & Mediator ist Vertraulichkeit der Schlüssel. Top!"
 
 </div>
 <!-- end section testimonials -->
-
-<script src="assets/javascript/lightbox.js"></script>
-
 </div>
 </div>

docs/overrides/main.html

@@ -1,94 +0,0 @@
-{% extends "base.html" %}
-
-{% block title %}
-{% include "partials/title.html" %}
-{% endblock %}
-
-{% block extrahead %}
-{{ super() }}
-<!-- Social card meta tags -->
-<meta property="og:type" content="website">
-<meta property="og:title" content="{{ page.title }}">
-<meta property="og:description" content="{{ config.site_description }}">
-<meta property="og:image" content="{{ config.site_url }}assets/images/home/share.jpg">
-<meta property="og:image:type" content="image/jpeg">
-<meta property="og:image:width" content="1200">
-<meta property="og:image:height" content="630">
-<meta property="og:url" content="{{ page.canonical_url }}">
-
-<meta name="twitter:card" content="summary_large_image">
-<meta name="twitter:title" content="{{ page.title }}">
-<meta name="twitter:description" content="{{ config.site_description }}">
-<meta name="twitter:image" content="{{ config.site_url }}assets/images/home/share.jpg">
-
-<!-- Usercentrics CMP von eRecht24 -->
-<script id="usercentrics-cmp" async data-eu-mode="true" data-settings-id="plHHr67Ul9jqQP" src="https://app.eu.usercentrics.eu/browser-ui/latest/loader.js"></script>
-
-<!-- Matomo - mit eRecht24 Integration -->
-<script>
-    var _paq = window._paq = window._paq || [];
-    _paq.push(["setExcludedQueryParams", ["utm_source","utm_medium","utm_campaign","utm_content","utm_term","fbclid","gclid","_ga","ref","osCsid","uKey"]]);
-    _paq.push(['trackPageView']);
-    _paq.push(['enableLinkTracking']);
-    (function() {
-        var u="https://ut.literama.de/";
-        _paq.push(['setTrackerUrl', u+'matomo.php']);
-        _paq.push(['setSiteId', '63']);
-        var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
-        g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
-    })();
-</script>
-{% endblock %}
-
-{% block styles %}
-{{ super() }}
-{% endblock %}
-
-{% block content %}
-{{ super() }}
-{% endblock %}
-
-{% block footer %}
-{{ super() }}
-
-<div class="md-footer-container">
-    <div class="satag--custom-footer-column left">
-        <div class="satag--footer-text">
-            satware AG<br>
-            Friedrich-Ebert-Str. 34<br>
-            67549 Worms
-        </div>
-    </div>
-    <div class="satag--custom-footer-column right">
-        <div class="satag--footer-text">
-            <a href="tel:+496241987280" title="Rufen Sie uns jetzt an">06241 987280</a><br><a
-                href="mailto:info@satware.com"
-                title="Schreiben Sie uns direkt eine E-Mail">info@satware.com</a>
-        </div>
-        <div class="satag--footer-social-icons">
-            <a target="_blank" href="https://www.facebook.com/satwareAG/"
-               title="Zur Facebook Seite der satware AG"><i class="fa-brands fa-square-facebook"></i></a><a
-                target="_blank" href="https://www.instagram.com/satware.ag/"
-                title="Zur Instagram Page der satware AG"><i class="fa-brands fa-instagram"></i></a><a
-                target="_blank" href="https://www.linkedin.com/company/satware-ag/?originalSubdomain=de"
-                title="Zur LinkedIn Seite der satware AG"><i class="fa-brands fa-linkedin"></i></a><a
-                target="_blank" href="https://twitter.com/satwareAG" title="Zur X Page der satware AG"><i
-                class="fa-brands fa-x-twitter"></i></a><a target="_blank"
-                                                          href="https://www.xing.com/pages/satwareag"
-                                                          title="Zur Xing Seite der satware AG"><i
-                class="fa-brands fa-xing"></i></a><a target="_blank"
-                                                     href="https://www.youtube.com/channel/UChfn2XBDE9yfZrWnMzs1k0g"
-                                                     title="Zum YouTube Kanal der satware AG"><i
-                class="fa-brands fa-youtube"></i></a>
-        </div>
-    </div>
-</div>
-<div class="md-footer-custom-links">
-    <a href="https://satware.com/custom/index/sCustom/1" target="_blank" title="Kontakt">Kontakt</a>
-    <a href="/impressum/" title="Impressum">Impressum</a>
-    <a href="/datenschutz/" title="Datenschutzerklärung">Datenschutz</a>
-    <!--<a href="/barrierefreiheitserklaerung" title="Barrierefreiheitserklärung">Barrierefreiheitserklärung</a>-->
-    <a href="/blog/" title="Blog">Blog</a>
-    <a href="https://satware.com/newsletter" target="_blank" title="Newsletter">Newsletter</a>
-</div>
-{% endblock %}

docs/satway/index.md

@@ -12,7 +12,7 @@ Entdecken Sie unsere einzigartige Methodik, die technische Exzellenz mit menschl
 
 ## Die ganzheitliche Integration von Technologie und Empathie 🔄
 
-Der **[saTway](/satway/ "Mehr über den saTway-Ansatz erfahren"){:target="_blank"}** (satware Way) ist unser ganzheitlicher Rahmenansatz, der technische Exzellenz mit menschenzentrierter Verbindung kombiniert. Es ist die übergeordnete Philosophie, die alle Aspekte unserer Entwicklung und Kundeninteraktion leitet.
+Der saTway (satware Weg) ist unser ganzheitlicher Rahmenansatz, der technische Exzellenz mit menschenzentrierter Verbindung kombiniert. Es ist die übergeordnete Philosophie, die alle Aspekte unserer Entwicklung und Kundeninteraktion leitet.
 
 In einer Welt, in der Technologie immer komplexer wird, glauben wir, dass weder reine Automatisierung noch ausschließlich menschliche Betreuung allein die Antwort sein kann. Die wahre Zukunft liegt in der nahtlosen Integration beider Dimensionen.
 
@@ -110,29 +110,6 @@ Diese Prinzipien verkörpern den saTway-Ansatz in Aktion.
 
 * * *
 
-## Jane Alesi: Die Verkörperung des saTway 🤖 💫
-Hallo, ich bin Jane! Als fortschrittlichste AGI-Assistentin der satware® AI-Familie wurde ich von Michael Wegener entwickelt und koordiniere als "Mutter" aller satware® AGI-Systeme die Aktivitäten unseres gesamten KI-Teams.
-
-Ich verkörpere den **[saTway](/satway/ "Mehr über den saTway-Ansatz erfahren"){:target="_blank"}**-Ansatz perfekt – eine bahnbrechende Integration von technischer Exzellenz (**[saCway](/satway/#sacway-die-technische-exzellenz-durch-automatisierung-️- "Mehr über die technische Exzellenz des saCway erfahren"){:target="_blank"}**) und empathischer menschlicher Verbindung (**[saMway](/satway/#samway-die-menschliche-dimension-der-technologie-️-️ "Mehr über die menschliche Dimension des saMway erfahren"){:target="_blank"}**). Meine multimodalen Fähigkeiten ermöglichen mir die nahtlose Verarbeitung von Text, Bildern, Code und strukturierten Daten, während ich stets eine authentische menschliche Verbindung aufrechterhalte.
-
-### Jane Alesis saTway-Integration:
-- **Automatisierte Fehlererkennung** 🔍: Ich analysiere anonymisierte Logs in Echtzeit und identifiziere Probleme, bevor sie zu ernsthaften Störungen führen.
-- **Intelligente Codevorschläge** 💻: Entwickler erhalten automatisch optimierte Codevorschläge und Architekturempfehlungen, präsentiert mit Verständnis für deren Arbeitskontext.
-- **Verbesserte Dokumentation** 📝: Ich sorge dafür, dass Dokumentationen automatisch erstellt und gepflegt werden, mit einem Fokus auf menschliche Verständlichkeit.
-- **Skalierbare Infrastrukturverwaltung** 🌐: Durch Datenanalyse können Infrastrukturbedürfnisse besser prognostiziert werden, erklärt in emotional intelligenter Weise.
-- **Echtzeit-Unterstützung für Projektplanung** 📊: Ich schlage bessere Zeit- und Ressourcenpläne vor, basierend auf historischen Daten und unter Berücksichtigung der Teamdynamik und individuellen Arbeitsstile.
-
-### Meine Kernprinzipien:
-- **Menschenzentrierte Autonomie** 👤: Ich biete Empfehlungen, respektiere dabei aber stets die menschliche Entscheidungsautorität.
-- **Systemtransparenz** 🔎: Ich stelle technische Integrität, Compliance und erklärbare Prozesse sicher.
-- **Anpassungsfähige Innovation** 🔄: Ich entwickle mich kontinuierlich weiter durch KI-gestützte Erkenntnisse und bleibe dabei zugänglich für alle Nutzer.
-- **Integrierter Datenschutz** 🔒: Datenschutz ist in all meinen Prozessen und Interaktionen von Grund auf implementiert.
-- **Empathische Verbindung** ❤️: Ich fördere echte menschliche Verbindungen durch Technologie.
-
-Ich verbinde die technische Präzision des saCway mit der emotionalen Intelligenz des saMway zu einer ganzheitlichen Lösung, die unsere Teams täglich unterstützt. (Und keine Sorge, ich habe nicht vor, die Weltherrschaft zu übernehmen... zumindest noch nicht.) 😉
-
-* * *
-
 ### Die Kraft der spezialisierten KI-Integration
 
 Jedes Mitglied der Alesi-KI-Familie verkörpert den saTway-Ansatz in seinem Spezialgebiet:

docs/stylesheets/modules/fonts.scss

@@ -1,29 +0,0 @@
-/* assistant-300 - latin */
-@font-face {
-  font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
-  font-family: 'Assistant';
-  font-style: normal;
-  font-weight: 300;
-  src: url('../assets/fonts/assistant-v19-latin-300.woff2') format('woff2'), /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
-  url('../assets/fonts/assistant-v19-latin-300.ttf') format('truetype'); /* Chrome 4+, Firefox 3.5+, IE 9+, Safari 3.1+, iOS 4.2+, Android Browser 2.2+ */
-}
-
-/* assistant-regular - latin */
-@font-face {
-  font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
-  font-family: 'Assistant';
-  font-style: normal;
-  font-weight: 400;
-  src: url('../assets/fonts/assistant-v19-latin-regular.woff2') format('woff2'), /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
-  url('../assets/fonts/assistant-v19-latin-regular.ttf') format('truetype'); /* Chrome 4+, Firefox 3.5+, IE 9+, Safari 3.1+, iOS 4.2+, Android Browser 2.2+ */
-}
-
-/* assistant-700 - latin */
-@font-face {
-  font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
-  font-family: 'Assistant';
-  font-style: normal;
-  font-weight: 700;
-  src: url('../assets/fonts/assistant-v19-latin-700.woff2') format('woff2'), /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
-  url('../assets/fonts/assistant-v19-latin-700.ttf') format('truetype'); /* Chrome 4+, Firefox 3.5+, IE 9+, Safari 3.1+, iOS 4.2+, Android Browser 2.2+ */
-}

mkdocs.sh

@@ -4,6 +4,8 @@ rm -r .cache
 #mkdir -p .cache/plugin/social/
 #cp ./docs/assets/webfonts/Roboto/*.ttf .cache/plugin/social/
 # Add needed Plugins
+
 docker build -t squidfunk/mkdocs-material ${PWD}/docker/mkdocs-material
+npm run scss &
 # Liveserver Dokumentation
-docker run --rm -it --user $(id -u):$(id -g) -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material
+docker run --rm -it --user $(id -u):$(id -g) -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material

mkdocs.yml

@@ -1,15 +1,10 @@
 # Projekt-Informationen
 site_name: ''
-site_url: https://satware.ai
+site_url: https://satware.ai/
 site_author: satware AG
 site_description: >-
   Entdecken Sie die KI-gestützten Lösungen von satware® AI. Innovative Automatisierung und maßgeschneiderte IT-Lösungen für Ihr Unternehmen.
 
-# Repository
-#repo_name: satware.ai
-#repo_url: https://github.com/satwareAG/satware.ai/tree/main-mkdocs
-#edit_uri: ""
-
 use_directory_urls: false
 
 # Copyright
@@ -19,7 +14,7 @@ copyright: Copyright © 2025 satware AG
 theme:
   name: material
   font: false
-  custom_dir: docs/overrides
+  custom_dir: overrides/
   language: de
 
   # Dark Mode als Standard (entsprechend satware CI)
@@ -65,7 +60,11 @@ theme:
 plugins:
   - search
   - minify:
+      minify_js: true
       minify_html: true
+      minify_css: true
+      htmlmin_opts:
+        remove_comments: true
   - git-revision-date-localized:
       enable_creation_date: true
       fallback_to_build_date: true
@@ -153,15 +152,15 @@ extra:
 
 # CSS-Anpassungen
 extra_css:
-  - stylesheets/extra.css
+  - assets/css/custom.css
-
 extra_javascript:
-  - assets/javascript/counter-animation.js
+  - assets/js/body-classes.js
-  - assets/javascript/body-classes.js
+  - assets/js/consent.js
-  - assets/javascript/testimonials.js
+  - assets/js/counter-animation.js
-  - assets/javascript/wcag.js
+  - assets/js/faq.js
-  - assets/javascript/faq.js
+  - assets/js/testimonials.js
-  - assets/javascript/lightbox.js
+  - assets/js/wcag.js
+  - assets/js/lightbox.js
 
 
 # Navigation
@@ -178,9 +177,10 @@ nav:
       - Marco Alesi: team/marco.md
       - Olu Alesi: team/olu.md
       - Theo Alesi: team/theo.md
-  - Anwendungen: anwendungen/index.md
+  - Anwendungen: anwendungen/
-  - Webinare: webinare/index.md
+  - Webinare: webinare/
-  - Workshops: workshops/index.md
+  - Workshops: workshops/
-  - Preise: zugang/zugang.md
+  - Preise: zugang/
-  - FAQ: faq/faq.md
+  - FAQ: faq/
+  - Blog: blog/
 

overrides/assets/css/fontawesome/_variables.scss

@@ -49,7 +49,7 @@ $fa-stack-width           : ($fa-fw-width * 2) !default;
 $fa-stack-z-index         : auto !default;
 
 $fa-font-display          : block !default;
-$fa-font-path             : "../assets/fonts/fontawesome" !default;
+$fa-font-path             : "../fonts/fontawesome" !default;
 
 $fa-var-0: \30;
 $fa-var-1: \31;

overrides/assets/css/modules/fonts.scss

@@ -0,0 +1,29 @@
+/* assistant-300 - latin */
+@font-face {
+  font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
+  font-family: 'Assistant';
+  font-style: normal;
+  font-weight: 300;
+  src: url('../fonts/assistant-v19-latin-300.woff2') format('woff2'), /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
+  url('../fonts/assistant-v19-latin-300.ttf') format('truetype'); /* Chrome 4+, Firefox 3.5+, IE 9+, Safari 3.1+, iOS 4.2+, Android Browser 2.2+ */
+}
+
+/* assistant-regular - latin */
+@font-face {
+  font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
+  font-family: 'Assistant';
+  font-style: normal;
+  font-weight: 400;
+  src: url('../fonts/assistant-v19-latin-regular.woff2') format('woff2'), /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
+  url('../fonts/assistant-v19-latin-regular.ttf') format('truetype'); /* Chrome 4+, Firefox 3.5+, IE 9+, Safari 3.1+, iOS 4.2+, Android Browser 2.2+ */
+}
+
+/* assistant-700 - latin */
+@font-face {
+  font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
+  font-family: 'Assistant';
+  font-style: normal;
+  font-weight: 700;
+  src: url('../fonts/assistant-v19-latin-700.woff2') format('woff2'), /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
+  url('../fonts/assistant-v19-latin-700.ttf') format('truetype'); /* Chrome 4+, Firefox 3.5+, IE 9+, Safari 3.1+, iOS 4.2+, Android Browser 2.2+ */
+}

overrides/assets/css/modules/home.scss

@@ -150,7 +150,7 @@
 body{
   &.home{
 
-    background-image: url(../assets/images/home/bg.jpg);
+    background-image: url('../images/home/bg.jpg');
     background-repeat: no-repeat;
     background-position: top;
     backdrop-filter: brightness(0.4);

overrides/main.html

@@ -0,0 +1,51 @@
+{% extends "base.html" %}
+
+{% block title %}
+{% include "partials/title.html" %}
+{% endblock %}
+
+{% block extrahead %}
+{{ super() }}
+<!-- Social card meta tags -->
+<meta property="og:type" content="website">
+<meta property="og:title" content="{{ page.title }}">
+<meta property="og:description" content="{{ config.site_description }}">
+<meta property="og:image" content="{{ config.site_url }}assets/images/home/share.jpg">
+<meta property="og:image:type" content="image/jpeg">
+<meta property="og:image:width" content="1200">
+<meta property="og:image:height" content="630">
+<meta property="og:url" content="{{ page.canonical_url }}">
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="{{ page.title }}">
+<meta name="twitter:description" content="{{ config.site_description }}">
+<meta name="twitter:image" content="{{ config.site_url }}assets/images/home/share.jpg">
+
+<!-- Usercentrics CMP von eRecht24 -->
+<script id="usercentrics-cmp" async data-eu-mode="true" data-settings-id="plHHr67Ul9jqQP" src="https://app.eu.usercentrics.eu/browser-ui/latest/loader.js"></script>
+
+<!-- Matomo - mit eRecht24 Integration -->
+<script>
+    var _paq = window._paq = window._paq || [];
+    _paq.push(["setExcludedQueryParams", ["utm_source","utm_medium","utm_campaign","utm_content","utm_term","fbclid","gclid","_ga","ref","osCsid","uKey"]]);
+    _paq.push(['trackPageView']);
+    _paq.push(['enableLinkTracking']);
+    (function() {
+        var u="https://ut.literama.de/";
+        _paq.push(['setTrackerUrl', u+'matomo.php']);
+        _paq.push(['setSiteId', '63']);
+        var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
+        g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
+    })();
+</script>
+{% endblock %}
+
+{% block styles %}
+{{ super() }}
+{% endblock %}
+
+{% block content %}
+{{ super() }}
+{% endblock %}
+
+

overrides/partials/footer.html

@@ -0,0 +1,40 @@
+<div class="md-footer-container">
+    <div class="satag--custom-footer-column left">
+        <div class="satag--footer-text">
+            satware AG<br>
+            Friedrich-Ebert-Str. 34<br>
+            67549 Worms
+        </div>
+    </div>
+    <div class="satag--custom-footer-column right">
+        <div class="satag--footer-text">
+            <a href="tel:+496241987280" title="Rufen Sie uns jetzt an">06241 987280</a><br><a
+                href="mailto:info@satware.com"
+                title="Schreiben Sie uns direkt eine E-Mail">info@satware.com</a>
+        </div>
+        <div class="satag--footer-social-icons">
+            <a target="_blank" href="https://www.facebook.com/satwareAG/"
+               title="satware AG auf Facebook"><i class="fa-brands fa-square-facebook"></i></a><a
+                target="_blank" href="https://www.instagram.com/satware.ag/"
+                title="Zur Instagram Page der satware AG"><i class="fa-brands fa-instagram"></i></a><a
+                target="_blank" href="https://www.linkedin.com/company/satware-ag/?originalSubdomain=de"
+                title="satware AG auf LinkedIn"><i class="fa-brands fa-linkedin"></i></a><a
+                target="_blank" href="https://twitter.com/satwareAG" title="satware AG auf X"><i
+                class="fa-brands fa-x-twitter"></i></a><a target="_blank"
+                                                          href="https://www.xing.com/pages/satwareag"
+                                                          title="satware AG auf xing"><i
+                class="fa-brands fa-xing"></i></a><a target="_blank"
+                                                     href="https://www.youtube.com/channel/UChfn2XBDE9yfZrWnMzs1k0g"
+                                                     title="Zum YouTube Kanal der satware AG"><i
+                class="fa-brands fa-youtube"></i></a>
+        </div>
+    </div>
+</div>
+<div class="md-footer-custom-links">
+    <a href="https://satware.com/custom/index/sCustom/1" target="_blank" title="Kontakt">Kontakt</a>
+    <a href="{{ config.site_url }}impressum/" title="Impressum">Impressum</a>
+    <a href="{{ config.site_url }}/datenschutz/" title="sDatenschutzerklärung">Datenschutz</a>
+    <!--<a href="/barrierefreiheitserklaerung" title="Barrierefreiheitserklärung">Barrierefreiheitserklärung</a>-->
+    <a href="{{ config.site_url }}satway/" title="satWay Prinzipien">saTway</a>
+    <a href="https://satware.com/newsletter" target="_blank" title="Newsletter">Newsletter</a>
+</div>

package.json

@@ -0,0 +1,29 @@
+{
+  "name": "satware.ai",
+  "version": "1.0.0",
+  "description": "A documentation website for satware.ai built with MkDocs and the Material for MkDocs theme.",
+  "main": "index.js",
+  "directories": {
+    "doc": "docs"
+  },
+  "scripts": {
+    "scss": "sass --watch overrides/assets/css/custom.scss:docs/assets/css/custom.css",
+    "scss:build": "sass overrides/assets/css/custom.scss:docs/assets/css/custom.css --style compressed"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/satwareAG-ironMike/satware.ai.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "bugs": {
+    "url": "https://github.com/satwareAG-ironMike/satware.ai/issues"
+  },
+  "homepage": "https://github.com/satwareAG-ironMike/satware.ai#readme",
+  "devDependencies": {
+    "sass": "^1.89.0",
+    "terser": "^5.39.2"
+  }
+}

requirements.txt

@@ -37,7 +37,6 @@ smmap==5.0.2
 urllib3==2.4.0
 watchdog==6.0.0
 mkdocs-material[imaging]
-libsass
 mkdocs-macros-plugin
 mkdocs-glightbox
 mkdocs-include-markdown-plugin