entity external

Fügt einer bestehenden Entität einen externen URL-Verweis hinzu — für Primärinhalte, die außerhalb des Vaults leben (Vorträge auf YouTube, Artikel auf Nachrichtenseiten, Dokumente in fremden Systemen). Das Gegenstück zu --external bei entity new, für den Fall, dass die Entität schon existiert und später ein weiterer Verweis dazukommt.

Eine URL hinzufügen

apparat entity external V1StGXRa https://example.com/vortrag-2025

Apparat hängt im Frontmatter der Entität einen neuen Eintrag unter external an:

external:
  - url: https://example.com/vortrag-2025
    format: text/html
    title: https://example.com/vortrag-2025

Bestehende external-Einträge bleiben unangetastet; der neue Eintrag landet am Ende der Liste.

Defaults für format und title

Ohne weitere Angaben verwendet Apparat:

format: text/html — die sichere Standardannahme für Web-URLs.
title: = die URL selbst — als sichtbarer Platzhalter, bis du einen sprechenden Titel setzt.

Beide Werte verfeinerst du anschließend über entity meta — Apparat lädt die Zielseite nicht automatisch herunter, um einen Titel zu extrahieren (Local-First-Prinzip, siehe Philosophie).

Wie oft aufrufen?

Pro Aufruf wird genau eine URL hinzugefügt. Mehrere Verweise fügst du durch wiederholten Aufruf hinzu:

apparat entity external V1StGXRa https://example.com/primaerquelle
apparat entity external V1StGXRa https://archive.example.com/spiegelung

Vault wählen

Ohne --vault verwendet Apparat die übliche Auflösung. Mit --vault übersteuerst du sie:

apparat entity external V1StGXRa https://example.com/vortrag --vault=arbeit

Fehler

„Entity id "…" is not a valid NanoId" — das Positional-Argument muss eine 8-stellige NanoID aus [A-Za-z0-9] sein.
„No entity with id "…" in vault "…"" — zur angegebenen NanoID existiert im Vault keine Entität.
„External link URL "…" is not a valid URL" — die URL muss ein gültiges Web-URL-Format sein. Bloßes example.com/… ohne Schema wird abgelehnt, ebenso syntaktisch fehlerhafte Eingaben.
„External link URL "…" must use the http or https scheme" — Apparat akzeptiert nur http:// und https://. Andere Schemata (mailto:, ftp:, javascript:, …) werden zurückgewiesen.

Wirkung im Vault

entity external legt einen reinen Verweis im Frontmatter ab — die Ressource selbst lädt Apparat nicht herunter. Wenn du sie lokal archivieren willst, lädst du sie manuell herunter und hängst sie anschließend über entity attach als Repräsentation an. Bestehende Einträge werden nicht auf Duplikate geprüft — eine versehentlich doppelt eingetragene URL entfernst du über entity detach oder entity meta.