Scribe

Studio

Ein lokales Studio, um Inhalte zu durchsuchen, über alle Dokumente hinweg zu suchen, MDX-Bodys in der Vorschau anzuzeigen, Übersetzungen zu prüfen und Einträge sicher zu löschen.

View as Markdown
scribe studio            # http://127.0.0.1:3600
scribe studio --port 4000

Das Studio ist ein lokales Entwicklungstool: serverseitig gerendertes HTML, kein Build-Prozess, keine Authentifizierung. Es liest Ihren Live-Working-Tree aus. Agenten und Menschen bearbeiten Dateien. Das Studio ist der Ort, an dem Menschen alles sehen und verifizieren, was Scribe verwaltet. Sie können Sammlungen durchsuchen, Einträge mit aufgelösten Relationen und Asset-Vorschauen prüfen, fehlerhafte oder fehlende Bilder aufspüren und die Frage „Wo wird das verwendet?“ klären, bevor etwas geändert wird. Es enthält auch das bestehende Übersetzungs-Dashboard (Abdeckung, Arbeitsliste, Snapshots pro Dokument, siehe Übersetzung).

Sammlungs-Browser

Unter /types/:typeId listet die Seitenleiste jeden Inhaltstyp mit der Anzahl der Einträge und einem aggregierten Problem-Badge auf. Die Eintragstabelle zeigt jeden Slug, eine aus dem Schema abgeleitete Auswahl von Schlüsselfeldern (Enums und Relationen als Chips), Punkte für den Übersetzungsstatus und Validierungs-Badges für jeden Eintrag.

Feldfilter werden aus der Schema-Introspektion abgeleitet und leben in den Query-Parametern (damit URLs teilbar und serverseitig gerendert sind). Enum-Felder werden zu einem Select, Relationsfelder zu einem Select der Ziel-Slugs, Booleans zu einem Toggle und Strings zu einem Contains-Match.

Jeder Typ mit mindestens einem Asset-Feld kann die Tabelle in ein Galerie-Kartenraster umschalten. Jede Karte zeigt das primäre Asset-Bild plus Slug, Schlüsselfelder und Badges. Filter werden identisch angewendet. Das ist die QA-Ansicht für generierte Bilder.

Eintrags-Inspektor

/types/:typeId/:enSlug rendert Felder nach ihrer inspizierten Art:

  • translatable: der Wert mit einem Sprachumschalter (Daten aus dem Store). Der englische Fallback wird deutlich markiert, wenn eine Sprache keine Übersetzung hat.
  • structural: der einfache Wert.
  • relation: ein klickbarer Link zum Zieleintrag. Fehlerhafte Referenzen erhalten ein rotes Badge.
  • asset: eine Bildvorschau mit aufgelöster URL, Dateigröße und Abmessungen. Eine fehlende Datei wird mit einem roten Badge versehen.
  • Used by: ein Bereich für Rückverweise, der jeden Eintrag (jedes Typs) auflistet, dessen Relationen hierher zeigen.
  • Body: ein Toggle für Raw / Preview (?body=preview). Die Vorschau rendert Markdown und GFM korrekt und zeigt unbekannte JSX-Komponenten als beschriftete Boxen mit ihren Props an. Relations-Tokens werden zu klickbaren Links (fehlerhafte sind deutlich sichtbar) und Asset-Tokens werden als echte Bilder gerendert. Für routingfähige Typen erscheint ein Link „Auf der Website ansehen“.

Pfeiltasten navigieren zwischen den Einträgen: ArrowLeft / ArrowRight springen zum vorherigen / nächsten Eintrag desselben Typs in der Standardreihenfolge der Sammlung (ohne Umbruch). Dabei bleiben das aktuelle Gebietsschema und die Body-Ansicht-Query-Parameter erhalten. Die Tasten werden ignoriert, solange der Fokus in einem Eingabefeld liegt.

Asset-Browser

/assets zeigt ein Thumbnail-Raster pro verwaltetem Root an. Jedes Asset listet seine Vorschau, den Pfad, die Größe, die Abmessungen und eine Referenziert durch-Liste jedes Eintrags und Felds auf, das darauf zeigt (live berechnet aus der In-Memory-Laufzeitumgebung). Badges markieren unreferenzierte (Kandidaten für Waisen), fehlende aber referenzierte, übergroße (über dem Feld maxKB) und Formatabweichungen. Weitere Details zum zugrunde liegenden Feldsystem finden Sie unter Assets.

Globale Suche

/search?q= führt eine Suche ohne Berücksichtigung der Groß- und Kleinschreibung über englische Slugs, jeden Frontmatter-Wert und rohe MDX-Bodys durch. Ein Suchformular befindet sich auf jeder Seite. Die Ergebnisse werden nach Typ gruppiert, mit einem hervorgehobenen Textausschnitt versehen und auf 20 Treffer pro Typ begrenzt.

Einträge löschen

Die Inspektor-Symbolleiste verfügt über einen rot markierten Löschen-Button. Er öffnet eine Bestätigungsseite, die den vollständigen Löschplan in Abschnitten anzeigt (Cascades, Detaches, betroffene Assets, Speicheranzahl pro Locale und etwaige Blocker). Anschließend folgt ein roter Bestätigungsbutton (oder, bei einem blockierten Plan, die Blocker und keine Bestätigungsmöglichkeit). Die Bestätigung führt exakt den Plan aus: die Quelldatei, ihre Assets, gespeicherte Übersetzungen und Snapshots sowie alle Detach-Umschreibungen und absolut nichts anderes. Der onTargetDelete-Modus einer Relation (restrict, detach oder cascade) und der onDelete-Modus eines Assets bestimmen, was der Plan ausführt. Derselbe Plan ist auf der Kommandozeile über scribe delete verfügbar. Dies ist die einzige Route des Studios, die Änderungen vornimmt. Sie bleibt ein reines Localhost-Tool.

Was das Studio nicht tut

Keine Inhaltsbearbeitung, kein Auslösen von Übersetzungen, kein Bild-Upload, keine Authentifizierung und kein echtes MDX-Komponenten-Rendering. Die Bearbeitung bleibt in Ihrem Editor und Git. Das Studio dient ausschließlich der Überprüfung.

Studio · Scribe