Funktion
Der Vorlageneditor
Die meisten Dokument-APIs geben Ihnen ein Textfeld. Formfeed gibt den Menschen, die Vorlagen schreiben, den Editor, den sie verdienen: Er kennt Ihre Daten, zeigt die Seiten so, wie Chromium sie druckt, und behält jede veröffentlichte Version.
Kostenloser Plan mit 100 Einheiten im Monat, keine Kreditkarte
Autovervollständigung aus den eigenen Daten
Tippen Sie eine Variable, und der Editor bietet die Felder Ihrer Beispieldaten mit ihren Beispielwerten an. Helfer und Filter vervollständigen sich mit ihrer Signatur, Sie raten die Argumentreihenfolge also nie.
- Pfade statt Raten. Verschachtelte Objekte werden durchlaufen, ein tiefes Feld ist einen Tastendruck entfernt; eine Liste vervollständigt sich mit ihrem Namen.
- Helfer-Signaturen. Der Mauszeiger über einem Helfer zeigt Parameter, Standardwerte und ein Beispiel in Ihrer Vorlagensprache.
- Partials. Includes vervollständigen sich aus den eigenen Partials der Vorlage und denen, die Ihre Organisation teilt.
Diagnosen vor dem Rendern
Ungeschlossene Blöcke, unbekannte Filter und Variablen, die in den Beispieldaten fehlen, werden beim Tippen unterstrichen, mit Zeile und Spalte. Dieselbe Analyse läuft in der Kommandozeile und in Ihrer Testsuite; was lokal besteht, besteht in der Produktion.
Bausteine statt leerer Seite
Das Bausteine-Panel enthält, was sich in Geschäftsdokumenten wiederholt: Briefkopf und Pflichtfußtext aus Ihrem Brand Kit, ein Anschriftfeld für Fensterumschläge nach DIN 5008, Rechnungstabellen und Summen, Zahlungsbedingungen mit Bankverbindung und EPC-Zahlcode, Umsatzsteuerhinweise, Kennzahlen und Diagramme. Jeder Baustein zeigt die Vorschau in Sprache, Währung und Brand Kit Ihrer Vorlage und wird mit seinen Beispieldaten, dem fehlenden CSS und seinen Beschriftungen auf Deutsch und Englisch eingefügt.
- Eigene Partials. Die Partials, die Ihre Organisation teilt, etwa Briefköpfe und Fußzeilen, erscheinen im selben Panel unter „Partials der Organisation“ und werden als Include eingefügt.
- Suche auf Strg+K. Ein Feld findet Ihre Vorlagen, die Beispiele, geteilte Partials, Dateien, API-Schlüssel, Webhook-Endpunkte, Mitglieder und jede Seite der App, im Editor auch jeden Baustein und jedes Panel. Was passt, ist hervorgehoben.
Eine Vorschau, die paginiert
Der rechte Bereich rendert echte Seiten mit laufenden Kopf- und Fußzeilen und Seitenzahlen, befüllt von derselben Vorlagen-Engine wie auf den Render-Servern. Wechseln Sie zwischen Datensätzen, um zu sehen, wie das Layout mit fünfzig Positionen oder einem fehlenden optionalen Feld aussieht.
- Echtes Rendering. Ein Klick rendert den Entwurf auf unseren Servern und zeigt das PDF oder Bild, das Chromium druckt, im Free-Plan mit der Testmarkierung. Es kostet in keinem Plan eine Einheit.
- Klick zur Quelle. Ein Klick auf ein Element in der Vorschau springt zur Zeile, die es erzeugt hat.
- Text in der Vorschau bearbeiten. Mit Text bearbeiten ändern Sie Überschriften, Absätze und übersetzte Beschriftungen direkt in der Vorschau. Werte aus den Daten bleiben, wie sie sind, und die Änderung landet als eine Bearbeitung in der Vorlage, die Strg+Z rückgängig macht.
Von der Vorlage in Ihren Code
Der API-Tab einer Vorlage zeigt den Aufruf, der sie rendert, in curl, TypeScript, Python, PHP, Go, C#, Java und Ruby, mit dem Slug der Vorlage und ihren Beispieldaten als data.json. Die erste Zeile sagt, welche Version ein Aufruf rendert, und ein Klick sendet die Anfrage als Test-Rendering und zeigt die Antwort, die Ihr Code erhält.
- Ein Test-Schlüssel an Ort und Stelle. Inhaber und Admins legen im Tab einen Test-Schlüssel an. Sein Geheimnis wird einmal angezeigt, als die Zeile, die Ihre Shell braucht.
- Veröffentlicht oder Entwurf. Aufrufe rendern die veröffentlichte Version. Ein Schalter nimmt den neuesten Entwurf in die Anfrage auf, den Test-Schlüssel rendern dürfen.
- Die Antwort der API selbst. Ein Test-Rendering kostet nichts und steht im Render-Protokoll. Scheitert eine Vorlage, zeigt der Tab das Problem so, wie die API es meldet, mit der Seite, die es erklärt.
Eine Historie, auf die Verlass ist
Jedes Speichern ist eine Version, mit einer Notiz, wenn Sie eine schreiben, und jedes Rendering hält fest, welche Version es verwendet hat. Vergleichen Sie eine Version nebeneinander mit Ihrer Arbeitskopie, oder stellen Sie sie als neuen Entwurf wieder her. Bewahrt ein Workspace Render-Anfragen auf (eine Einstellung der bezahlten Pläne: bis zu einem Tag in Starter, einer Woche ab Pro), holt „Mit diesen Daten im Editor öffnen“ die Daten eines fehlgeschlagenen Renderings in den Editor, und die Vorschau zeigt den Fehler erneut.
FAQ
- Können auch Nicht-Entwickler damit arbeiten?
- Ja. Wer den Text verantwortet, ändert ihn mit Text bearbeiten direkt in der Vorschau, und Bildvorlagen lassen sich im visuellen Editor auf einer Arbeitsfläche gestalten; Entwickler verantworten den Datenvertrag und können dieselben Vorlagen als Dateien im Repository halten.
- Funktioniert das offline?
- Für HTML-Vorlagen bringt der Dev-Server der Kommandozeile dieselbe Vorschau ohne Konto auf Ihren Rechner; nur das echte Chromium-Rendering braucht die API. Word- und PowerPoint-Vorlagen zeigen ihre Vorschau über die API.
Aus dem Blog
- Die Vorschau, die lügt, und die, die es nicht tut →
Eine paginierte Vorschau auf Basis von Paged.js bringt neun Karten auf eine Seite, wo Chromiums PDF sechs bringt. Warum, die eine Regel, die wir geändert haben, damit die Vorschau umbricht, wo das PDF umbricht — und der Fall, den keine Vorschau zeigen kann, weil Chromium das ganze PDF verkleinert.