diff --git a/.github/workflows/blog-preview.yml b/.github/workflows/blog-preview.yml
new file mode 100644
index 0000000..5e7b76d
--- /dev/null
+++ b/.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
diff --git a/.gitignore b/.gitignore
index 8978369..dcf69b7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,6 +1,5 @@
.idea
.cache
-site/.htaccess
-site/.htpasswd
-site/
-docs/stylesheets/extra.css
+/site
+/docs/assets/css/custom.css
+/package-lock.json
diff --git a/compile_scss.py b/compile_scss.py
index aee4c96..40d8e2a 100644
--- a/compile_scss.py
+++ b/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():
diff --git a/docker/mkdocs-material/Dockerfile b/docker/mkdocs-material/Dockerfile
index d72a32a..3130ecc 100644
--- a/docker/mkdocs-material/Dockerfile
+++ b/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
\ No newline at end of file
+RUN pip install mkdocs-literate-nav
+RUN pip install mkdocs-minify-plugin
\ No newline at end of file
diff --git a/docs/assets/javascript/body-classes.js b/docs/assets/js/body-classes.js
similarity index 95%
rename from docs/assets/javascript/body-classes.js
rename to docs/assets/js/body-classes.js
index 3b883fb..bffae7e 100644
--- a/docs/assets/javascript/body-classes.js
+++ b/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
- if (cleanPath === '') {
+ // Wenn der Pfad leer oder eine Entwickler Github Page ist (Startseite), füge die Klasse 'home' hinzu
+ if (cleanPath === '' || cleanPath === 'satware.ai') {
document.body.classList.add('home');
} else {
// Teile den Pfad in Segmente auf
diff --git a/docs/assets/javascript/consent.js b/docs/assets/js/consent.js
similarity index 100%
rename from docs/assets/javascript/consent.js
rename to docs/assets/js/consent.js
diff --git a/docs/assets/javascript/counter-animation.js b/docs/assets/js/counter-animation.js
similarity index 100%
rename from docs/assets/javascript/counter-animation.js
rename to docs/assets/js/counter-animation.js
diff --git a/docs/assets/javascript/faq.js b/docs/assets/js/faq.js
similarity index 100%
rename from docs/assets/javascript/faq.js
rename to docs/assets/js/faq.js
diff --git a/docs/assets/javascript/lightbox.js b/docs/assets/js/lightbox.js
similarity index 100%
rename from docs/assets/javascript/lightbox.js
rename to docs/assets/js/lightbox.js
diff --git a/docs/assets/javascript/testimonials.js b/docs/assets/js/testimonials.js
similarity index 100%
rename from docs/assets/javascript/testimonials.js
rename to docs/assets/js/testimonials.js
diff --git a/docs/assets/javascript/wcag.js b/docs/assets/js/wcag.js
similarity index 100%
rename from docs/assets/javascript/wcag.js
rename to docs/assets/js/wcag.js
diff --git a/docs/blog/.authors.yml b/docs/blog/.authors.yml
index e27287b..4897f6a 100644
--- a/docs/blog/.authors.yml
+++ b/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
diff --git a/docs/blog/posts/2025-05-20-relaunch-mit-mkdocs.md b/docs/blog/posts/2025-05-20-relaunch-mit-mkdocs.md
new file mode 100644
index 0000000..56404ea
--- /dev/null
+++ b/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 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
+
diff --git a/docs/faq/faq.md b/docs/faq/index.md
similarity index 100%
rename from docs/faq/faq.md
rename to docs/faq/index.md
diff --git a/docs/index.md b/docs/index.md
index 1e2d1d7..31f5d39 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -6,78 +6,61 @@ hide:
- toc
---
-
-
-
-
-
-
-
KI-Power für Ihr Business
-
-
+
+
KI-Power für Ihr Business
+
satware® 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.
-
@@ -131,9 +114,9 @@ Technologien sind darauf ausgerichtet, Ihren Geschäftserfolg durch moderne, KI-
-
+
-
+
"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!"
-
+
-
+
@@ -166,9 +149,9 @@ Für mich als Coach & Mediator ist Vertraulichkeit der Schlüssel. Top!"
-
+
-
+
@@ -186,48 +169,48 @@ Für mich als Coach & Mediator ist Vertraulichkeit der Schlüssel. Top!"
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
@@ -238,8 +221,5 @@ Für mich als Coach & Mediator ist Vertraulichkeit der Schlüssel. Top!"
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 