Dokumentationsanhänge

Hängen Sie Bilder und Dateien direkt an jede Dokumentationsseite an. Ziehen Sie einen Screenshot in den Editor, und er wird direkt im Text eingebettet; hängen Sie ein PDF, eine Spezifikation oder ein Archiv an, und es erscheint als herunterladbare Karte. Dateien liegen im Objektspeicher — Ihre Datenbank bläht sich also nie auf — und begleiten die Seite überallhin, wo sie angezeigt oder geteilt wird.

Anhänge hinzufügen

Öffnen Sie eine Dokumentationsseite im Editor (Neues Dokument oder Bearbeiten) und fügen Sie Dateien auf dem jeweils schnellsten Weg hinzu:

  • Drag & Drop: Ziehen Sie eine oder mehrere Dateien in den Editor
  • Einfügen: Fügen Sie ein Bild direkt aus der Zwischenablage ein (z. B. einen Screenshot)
  • Klicken Sie in der Editor-Werkzeugleiste auf Anhängen und wählen Sie Dateien aus

Sie können mehrere Dateien gleichzeitig anhängen. Ein neues Dokument wird beim ersten Anhängen einer Datei automatisch gespeichert, sodass Ihnen kein Upload verloren geht.

Bilder vs. Dateien

Archyl behandelt beide Fälle so, wie Sie es erwarten:

  • Bilder werden an der Stelle, an der Sie sie hinzufügen, inline in Ihr Markdown eingebettet und direkt auf der Seite dargestellt.
  • Andere Dateien (PDFs, Dokumente, Archive, …) landen nicht im Text, sondern als herunterladbare Karten im Bereich Anhänge.

Anhänge ansehen

Beim Lesen einer Seite erscheinen Anhänge in einem Anhänge-Bereich oben im Dokument, direkt unter dem Titel — so sehen Lesende, was verfügbar ist, bevor sie scrollen. Zu jeder Datei werden angezeigt:

  • Ein farbcodiertes Dateityp-Symbol oder eine Bildvorschau
  • Dateiname, Typ und Größe
  • Eine Herunterladen-Aktion mit einem Klick

Bilder werden außerdem inline an der Stelle dargestellt, an der Sie sie im Inhalt platziert haben.

Anhänge verwalten

Im Editor können Sie über den Anhänge-Bereich:

  • Jede Datei herunterladen
  • Eine Datei löschen (mit kurzer Inline-Bestätigung) — dabei wird sie auch aus dem Speicher entfernt

Wenn Sie ein Dokument löschen, werden auch seine Anhänge entfernt.

Unterstützte Dateien

Sie können jeden Dateityp anhängen. Bilder werden inline eingebettet; alles andere erscheint als herunterladbare Karte. Typische Beispiele:

  • Bilder — PNG, JPEG, GIF, WebP, SVG, AVIF
  • Dokumente — PDF, Word, Excel, PowerPoint, Klartext, Markdown, CSV
  • Daten & Archive — JSON, YAML, ZIP, Logs

Die Standard-Obergrenze liegt bei 10 MB pro Datei (auf selbst gehosteten Instanzen konfigurierbar).

Tipp: Erkennt Ihr Browser einen Dateityp nicht, wird die Datei trotzdem akzeptiert und zum Download angeboten.

Speicherung & Datenschutz

Anhänge liegen im Objektspeicher statt in der Anwendungsdatenbank. In der Archyl Cloud ist dieser Speicher Google Cloud Storage — für Sie verwaltet, ohne dass etwas zu konfigurieren ist. Auf selbst gehosteten Instanzen wählen Sie Ihren eigenen S3-kompatiblen Anbieter (siehe unten).

In beiden Fällen gilt:

  • Der Bucket ist privat. Dateien werden über kurzlebige, signierte Links ausgeliefert, die bei Bedarf erzeugt werden — die zugrunde liegenden Objekte sind nie öffentlich auflistbar.
  • In eine Seite eingebettete Links bleiben stabil, sodass geteilte und öffentliche Dokumentation weiter funktioniert, ohne den Bucket offenzulegen.
  • Verschlüsselung ruhender Daten ist standardmäßig aktiv. Google Cloud Storage verschlüsselt jedes Objekt automatisch; auf selbst gehosteten Instanzen können Sie zusätzlich eigene Schlüssel bereitstellen (zum Beispiel einen Cloud KMS CMEK auf GCS).

Für selbst gehostete Instanzen

In der Archyl Cloud funktionieren Anhänge ohne weitere Einrichtung. Wenn Sie Archyl selbst hosten, bringen Sie Ihren eigenen Objektspeicher mit — und können Archyl an jeden S3-kompatiblen Anbieter anbinden (Google Cloud Storage, Amazon S3, MinIO, Cloudflare R2, …).

Solange kein Speicher konfiguriert ist, ist die Aktion Anhängen nicht verfügbar, und Uploads liefern eine eindeutige Meldung "File storage is not configured". Setzen Sie im Backend die Umgebungsvariablen STORAGE_* (Endpoint, Bucket, Access Key, Secret Key), um die Funktion zu aktivieren; für Google Cloud Storage verwenden Sie den Interoperabilitäts-Endpoint (HMAC). Die vollständige Liste der Optionen finden Sie in Ihrer Deployment-Konfiguration.

Nächste Schritte