` Section einfügen - CSS-Variablen sind bereits gesetzt: `--primary: #3d4717`, `--secondary: #747d4b` 3. **Drucken oder Digital teilen** - PDF-Export aus Browser - Oder direkt als HTML zum Hosting ### Markdown Konventionen für Reales **Headers** - `# Titel` → Primärfarbe, größer, seriös - `## Abschnitt` → Sekundärfarbe - `### Unter-Abschnitt` → Grau **Hervorhebung** - `**Fett**` → Für Konzepte, Definitionen - `*Kursiv*` → Für Betonungen - `~~Durchgestrichen~~` → Nur sparsam **Strukturen** - Nummerierte Listen für Prozesse - Bullet-Points für Eigenschaften - Blockquotes für Zitate/Hinweise **Code-Blöcke** ```markdown ```json { "key": "value" } ``` ``` **Tabellen** ```markdown | Header 1 | Header 2 | |----------|----------| | Zelle | Zelle | ``` ### HTML/CSS Branding Framework Siehe `templates/markdown/branded-doc.html` für vollständiges Template. **CSS-Variablen (vordefiniert):** ```css --primary: #3d4717; --secondary: #747d4b; --text: #555555; --light-bg: #f5f5f5; --white: #ffffff; ``` **Beispiel: Styled Box** ```html

Hinweis: Text hier

``` CSS dafür: ```css .info-box { border-left: 4px solid var(--primary); padding: 12px 16px; background: var(--light-bg); margin: 16px 0; } ``` --- ## Briefe & Korrespondenz ### LibreOffice-Template **Datei**: `templates/letters/reales-letter-template.odt` **Vorlage enthält:** - Logo oben links - Adressblock rechts (anpassbar) - Kontaktinfo in Fußzeile (Telefon, Email, Web) - Brieftext-Bereich mit Absatz-Styles - Unterschriftszeile **Verwendung:** 1. Template in LibreOffice Writer öffnen 2. Empfänger-Adresse in der Kopfzeile aktualisieren 3. Betreff und Inhalt anpassen 4. Als ODF oder PDF exportieren ### HTML Letter Template Für schnelle HTML-Briefe: `templates/letters/reales-letter.html` **Features:** - Print-optimiert (CSS Media Queries) - DIN A4 Seitengröße - Responsive für Bildschirm **Beispiel:** ```html

``` ### Microsoft Word Vorlage (Legacy) Die Datei `20210729_Standard_Serienbrief.dotx` ist verfügbar, wird aber zugunsten von LibreOffice/HTML-Lösungen veraltet. **Empfehlung:** Schrittweise zu LibreOffice migrieren für bessere Open Source Unterstützung. --- ## Open Source Tools & Richtlinien ### Empfohlene Tools | Aufgabe | Tool | Format | |---------|------|--------| | Dokumentation | Markdown + Pandoc | `.md` → HTML/PDF | | Briefe & Vorlagen | LibreOffice Writer | `.odt` → `.pdf` | | Grafikbearbeitung | Inkscape | `.svg` / `.png` | | PDF-Verarbeitung | PyPDF2 / Ghostscript | PDF-Handling | | HTML/CSS Rendering | Pandoc / Weasyprint | HTML → PDF | ### Konvertierungs-Befehle **Markdown zu HTML (mit Styling):** ```bash pandoc -f markdown -t html -c branded-doc.css input.md > output.html ``` **Markdown zu PDF:** ```bash pandoc input.md -o output.pdf --css=branded-doc.css ``` **DOCX zu Markdown (für Migration):** ```bash pandoc input.docx -f docx -t markdown -o output.md ``` **LibreOffice ODT zu PDF:** ```bash libreoffice --headless --convert-to pdf input.odt ``` --- ## Email-Signatur ### HTML Email Signature Template ```html

Dein Name
Deine Position

Reales GmbH
Bachgässchen 6
CH-4125 Riehen

T +41 61 641 90 90
F +41 61 641 90 91
welcome@reales.ch
www.reales.ch

``` --- ## Prozess: Neue Dokumentation erstellen ### Schritt für Schritt 1. **Inhalte in Markdown schreiben** - Clean, strukturiert, focus auf Inhalt - Nutze Markdown-Konventionen aus diesem Skill 2. **Wähle dein Ausgabe-Format:** - **Digital (Web/Email)**: HTML mit CSS Branding - **Druck**: PDF (via Pandoc oder Browser-Print) - **Legacy Office**: DOCX (falls nötig) 3. **Styling anwenden** - Nutze `branded-doc.css` mit Reales-Farben - Beachte Logo-Platzierung und Kontrast - Teste auf mehreren Screens/Druckern 4. **QA & Export** - Überprüfe Farben & Logo-Platzierung - Teste Links & Formatierung - Exportiere als PDF oder veröffentliche als HTML --- ## Häufig gestellte Fragen ### Kann ich andere Farben verwenden? Nein, nur die definierten zwei Grün-Töne + Weiß/Grau. Konsistenz ist zentral. ### Müssen Dokumente immer das Logo haben? Nur bei external-facing Dokumenten (Briefe, Marketing, Reports). Intern optional. ### Welches Format für Archivierung? PDF für Langzeit-Archivierung. Markdown + HTML für versionierbare Dokumentationen. ### Kann ich Microsoft Word verwenden? Bedingt – die `.dotx` Vorlage ist verfügbar, aber LibreOffice wird empfohlen (Open Source, bessere Markdown-Integration). ### Wie stelle ich Markdown-Dokumente online? Generiere HTML mit Pandoc, hoste auf deiner Website, oder nutze ein Markdown-Hosting (zB GitHub Pages). --- ## Asset-Verzeichnis ``` reales-ci-skill/ ├── assets/ │ ├── Logo_Reales.png │ └── logo-colors.json (Referenz) ├── templates/ │ ├── markdown/ │ │ ├── branded-doc.html │ │ └── branded-doc.css │ └── letters/ │ ├── reales-letter-template.odt │ └── reales-letter.html ├── references/ │ ├── color-palette.md │ └── open-source-tools.md └── SKILL.md (diese Datei) ``` --- ## Kontakt & Support **Fragen zu CI/CD oder diesem Skill?** - Reales GmbH - Bachgässchen 6, CH-4125 Riehen - T +41 61 641 90 90 - welcome@reales.ch - www.reales.ch --- **Version**: 1.0 **Zuletzt aktualisiert**: 2026 **Fokus**: Open Source, Markdown-first, professionelles Branding