From 4943f1b0a9373cd1aa4df510058890cfa235c8af Mon Sep 17 00:00:00 2001 From: enchiriadis Date: Tue, 18 Aug 2026 10:43:05 +0000 Subject: [PATCH] Helpers/scripts/_belegversand_setup.applescript aktualisiert MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Vereinfachte buildReadmeText(). Interne README enthält nur Stichworte und Verweise auf die Quellen. --- .../scripts/_belegversand_setup.applescript | 76 +++++-------------- 1 file changed, 19 insertions(+), 57 deletions(-) diff --git a/Helpers/scripts/_belegversand_setup.applescript b/Helpers/scripts/_belegversand_setup.applescript index 35d82ed..4be2d9a 100644 --- a/Helpers/scripts/_belegversand_setup.applescript +++ b/Helpers/scripts/_belegversand_setup.applescript @@ -252,65 +252,27 @@ end buildConfigText buildReadmeText() ----------------- Erzeugt den Inhalt der internen README-Datei in DEVONthink. +Bewusst kurz & prägnant — Links verweisen auf ausführliche Doku. *) on buildReadmeText() - return "# README – Belegversand" & return & return & ¬ - "## Version" & return & return & ¬ - "Diese Installation verwendet Belegversand Version " & appVersion & "." & return & return & ¬ - "## Beteiligte Dateien" & return & return & ¬ - "- START.scpt – Einstiegspunkt" & return & ¬ - "- Helpers/scripts/_belegversand_setup.scpt – Einrichtung und Weiterleitung" & return & ¬ - "- Helpers/scripts/_belegversand.scpt – eigentlicher Versand" & return & ¬ - "- Helpers/show_mail_templates.scpt – Mail-Vorlagen-Auswahl" & return & ¬ - "- _config/belegversand.conf – Konfigurationsdatei" & return & ¬ - "- _config/README-Belegversand – diese Hilfe" & return & ¬ - "- _config/mail_vorlagen/belegversand – Standardtext für den Mail-Inhalt" & return & return & ¬ - "## Zweck" & return & return & ¬ - "Der Belegversand automatisiert den Versand ausgewählter Dokumente aus DEVONthink." & return & return & ¬ - "## Ablauf" & return & return & ¬ - "1. Dokumente in DEVONthink auswählen" & return & ¬ - "2. ZIP-Archiv erstellen" & return & ¬ - "3. Mail-Entwurf mit ZIP-Anhang erzeugen" & return & ¬ - "4. Dokumente optional mit dem Tag gesendet markieren" & return & ¬ - "5. Versand in Logdateien protokollieren" & return & return & ¬ - "## Voraussetzungen" & return & return & ¬ - "- DEVONthink" & return & ¬ - "- Apple Mail" & return & ¬ - "- korrekt eingerichtete Konfiguration in _config/belegversand.conf" & return & return & ¬ - "## Konfigurationsdatei" & return & return & ¬ - "Ort: _config/belegversand.conf" & return & return & ¬ - "Wichtige Werte:" & return & ¬ - "- MAIL_TO_DEFAULT" & return & ¬ - "- MAIL_CC_TO_DEFAULT" & return & ¬ - "- MAIL_SUBJECT_PREFIX" & return & ¬ - "- ZIP_PASSWORD_DEFAULT" & return & ¬ - "- LOG_SENT_GROUP_NAME" & return & ¬ - "- BELEGE_ROOT_UUID" & return & ¬ - "- WRITE_DEBUG_LOG" & return & ¬ - "- SHOW_README" & return & ¬ - "- README_UUID" & return & ¬ - "- MAILBODY_FOLDER_NAME" & return & ¬ - "- MAILBODY_RECORD_NAME" & return & ¬ - "- SENT_TAG_FOR_DOCS: Tag für bereits verarbeitete Dokumente" & return & ¬ - "- PATH_TO_DRYRUN_PREVIEW: Speicherort für die vollständige Dry-Run-Vorschau" & return & return & ¬ - "Wenn LOG_SENT_GROUP_NAME geändert wird, legt das Script die Protokollgruppe künftig mit genau diesem Namen an." & return & ¬ - "Ein anderer Wert führt also zu einem anderen Zielordner für die Versandprotokolle." & return & return & ¬ - "## Mail-Text" & return & return & ¬ - "Alle Werte können später in _config/belegversand.conf angepasst oder überschrieben werden." & return & return & ¬ - "## Hinweise zur Benutzung" & return & return & ¬ - "- Vor dem Versand die gewünschten Belege in DEVONthink auswählen" & return & ¬ - "- Gruppen in der Auswahl werden nicht versendet" & return & ¬ - "- Bereits mit gesendet markierte Belege werden übersprungen" & return & ¬ - "- Nach Erstellung des Mail-Entwurfs kann entschieden werden, ob die Belege als gesendet markiert werden sollen" & return & return & ¬ - "## Logs" & return & return & ¬ - "Der Versand wird in DEVONthink in zwei Formaten protokolliert:" & return & ¬ - "- NDJSON für technische bzw. maschinelle Weiterverarbeitung" & return & ¬ - "- Markdown für eine gut lesbare Übersicht für Menschen" & return & return & ¬ - "Für Belege aus Buchungsjahren wird die Gruppe Versendet im jeweiligen Jahresordner angelegt." & return & ¬ - "Für Außenseiter-Belege wird die Gruppe Versendet_Outsider direkt unter der DB-Wurzel angelegt." & return & return & ¬ - "## Debugging" & return & return & ¬ - "Wenn WRITE_DEBUG_LOG=true gesetzt ist, schreibt das Script ein Debug-Log nach:" & return & return & ¬ - "/tmp/DT-Belegversand-debug.log" & return + return "# Belegversand v" & appVersion & return & return & ¬ + "Automatisiertes Dokumenten-Versand-System für DEVONthink-Datenbanken." & return & return & ¬ + "## Installation" & return & return & ¬ + "```bash" & return & ¬ + "cd ~/Library/Application\\ Scripts/com.devon-technologies.think/Menu/" & return & ¬ + "git clone https://gitea.tuxi.ddnss.de/enchiriadis/DEVONthink-Belegversand-Automatisation.git Belegversand" & return & ¬ + "cd Belegversand && ./compile.sh" & return & ¬ + "```" & return & return & ¬ + "## Dokumentation" & return & return & ¬ + "- **Ausführliche Anleitung & Setup-Guide:** " & return & ¬ + " https://gitea.tuxi.ddnss.de/enchiriadis/DEVONthink-Belegversand-Automatisation" & return & ¬ + "- **Konfiguration:** _config/belegversand.conf" & return & ¬ + "- **Mail-Templates:** _config/mail_vorlagen/" & return & return & ¬ + "## Erste Schritte" & return & return & ¬ + "1. Belege in DEVONthink auswählen" & return & ¬ + "2. Scripts → START aufrufen" & return & ¬ + "3. Dialog folgen → Versand vorbereiten" & return & return & ¬ + "Hinweis: Detaillierte Dokumentation immer im Repository (siehe oben)." end buildReadmeText (* buildDefaultMailBodyText()