Refactor MkDocs blog structure, enhance SCSS watcher, and improve plugin configuration (#103)

- Adjusted `mkdocs.sh` to expand SCSS watcher to include `docs` and `mkdocs.yml`. - Simplified blog template by extracting post logic to `partials/post.html`. - Updated `mkdocs.yml` with refined plugins including RSS, meta, and enhanced blog options. - Improved blog Markdown files with structural changes and better TOC handling. - Removed unused styles and deprecated logic in blog posts for cleaner maintenance.
2025-06-02 16:01:40 +02:00
parent 7cf43df29c
commit ee8eba8549
8 changed files with 81 additions and 66 deletions
@@ -1,6 +1,7 @@
 ---
 hide:
 - navigation
+- toc
 ---

 # Blog
@@ -18,18 +18,6 @@ tags:
  - Verifikation
 ---

-<style>
-.md-typeset .admonition.warning {
-    color: #fff !important;
-    background-color: rgba(255, 152, 0, 0.1) !important;
-    border-color: #ff9800 !important;
-}
-.md-typeset .admonition.warning .admonition-title {
-    background-color: #ff9800 !important;
-    color: #fff !important;
-}
-</style>
-
 # Extended Thinking Revolution: Wie Sequential Thinking die KI-Qualität potentiell um bis zu 40% verbessert

 **Ab heute verfügbar auf chat.satware.ai: Das 🧠 satware® AI Sequential-Think Plugin transformiert komplexe Problemlösungen von oberflächlichen Ein-Schuss-Antworten zu strukturierten, mehrstufigen Denkprozessen.**
@@ -125,7 +113,7 @@ flowchart TD

 ## Usecase: Theo Alesi's Finanz-Expertise in der Praxis

-!!! warning "⚠️ WICHTIGER HINWEIS: Keine Finanzberatung"
+!!! warning "WICHTIGER HINWEIS: Keine Finanzberatung"

    Der folgende Abschnitt dient ausschließlich zu allgemeinen Informations- und Demonstrationszwecken über das Potenzial von KI-Systemen im Finanzbereich. Die hierin enthaltenen Informationen stellen **keine Anlageberatung, Finanzberatung, Steuerberatung oder sonstige individuelle Empfehlung** dar. Jede Investitionsentscheidung birgt Risiken und sollte auf einer umfassenden, unabhängigen Analyse und gegebenenfalls nach Konsultation eines qualifizierten Finanzberaters erfolgen. satware.ai übernimmt keine Haftung für Verluste, die sich aus der Nutzung oder dem Vertrauen auf die enthaltenen Informationen ergeben.

@@ -142,6 +130,7 @@ Ein erfolgreicher Unternehmer (55 Jahre) plant den schrittweisen Ruhestand in 10
 #### Sequential Thinking Analyse mit Theo Alesi:

 **Schritt 1: Problemstrukturierung**
+
 - Identifikation von 3 Hauptrisiken: Klumpenrisiko (80% Eigenunternehmen), Sequence-of-Returns Risk, Liquiditätskrisen
 - Definition der Zeithorizonte: 5 Jahre bis Teilrückzug, 10 Jahre bis Vollrente
 - Cashflow-Anforderungen: €150k/Jahr ab 65, inflationsangepasst
@@ -157,23 +146,28 @@ graph LR
 ```

 **Schritt 3: Dynamische Bucket-Strategieentwicklung**
+
 - **Bucket 1 (Cash-Reserve):** 2 Jahre Ausgaben = €300k in Tagesgeld/kurze Staatsanleihen
 - **Bucket 2 (Mittelfristig):** 3-8 Jahre in ausgewogenen Fonds und Unternehmensanleihen  
 - **Bucket 3 (Langfristig):** 8+ Jahre in diversifizierten Aktienmärkten und REITs
 - **Bucket 4 (Unternehmensbeteiligung):** Strukturierter Exit-Plan über 5 Jahre

 **Schritt 4: Risikoszenario-Modellierung**
+
 Sequential Thinking simuliert verschiedene Marktsequenzen:
+
 - **Best Case:** Positive Renditen in ersten 5 Jahren → Bucket 1 nie angetastet
 - **Worst Case:** 2008-ähnlicher Crash in Jahren 1-2 → Bucket 1 puffert, Bucket 3 erholt sich langfristig
 - **Mixed Scenarios:** Verschiedene Timing-Kombinationen mit spezifischen Handlungsempfehlungen

 **Schritt 5: Implementierungsplanung**
+
 - **Phase 1 (Jahre 1-2):** Schrittweise Reduktion der Unternehmensbeteiligung von 80% auf 60%
 - **Phase 2 (Jahre 3-5):** Weitere Reduktion auf 40%, Aufbau der Bucket-Struktur
 - **Phase 3 (Jahre 6-10):** Finale Diversifikation und Übergang zur Entnahmephase

 **Schritt 6: Monitoring & Anpassung**
+
 - Jährliche Review der Bucket-Allokation basierend auf Marktperformance
 - Dynamische Anpassung der Entnahmeraten (3-5% Bandbreite statt fixer 4%)
 - Flexibler Exit-Zeitplan für Unternehmensbeteiligung je nach Marktlage
@@ -183,6 +177,7 @@ Sequential Thinking simuliert verschiedene Marktsequenzen:
 **Traditionelle Beratung:** Statische Empfehlungen ohne Berücksichtigung der spezifischen Risikoprofile und Timing-Sensitivitäten.

 **Sequential Thinking Advantage:**
+
 - ✅ **Systematische Risikoidentifikation** statt pauschaler Diversifikationsregeln
 - ✅ **Dynamische Strategieanpassung** basierend auf sich ändernden Marktbedingungen  
 - ✅ **Quantifizierte Szenarien** mit konkreten Handlungsoptionen für verschiedene Marktphasen
@@ -190,12 +185,14 @@ Sequential Thinking simuliert verschiedene Marktsequenzen:

 ### Die saTway-Integration im Finanzbereich

-**saCway (Technische Exzellenz):** 
+**saCway (Technische Exzellenz):**
+
 - Präzise Monte-Carlo-Simulationen für Portfolioentwicklung
 - Systematische Risiko-Rendite-Optimierung mit Verhaltensökonomie-Integration
 - Datengetriebene Bucket-Allokation basierend auf historischen Marktzyklen

 **samWay (Menschliche Verbindung):**
+
 - Verständliche Visualisierung komplexer Finanzkonzepte
 - Emotionale Berücksichtigung von Verlustaversion und Risikowahrnehmung  
 - Transparente Kommunikation von Unsicherheiten und Annahmen
@@ -224,16 +221,19 @@ Alle spezialisierten Alesi-Agenten profitieren vom Sequential Thinking:
 Als Rechts-AGI für deutsches, schweizerisches und EU-Recht habe ich den gesamten Blogbeitrag auf rechtliche Compliance geprüft:

 ### Performance-Claims Präzisierung
+
 ✅ **Alle quantitativen Angaben** sind mit "bis zu", "potentiell" oder Quellenverweisen versehen  
 ✅ **Wissenschaftliche Basis** durch Verweis auf Chain-of-Thought Research und Inner Thinking Transformer  
 ✅ **Keine irreführenden absoluten Aussagen** im Sinne des UWG § 5  

 ### Finanzberatungs-Compliance
+
 ✅ **Prominenter Disclaimer** im Finanz-Usecase platziert  
 ✅ **Methodische Darstellung** statt konkreter Handlungsempfehlungen  
 ✅ **Transparente Kennzeichnung** als Informations- und Demonstrationszwecke  

 ### Quellennachweise und Transparenz
+
 ✅ **Verifizierte externe Quellen** (NPM Registry, Investopedia, Charles Schwab)  
 ✅ **Tier-System Kennzeichnung** für Evidenzqualität  
 ✅ **Offenlegung des KI-Charakters** aller beteiligten Agenten  
@@ -283,6 +283,7 @@ interface SequentialThinkingTool {
 ```

 Erweiterte Features:
+
 - **Dynamisches Revisions-System**: Ermöglicht die Korrektur früherer Denkschritte bei neuen Erkenntnissen
 - **Branching Logic**: Unterstützt parallele Denkwege für komplexe Problemstellungen
 - **Adaptive Erweiterung**: Passt die Anzahl der Denkschritte dynamisch an die Problemkomplexität an
@@ -343,6 +344,7 @@ timeline
 ## Quellen und Referenzen

 ### Technische Grundlagen:
+
 1. **NPM Package:** [@modelcontextprotocol/server-sequential-thinking v0.6.2](https://www.npmjs.com/package/@modelcontextprotocol/server-sequential-thinking) (T1)
 2. **Chain-of-Thought Research:** [Attention Is All You Need](https://arxiv.org/abs/1706.03762) (T1)
 3. **Multi-Agent Reasoning Framework:** [Model Context Protocol Documentation](https://modelcontextprotocol.io/) (T1)
@@ -350,11 +352,13 @@ timeline
 5. **Inner Thinking Transformer:** [arXiv:2502.13842](https://arxiv.org/abs/2502.13842) - "Inner Thinking Transformer: Leveraging Dynamic Depth Scaling" (T1)

 ### Sequence-of-Returns Risk:
+
 6. **Investopedia:** [Sequence Risk Definition](https://www.investopedia.com/terms/s/sequence-risk.asp) (T1)
 7. **Charles Schwab:** [Understanding Sequence-of-Returns Risk](https://www.schwab.com/learn/story/timing-matters-understanding-sequence-returns-risk) (T1)
 8. **Northwestern Mutual:** [What Is Sequence of Returns Risk?](https://www.northwesternmutual.com/life-and-money/what-is-sequence-of-returns-risk/) (T2)

-### Rechtliche Compliance:
+### Rechtliche Compliance
+
 Alle Performance-Claims und finanzbezogenen Aussagen wurden durch Justus Alesi gemäß deutschem und EU-Recht geprüft. Quellenangaben wurden zum Zeitpunkt der Veröffentlichung (Mai 2025) verifiziert.

 ---
@@ -362,11 +366,13 @@ Alle Performance-Claims und finanzbezogenen Aussagen wurden durch Justus Alesi g
 ## Rechtlicher Hinweis

 **Keine individuelle Beratung:** Dieser Beitrag dient ausschließlich Informationszwecken. satware.ai ist kein lizenzierter Finanz-, Rechts- oder Steuerberater. Die bereitgestellten Informationen sind:
+
 - Allgemein und lehrreich
 - Kein Ersatz für professionelle Beratung  
 - Ohne Gewähr für Vollständigkeit oder Aktualität

 **Für kritische Entscheidungen konsultieren Sie:**
+
 - Lizenzierte Fachexperten im relevanten Bereich
 - Qualifizierte Spezialisten mit Domänen-Expertise  
 - Zuständige Behörden für regulierte Angelegenheiten
@@ -378,6 +384,7 @@ Die bereitgestellten Informationen sollten durch angemessene Verifikation validi
 *Entwickelt von Michael Wegener und dem satware® AI Team | Mai 2025*

 **Weitere Informationen:**
+
 - [chat.satware.ai](https://chat.satware.ai) - Direkt testen
 - [satware.ai/team](https://satware.ai/team) - Die Alesi-AGI-Familie kennenlernen  
 - [GitHub: satwareAG-ironMike](https://github.com/satwareAG-ironMike) - Open Source Beiträge
@@ -21,18 +21,6 @@ tags:
  - Enterprise-Software
 ---

-<style>
-.md-typeset .admonition.warning {
-    color: #fff !important;
-    background-color: rgba(255, 152, 0, 0.1) !important;
-    border-color: #ff9800 !important;
-}
-.md-typeset .admonition.warning .admonition-title {
-    background-color: #ff9800 !important;
-    color: #fff !important;
-}
-</style>
-
 # KI entwickelt Software: Wie Prompts zu Enterprise-Ready-Lösungen werden 🚀🔖

 ## Wenn Algorithmen programmieren: Die neue Ära der AI-gestützten Entwicklung
@@ -14,4 +14,4 @@ docker run --rm -it --user $(id -u):$(id -g) -p 8000:8000 -v ${PWD}:/docs     --
        echo 'Initial SCSS compilation complete. Starting watcher...' && \
        python /docs/scss_watcher.py & \
        echo 'SCSS watcher started. Starting MkDocs server...' && \
-        mkdocs serve --dev-addr=0.0.0.0:8000 --watch overrides"
+        mkdocs serve --dev-addr=0.0.0.0:8000 --watch overrides --watch docs --watch mkdocs.yml"
@@ -1,5 +1,5 @@
 # Projekt-Informationen
-site_name: ''
+site_name: 'satware® AI'
 site_url: https://satware.ai/
 site_author: satware AG
 site_description: >-
@@ -57,6 +57,16 @@ theme:

 # Plugins
 plugins:
+  - meta
+  - blog:
+      blog_dir: blog
+      blog_toc: true
+      post_url_format: "{slug}"
+      post_date_format: "dd.MM.yyyy"
+      archive_toc: true
+      pagination: true
+      archive: true
+      authors: true
  - search
  - minify:
      minify_js: true
@@ -67,13 +77,22 @@ plugins:
  - git-revision-date-localized:
      enable_creation_date: true
      fallback_to_build_date: true
-  - blog:
-      blog_dir: blog
-      blog_toc: true
-      post_url_format: "{slug}"
-      post_date_format: "dd.MM.yyyy"
-      archive_toc: true
-  - social
+  - social:
+      cards_layout_options:
+        background_color: "#000000"
+  - rss:
+      feed_title: satware® AI Blog
+      feed_description: Aktuelle Nachrichten, technische Einblicke und Innovationen von satware® AI.
+      match_path: blog/posts/.*
+      abstract_chars_count: 250
+      date_from_meta:
+        as_creation: date
+      categories:
+        - categories
+        - tags
+      pretty_print: false
+      use_git: true
+

 # Erweiterungen
 markdown_extensions:
@@ -5,31 +5,7 @@

 <div class="md-posts">
    {% for post in posts %}
-    <article class="md-post md-post--excerpt">
-        <div class="md-post__meta">
-            <time datetime="{{ post.meta.date }}">{{ post.meta.date.strftime('%d. %B %Y')|replace('January', 'Januar')|replace('February', 'Februar')|replace('March', 'März')|replace('April', 'April')|replace('May', 'Mai')|replace('June', 'Juni')|replace('July', 'Juli')|replace('August', 'August')|replace('September', 'September')|replace('October', 'Oktober')|replace('November', 'November')|replace('December', 'Dezember') }}</time>
-        </div>
-
-        <h2 class="md-post__title">
-            <a href="{{ post.url | replace('blog/', '') }}" title="{{ post.title }}">{{ post.title }}</a>
-        </h2>
-
-        <!-- Post-Excerpt hinzufügen -->
-        <div class="md-post__excerpt">
-            {% if post.excerpt %}
-            {{ post.excerpt }}
-            {% elif post.content | length > 0 %}
-            {{ post.content | striptags | truncate(200, true, "...") }}
-            {% else %}
-            <!-- Fallback, falls kein Excerpt oder Inhalt verfügbar ist -->
-            <p>Mehr Informationen im vollständigen Artikel.</p>
-            {% endif %}
-        </div>
-
-        <br />
-
-        <a href="{{ post.url | replace('blog/', '') }}" class="md-button" title="Weiterlesen: {{ post.title }}">Weiterlesen</a>
-    </article>
+        {% include "partials/post.html" %}
    {% endfor %}
 </div>
 {% endblock %}
@@ -31,13 +31,10 @@
        </header>
        <div class="md-post__content md-typeset">
            <h2>
-                <a href="{{ post.url | replace('blog/', '') | url }}" title="{{ post.config.title }}">{{ post.config.title }}</a>
+                <a href="{{ post.url  | url }}" title="{{ post.config.title }}">{{ post.config.title }}</a>
            </h2>
-
-            <!-- Wir zeigen nur die Überschrift an, kein Excerpt oder weiterer Inhalt -->
-
            <nav class="md-post__action">
-                <a href="{{ post.url | replace('blog/', '') | url }}" class="md-button" title="Weiterlesen: {{ post.config.title }}">
+                <a href="{{ post.url  | url }}" class="md-button" title="Weiterlesen: {{ post.config.title }}">
                    Weiterlesen
                </a>
            </nav>
@@ -0,0 +1,27 @@
+<article class="md-post md-post--excerpt">
+    <div class="md-post__meta">
+        <time datetime="{{ post.config.date.created }}">
+            {{- post.config.date.created | date -}}
+        </time>
+    </div>
+
+    <h2 class="md-post__title">
+        <a href="{{ post.url | url }}" title="{{ post.title }}">{{ post.title }}</a>
+    </h2>
+
+    <!-- Post-Excerpt hinzufügen -->
+    <div class="md-post__excerpt">
+        {% if post.excerpt %}
+        {{ post.excerpt }}
+        {% elif post.content | length > 0 %}
+        {{ post.content | striptags | truncate(200, true, "...") }}
+        {% else %}
+        <!-- Fallback, falls kein Excerpt oder Inhalt verfügbar ist -->
+        <p>Mehr Informationen im vollständigen Artikel.</p>
+        {% endif %}
+    </div>
+
+    <br />
+
+    <a href="{{ post.url | url }}" class="md-button" title="Weiterlesen: {{ post.title }}">Weiterlesen</a>
+</article>