Dev-Server
formfeed dev invoice-de
# formfeed dev: invoice-de on http://127.0.0.1:4400
Starten Sie den Befehl innerhalb eines Projekts. Ohne Slug öffnet er die alphabetisch erste Vorlage. Beenden Sie ihn mit Strg+C.
- Beobachtet den Ordner der Vorlage, die Partials- und Dateiordner und
.formfeed/und rendert bei jeder Änderung neu; der Browser aktualisiert sich über Server-Sent Events. Auchformfeed brand pullin einem anderen Terminal aktualisiert die Vorschau. - Paged (der Standard) zeigt echte Seiten mit Kopf- und Fußzeilen und Seitenzahlen, umbrochen von Paged.js wie im Web-Editor; Flow zeigt das Dokument als eine lange Seite. Eine Bildvorlage erscheint immer im Flow, in ihrer Pixelgröße.
- Datensätze (
data/*.json) und Sprachen (i18n.json) lassen sich in der Werkzeugleiste wechseln. - Diagnosebereich mit denselben Meldungen wie im Web-Editor (Zeile und Spalte jedes Fundes).
- Liefert den Ordner
files/des Projekts aus, sodassasset('logo.png')und relative Bildpfade die lokale Kopie der Dateibibliothek zeigen.formfeed files pullfüllt den Ordner aus dem Workspace. - Vorlagen sehen das Brand Kit aus
.formfeed/brand.jsonalsbrand; ohne die Datei sehen sie ein leeres Kit.formfeed brand pullschreibt sie. - Button True render, wenn ein Schlüssel konfiguriert ist (
--api-key,FORMFEED_API_KEYoder der Schlüssel, denformfeed logingespeichert hat): das PDF oder Bild, das die API aus Ihren lokalen Dateien mit dem gewählten Datensatz erzeugt. Der Bereich zeigt die Seitenzahl, die verbrauchten Einheiten und einen Link auf die Datei. Ein Test-Schlüssel rendert kostenlos; der Schlüssel, denformfeed loginspeichert, ist ein Live-Schlüssel, dessen Renderings gegen Ihren Plan zählen. Ohne Schlüssel ist der Button aus, alles andere funktioniert. - Bei einer Vorlage, die
pdf.uafestlegt, prüft die Vorschau die Seite, die sie zeigt, und führt unter Template check · PDF/UA-1 auf, was sie gefunden hat; ein echtes Rendering zeigt das Urteil des Validators mit den verletzten Regeln.
Word- und PowerPoint-Vorlagen
formfeed dev öffnet auch einen Ordner mit template.docx oder template.pptx. Eine lokale Vorschau des Dokuments selbst gibt es nicht:
- Bearbeiten Sie die Datei in Word oder PowerPoint und speichern Sie sie; der Diagnosebereich listet bei jedem Speichern die Funde zu den Tags, nach Teil und Absatz (
word/document.xml ¶12) statt nach Zeile und Spalte. - True render füllt das Dokument auf Ihrem Rechner mit der Engine der Render-Server und wandelt es über die API in PDF um (
POST /pdf/convert), was den Starter-Plan oder höher braucht. Der Rahmen zeigt dieses PDF, und nach dem ersten echten Rendering rendert jede gespeicherte Änderung erneut. - QR-Codes, Barcodes und SVG-Bilder zeichnet
@resvg/resvg-js, eine optionale Abhängigkeit der CLI. Ohne das Paket, und bei WebP-, GIF- und AVIF-Bildern, die nur die Render-Server zeichnen, meldet das Rendering eine Warnung und lässt das Bild weg.
Flags
| Flag | Bedeutung |
|---|---|
--port <n> | Port, Standard 4400 |
--host <host> | Bind-Adresse, Standard 127.0.0.1 |
--open | Browser öffnen |
--data <name> | Anfänglicher Datensatz (data/<name>.json) |
--locale <tag> | Anfängliche Sprache (aus i18n.json) |
Noch nicht verfügbar: --open-in-editor (vscode://-Links in den Diagnosen) und --local-chromium (näherungsweises Rendering mit einem lokalen Playwright-Chromium).
Der Server bindet standardmäßig an 127.0.0.1, erreichbar also nur von Ihrem eigenen Rechner; --host 0.0.0.0 öffnet ihn für Ihr Netzwerk. Ein belegter Port beendet den Befehl mit Exit-Code 2; wählen Sie mit --port einen anderen. Für die Offline-Funktionen braucht er kein Konto.