Trends

Makefile

@@ -12,7 +12,7 @@ build:
 	mkdocs build
 
 serve:
-	mkdocs serve -a 0.0.0.0:8000
+	mkdocs serve --livereload -a 0.0.0.0:8000 -w overrides
 
 clean:
 	rm -rf site .env

docs/de/index.md

@@ -1,54 +1,61 @@
 # News Deframer
 
-> :mega: **Hinweis:** Wir suchen einen [Sponsor](sponsors.md), um dieses Projekt in den USA zu hosten. :flag_us: :statue_of_liberty:
+> **Hinweis:** Wir suchen einen [Sponsor](sponsors.md), um dieses Projekt in den USA zu hosten.
 
-Der "News Deframer" ist ein sprachliches Analysetool, für alle Ihre präferierten Nachrichtenseiten. Mit Hilfe von LLMs analysiert es die Nachrichten Schlagzeilen. Die Anwendung besitzt zwei Verwendungsmöglichkeiten: einen **RSS-Feed-Proxy** und ein **Browser-Plugin**.
+Der „News Deframer“ ist ein sprachliches Analysetool für Ihre bevorzugten Nachrichtenseiten. Mithilfe von LLMs analysiert es Schlagzeilen und formuliert sie in neutraler Sprache neu.
 
-## Video
+> Ein Werbeblocker blockiert unerwünschte Werbung. Der News Deframer reduziert die mentale Wirkung von Clickbait, indem er die Portalseite großer Nachrichtenangebote durch neutral formulierte Inhalte ersetzt.
 
-[![News Deframer Promo](https://img.youtube.com/vi/flORP9WqgSw/maxresdefault.jpg){ width="500" }](https://www.youtube.com/watch?v=flORP9WqgSw&vq=hd1080 "News Deframer Promo"){ .glightbox data-width="100%" data-height="100%" }
+## Was wir tun
 
-[:fontawesome-brands-youtube: Auf YouTube anschauen](https://www.youtube.com/watch?v=flORP9WqgSw){ target="_blank" }
+* Wir [ersetzen](showcases/index.md) die Portalseite.
+* Jede Schlagzeile wird in neutrale Sprache überführt (Reduktion von Clickbait, Reizüberflutung, Suggestion und Framing).
+* Integrierte [Trendanalyse](trends/index.md) zur Erkennung von Talking Points.
+* Vergleich verschiedener Nachrichtenportale, z. B. "Tagesschau" mit "Apollo News" oder "Bild" mit dem "Bayerischen Rundfunk".
+* Per Klick gelangen Sie zurück zum Originalartikel bzw. zur ursprünglichen Portalseite.
 
-## Wir ersetzen die Portalseite
+|                                                                                     |                                                                                       |
+| :---------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------: |
+| <img src="/assets/screenshots/portal/tagesschau.png" alt="Tagesschau" width="500"/> | <img src="/assets/screenshots/portal/apollo-news.png" alt="Apollo News" width="500"/> |
+|                   [Showcase: Tagesschau](showcases/tagesschau.md)                   |                   [Showcase: Apollo News](showcases/apollo-news.md)                   |
 
-Ein Werbeblocker blockiert Werbung, die Sie nicht wollen. Der News Deframer neutralisiert die mentale Wirkung von Clickbait, indem er die Portalseite jedes großen Nachrichtennetzwerks durch neutrale Sprache ersetzt.
+## Video
 
-Ein Wert von 50% oder höher deutet auf signifikantes Framing durch Sprache hin. Mit anderen Worten: Sehr wahrscheinlich versucht ein geschulter Journalist Sie mit Worte zu manipulieren und die KI sagt wo und wie. Der Titel oder die Beschreibung sind Clickbait, Framing, Reizüberflutung oder dient einer Agenda.
+[![News Deframer Promo](https://img.youtube.com/vi/flORP9WqgSw/maxresdefault.jpg){ width="500" }](https://www.youtube.com/watch?v=flORP9WqgSw&vq=hd1080 "News Deframer Promo"){ .glightbox data-width="100%" data-height="100%" }
 
-| | |
-| :---: | :---: |
-| **Apollo News** | **Heise** |
-| <img src="/assets/screenshots/portal/apollo-news.png" alt="Apollo News" width="500"/> | <img src="/assets/screenshots/portal/heise.png" alt="Heise" width="500"/> |
-| **BBC** | **Tagesschau** |
-| <img src="/assets/screenshots/portal/bbc.png" alt="BBC" width="500"/> | <img src="/assets/screenshots/portal/tagesschau.png" alt="Tagesschau" width="500"/> |
-| **Spiegel** | **NY Times** |
-| <img src="/assets/screenshots/portal/spiegel.png" alt="Spiegel" width="500"/> | <img src="/assets/screenshots/portal/nytimes.png" alt="NY Times" width="500"/> |
+[Auf YouTube ansehen](https://www.youtube.com/watch?v=flORP9WqgSw){ target="_blank" }
 
-## Was dieses Projekt ist und was nicht
+## Was dieses Projekt ist – und was nicht
 
-- Es handelt sich **nicht** um einen Fake-News-Detektor! Es findet keine inhaltliche Überprüfung der Nachrichten statt.
-- Dieses Projekt verwendet ein LLM, das als neutraler Journalist operiert, um Inhalte auf Voreingenommenheit zu prüfen und die Einhaltung neutraler Sprache zu analysieren.
-- Wir verwenden offene [Prompts](https://github.com/deframer/news-deframer/blob/main/pkg/think/prompts) die auf jedem LLM ausgeführt werden können.
+* **Kein** Fake-News-Detektor: Es findet keine inhaltliche Faktenprüfung statt.
+* Ein LLM agiert als neutraler Journalist und analysiert Inhalte hinsichtlich sprachlicher Voreingenommenheit und Neutralität.
+* Es werden offene [Prompts](https://github.com/deframer/news-deframer/blob/main/pkg/think/prompts) verwendet, die mit unterschiedlichen LLMs ausgeführt werden können.
 
-## Warum ist eine Sprachanalyse geboten und effektiv
+## Sprachanalyse
 
-- Wir möchten dabei helfen, die emotionale Wirkung von Schlagzeilen zu vermindern.
-- Desinformation und Spekulation beruhen oft auf "Dark Patterns, Clickbait und emotionalen Triggern".
-- Autoren von Desinformation verwenden häufig verschleiernde, reißerische und vage Sprachmittel, um rechtliche Konsequenzen zu vermeiden, aber einen bestimmten Effekt beim Leser hervorzurufen.
+Warum Sprachanalyse wirksam ist:
 
-**Hinweis**: Es kann zu falsch-positiven / falsch-negativen Ergebnissen kommen.
+* Ziel ist es, die emotionale Wirkung von Schlagzeilen zu reduzieren.
+* Desinformation und Spekulation basieren häufig auf Dark Patterns, Clickbait und emotionalen Triggern.
+* Verfasser von Desinformation nutzen oft reißerische, vage oder verschleiernde Formulierungen, um rechtliche Konsequenzen zu vermeiden und dennoch eine bestimmte Wirkung zu erzielen.
+
+**Warnung:** Durch den Einsatz eines LLMs kann es zu falsch-positiven oder falsch-negativen Ergebnissen kommen. Im ungünstigsten Fall wird ein qualitativ hochwertiger Artikel übersehen oder ein Clickbait-Artikel nicht erkannt.
 
 ## Installation
 
 Richten Sie Ihre eigene [Instanz](https://github.com/deframer/news-deframer/blob/main/docs/SETUP.md){ target="_blank" } ein.
 
-## Chrome Erweiterung
+## Funktionsweise
+
+Der News Deframer fungiert als RSS-Feed-Proxy. Die Schlagzeilen werden aus dem [RSS](rss-feed.md) eines Portals bezogen.
+Der Feed wird verarbeitet und durch neutral formulierte Schlagzeilen ersetzt. Diese aktualisierten Daten werden zudem vom **Browser-Plugin** verwendet, das die Portalseite der jeweiligen Nachrichtenquelle ersetzt.
+
+## Chrome-Erweiterung
 
-Installation der [Chrome Erweiterung](https://chromewebstore.google.com/detail/ffpibngfmnagagggbjpgjbmehhilfinp){ target="_blank" }.
+Installation der [Chrome-Erweiterung](https://chromewebstore.google.com/detail/ffpibngfmnagagggbjpgjbmehhilfinp){ target="_blank" }.
 
 ## Ressourcen
 
-- [Quellcode](https://github.com/deframer/news-deframer/)
-- [Fehlerbericht](https://github.com/deframer/news-deframer/issues)
-- [Lizenz](https://github.com/deframer/news-deframer/blob/main/LICENSE)
+* [Quellcode](https://github.com/deframer/news-deframer/)
+* [Fehler melden](https://github.com/deframer/news-deframer/issues)
+* [Lizenz](https://github.com/deframer/news-deframer/blob/main/LICENSE)

docs/de/screenshots/rss-feed.md → docs/de/rss-feed.md

@@ -4,15 +4,15 @@ Dieses Beispiel stammt aus dem Feed `https://rss.nytimes.com/services/xml/rss/ny
 
 ## Screenshots
 
-Es wurde `freshrss` verwendet um die Screenshots zu erzeugen. Der "News Deframer" neutralisiert den Ton jedes Artikels und stellt sicher, dass er sich als objektive Nachricht liest.
+Es wurde [freshrss](https://www.freshrss.org/){ target="_blank" } verwendet um die Screenshots zu erzeugen. Der "News Deframer" neutralisiert den Ton jedes Artikels und stellt sicher, dass er sich als objektive Nachricht liest.
 
-| Aktualisiert | Original |
+| Deframed | Original |
 | :---: | :---: |
-| <img src="/assets/screenshots/rss-feed/updated.jpg" alt="Aktualisiert" width="600"/> | <img src="/assets/screenshots/rss-feed/original.jpg" alt="Original" width="600"/> |
+| <img src="/assets/screenshots/rss-feed/deframed.jpg" alt="Deframed" width="600"/> | <img src="/assets/screenshots/rss-feed/original.jpg" alt="Original" width="600"/> |
 
 ## Proxy XML-Feed
 
-Die KI analysiert den Upstream-Inhalt, liefert eine Begründung für ihre Bewertung und führt notwendige Ersetzungen durch, um die Sprache zu entschärfen.
+Die KI analysiert den Feed, liefert eine Begründung für ihre Bewertung und erzeugt eine neue Schlagzeile, um die Sprache zu entschärfen.
 
 ```xml
 <item>

docs/de/showcases/apollo-news.md

@@ -0,0 +1,41 @@
+# Apollo News
+
+* RSS-Feed: `https://apollo-news.net/feed/`
+
+# Portal
+
+<img src="/assets/screenshots/portal/apollo-news.png" alt="Apollo News - Portal" width="1000"/>
+
+* **Portal-Ersatz**: Die Standard-Startseite wird vollständig durch die benutzerdefinierte Portalansicht ersetzt.
+* **Ausblenden-Button**: Mit dem Ausblenden-Button kann die ursprüngliche Startseite wieder angezeigt werden.
+
+## Artikel
+
+Artikel 1
+
+<img src="/assets/screenshots/portal/apollo-news_article1.png" alt="Apollo News - Artikel 1" width="1000"/>
+
+Artikel 2
+
+<img src="/assets/screenshots/portal/apollo-news_article2.png" alt="Apollo News - Artikel 2" width="1000"/>
+
+* **Artikel-Ersatz**: Wird die Artikel-URL erkannt, wird die komplette Artikelseite durch die benutzerdefinierte Ansicht ersetzt.
+* **Ausblenden-Button**: Mit dem Ausblenden-Button kann zur ursprünglichen Artikelseite zurückgekehrt werden.
+
+## Trendanalyse
+
+<img src="/assets/screenshots/portal/tagesschau_tag_cloud.png" alt="Tagesschau - Tag Cloud" width="1000"/>
+
+* **Tag-Cloud**: Zeigt die häufigsten Themen und Schlagwörter im ausgewählten Zeitraum.
+
+<img src="/assets/screenshots/portal/tagesschau_lifecycle.png" alt="Tagesschau - Lebenszyklus" width="1000"/>
+
+* **Lebenszyklus**: Nach Auswahl eines Trends aus der Tag-Cloud wird dessen zeitlicher Verlauf im gewählten Zeitraum dargestellt.
+
+<img src="/assets/screenshots/portal/tagesschau_context.png" alt="Tagesschau - Kontext" width="1000"/>
+
+* **Kontext**: Nach Auswahl eines Trends werden die zugehörigen Verben angezeigt, die verdeutlichen, wie der Begriff verwendet wird.
+
+<img src="/assets/screenshots/portal/tagesschau_vs_apollo-news.png" alt="Tagesschau - Vergleich" width="1000"/>
+
+* **Vergleich**: Eine bekannte Quelle in der gewählten Sprache kann mit einer anderen Quelle verglichen werden. Die Ansicht zeigt zentrale Themen, identifiziert blinde Flecken einer Quelle und hebt gemeinsame Schwerpunkte beider Quellen hervor.

docs/de/screenshots/index.md → docs/de/showcases/index.md

@@ -1,9 +1,7 @@
-# Screenshots
+# Showcases
 
-## Browser-Plugin
-
-- [BBC](bbc.md)
 - [Tagesschau](tagesschau.md)
+- [Apollo News](apollo-news.md)
 
 ## RSS Feed
 
@@ -14,8 +12,8 @@
 Die folgende Konfiguration wurde verwendet, um diese Beispiele zu erstellen:
 
 - **Hardware**: Mac Mini M1 (16GB RAM), unter macOS Tahoe 26.2
-- **Software**: [LM Studio](https://lmstudio.ai/) 0.3.39
-- **Modell**: [meta-llama-3.1-8b-instruct](https://huggingface.co/lmstudio-community/Meta-Llama-3.1-8B-Instruct-GGUF)
+- **Software**: [LM Studio](https://lmstudio.ai/) 0.4.2
+- **Modell**: [ministral-3-3b](https://huggingface.co/lmstudio-community/Ministral-3-3B-Instruct-2512-GGUF)
 
 Das System verwendet diese [Prompts](https://github.com/deframer/news-deframer/tree/main/pkg/think/prompts/).
 

docs/de/showcases/tagesschau.md

@@ -0,0 +1,41 @@
+# Tagesschau
+
+* RSS-Feed: `https://www.tagesschau.de/infoservices/alle-meldungen-100~rss2.xml`
+
+# Portal
+
+<img src="/assets/screenshots/portal/tagesschau.png" alt="Tagesschau - Portal" width="1000"/>
+
+* **Portal-Ersatz**: Die Standard-Startseite wird vollständig durch die benutzerdefinierte Portalansicht ersetzt.
+* **Ausblenden-Button**: Mit dem Ausblenden-Button kann die ursprüngliche Startseite wieder angezeigt werden.
+
+## Artikel
+
+Artikel 1
+
+<img src="/assets/screenshots/portal/tagesschau_article1.png" alt="Tagesschau - Artikel 1" width="1000"/>
+
+Artikel 2
+
+<img src="/assets/screenshots/portal/tagesschau_article2.png" alt="Tagesschau - Artikel 2" width="1000"/>
+
+* **Artikel-Ersatz**: Wird die Artikel-URL erkannt, wird die komplette Artikelseite durch die benutzerdefinierte Ansicht ersetzt.
+* **Ausblenden-Button**: Mit dem Ausblenden-Button kann zur ursprünglichen Artikelseite zurückgekehrt werden.
+
+## Trendanalyse
+
+<img src="/assets/screenshots/portal/tagesschau_tag_cloud.png" alt="Tagesschau - Tag Cloud" width="1000"/>
+
+* **Tag-Cloud**: Zeigt die häufigsten Themen und Schlagwörter im ausgewählten Zeitraum.
+
+<img src="/assets/screenshots/portal/tagesschau_lifecycle.png" alt="Tagesschau - Lebenszyklus" width="1000"/>
+
+* **Lebenszyklus**: Nach Auswahl eines Trends aus der Tag-Cloud wird dessen zeitlicher Verlauf im gewählten Zeitraum dargestellt.
+
+<img src="/assets/screenshots/portal/tagesschau_context.png" alt="Tagesschau - Kontext" width="1000"/>
+
+* **Kontext**: Nach Auswahl eines Trends werden die zugehörigen Verben angezeigt, die verdeutlichen, wie der Begriff verwendet wird.
+
+<img src="/assets/screenshots/portal/tagesschau_vs_apollo-news.png" alt="Tagesschau - Vergleich" width="1000"/>
+
+* **Vergleich**: Eine bekannte Quelle in der gewählten Sprache kann mit einer anderen Quelle verglichen werden. Die Ansicht zeigt zentrale Themen, identifiziert blinde Flecken einer Quelle und hebt gemeinsame Schwerpunkte beider Quellen hervor.

docs/de/trends/index.md

@@ -0,0 +1,17 @@
+# Trend Analyse
+
+<img src="/assets/screenshots/portal/tagesschau_tag_cloud.png" alt="Tagesschau - Tag Cloud" width="1000"/>
+
+* **Tag-Cloud**: Zeigt die häufigsten Themen und Schlagwörter im ausgewählten Zeitraum.
+
+<img src="/assets/screenshots/portal/tagesschau_lifecycle.png" alt="Tagesschau - Lebenszyklus" width="1000"/>
+
+* **Lebenszyklus**: Nach Auswahl eines Trends aus der Tag-Cloud wird dessen zeitlicher Verlauf im gewählten Zeitraum dargestellt.
+
+<img src="/assets/screenshots/portal/tagesschau_context.png" alt="Tagesschau - Kontext" width="1000"/>
+
+* **Kontext**: Nach Auswahl eines Trends werden die zugehörigen Verben angezeigt, die verdeutlichen, wie der Begriff verwendet wird.
+
+<img src="/assets/screenshots/portal/tagesschau_vs_apollo-news.png" alt="Tagesschau - Vergleich" width="1000"/>
+
+* **Vergleich**: Eine bekannte Quelle in der gewählten Sprache kann mit einer anderen Quelle verglichen werden. Die Ansicht zeigt zentrale Themen, identifiziert blinde Flecken einer Quelle und hebt gemeinsame Schwerpunkte beider Quellen hervor.