Kapitel 21 · Teil III · In der Praxis

Agent-Skill: eine Publikation nach Postext übertragen

Installieren Sie den Skill postext-port in Claude Code, Codex oder einem anderen Agenten und lassen Sie ihn eine PDF-, Word-, PowerPoint-, EPUB-, InDesign- oder HTML-Quelle in ein Postext-Projekt umwandeln, das dem Layout des Originals folgt

Aktualisiert 2026-10-098 minenescadefritptzhjaar

Kurz gesagt

Diese Seite richtet sich an Menschen, die ein Buch oder Dokument bereits in einem anderen Format haben, etwa als PDF, Word- oder InDesign-Datei, und es nach Postext übertragen möchten. Ein KI-Helfer, ein sogenannter Agent, kann den größten Teil der Arbeit erledigen, wenn Sie ihm eine kleine Erweiterung geben, einen sogenannten Skill. Der Skill bringt dem Agenten bei, den Text zu übernehmen und die Gestaltung des Originals nachzubauen. Die Seite erklärt, wie Sie ihn installieren, worum Sie bitten und wie Sie das Ergebnis prüfen. Ein Video von etwa fünf Minuten, auf Englisch, zeigt jeden Schritt.

Machen Sie aus einer vorhandenen Publikation mit einem Coding-Agenten ein Postext-Projekt.

Viele kommen mit einem Buch zu Postext, das es bereits gibt: ein Lehrbuch als Druck-PDF, ein Bericht in Word, ein Kurs in PowerPoint, ein Katalog in InDesign, ein EPUB. Die Übertragung umfasst zwei Aufgaben:

  • Inhalt: das erweiterte Markdown jedes Kapitels mit seinen Direktiven und Mikroformaten.
  • Gestaltung: ein Konfigurationsmanifest, das die Layoutregeln des Originals nachbildet (Seitengeometrie, Grundlinienraster, Schrift, Kapitelauftakte, Kolumnentitel, Kästen, Gleitobjekte, Tabellen, Teile).

Ein LLM kann einen großen Teil dieser Arbeit übernehmen, aber nur, wenn es weiß, wie Postext funktioniert. Postext-Markdown ist kein CommonMark, und die Konfiguration hat Fallstricke, die erst auffallen, wenn eine Seite falsch gerendert wird. Der Skill postext-port bündelt dieses Wissen mit den Werkzeugen, mit denen wir jede Vorlage in der Sandbox gebaut haben, damit Ihr Agent die Übertragung sauber erledigen kann.

Er folgt dem offenen Format Agent Skills und funktioniert daher mit Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode und vielen anderen Agenten.

#Das Tutorial ansehen

Fünf Minuten, kein Code: den Ordner vorbereiten, die Vektororiginale mitbringen, ein Referenz-PDF hinzufügen, den Agenten beauftragen und das Ergebnis in der Sandbox prüfen. Das Video ist auf Englisch.

Transkript

Alles, was der Sprecher sagt, mit einer Beschreibung dessen, was auf dem Bildschirm zu sehen ist.

  1. 0:00

    Auf dem BildschirmTitelkarte: das Postext-Logo, die Dachzeile „Tutorial · 5 steps“ („Tutorial in 5 Schritten“) und der Titel „Turn your publication into Postext with an AI agent. No code.“ („Überführen Sie Ihre Publikation mit einem KI-Agenten in Postext. Ohne Code.“)

  2. 0:03

    Auf dem Bildschirm„Your publication already exists.“ („Ihre Publikation gibt es schon.“) Drei von Postext gesetzte Seiten, ein Buch, ein Handbuch und eine Zeitschrift, fallen nacheinander herein, beschriftet mit InDesign (IDML), Word (DOCX) und PDF. Sie sammeln sich links, ein gestrichelter goldener Pfeil läuft durch ein Abzeichen „AI agent“ (KI-Agent), und ein Dateisymbol namens my-book.postext erscheint, unter „An agent turns it into Postext. Five steps. A few well-written requests.“ („Ein Agent überführt sie in Postext. Fünf Schritte. Ein paar gut formulierte Anfragen.“)

    SprecherSie haben bereits eine Publikation: ein Buch, ein Handbuch, eine Zeitschrift. Sie liegt in InDesign, in Word oder in einem PDF. In diesem Tutorial überführt ein KI-Agent sie für Sie in Postext. Ohne Code: nur fünf Schritte und ein paar gut formulierte Anfragen.

  3. 0:23

    Auf dem Bildschirm„The plan“ („Der Plan“): Fünf nummerierte Karten erscheinen, während jeder Schritt genannt wird: 01 Prepare the folder (den Ordner vorbereiten), 02 Bring the vector originals (die Vektororiginale mitbringen), 03 Add a reference (eine Referenz hinzufügen), 04 Ask the agent (den Agenten beauftragen), 05 Check in the sandbox (in der Sandbox prüfen).

    SprecherDas ist der Plan: den Ordner vorbereiten, die Originalgrafiken mitbringen, eine Referenz hinzufügen, den Agenten beauftragen und das Ergebnis prüfen.

  4. 0:33

    Auf dem BildschirmSchritt 01, der Ordner: „One project, one folder.“ („Ein Projekt, ein Ordner.“) Ein großer Ordner, my-book/, schwebt zwischen zehn losen Dateien wie MinionPro-Regular.otf, cover.jpg, fig-2-1.ai, chapter-01.docx, map.svg, book.idml und chart.pdf. Ein Fenster mit dem Ordnerbaum öffnet sich, und jede Datei fliegt in ihren Unterordner, sobald er genannt wird: reference.pdf (wie es aussehen muss, Schritt 03), fonts/ (Minion Pro, Myriad…, .otf .ttf .woff2), images/ (Fotos, .jpg .png), artwork/ (Vektororiginale, .ai .svg .pdf) und text/ (Word, InDesign IDML…).

    SprecherSchritt eins: Legen Sie alles in einen einzigen Ordner auf Ihrem Computer. Ein Projekt, ein Ordner. Darin bekommt jede Art von Material einen eigenen Unterordner: die Schriften, die Bilder, die Illustrationen und die Textdateien.

  5. 0:50

    Auf dem BildschirmDie Zeile fonts/ wird hervorgehoben, und eine Karte mit der Überschrift „Fonts“ (Schriften) zeigt ein großes „Aa“, die Schnitte Regular, Italic und Bold, die Formate OTF, TTF und WOFF2 und den Hinweis „Only the fonts you include can be used.“ („Nur die Schriften, die Sie beilegen, können verwendet werden.“) Dann „The tidier the folder, the less it guesses.“ („Je ordentlicher der Ordner, desto weniger muss er raten.“), während jeder Unterordner im Baum ein Häkchen bekommt.

    SprecherVergessen Sie die Schriften nicht. Sie geben der Gestaltung ihre Stimme, und der Agent kann nur die verwenden, die Sie beilegen. Je ordentlicher der Ordner, desto weniger muss der Agent raten.

  6. 1:03

    Auf dem BildschirmSchritt 02, Vektororiginale: „Bring the originals.“ („Bringen Sie die Originale mit.“) Ein Diagramm, ein Schaubild und eine Karte werden als Strichzeichnungen mit sichtbaren Ankerpunkten gezeichnet, und drei Dateisymbole erscheinen: .ai Illustrator, .svg SVG und .pdf PDF.

    SprecherSchritt zwei: Wenn Ihre Illustrationen Vektorgrafiken sind, etwa Diagramme, Schaubilder oder Karten, suchen Sie die Originaldateien heraus: Illustrator, SVG oder PDF.

  7. 1:14

    Auf dem BildschirmZwei Felder zeigen dieselbe Abbildung, ein Diagramm, in dem Manuscript und Template beide auf Pages zeigen, mit der Bildunterschrift „Fig. 2.1 Content and design meet.“ („Abb. 2.1 Inhalt und Gestaltung treffen sich.“) Links wird „Cut from the PDF: a photo of the drawing“ („Aus dem PDF ausgeschnitten: ein Foto der Zeichnung“) beim Hineinzoomen unscharf und pixelig; rechts bleibt „The original: the drawing itself“ („Das Original: die Zeichnung selbst“) scharf. Das linke Feld blendet aus, die Beschriftungen des Originals werden auf Spanisch neu getippt (Manuscrito, Plantilla, Páginas), Schnittmarken rahmen es ein, und drei Häkchen stehen bei „Sharp at any size“ (scharf in jeder Größe), „Labels are live text“ (Beschriftungen sind echter Text) und „Print master → press“ (Druckvorlage → Druckmaschine).

    SprecherEine aus dem fertigen PDF ausgeschnittene Abbildung ist kaum mehr als ein Foto der Zeichnung. Das Original ist die Zeichnung selbst. Damit baut der Agent jede Abbildung neu auf: scharf in jeder Größe, mit Beschriftungen, die echter Text bleiben und übersetzt werden können. Und für den Druck geht das Original unverändert in die Druckerei.

  8. 1:37

    Auf dem BildschirmSchritt 03, die Referenz: „Show how it should look.“ („Zeigen Sie, wie es aussehen soll.“) Im Ordnerbaum wird reference.pdf hervorgehoben und mit „In the root“ (im Hauptordner) markiert; eine Seite fliegt heraus und wird zu einer großen zweispaltigen Buchseite mit der Kennzeichnung reference.pdf.

    SprecherSchritt drei ist unverzichtbar: Legen Sie in den Hauptordner eine Datei, die klar zeigt, wie das fertige Produkt aussehen soll. Ideal ist ein PDF.

  9. 1:47

    Auf dem BildschirmÜber der Seite erscheinen Maße: Spaltenumrisse, ein Spaltenabstand von 9 mm, ein Rand von 20 mm, Beschriftungen für die Überschrift (Fraunces 28 pt), den Grundtext (Lora 9,4/13,6 pt) und einen Kasten (getönt, 1 Linie) sowie Grundlinien mit 13,6 pt Zeilenabstand. Eine Datei, spec-sheet.md, füllt sich: Seite 210 × 280 mm; Ränder 24 · 20 · 22 · 20 mm, gespiegelt; 2 Spalten, Spaltenabstand 9 mm; Grundlinienraster 13,6 pt; Grundtext Lora 9,4 / 13,6 pt, Blocksatz; Überschriften Fraunces 28 pt · Geist; Kapitelauftakte mit einem Farbband von 101 mm; Kästen mit Tönung und Linie links. Dann wird das Wort „Guess“ (raten) durchgestrichen, und „Measure.“ (messen) leuchtet golden auf.

    SprecherDer Agent liest die Gestaltung aus diesen Seiten ab. Er misst Ränder, Spalten, Schriften und Abstände und hält sie als Layoutregeln fest. Ohne Referenz müsste er raten. Mit einer Referenz misst er.

  10. 2:03

    Auf dem BildschirmSchritt 04, der Agent: „Ask for it in plain words.“ („Bitten Sie in einfachen Worten darum.“) Ein Fenster mit dem Titel „Agent · ~/my-book“ öffnet sich neben den Abzeichen Claude Code, Codex und „or any other agent“ (oder jeder andere Agent). Eine Nachricht von YOU (Sie) tippt sich: „Install the Postext skill: `npx skills add drnachio/postext --skill postext-port`“ (Installieren Sie den Skill von Postext), und der Agent antwortet „✓ Skill installed: postext-port“ (Skill installiert). Eine Karte zum Skill postext-port nennt „A proven workflow“ (ein bewährter Arbeitsablauf), „Everything about Postext“ (alles über Postext) und „Tools to check its own work“ (Werkzeuge, um die eigene Arbeit zu prüfen).

    SprecherSchritt vier: Öffnen Sie Ihren Agenten, Claude Code, Codex oder welchen Sie auch verwenden, in diesem Ordner und bitten Sie ihn, den Skill von Postext zu installieren. Ein Skill ist ein Paket aus Fachwissen. Dieser bringt dem Agenten bei, wie er eine Publikation in Postext überführt, und gibt ihm die Werkzeuge, seine eigene Arbeit zu prüfen.

  11. 2:24

    Auf dem BildschirmDie nächste Anfrage tippt sich: „Use the postext-port skill to convert this book to Postext. The design is in reference.pdf, the fonts are in fonts/ and the original illustrations are in artwork/: use them instead of cutting figures out of the PDF. Start with chapter 1 only, and show me the spec sheet before you build it.“ („Überführen Sie dieses Buch mit dem Skill postext-port in Postext. Die Gestaltung steht in reference.pdf, die Schriften liegen in fonts/ und die Originalillustrationen in artwork/: Verwenden Sie diese, statt Abbildungen aus dem PDF auszuschneiden. Beginnen Sie nur mit Kapitel 1, und zeigen Sie mir das Datenblatt, bevor Sie es bauen.“) Daneben leuchten reference.pdf, fonts/ und artwork/ im Ordnerbaum auf, sobald die Anfrage sie nennt, und eine Karte mit „Ch. 1“ (Kap. 1) springt auf.

    SprecherDann bitten Sie in einfachen Worten um das, was Sie wollen. Sagen Sie ihm, wo die Referenz, die Schriften und die Originale liegen, und bitten Sie ihn, mit einem einzigen Kapitel anzufangen.

  12. 2:37

    Auf dem BildschirmEin Raster aus zwölf abgedunkelten Buchseiten; die erste ist golden umrandet. Ein kreisförmiger Pfeil zählt darauf Überarbeitungsrunden, bis ein Häkchen erscheint, dann leuchten die übrigen elf auf. Darunter: Sample chapter → Polish → Extend (Probekapitel → verfeinern → ausweiten).

    SprecherWenn der Inhalt lang ist, beginnen Sie mit einem Probekapitel. Verfeinern Sie es, bis es perfekt ist, und übertragen Sie es erst dann auf den Rest.

  13. 2:46

    Auf dem BildschirmDer Agent fragt „Faithful copy or redesign?“ („Getreue Kopie oder Neugestaltung?“), „Which languages?“ („Welche Sprachen?“) und „Print, screen, or both?“ („Druck, Bildschirm oder beides?“). Eine Checkliste geht Take inventory, Measure the design, Extract the text, Fonts and images, Compare page by page und Pack the file durch (Bestand aufnehmen, Gestaltung messen, Text extrahieren, Schriften und Bilder, Seite für Seite vergleichen, Datei packen), und die Datei my-book.postext erscheint. Eine dritte Anfrage tippt sich: „Chapter 1 is approved. Convert the remaining chapters with the same design, compare each one with reference.pdf, and pack everything into a single .postext file.“ („Kapitel 1 ist abgenommen. Überführen Sie die übrigen Kapitel mit derselben Gestaltung, vergleichen Sie jedes mit reference.pdf und packen Sie alles in eine einzige .postext-Datei.“) Der Agent antwortet „✓ 12 chapters · 0 warnings · my-book.postext“ (12 Kapitel, 0 Warnungen).

    SprecherDer Agent stellt ein paar Fragen: getreue Kopie oder Neugestaltung, welche Sprachen, Druck oder Bildschirm. Dann misst er, extrahiert, setzt zusammen und prüft. Und er übergibt Ihnen eine Postext-Datei. Sobald das Probekapitel stimmt, ist die Ausweitung auf das ganze Buch nur noch eine weitere Anfrage.

  14. 3:14

    Auf dem BildschirmSchritt 05, die Sandbox: „Check it, page by page.“ („Prüfen Sie es Seite für Seite.“) In einem Browserfenster wird die Adresse postext.dev/sandbox getippt. Der Mauszeiger klickt in der Seitenleiste auf Books (Bücher), dann auf New (Neu), dann auf „Open a .postext file…“ („Eine .postext-Datei öffnen…“); die Datei fliegt herein, „My book, 12 chapters · 184 pages“ („Mein Buch, 12 Kapitel, 184 Seiten“) erscheint oben in der Liste, und seine ersten Seiten öffnen sich in der Ansicht Canvas; die Tabs der Ansichten heißen Canvas, HTML, PDF, Folio und EPUB 3.

    SprecherSchritt fünf: Öffnen Sie die Postext-Sandbox auf postext.dev. Wählen Sie unter Bücher die Option Neu und öffnen Sie Ihre Datei.

  15. 3:24

    Auf dem BildschirmDie Referenzseite und die Postext-Seite stehen nebeneinander, beschriftet mit Reference und Postext, und eine goldene Linie tastet beide von oben nach unten ab. Das Bedienfeld Checks (Prüfungen) öffnet sich mit einem Zähler von 3 und listet Widow (Witwe, S. 4), Loose line (zu lockere Zeile, S. 7) und Figure does not fit (Abbildung passt nicht, S. 9) auf; rote Rahmen markieren jedes Problem auf der Postext-Seite.

    SprecherGehen Sie es Seite für Seite durch, neben Ihrer Referenz. Das Bedienfeld Prüfungen weist Sie auf Probleme hin: Witwen, zu lockere Zeilen, Abbildungen, die nicht passen.

  16. 3:35

    Auf dem BildschirmZwei Reihen von Seitenskizzen, „Reference · PDF“ (Referenz) und „Postext · reflowed“ (neu umbrochen). In der neu umbrochenen Reihe wandert eine Abbildung von der ersten Seite an den Kopf der zweiten, und eine gestrichelte Linie verbindet ihre beiden Positionen. Text: „Same rules, not the same pages. The content flows: a figure or a page break may land elsewhere.“ („Gleiche Regeln, nicht die gleichen Seiten. Der Inhalt fließt: Eine Abbildung oder ein Seitenumbruch kann woanders landen.“) Dann verbindet ein Gleichheitszeichen jedes Seitenpaar unter „What must match“ (was übereinstimmen muss): Margins and baseline grid (Ränder und Grundlinienraster), Typography (Typografie), Figure and box styles (Stile von Abbildungen und Kästen), Clean pages: no widows, even columns (saubere Seiten: keine Witwen, ausgeglichene Spalten). Ein rotes Feld mit ≠ sagt „Hand-made craft decisions: not rules, so they can’t set changing content“ („Handwerkliche Entscheidungen von Hand: keine Regeln, also können sie keinen Inhalt setzen, der sich ändert“).

    SprecherEines sollten Sie bedenken: Die Seiten müssen nicht mit Ihrem PDF identisch sein. Postext hat die Layoutregeln gelernt, und Ihr Inhalt fließt jetzt, sodass eine Abbildung oder ein Seitenumbruch woanders landen kann. Übereinstimmen sollte die Qualität: derselbe handwerkliche Anspruch. Wenn wir von Hand setzen, treffen wir kleine handwerkliche Entscheidungen, die keine Regeln sind. Und nur Regeln können Inhalt setzen, der sich immer wieder ändert.

  17. 4:03

    Auf dem BildschirmDas Agentenfenster kehrt mit einer vierten Anfrage zurück: „In the sandbox, chapter 2, page 7: the “Remember” box is split across two columns, and the running head is missing. Checks shows 3 loose lines. Fix it and pack the file again.“ („In der Sandbox, Kapitel 2, Seite 7: Der Kasten ‚Remember‘ ist auf zwei Spalten verteilt, und der Kolumnentitel fehlt. Prüfungen zeigt 3 zu lockere Zeilen. Beheben Sie das und packen Sie die Datei neu.“) Ein Screenshot ist angehängt, screenshot-ch2-p7.png. Dann läuft eine Schleife zwischen Sandbox (check, prüfen) und Agent (fix, beheben) durch die Runden 1 bis 3, während die Zahl der Warnungen von 3 auf 0 fällt, und endet mit einem Häkchen und „Exactly right.“ („Genau richtig.“)

    SprecherDann sagen Sie dem Agenten so genau wie möglich, was Sie sehen: das Kapitel, die Seite und was nicht stimmt. Ein Screenshot hilft. Öffnen Sie die neue Fassung, prüfen Sie erneut und wiederholen Sie das. Jede Runde kommt dem Ziel näher, bis es genau richtig ist.

  18. 4:23

    Auf dem Bildschirm„Not just a Postext version.“ („Nicht nur eine Postext-Fassung.“) Die Datei my-book.postext teilt sich entlang einer goldenen Linie in zwei. Links Content (what it says), der Inhalt, also was gesagt wird: chapters/en/02-the-cell.md mit der Überschrift „The cell“, einem Satz, der auf die Abbildung fig-cell verweist, und einem Kasten „remember“. Rechts Form (how it looks), die Form, also wie es aussieht: eine aus Ihrem Original abgeleitete Vorlage mit gespiegelten Seiten von 210 × 280 mm, 2 Spalten mit 9 mm Spaltenabstand, Grundtext Lora 9,4/13,6 im Blocksatz, nummerierten Überschriften in Fraunces, Kästen „remember“ mit Tönung und Linie und Abbildungen, die an den Spaltenkopf gleiten.

    SprecherUnd das ist das Beste daran: Sie haben nicht nur eine Postext-Fassung Ihres Inhalts erstellt. Sie haben Inhalt und Form getrennt. Der Text lebt in sauberen Kapiteln. Die Gestaltung lebt in einer Vorlage, mit Layoutregeln, die aus Ihrem Original abgeleitet sind.

  19. 4:39

    Auf dem BildschirmÜber einer Reihe von Buchseiten leuchten Chips für Correct, Extend und Translate auf (korrigieren, erweitern, übersetzen): Eine Zeile wird hervorgehoben und ein Schimmer zieht über die Seiten, zwei weitere Seiten gleiten herein, und die Seiten blättern zur spanischen Ausgabe um. Eine Anfrage tippt sich: „Add a Spanish edition: translate the chapters, captions and diagram labels, and keep the same design.“ („Fügen Sie eine spanische Ausgabe hinzu: Übersetzen Sie die Kapitel, Bildunterschriften und Diagrammbeschriftungen und behalten Sie dieselbe Gestaltung bei.“) Bildtext: „Same rules. New content. Pages set themselves.“ („Gleiche Regeln. Neuer Inhalt. Die Seiten setzen sich selbst.“) Dann „One file, the whole book.“ („Eine Datei, das ganze Buch.“): Ein .postext-Symbol verzweigt sich zu einer Seite mit Schnittmarken (Print-ready PDF, ein druckfertiges PDF), einem E-Reader, dessen Text sich an seinen Bildschirm anpasst (EPUB e-book, ein E-Book im Format EPUB), einem Browserfenster (Web reader, ein Reader für das Web) und einem Seitenpaar (Every page, set: jede Seite gesetzt).

    SprecherWenn sich Ihr Inhalt also ändert, wenn Sie ihn korrigieren, erweitern oder übersetzen, müssen Sie nicht an das Layout denken. Postext setzt ihn neu, nach denselben Regeln. Eine Datei für das ganze Buch: ein druckfertiges PDF, ein E-Book im Format EPUB, ein Reader für das Web und Seiten, die sich selbst setzen.

  20. 5:03

    Auf dem BildschirmAbspann: das Postext-Logo, der Slogan „The programmable typesetter for the web“ („Das programmierbare Satzsystem für das Web“), postext.dev, eine Pille mit „The prompts from this video are in the description ↓“ („Die Prompts aus diesem Video stehen in der Beschreibung“) und die Fußzeile „Open source · MIT · github.com/drnachio/postext“.

    SprecherPostext. Open Source, auf postext.dev. Die Beispiel-Prompts finden Sie in der Beschreibung.

Auch auf YouTube (auf Englisch): dort ansehen oder in der Postext-Playlist.

#Was der Skill enthält

  • Einen Arbeitsablauf:
    1. den Auftrag abstimmen;
    2. die Quelle inventarisieren;
    3. die Gestaltung in einem Datenblatt vermessen;
    4. das Projektgerüst anlegen;
    5. den Inhalt extrahieren;
    6. ihn zu Postext-Markdown aufbereiten;
    7. Schriften und Bilder vorbereiten;
    8. Seite für Seite prüfen;
    9. das Paket schnüren.
  • Referenzen:
    • das Dokumentformat und das Konfigurationsmanifest, beide an der Engine geprüft;
    • das Projektformat (Paket);
    • ein Leitfaden je Quellformat;
    • eine Methode zur Gestaltungsanalyse;
    • ein Katalog gelöster Layoutfälle: Teile mit eigenen Farben, Kapitelauftakte, Verse, Marginalglossen, Fußnoten, Register, gleitende, geteilte und verschachtelte Kästen, Vektor-Druckvorlagen, Abbildungen mit Live-Text, Bilder in Tabellenzellen, Tabellen im Querformat, zweisprachige Ausgaben und mehr;
    • chinesische Bücher, waagerecht oder senkrecht gesetzt und rechts gebunden: was im Auftrag zu klären ist (Schrift, Region, Richtung, Bindung), wie man ein Zeichenraster vermisst, wie man senkrechte PDFs liest, Ruby und Warichu aus InDesign, das ostasiatische Layout von Word und EPUBs von rechts nach links, und wie man CJK-Schriften auf das Buch zuschneidet (siehe Chinesischer Satz);
    • japanische Bücher, senkrecht gesetzte Bunko- und Tankōbon-Romane mit Bindung rechts oder waagerecht gesetzte Fachbücher: das Gebietsschema, das die japanischen Regeln einschaltet (ja, nie ein chinesisches Tag), was zu klären ist (Richtung, Raster, Furigana, Anmerkungen, die Orthografie der Ausgabe), wie man den Satzspiegel in Zeichen und Zeilen vermisst, die Auszeichnung von Furigana und Bōten, mit aozora.py umgewandelte Texte aus Aozora Bunko, Scans gemeinfreier Ausgaben aus der National Diet Library und japanische Schriften, zugeschnitten mit ihren Kana und senkrechten Formen (siehe Japanischer Satz);
    • arabische Bücher, modern oder klassisch und vokalisiert, von rechts nach links gesetzt und rechts gebunden: das Gebietsschema, das das Buch wendet, was zu klären ist (Region und Ziffern, Vokalisierung, Verse, Inhaltsverzeichnis am Ende), wie man eine gespiegelte Seite vermisst, wie man Arabisch aus PDFs, Word und Wikisource liest, Gedichte als :::verse, Anmerkungen «(١)» je Seite und arabische Schriften, zugeschnitten mit ihren Verbindungstabellen (siehe Arabischer Satz);
    • Comics, Manga und Zeitungsstrips: die Aufteilung, die eine Seite in Panels schneidet, die Panelbilder mit ihren Sprecherankern und Sicherheitsbereichen, ein Skript je Sprache, das die Engine letterst (Sprechblasen, Textkästen, Geräuschwörter), Manga und arabische Ausgaben von rechts nach links, und wie man aus textfreien Zeichnungen samt Übersetzungen, aus geletterten Scans oder aus einem Skript mit generierten Bildern überträgt (siehe Comics);
    • das gedruckte Objekt: wie man Papier, Bindung, Umschläge und Buchrücken der Quelle abliest und als die Einstellungen folio festlegt, die der Betrachter Folio zeigt, geprüft vom Linter.
  • Skripte (Python und Node), im nächsten Abschnitt beschrieben.

#Skripte

SkriptWas es tut
inventory.pyErster Blick auf jede Quelle: Geometrie, Schriften, verwendete Formate, Medien, Seiten, die OCR brauchen; bei einem als PDF/X gedruckten PDF seine Ausgabebedingung und sein Anschnitt samt den Einstellungen print, die beides nachbilden.
measure_layout.pyRänder, Spalten, Spaltenabstand und Zeilenabstand (das Grundlinienraster) eines PDFs
pdf_extract.pyPDF → Kapitelentwürfe nach typografischer Rolle (Schrift/Größe/Farbe): Lesereihenfolge, Absätze, Auflösen von Trennungen, fett/kursiv, hoch-/tiefgestellt, Listen, Legenden
pdf_figures.pySchneidet Abbildungen aus einem PDF: Fotos in nativer Auflösung, SVG-Vorschauen, Vektor-PDF-Druckvorlagen
extract_tables.pyPDF-Tabellen → Postext-TableModel
pandoc_to_postext.pyDOCX, PPTX, ODT, EPUB, HTML, LaTeX, Markdown, JATS, DocBook → Kapitelentwürfe, wobei Word-Formatvorlagen auf Kästen und Absatzformate abgebildet werden
idml_extract.pyInDesign-IDML → Kapitelentwürfe nach Absatzformat, Tabellen und verankerte Bilder; Ruby, Tate-chū-yoko, Betonungszeichen und Warichu werden zu :ruby, :tcy, :dots und :warichu, und senkrechte Textabschnitte sowie eine Bindung von rechts nach links werden gemeldet
aozora.pyText aus Aozora Bunko (ein CP932-Zip oder eine .txt) → Postext-Markdown: Furigana, Bōten und Seitenlinien, Überschriften mit ihren Einzügen, 字下げ- und 地付き-Blöcke als Absatzformate, Seitenumbrüche, über JIS X 0213 aufgelöste 外字, Kanbun-Zeichen; es gibt den Block mit den Nachweisen und einen Bericht über das zurück, was es nicht ausdrücken konnte
index_marks.pyBaut ein gedrucktes Register als Marken :index nach: liest die Registerseiten des PDFs, findet jeden Begriff auf seiner Seite und markiert dieselben Wörter in den Kapiteln
comic_panels.pyVermisst Comicseiten: findet die Panels am Papier zwischen ihnen, schreibt den Ausdruck split (von links nach rechts oder von rechts nach links, schräge Zwischenräume eingeschlossen), die Zwischenräume und den Rahmen, schneidet ein Bild je Panel aus und gibt die Gerüste :::page aus; legt ein Raster über die Bilder, um Sprecheranker und Sicherheitsbereiche abzulesen, und zeichnet sie zur Kontrolle wieder ein
fonts.py, images.py, convert_assets.pyInstanziieren, reduzieren, skalieren und teilen Schriften (eine chinesische oder japanische Schrift, auf die Zeichen des Buchs zugeschnitten, behält ihre senkrechten Formen und Metriken, eine arabische ihre Verbindungsformen und das Tatweel); wandeln Bilder nach sRGB um, beschneiden und verbinden sie; machen aus .ai-/.pdf-Grafiken SVG
preset_kit.pyLegt das Projektgerüst und sein Generatorskript an, erstellt preset.json und packt die .postext-Datei
lint_project.pyFindet alles, was Parser und Loader stillschweigend falsch machen, und bei chinesischem, japanischem und koreanischem Text die Zeichen, die die mitgelieferten Schriften nicht setzen können; bei japanischem Text Kana unter einem chinesischen Gebietsschema, chinesische Schriften oder Einstellungen, in den Kapiteln verbliebene Aozora-Notation und Kanji-Registereinträge ohne Lesung; bei arabischem Text ein fehlendes arabisches Gebietsschema, rein lateinische oder nicht verbindende Schriften, Sperrung, erzwungene Silbentrennung und kursive Hervorhebung; bei Comics Aufteilungsausdrücke, die sich nicht einlesen lassen, Panels, die nicht zu den Zellen passen, unbekannte Bilder sowie Sprechblasen- oder Panelformate, fehlerhafte Sprecheranker, Lettering-Schriften, die das Projekt nicht mitliefert, und Ausgaben mit abweichenden Seiten
render.mjsSetzt das Projekt (einen Ordner oder eine .postext-Datei) ohne Oberfläche mit der echten Engine, liest seine Konfiguration wie die Sandbox und gibt Warnungen aus. Mit --jpeg malt es die gewünschten Seiten (--pages 12-15) mit dem Canvas-Renderer der Engine in ein bis zwei Sekunden als JPEG-Dateien, sodass der Agent seine Seiten ansieht, ohne ein PDF zu erzeugen; --out schreibt das PDF. Ein für den Druck eingerichtetes Buch erhält PREFLIGHT-Zeilen (Bilder mit niedriger Auflösung, dünne Linien, kleiner Text in mehreren Farben, Farbauftrag über dem Grenzwert, Text nahe am Beschnitt), und sein PDF wird über das ICC-Ausgabeprofil separiert.
compare_pages.pyStellt Quell- und Postext-Seiten nebeneinander, aus dem PDF des Renderlaufs oder aus seinem Ordner mit JPEGs

#Installation

#Jeder Agent (skills.sh)

Das CLI skills erkennt Ihre Agenten und installiert den Skill für sie:

npx skills add drnachio/postext --skill postext-port

Wählen Sie Agenten ausdrücklich mit -a und installieren Sie global (für jedes Projekt) mit -g:

npx skills add drnachio/postext --skill postext-port -a codex -a claude-code -g

Derselbe Skill wird auch von der Website veröffentlicht, daher funktioniert ebenso:

npx skills add https://postext.dev

#Plug-in für Claude Code

Das Postext-Repository ist zugleich ein Plug-in-Marktplatz für Claude Code. In Claude Code:

/plugin marketplace add drnachio/postext
/plugin install postext@postext

Oder aus einer Shell:

claude plugin marketplace add drnachio/postext
claude plugin install postext@postext

#Den Agenten installieren lassen

Sie können Ihren Agenten darum bitten, zum Beispiel: „Installiere den Skill zur Übertragung nach Postext (npx skills add drnachio/postext --skill postext-port) und übertrage damit dieses PDF.“ Agenten, die https://postext.dev/llms.txt lesen, finden dort diese Seite und den Installationsbefehl.

#Werkzeuge, die die Skripte nutzen

python3 -m pip install pymupdf pillow fonttools brotli
brew install pandoc poppler
mkdir -p ~/.cache/postext-tools && cd ~/.cache/postext-tools && npm init -y && npm i postext postext-pdf postext-citeproc react @pdf-lib/fontkit @napi-rs/canvas

Pandoc wird für Quellen aus Word, PowerPoint, EPUB und HTML gebraucht, poppler für die Seitenbilder der Quelle. Die Node-Pakete treiben den Renderer ohne Oberfläche an (Node 22.15 oder neuer); @napi-rs/canvas ist ein vorkompiliertes Canvas, mit dem er die Seiten des Buchs direkt als JPEG malen kann. Optionale Werkzeuge: ocrmypdf für Scans, ImageMagick und veraPDF für PDF/UA-Prüfungen.

Die Arbeitsschleife läuft über die Kommandozeile, eine eigenständige ausführbare Datei, für die nichts installiert werden muss: Der Agent hält das Projekt entpackt und lässt postext build --watch auf den Seiten laufen, an denen er arbeitet, sodass jede Änderung etwa eine Sekunde später als JPEG erscheint, auch in einem langen Buch. Die Node-Pakete sind optional: Sie führen render.mjs aus, das die zusätzlichen Prüfungen der Sandbox ergänzt. Beide setzen das Buch mit bodyText.shapingLanguage: 'host', gleich was seine Konfiguration angibt, sodass eine Zeile an einem anderen Wort umbrechen kann als in der Sandbox (siehe Unterschiede zur Sandbox).

#Anwendung

Legen Sie die Quelldateien in Ihren Arbeitsordner und bitten Sie um die Übertragung. Zum Beispiel:

  • „Übertrage die Kapitel 1–3 von manual.pdf nach Postext und bilde dabei das zweispaltige Layout, die Kapitelauftakte und die Kästen nach.“
  • „Wandle course.docx in ein Postext-Buch um. Die Formatvorlagen ‚Nota‘ und ‚Actividad‘ sind Kästen.“
  • „Mach aus deck.pptx ein Postext-Handout: Folien werden zu Abschnitten, Sprechernotizen werden zum Text.“
  • „Wir haben das InDesign-Paket (IDML + Druck-PDF) dieses Lehrbuchs. Erstelle die Postext-Vorlage für Kapitel 1 auf Spanisch und Englisch.“

Der Agent folgt dem Arbeitsablauf:

  1. Auftrag. Er fragt, was er nicht ableiten kann: eine getreue Nachbildung oder eine Neugestaltung, ein Beispielkapitel oder das ganze Buch, Sprachen, Druck oder Bildschirm sowie die Rechte an Text, Bildern und Schriften.
  2. Inventar und Vermessung. Er liest die Quelle und schreibt ein Datenblatt mit gemessenen Fakten: Endformat, Ränder, Spalten, Zeilenabstand, typografische Rollen, Farbpalette, Kapitelauftakte, Kolumnentitel, Kastenfamilien und Gewohnheiten der Platzierung.
  3. Projekt. Er legt das Gerüst my-book/ mit einem Generator build_preset.py an, der das Datenblatt als Konstanten enthält und preset.json erzeugt.
  4. Inhalt. Er extrahiert Kapitelentwürfe mit dem passenden Extraktor und bereitet sie dann zu Postext-Markdown auf: Kästen, Absatzformate, Teile, Attribute von Überschriften für Kapitelauftakte, Verweise mit :ref, Ressourcen für Tabellen und Abbildungen.
  5. Prüfung. Er prüft das Projekt mit dem Linter und lässt postext build --watch auf dem entpackten Projekt laufen: Er ändert ein Kapitel oder eine Einstellung, sieht sich das JPEG der Seite an, das etwa eine Sekunde später neu gemalt ist, und ändert erneut, bis Seitenumbrüche, Abbildungen und Kästen Seite für Seite mit der Quelle übereinstimmen. An jedem Meilenstein führt er die vollständigen Prüfungen aus (postext check und den Linter). Das PDF wird für die Druckprüfungen erzeugt, nicht für jeden Blick.
  6. Übergabe. Er legt Papier, Bindung und Umschläge des Buchs für den Betrachter Folio fest und packt my-book.postext.

Öffnen Sie das Ergebnis in der Sandbox: Bücher → Neu → Eine .postext-Datei öffnen …. Der Import übernimmt die Kapitel und Texte in der Sprache der Sandbox. Um mit einem Ordner voller Projekte in einer lokalen Kopie von Postext zu arbeiten, setzen Sie POSTEXT_PRIVATE_PRESETS_DIR (siehe Sandbox).

#Das Ergebnis per Code laden

Die gelieferte Datei ist nicht an die Sandbox gebunden. Das Paket postext öffnet sie mit openBundle, setzt das Buch mit buildBundle und rendert es als Canvas, HTML oder PDF (siehe Pakete). Eine Übertragung kann daher direkt ein Programm speisen. Wenn die Ausgabe dieses Programms Anpassungen braucht, exportieren Sie sie mit createBundle zurück in eine .postext-Datei, stimmen sie in der Sandbox fein ab und laden die korrigierte Datei erneut. Das render.mjs des Skills, das ohne Oberfläche läuft, nimmt neben einem Projektordner auch eine gepackte .postext-Datei an.

#Was Sie erwarten können

  • Die Extraktoren liefern Entwürfe; der Agent bereitet sie auf. Rechnen Sie mit einem Durchgang je Kapitel, bei dem mit den Originalseiten verglichen wird. Aus dieser Durchsicht kommt die Qualität.
  • Nur Konfiguration und Markdown. Der Skill ändert nie die Engine, um ein einzelnes Buch passend zu machen. Wenn Postext etwas nicht ausdrücken kann, wählt der Agent den nächstliegenden Ausdruck und führt ihn als bekannte Lücke auf.
  • Über Rechte entscheiden Sie. Der Agent fragt nach, bevor er Bilder oder Schriften mit unklarer Lizenz übernimmt. Lizenzierte Schriften werden als redistributable: false gekennzeichnet, sodass exportierte Projekte sie weglassen.
  • Treue dort, wo es darauf ankommt. Das Ziel sind dasselbe Raster, dieselbe Schrift, dieselben Kapitelauftakte, Kästen, Abbildungsplatzierungen und Seitenumbrüche auf den meisten Seiten (innerhalb einer Seite je Kapitel), nicht identische Zeilenumbrüche.

#Wo er liegt

Der Skill liegt im Repository unter plugins/postext/skills/postext-port. Er deckt jeden Fall ab, der beim Bau der öffentlichen und privaten Vorlagen in der Sandbox aufgetreten ist. Wenn eine Übertragung auf einen Fall stößt, den er noch nicht abdeckt, eröffnen Sie bitte ein Issue oder einen Pull-Request, der den Skill verbessert, damit die nächste Übertragung ihn gleich mitbekommt.