Der Datei-Viewer Neu in 0.9.9

Der Datei-Viewer zeigt jeweils eine Datei über den ganzen Bildschirm. Er öffnet sich, wenn du eine Datei in 📁 Browse files (Dateien durchsuchen) anklickst, einen Dateinamen, den ein Agent in seine Antwort geschrieben hat, oder einen Bild-, Video- oder Audio-Anhang in der Konversation. Du kannst die Datei lesen, abspielen, hineinzoomen, speichern und, bei Bildern, markieren.

Bilder, Video und Audio liegen auf Schwarz. Text steht in einer Spalte, die auch auf einem breiten Bildschirm lesbar bleibt. Der Titel, die Buttons und eine Zeile mit Art und Größe der Datei schweben über dem Inhalt. Ein Tippen oder Klicken auf den Inhalt blendet sie aus und wieder ein. Während ein Video oder eine Audiodatei läuft, verblassen sie außerdem nach drei Sekunden, und eine Mausbewegung oder das Berühren eines Buttons holt sie zurück. Ein pausierter Player zeigt sie immer.

Wie jede Art aussieht #

Das Relay bestimmt die Art an der Dateiendung und, bei Text, an einem Blick auf die ersten Bytes.

Art	Was du siehst
Bild	Das Bild, an den Bildschirm angepasst, mit Zoom (siehe Zoom). SVG, GIF, ICO, BMP und AVIF werden ebenfalls gezeigt.
Video	Ein Player mit Bedienelementen. Du kannst springen, weil das Relay Video in Teilen ausliefert.
Audio	Eine Karte mit dem Dateinamen und einem Player.
Markdown (`.md`, `.mdx`, `.markdown`)	Gerendert, mit Überschriften, Tabellen, Code und Formeln. Raw (Roh) zeigt den Quelltext. Neu in 0.9.11 Eine Tabelle, die breiter als der Viewer ist, scrollt wie ein Codeblock in ihrem eigenen Kasten seitwärts, und ein Wischen, das auf ihr beginnt, bleibt in der Datei.
Code und Text	Der Text mit Syntaxhervorhebung, wo das Relay die Sprache kennt. Keine Zeilennummern. Lange Zeilen werden nicht umbrochen: Der Block scrollt seitwärts. Jeder Block hat einen Copy-Button (Kopieren).
PDF	Eine Karte mit Open in new tab (In neuem Tab öffnen; der eigene PDF-Viewer deines Browsers) und Download (Herunterladen). Der Viewer zeigt PDFs nicht selbst.
Alles andere	Eine Karte mit dem Namen, der Größe, „no inline preview“ und Download.

Die Zeile über dem Inhalt lautet etwa CODE · javascript · 4.2 KB: die Art, die Sprache, wo es eine gibt, und die Größe.

Text-Buttons #

Bei Markdown-, Code- und Textdateien aus dem Workspace, den Laufwerken oder dem Session-Ordner hat die Werkzeugleiste Preview (Vorschau) und Raw. Preview ist die gerenderte oder hervorgehobene Ansicht, Raw der reine Text.

Eine Markdown-Datei öffnet sich mit eingeschaltetem Layout-HTML, und eine Zeile sagt ⚠ Safe layout HTML enabled; active content is blocked. Show literal HTML (HTML-Quelltext zeigen) schaltet das aus, sodass HTML in der Datei als Text erscheint, und Show HTML layout (HTML-Layout zeigen) schaltet es wieder ein. Skripte laufen in keinem Fall.

Ein relativer Link in einer gerenderten Markdown-Datei öffnet die verlinkte Datei im selben Viewer, und in der Werkzeugleiste erscheint ein ← Back-Button (Zurück), der zur vorigen Datei zurückführt. Ein Link auf eine Webadresse öffnet sich in einem neuen Tab. Eine so geöffnete Datei hat keine Nachbarn, zu denen du wischen kannst.

Große und binäre Dateien #

Großer Text. Der Viewer liest die ersten 512 KB einer Textdatei. Bei einer längeren Datei ergänzt die Zeile über dem Inhalt truncated to 512 KB. Der Rest wird nicht gezeigt; Download liefert die ganze Datei.
Binärer Inhalt. Eine Datei, die nach ihrer Endung wie Text aussieht, deren Bytes aber binär sind (oder die das Relay als binären Typ ausliefert), erscheint als „no inline preview“-Karte.
Bilder, Video, Audio. Für sie gilt im Viewer keine Größengrenze.
Eine Datei, die sich nicht lesen lässt. Der Viewer zeigt Preview failed mit dem Fehler, zum Beispiel File not found.

Zwischen Dateien wechseln #

Ob du von der offenen Datei weiterkommst, hängt davon ab, wie du sie geöffnet hast.

Geöffnet aus	Die Galerie ist
Einem Ordner in 📁 Browse files	Die Dateien dieses Ordners, in der Reihenfolge, in der der Browser sie listet. Unterordner werden übersprungen.
Einem Bild oder einem Anhang in einer Konversation	Jeder Bild-, Video- und Audio-Anhang und jedes in eine Antwort eingebettete Bild, in der Reihenfolge der Konversation, vom ältesten zum neuesten.
Einem Dateinamen in einer Antwort oder einem Link in einer Markdown-Datei	Keine. Der Viewer zeigt diese eine Datei.

Ein Ordner mit einer einzigen Datei oder eine Konversation mit einem einzigen Bild öffnet sich ohne Galerie. Gibt es eine, erscheinen unten zwei Buttons (‹ und ›) und die Position (zum Beispiel 3 / 12). Die Galerie springt nicht im Kreis: An beiden Enden sind die Buttons deaktiviert. Die Nachbarn auf beiden Seiten werden vorab geholt, sodass ein Schritt auf der Datei landet statt auf Fetching file preview….

Eine Datei in einer Konversation, die kein Bild, Video oder Audio ist (etwa ein PDF), ist ein normaler Link unter der Nachricht und öffnet sich in einem neuen Browser-Tab, nicht im Viewer.

Schließen #

Nach unten wischen auf einem Bild, einem Player oder einer Karte. Der Inhalt folgt deinem Finger und verschwindet, wenn du weit oder schnell genug wischst. Text scrollt stattdessen unter deinem Finger.
Seitwärts wischen, um durch die Galerie zu blättern. Ziehen mit der Maus wischt nicht, sodass du damit weiterhin Text markieren kannst; ein hineingezoomtes Bild wird verschoben statt gewischt.
× oben rechts oder Esc.
Back auf einem Handy, siehe unten.

Zoomen und Verschieben #

Aktion	Ergebnis
Mausrad	Zoomt um den Zeiger herum hinein und heraus.
Zusammenziehen (zwei Finger)	Zoomt um den Punkt zwischen ihnen, bis zum 8-Fachen.
Doppelklick oder doppeltes Tippen	Zoomt an dieser Stelle auf das 3-Fache. Ein zweiter Doppelklick kehrt zur angepassten Ansicht zurück.
Ziehen, wenn hineingezoomt	Verschiebt das Bild.

Ein Bild wird zuerst in seiner angepassten Größe gezeigt und nie kleiner. Angepasst führt ein Wischen zur Seite zur nächsten Datei, und ein Wischen nach unten schließt den Viewer. Hineingezoomt verschieben diese Gesten stattdessen das Bild.

Zurück auf dem Handy und in der installierten App #

Solange der Viewer offen ist, schließt die Zurück-Geste oder Zurück-Taste des Systems den Viewer und sonst nichts. Die Adresse im Browser ändert sich nicht.

In der vom Browser installierten App (Android, iOS oder Desktop) schließt Zurück die App nie von selbst. Ist nichts mehr zu schließen, zeigt sie Press back again to close the app, und ein zweiter Druck schließt sie. Bevor du die Seite einmal berührt hast, lässt der Browser Zurück die App verlassen, was eine Seite nicht ändern kann. In einem gewöhnlichen Browser-Tab gehört die Zurück-Taste wie üblich dem Browser.

Aktionen #

Button	Was er tut	Wo
Download	Speichert die Datei. Eine Datei aus dem Workspace oder von den Laufwerken wird mit dem Zeitpunkt ihrer letzten Änderung im Namen gespeichert, etwa `report (1005-0719).pdf` (Monat, Tag, Stunde, Minute), damit du Versionen auseinanderhalten kannst und nie eine ältere Kopie bekommst. Ein Anhang behält seinen Namen.	Jede Datei
Copy	Kopiert das Bild als PNG in die Zwischenablage. Die Beschriftung zeigt Copied ✓ (Kopiert) oder Copy failed (Kopieren fehlgeschlagen).	Bilder
🖍️ Annotate (Annotieren)	Schließt den Viewer und öffnet den Bildeditor. Die annotierte Kopie kommt in den Eingabebereich. Das Original bleibt unverändert. Nicht verfügbar für GIF und SVG. Siehe Ein Bild annotieren.	Bilder, nicht in einem geteilten Link
Open in new tab	Öffnet die Datei im eigenen Viewer des Browsers.	PDF-Karten
← Back	Führt nach einem Link in einer Markdown-Datei zur vorigen Datei zurück.	Nur nach einem solchen Link

Klick oben auf den Titel, um den Verweis auf die Datei zu kopieren, etwa `@file:src/app.js`, den du in den Eingabebereich einfügen kannst, damit der Agent diese Datei liest. Der Tooltip des Titels zeigt den genauen Text. Bei einer Datei von den Laufwerken oder aus dem Session-Ordner trägt der Verweis den absoluten Pfad.

Wohin ein Link in einer Antwort führt #

Ein Dateiname oder Pfad im Fließtext, etwa src/app.js, mit der Endung eines bekannten Dateityps, ist ein Link, der die Datei im Viewer öffnet. Er wird immer als Pfad im Workspace der Konversation gelesen. Ein absoluter Pfad wird auf den Teil im Workspace gekürzt. Ein absoluter Pfad, der nicht im Workspace liegt, etwa /var/log/app.log, wird ebenfalls zu einem Workspace-Pfad und scheitert mit File not found. Namen in Code-Spans und Codeblöcken werden nicht zu Links.
Ein Bild, das der Agent über seinen absoluten Pfad eingebettet hat, öffnet sich im Viewer zusammen mit den übrigen Medien der Konversation. Das funktioniert auch für Dateien außerhalb des Workspace. Siehe Medien in der Antwort eines Agents.
Ein Markdown-Link auf einen Dateipfad öffnet die Rohdatei in einem neuen Browser-Tab, nicht im Viewer, ebenso einer auf eine Webadresse. Derselbe Pfad als Fließtext geschrieben öffnet sich im Viewer.

Was der Viewer öffnen kann #

Der Viewer fragt das Relay nach der Datei, also entscheidet das Relay.

Quelle	Welche Dateien
Workspace	Dateien im Arbeitsordner der Konversation. Ein Pfad mit `..` wird abgelehnt, ebenso ein symbolischer Link, der aus dem Ordner herausführt.
Laufwerke	Unter Linux und macOS jede Datei, die der Benutzer, unter dem das Relay läuft, lesen kann, überall. Unter Windows Dateien auf den Laufwerken, die das Relay unter 📁 Browse files listet.
Session-Ordner	Gelesen wie die Laufwerke.
Anhänge	Die Dateien, die du oder ein Agent an eine Nachricht in der Konversation angehängt habt.

Ein Pfad, der einen Ordner bezeichnet, oder eine Datei, die nicht mehr da ist, wird abgelehnt. HTML- und XML-Dateien werden als Text gezeigt, und ein SVG kann kein Skript ausführen, sodass eine Datei, die ein Agent geschrieben hat, nie als Seite auf dem Relay läuft. Ein geteilter Nur-Lese-Link kann keine Workspace- oder Laufwerksdateien holen, und ein Klick auf ein eingebettetes Bild bewirkt dort nichts.

Tasten #

Taste	Was sie tut
Esc	Schließt den Viewer.
→	Die nächste Datei in der Galerie.
←	Die vorige Datei in der Galerie.

Die Pfeiltasten funktionieren nur, wenn es eine Galerie gibt, und nicht, während du in ein Feld tippst.