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