added readme
This commit is contained in:
148
readme.md
Normal file
148
readme.md
Normal 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
|
||||
🍯
|
||||
Reference in New Issue
Block a user