# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-03-04

NEWSPAPER HANDLER
=================

BESCHREIBUNG
============

Tägliche PDF-Zeitung aus News-Items. Sammelt Artikel aus verschiedenen
Quellen, generiert eine formatierte HTML/PDF-Zeitung und stellt diese
über konfigurierbare Kanaele (Telegram, Email, Desktop) zu.

Abhängig von: NewsHandler (hub/news.py)
Datenquellen: hub/_services/newspaper/config.json, user/newspaper/

OPERATIONEN
===========

generate [--date YYYY-MM-DD]
  Zeitung generieren. Nutzt gesamelte News-Items aus der Datenbank.
  Erstellt HTML und PDF im Verzeichnis user/newspaper/.
  Standardmäßig für heute; --date setzt explizites Datum.
  Beispiel: bach newspaper generate --date 2026-02-18

deliver [--channel telegram|email|desktop]
  Zeitung zustellen. Findet neueste Zeitung und sendet sie.
  Ohne --channel werden alle konfigurierten Kanaele genutzt.
  Beispiel: bach newspaper deliver --channel telegram

config
  Konfiguration anzeigen. Liest hub/_services/newspaper/config.json
  und zeigt alle Parameter strukturiert an.

history
  Bisherige Ausgaben auflisten. Zeigt bis zu 20 neueste Zeitungen
  mit Datumsstempel und Dateigroe in KB.

help
  Diese Hilfe anzeigen.

BEISPIELE
=========

Tageszeitung generieren:
  bach newspaper generate

Mit spezifischem Datum:
  bach newspaper generate --date 2026-02-25

Zeitung zustellen (alle Kanaele):
  bach newspaper deliver

Nur per Telegram zustellung:
  bach newspaper deliver --channel telegram

Kompletter Workflow:
  bach news fetch              [Nachrichten sammeln]
  bach newspaper generate      [Zeitung erstellen]
  bach newspaper deliver       [Zeitung versenden]

DATEIEN
=======

Relative Pfade zu system/:

  hub/newspaper.py                             Handler-Implementierung
  hub/_services/newspaper/newspaper_generator Zeitungs-Generator (lazy-loaded)
  hub/_services/newspaper/config.json          Konfiguration (Kanaele, Quellen)

  user/newspaper/                              Ausgabeverzeichnis
  user/newspaper/newspaper_*.html              Generierte HTML-Zeitungen
  user/newspaper/newspaper_*.pdf               Generierte PDF-Zeitungen

  data/bach.db                                 Datenbank (news_items, news_sources)

SIEHE AUCH
==========

  news.py             NewsHandler (Quellsystem für News-Items)
  base.py             BaseHandler (Basis-Klasse)
  notify.py           Notification-System (Zustellung)
