Arif Kobel.
← Alle Projekte

Tintenfisch.

Ein PDF-Editor, der komplett im Browser läuft. Eine Case Study über eine eigene PDF-Engine in Rust, Text, der Text bleibt, und Dateien, die das Gerät nie verlassen.

01

Worum es geht

Tintenfisch mit Werkzeugleiste links und Kommentar-Panel rechts
Werkzeuge und Kommentare

Tintenfisch ist ein PDF-Editor im Browser. Text direkt in der Datei ändern, Seiten sortieren, kommentieren, Formulare ausfüllen und bauen, schwärzen, signieren und mit einem Passwort schützen. Ohne Konto und ohne Upload: Dokumente werden im Browser geöffnet, bearbeitet und gespeichert, kein Server bekommt sie zu sehen.

Viele Online-Editoren laden die Datei auf einen Server oder legen beim Bearbeiten ein weißes Kästchen mit neuem Text über den alten. Beides wollte ich nicht. Also habe ich die Engine selbst geschrieben.

02

Eine PDF-Engine von Grund auf

Tintenfisch mit Seitenübersicht und Vorschaubildern der Seiten
Die Seitenübersicht

Die Engine besteht aus gut 25.000 Zeilen Rust und kommt ohne fremde PDF-Bibliothek aus. Sie parst die Dateistruktur, interpretiert die Content Streams der Seiten und zeichnet sie selbst. Dazu gehören die gängigen Schriftformate von Type 1 über TrueType bis zu CID-Fonts, eigene Decoder für JPEG 2000, JBIG2 und CCITT-Fax, Verschlüsselung und digitale Signaturen.

Kompiliert wird sie zu WebAssembly und läuft in einem Web Worker. Die Oberfläche in React hält kein eigenes Dokumentmodell, sie schickt nur Nachrichten an die Engine und zeigt, was zurückkommt. Seiten kommen als Kacheln, und ein kleiner Scheduler im Worker arbeitet zuerst ab, was gerade angeklickt wird, dann was sichtbar ist, dann was als Nächstes kommt. Überholte Anfragen fliegen raus, bevor sie Rechenzeit kosten.

03

Text, der Text bleibt

Text wird direkt im PDF bearbeitet, mit Schriftformatierung in der Seitenleiste
Text direkt im PDF bearbeiten

Das Herzstück ist das Bearbeiten von Text. Statt die alte Zeile zu übermalen, sucht die Engine die Textbefehle des Absatzes im Content Stream, setzt den geänderten Absatz mit den Metriken der Originalschrift neu, bricht ihn um und schreibt neue Textbefehle an dieselbe Stelle zurück. Der Rest der Seite bleibt, wie er war.

Knifflig wird es, wenn eine eingebettete Schrift nur die Buchstaben enthält, die im Original vorkamen. Fehlt ein Zeichen, greift Tintenfisch auf eine passende freie Schrift zurück und bettet davon nur die gebrauchten Glyphen ein. Bevor es dafür eine Schrift aus dem Netz lädt, fragt es nach.

Gespeichert wird normalerweise als inkrementelles Update: Die Änderungen werden an die Datei angehängt, das Original bleibt unangetastet. Nur wenn es nötig ist, etwa beim Optimieren oder bei einer reparierten Datei, schreibt die Engine sie komplett neu. Und beim Schwärzen verschwindet der Inhalt wirklich aus der Datei, statt nur unter einem Balken zu liegen.

04

Getestet wie eine Bibliothek

Die Engine hat über 300 Tests. Golden-Tests rendern jede Testseite und vergleichen sie Pixel für Pixel mit einem Referenzbild, andere prüfen, dass sich eine Seite aus vier Kacheln ohne Naht wieder zusammensetzt. Ein Fuzz-Test tippt zufällige Änderungen in Absätze und prüft, dass der Text genau so ankommt, wie er getippt wurde, und sich vollständig rückgängig machen lässt.

Für die Oberfläche laufen Vitest-Tests, die die Stores gegen eine nachgebaute Verbindung zur Engine prüfen. Als Testdateien dienen nur kleine, selbst gebaute PDFs, nie echte Dokumente.

05

Der Stack

Selbst ausprobieren?

tintenfisch.app