added readme

This commit is contained in:
2026-03-27 00:32:54 +01:00
parent ef2c2743ec
commit e56c7fb7b5

148
readme.md Normal file
View File

@@ -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
🍯