AnnexPublish – Handbuch

1. Überblick

AnnexPublish ist die Desktop-Publishing- und Layout-App der AnnexCREATE-Suite. Sie richtet sich an Freelancer, Selbständige und kleine Agenturen, die druck- und webfertige Layouts — von Flyern und Broschüren bis zu digitalen Publikationen — in einem durchgängigen Workflow erstellen.

Kernnutzen:

• Seitenlayout mit Musterseiten, Hilfslinien, Satzspiegel und Einrasten
• Professioneller Fließtext: verkettete Textrahmen über Seiten hinweg, Absatz- und Zeichenvorlagen, OpenType-Typografie
• Brandkit-Anbindung der Suite: Markenfarben, -vorlagen und -Assets direkt im Dokument
• PDF- und HTML-Export aus ein und demselben Dokument — inklusive SEO-/Social-Meta und DSGVO-Toolkit für den Web-Export
• Offline-first: das Dokument liegt als .axpublish-Datei lokal auf deinem Mac

AnnexPublish ist Teil der AnnexCREATE-Suite („Creative OS"): gemeinsames Design-System, gemeinsame Module (Asset-Bibliothek, Brandkits, Zwischenablage) und Automatisierung per MCP — modular einsetzbar neben den anderen Apps.

2. Installation & Aktivierung

AnnexPublish wird über AnnexHub installiert, lizenziert und aktualisiert — die Zentrale der Suite für Apps, Lizenzen, Updates und Assets. Nach dem Download aus AnnexHub startest du die App wie jede andere Mac-App.

Die App ist offline-first: Dokumente, Asset-Verweise und Einstellungen liegen lokal auf dem Mac. Der optionale Versions-Sync mit einem Team-Workspace-Server ist eine Ergänzung, keine Voraussetzung — rein lokale Versionierung (Checkpoints, Wiederherstellen) funktioniert ohne Server.

3. Grundworkflow

1. Dokument öffnen: Ohne geöffnete Datei startet die App mit einem neuen Dokument. Eine bestehende .axpublish-Datei öffnest du über Ablage ▸ Öffnen… (⌘O).
2. Seiten einrichten: Seiten per Header-Button „Seite hinzufügen" anlegen; Musterseiten ordnest du den Seiten zu. In der Seiten- und Ebenen-Sidebar siehst du gerasterte Miniaturen.
3. Hilfslinien & Satzspiegel: über die Header-Buttons ein-/ausblenden und im Editor-Dialog anlegen.
4. Elemente platzieren: Textrahmen und Rechtecke per Header-Button einfügen, Bilder per Drag & Drop aus der Asset-Bibliothek auf den Canvas ziehen, QR-Codes über den QR-Button erzeugen.
5. Text setzen: Doppelklick auf einen Textrahmen öffnet den Editor direkt im Rahmen; Formatvorlagen aus dem Stile-Panel anwenden; Rahmen bei Bedarf zu einer Fließtext-Kette verketten.
6. Feinschliff: Elemente bei Mehrfachauswahl ausrichten und verteilen (Inspector); beim Verschieben rasten Elemente an Seitenkanten, Satzspiegel, Hilfslinien und anderen Elementen ein.
7. Sichern: Ablage ▸ Speichern (⌘S) schreibt die .axpublish-Datei; im Versionen-Panel legst du manuelle Checkpoints an.
8. Ausgeben: Ablage ▸ Exportieren… erzeugt ein mehrseitiges PDF, Ablage ▸ Als HTML exportieren… eine Website mit SEO-/Social-Meta- und Datenschutz-Panel; Ablage ▸ Drucken… (⌘P) nutzt denselben Renderpfad.

4. Kernfunktionen

4.1 Layout & Seiten

• Dokumentmodell: beliebig viele Seiten plus Musterseiten (Master-Seiten mit masterID-Zuordnung).
• Seiten- und Ebenen-Sidebar: gerasterte Seiten-Miniaturen zur Orientierung.
• Hilfslinien & Satzspiegel: anlegen/entfernen, ein-/ausblenden (Header-Buttons), Editor-Dialog „Hilfslinien & Satzspiegel…".
• Einrasten (Snapping): beim Verschieben an Seitenkanten/-mitte, Satzspiegel, Hilfslinien und anderen Elementen; Schwellwert und Aktivierung aus den Einstellungen.
• Mehrfachauswahl: Cmd-/Shift-Klick und Marquee-Auswahl; Gruppen-Drag rastet am Union-Frame ein; Ausrichten (6 Ziele) und Verteilen (horizontal/vertikal) im Inspector; „Durchklicken" durch überlappende Elemente mit Cmd+Alt+Shift.
• Elementtypen: Text, Textrahmen, Bild (Asset-Verweis), Rechteck, Pfad, Platzhalter, QR-Code.

4.2 Text & Typografie

• Textrahmen: Innenrand, Mehrspaltigkeit (1–12 Spalten, Spaltenabstand), vertikale Ausrichtung (oben/mitte/unten/Blocksatz) und Initialen (Drop Caps, 1–4 Zeilen).
• Fließtext-Verkettung: Rahmen über Seiten hinweg verketten und lösen (Inspector), verteiltes Rendering pro Rahmen, Überlauf-Hinweis, wenn der Text nicht vollständig in die Kette passt.
• Click-to-edit: Doppelklick öffnet den formatierten Texteditor direkt im Rahmen; bei verketteten Ketten bearbeitet der Editor den gesamten Fließtext am Kettenkopf.
• Zeichenformate im Editiermodus: Unterstrichen/Durchgestrichen, Hoch-/Tiefstellung, Spationierung, Textfarbe.
• Typografie: Schriftfamilie/-größe/-gewicht (100–900), Kursiv, variable Font-Achsen, OpenType-Features (Ligaturen, Kapitälchen, Mediävalzahlen, Tabellenzahlen, Brüche), Text auf Pfad mit Offset/Ausrichtung.
• Vorlagen: Absatz- und Zeichenvorlagen dokumentbasiert plus anwendungsweite Stilbibliothek mit Abgleich in beide Richtungen (Stile-Panel).

4.3 Assets, Brand & QR

• Asset-Bibliothek: die zentrale Asset-Bibliothek der Suite in der Sidebar; Bilder per Drag & Drop auf den Canvas ziehen (aspect-fit gerendert).
• Brandkits: mit Dokumenten verknüpfen — Brandkit-Farben erscheinen als eigene Palettenabschnitte, Brandkit-Assets als Schnellzugriff, und die Brandkit-Formatvorlagen lassen sich ins Dokument importieren.
• Farbpalette: dokumenteigene Farben in einer vereinheitlichten Palette (Dokument + Brandkits).
• QR-Code-Generator: mit Korrekturlevel und frei wählbaren Vorder-/Hintergrundfarben (Header-Button „QR-Code einfügen").

4.4 Dokumentenarbeit

• Undo/Redo: konfigurierbare Schrittzahl; History-Panel mit beschrifteten Zuständen und Direktsprung. Widerrufen ⌘Z, Wiederholen ⌘⇧Z (Header-Buttons).
• Löschen: ausgewählte Elemente per Entf (Header-Button).
• Autosave: am bekannten Dateiort; Intervall und Aktivierung aus den Einstellungen.
• Versionierung: manuelle Checkpoints, Wiederherstellen früherer Versionen, Freigabe-/Korrekturgänge mit Reviewer und Status (Versionen-Panel im Inspector).
• Einstellungen: Themes (hell/dunkel/system) und 5 Sprachen (de/en/es/fr/it) über die gemeinsamen Module; Einstellungen… (⌘,).

4.5 SEO & Datenschutz (Web-Export)

Das Panel öffnest du über Ablage ▸ Als HTML exportieren… (kein Kürzel). Es gilt dokumentweit, da der Export eine einzelne index.html für alle Seiten erzeugt.

• SEO & Social-Meta: Title, Meta-Description, Canonical/Basis-URL, Open-Graph (title/description/image/type), Twitter-Card, Robots index/noindex. Zeichenzähler mit Empfehlung (60/160 Zeichen) als Hinweis; leere Felder werden im Export weggelassen.
• sitemap.xml & robots.txt: werden aus der Basis-URL geschrieben (die Robots-Einstellung steuert Allow/Disallow); ohne Basis-URL zeigt das Panel einen Hinweis statt kaputter Dateien.
• DSGVO-/Consent-Toolkit: lokal generiertes Consent-Banner (annex-consent.js, kein CDN/externer Dienst; Banner-Text und Buttons konfigurierbar; die Entscheidung liegt nur im localStorage des Besuchers) und 2-Klick-Embeds: Textelemente mit eigenständiger YouTube-/Vimeo-URL werden als Platzhalter exportiert, das iframe lädt erst nach Zustimmung und Klick (nocookie-/dnt-Embed-URLs).
• Fonts: der Export referenziert von vornherein lokale System-Font-Stacks — keine Google-Fonts-Links. Das Panel dokumentiert das als Info, und der Export prüft seine Ausgabe per Selbstcheck auf externe Font-/Tracking-Referenzen.

4.6 Barrierefreiheit des Web-Exports (BFSG/WCAG)

Zwei Orte, weil es zwei Gegenstände sind: am Element steht, was der Inhalt bedeutet; an der Site steht, wie die Seite gebaut ist.

• Am Element (Inspector, Abschnitt „Barrierefreiheit"): Alternativtext für Bilder, der Schalter Rein schmückend (er schreibt alt="" und role="presentation" — eine Aussage, kein Versehen) und die Überschriftenebene H1–H6 für Textelemente. Für Rechtecke, Linien und Formen sagt der Abschnitt, dass es hier nichts einzustellen gibt, statt eine leere Bedienung zu zeigen.
• An der Site (Ablage ▸ Als HTML exportieren…, Abschnitt „Barrierefreiheit"): Sprache der Seite (lang), Sprungmarke „Zum Inhalt" als erstes fokussierbares Element und sichtbarer Fokusrahmen.
• Prüfung im selben Abschnitt: Sie listet Verstöße und Auffälligkeiten mit ihrem WCAG-Erfolgskriterium — fehlender Alternativtext (1.1.1), zu geringer Kontrast (1.4.3), fehlende Sprache (3.1.1), fehlender Seitentitel (2.4.2), Überschriftenstruktur (1.3.1), Formularfeld ohne Beschriftung (3.3.2). Wer die Sprache einträgt, sieht den Befund verschwinden.
• Der Vorbehalt gehört dazu: Die Prüfung deckt nur maschinell Prüfbares ab. Verständlichkeit, Lesereihenfolge und die Güte eines Alternativtextes bleiben deine Beurteilung — ein leerer Befundzettel ist keine Konformitätserklärung.

4.7 Kontaktformular (Web-Export)

Im selben Dialog, Abschnitt „Kontaktformular". Es gilt dokumentweit wie die übrigen Site-Angaben.

• Einschalten, Empfänger eintragen, Felder setzen. „Standardfelder einsetzen" legt Name, E-Mail und Nachricht an. Ohne Empfänger schreibt der Export kein Formular — eines, das ins Leere sendet, wäre schlimmer als keines.
• Versandweg kontakt.php: Der Export legt die Datei neben die index.html. Der Webserver muss PHP mit mail() bereitstellen; ein fremder Formulardienst ist nicht beteiligt. Das erzeugte Skript prüft Pflichtfelder, wehrt Header-Injektion ab und verwirft Zusendungen, die in den unsichtbaren Honigtopf schreiben.
• Versandweg mailto:: ohne Server, öffnet aber das Mailprogramm des Besuchers und funktioniert nicht überall.
• Einwilligung (DSGVO): Pflicht-Ankreuzfeld mit eigenem Text, voreingestellt eingeschaltet.
• Barrierefrei gebaut: Jedes Feld hat eine Beschriftung, die auf es zeigt; Pflichtfelder tragen required und aria-required, E-Mail und Telefon ihre autocomplete-Angabe. Ein Feld ohne Beschriftung meldet die Prüfung aus 4.6.

4.8 Ausschießen (Print-Assistent)

Ablage ▸ Print-Assistent… führt durch Papier, Anschnitt, Marken, Farbraum, Seitenbereich — und als sechsten Schritt durch das Ausschießen. Er steht hinter dem Seitenbereich, weil die Bogenzahl davon abhängt, welche Seiten gedruckt werden.

• Rückstichbroschur: zwei Nutzen je Bogenseite in Falzbogen-Reihenfolge. Die Seitenzahl wird auf ein Vielfaches von vier aufgefüllt; wie viele Blindseiten das sind, steht im Schritt.
• Nutzenmontage: fortlaufende Seitenfolge im Raster, Zeilen und Spalten frei bis 6 × 6. Der letzte Bogen bleibt teilweise leer statt aufgefüllt.
• Steg und Bogenrand in Millimetern. Die Schnittmarken sitzen an jedem Nutzen, nicht am Bogenrand — dort schneidet die Maschine.
• Zwei Dinge, die der Schritt ausdrücklich sagt: Bei Seiten verschiedener Größe rechnet der Bogen mit der größten und stellt kleinere mittig hinein. Und Ausschießen ordnet die Seiten selbst — der Doppelseiten-Export bleibt dabei wirkungslos.
• Bewusste Grenze: Der Anschnitt gilt am Bogenrand, nicht zwischen den Nutzen. Wer randabfallende Elemente hat, macht den Steg breit genug.

4.9 Verknüpfte Objekte

Über Ablage ▸ Platzieren… fügst du Bilder und Assets in einen Bildrahmen ein. Im Dialog wählst du Verknüpft oder Eingebettet. Verknüpfte Objekte referenzieren die Originaldatei und bleiben außerhalb des .axpublish-Containers.

In der Ebenen- und Seiten-Sidebar zeigt ein Status-Badge den Zustand der Verknüpfung an:

Vor dem PDF-Export prüft der Preflight auf fehlende Verknüpfungen und bricht den Export mit einer Warnung ab, bis die Verknüpfungen repariert oder eingebettet sind.

Grenzen: Verknüpfte Objekte in Textrahmen werden nicht unterstützt; sie müssen in eigenen Bildrahmen liegen.

4.10 Design-Grid und Baseline-Grid

Das Design-Grid richtest du über Darstellung ▸ Design-Grid (oder den Header-Button) ein. Der Dialog legt Spaltenanzahl, Spaltenabstand, Rastereinheit und Seitenränder fest. Objekte und Textrahmen rasten am Grid aus, wenn Einrasten aktiviert ist.

Das Baseline-Grid aktivierst du über Darstellung ▸ Baseline-Grid. Es zeigt eine Zeilengrundlinie über die Seite, an der Text ausgerichtet werden kann. Verbinde Absatzvorlagen mit dem Baseline-Grid, damit Fließtext automatisch auf den Zeilen abstimmt.

Grenzen: Das Baseline-Grid wirkt auf Fließtext in verketteten Rahmen; aneinandergehangene Rahmen über Seiten hinweg nutzen jeweils das Grid der Zielseite.

5. Formate & Interoperabilität

• Eigenes Format: .axpublish — AnnexDocument-Container (AnnexCoreKit) mit JSON-Snapshot (publish.json), Versionsmanifest und Versions-Snapshot-Assets. Speichern über Ablage ▸ Speichern (⌘S).
• Export: PDF (mehrseitig, Seitengröße pro Seite, layoutgetreuer CoreGraphics-Renderpfad inkl. Text auf Pfad und QR-Codes) über Ablage ▸ Exportieren…; HTML/CSS über Ablage ▸ Als HTML exportieren… (index.html in einem Zielordner, Bilder als eingebettete PNG-Data-URIs, SVG-TextPath für Text auf Pfad, <head> mit SEO-/Social-Meta-Tags, optional sitemap.xml/robots.txt und lokales Consent-Script — kein externer Dienst).
• Druck: systemweiter Druck über Ablage ▸ Drucken… (⌘P); Druck, Vorschau und PDF-Export nutzen denselben Renderpfad.
• Import: Datenquellen aus CSV (Semikolon), JSON, XML (<record>-Struktur) und TXT über „Datenquelle importieren"; SVG- und PDF-Dateien als Layout-Elemente über AnnexImportKit („Vektor/SVG importieren").
• Suite-Interop: Copy/Paste von Elementen über die Annex-Zwischenablage (LayerPayload, AnnexInteropKit); Verknüpfungs-Registry Element↔Asset und Platzhalter↔Datenquelle; gemeinsame Brandkit- und Asset-Bibliothek (AnnexAssetKit). Laut docs/konzepte/SHARED_MODULES.md lassen sich Vektor-Illustrationen aus AnnexDesign in AnnexPublish platzieren und exportierte HTML/CSS/JSON-Projekte in AnnexCode weiterbearbeiten.
• Sync: Versions-/Detail-Sync mit einem Team-Workspace-Server (offline-first, konfigurierbar im Versionen-Panel); beim Speichern wird der zentrale Versions-/Entwurfsindex aktualisiert, damit AnnexHub-Suchen das Dokument sehen. Keine iCloud-Verdrahtung.

6. MCP-Bedienung

Der MCP-Host läuft in AnnexHub (JSON-RPC 2.0 via STDIO) und wird dort gestartet; AnnexHub hostet die Tools der Suite, stellt aber selbst keine eigenen bereit. Für Agents stehen bereit:

Suite-Tools (alle Apps):

App-spezifisches Tool:

Skills (suite-weit): suite.discover (Apps und Tools erkunden — Einstieg für jeden Agenten), brandkit.apply (Brandkit-Rollen auf ein Dokument übertragen — unterstützt AnnexPublish).

Damit sind die dokumentierten Aktionen — Dokumente öffnen, Apps steuern, Assets suchen, Lizenzstatus abfragen — vollständig automatisierbar.

7. Diagnostik & Privatsphäre

AnnexPublish protokolliert Fehler und Aktionen lokal über AnnexDiagnosticsKit in rotierende JSON-Log-Dateien unter ~/Library/Logs/AnnexCREATE/AnnexPublish/, gespiegelt nach os_log (Subsystem com.annexcreative.annexpublish), mit PII-Filter. In der Entwicklungsphase ist die Protokollierung per Default aktiv und in den Einstellungen (Datenschutz) abschaltbar; es findet keine Übertragung statt.

Telemetrie (anonyme Nutzungs-Events und Crash-Reports) läuft ausschließlich per Opt-in — Default ist aus — und lässt sich zur Laufzeit in den Einstellungen umschalten.

Deine Dokumente bleiben auf dem Mac: .axpublish-Dateien, Asset-Verweise und Einstellungen sind lokal; der Team-Versions-Sync ist optional und setzt eine von dir konfigurierte Workspace-Verbindung voraus.

8. FAQ

Welches Dateiformat nutzt AnnexPublish? Das eigene Container-Format .axpublish (AnnexDocument-Container mit JSON-Snapshot, Versionsmanifest und Snapshot-Assets). Gespeichert wird über Ablage ▸ Speichern (⌘S).

Kann ich PDF und HTML aus demselben Dokument exportieren? Ja. Ablage ▸ Exportieren… erzeugt ein mehrseitiges Print-PDF, Ablage ▸ Als HTML exportieren… eine Website (index.html plus optional sitemap.xml/robots.txt und lokalem Consent-Script). Beide Wege nutzen denselben layoutgetreuen Renderpfad wie der Druck.

Warum lädt mein YouTube-Video im HTML-Export nicht sofort? Weil 2-Klick-Embeds aktiv sind: Textelemente, die nur eine YouTube-/Vimeo-URL enthalten, werden als Platzhalter mit Hinweis exportiert; das iframe lädt erst nach Zustimmung im Consent-Banner und Klick. Das Verhalten konfigurierst du im Datenschutz-Abschnitt des HTML-Export-Panels.

Bindet der HTML-Export Google Fonts ein? Nein. Der Export referenziert ausschließlich lokale System-Font-Stacks und prüft seine Ausgabe per Selbstcheck auf externe Font-/Tracking-Referenzen.

Kann ich Daten für Serienlayouts importieren? Ja: Datenquellen aus CSV (Semikolon), JSON, XML (<record>-Struktur) und TXT lassen sich importieren, und Platzhalter-Elemente kannst du anlegen. Das automatische Befüllen der Platzhalter aus Datensätzen (Serienbrieffunktion) ist aktuell noch nicht im UI-Pfad verdrahtet (Stand: siehe Feature-Liste).

Wie stelle ich eine frühere Version wieder her? Im Versionen-Panel (Inspector) legst du manuelle Checkpoints an und stellst frühere Versionen über „Wiederherstellen" zurück. Freigabe-/Korrekturgänge mit Reviewer und Status laufen über dasselbe Panel.

Was passiert, wenn Speichern oder Export fehlschlägt? Du bekommst einen Fehler-Alert im UI; die Änderungen liegen dann weiterhin im Arbeitsspeicher vor und gehen nicht verloren.

Brauche ich für den Team-Sync einen Server? Der Versions-/Detail-Sync mit einem Team setzt eine konfigurierte Workspace-Verbindung (Server) voraus. Rein lokale Versionierung — Checkpoints und Wiederherstellen — funktioniert ohne Server.