diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..56fd94e --- /dev/null +++ b/readme.md @@ -0,0 +1,148 @@ +# 🐝 PS-SetEtikettSorte + +Ein PowerShell-Skript zur automatisierten Erstellung von Honigetiketten auf Basis einer Photoshop-PSD-Datei. + +Das Script: + +* setzt dynamisch Text (Sorte, Zusatz, Datum) +* exportiert ein einzelnes Etikett als JPG +* erstellt automatisch ein druckfertiges A4-Layout mit mehreren Etiketten + +--- + +## 🚀 Features + +* 📝 Dynamische Textbefüllung (Sorte, Sorte2, Datum) +* 🇩🇪 Unterstützung für Umlaute +* 🖼️ Export als JPG +* 📄 Automatische Erstellung eines A4-Bogens +* 🔁 Wiederholbare und konsistente Ergebnisse +* ⚡ Komplett automatisiert via PowerShell + Photoshop + +--- + +## 📦 Voraussetzungen + +* Windows +* Installiertes **Adobe Photoshop** +* PowerShell (empfohlen: PowerShell 5 oder 7) + +--- + +## 📁 Projektstruktur (Beispiel) + +``` +PS-SetEtikettSorte/ +│ +├── Generated.ps1 +├── 500GrammEtikett.psd +├── Druckvorlage_A4.psd +├── .gitignore +└── README.md +``` + +--- + +## ⚙️ Verwendung + +### 🔹 Basisaufruf + +```powershell +.\Generated.ps1 -Sorte "Sommerblütenhonig" -Datum "21.01.2028" +``` + +--- + +### 🔹 Mit zusätzlicher Sorte + +```powershell +.\Generated.ps1 ` + -Sorte "Sommerblütenhonig" ` + -Sorte2 "Linde & Korn" ` + -Datum "21.01.2028" +``` + +--- + +## 🧾 Parameter + +| Parameter | Pflicht | Beschreibung | +| --------- | ------- | ---------------------------------- | +| `-Sorte` | ✅ | Hauptsorte des Honigs | +| `-Sorte2` | ❌ | Zusatz (z. B. Mischung) | +| `-Datum` | ✅ | Abfülldatum im Format `dd.MM.yyyy` | + +--- + +## 🖼️ Output + +Das Skript erzeugt: + +1. **Einzeletikett** + +``` +YYYY-MM-DD_Sorte.jpg +``` + +2. **A4-Druckbogen (6 Etiketten)** + +``` +YYYY-MM-DD_A4_Sorte.jpg +``` + +Mit `Sorte2`: + +``` +YYYY-MM-DD_Sorte_mit_Sorte2.jpg +YYYY-MM-DD_A4_Sorte_mit_Sorte2.jpg +``` + +--- + +## ⚠️ Wichtige Hinweise + +* Die PSD-Datei muss folgende Textlayer enthalten: + + * `Sorte` + * `Sorte2` + * `Datum` + +* Die Layernamen müssen **exakt übereinstimmen** + +* Photoshop wird über COM automatisiert → Script funktioniert nur lokal mit installierter Photoshop-Version + +--- + +## 💡 Tipps + +* Verwende **Point Text** in Photoshop (kein Textfeld), damit sich Text automatisch anpasst +* Halte Dateinamen ohne Sonderzeichen (Script bereinigt automatisch) +* Für beste Ergebnisse: + + * PSD in RGB + * Auflösung konsistent halten + +--- + +## 🛠️ Technischer Hintergrund + +Das Script nutzt: + +* PowerShell +* COM-Automation von Adobe Photoshop +* Copy/Paste Workflow zur stabilen Bildplatzierung +* Grid-basierte Layoutberechnung für A4 + +--- + +## 📄 Lizenz + +Private Nutzung / Hobbyprojekt +(bei Bedarf anpassen) + +--- + +## 🙌 Credits + +Erstellt zur Automatisierung von Honigetiketten +🍯