Von AFFiNE

Was daraus wird:

• Wohin es kommt: Aus einer Arbeitsbereichsdatei (.affine) mit mehreren Einträgen auf oberster Ebene – Ordner, Dokumente ohne Ordner, Sammlungen – entsteht eine Seite mit dem Namen des AFFiNE-Arbeitsbereichs, unter der alles liegt; die Vorschau nennt sie („Alles unter einer Seite …“). Ein Snapshot und ein Arbeitsbereich mit nur einem Eintrag auf oberster Ebene kommen direkt in den Zielbereich – ohne leere Seite darüber. Ein Whiteboard zählt dabei zu seinem Dokument; Journal-Dokumente gehen ins Journal.
• Ordner werden zu Seiten mit ihren Dokumenten darunter. Steht ein Dokument in mehreren Ordnern, liegt es im ersten; die anderen Ordner verlinken es. Dokumente ohne Ordner liegen auf oberster Ebene – unter der Arbeitsbereichsseite, wenn es sie gibt.
• Dokumente mit genau einem Verweis darunter einordnen (Schalter in der Vorschau, standardmäßig an; die Vorschau nennt die Zahl): Ein Dokument ohne eigenen Ordner, auf das im Text genau ein anderes Dokument verweist, kommt unter dieses Dokument statt auf die oberste Ebene. Ketten werden verschachtelt (C unter B unter A). Nicht verschoben werden Dokumente in Ordnern, Journal-Tage, Inhalte von Datenbankeinträgen und Dokumente, auf die nur eine Datenbank, ein Whiteboard oder ein Journal-Tag verweist. Bei gegenseitigen Verweisen kommt das erste unter das andere. Die Links bleiben unverändert; beim Import als Datenbank gilt der Schalter nicht.
• Text: Überschriften, Absätze, Aufzählungen, nummerierte Listen, To-dos mit ihrem Haken, Aufklapplisten, Zitate, Codeblöcke mit Sprache, Hinweisblöcke (Callouts, Art nach Farbe: Rot → Achtung, Orange/Gelb → Warnung, Grün → Tipp, Lila → Wichtig, sonst Hinweis; ihr Emoji wird zum Symbol des Hinweises), Trennlinien, Tabellen, LaTeX (Block und im Text), Fett, Kursiv, Unterstrichen, Durchgestrichen, Code, Links, Text- und Hervorhebungsfarben.
• Links zwischen Dokumenten – im Text (@-Verweise), als Karten verlinkter oder synchronisierter Dokumente und als AFFiNE-App-Links – zeigen auf die importierten Seiten. Synchronisierte Dokumente werden dabei zu Links. Verweise auf einen Block (Verweise und Dokumentkarten mit Block, App-Links mit ?blockIds=) führen zu diesem Block; Verweise auf Formen der Leinwand (elementIds) zur Seite.
• Tags werden zu Tags der Seite, mit ihren Farben aus AFFiNE (als neue Datenbank: Eigenschaft Tags).
• Eigenschaften eines Dokuments (Text, Zahl, Kontrollkästchen, Datum) werden zu Eigenschaften der Seite mit demselben Namen; fehlende Eigenschaften legt der Import an, wenn du den Arbeitsbereich verwalten darfst. Gelöschte Eigenschaften und AFFiNEs eigene Felder (Erstellt von, Modus, Vorlage …) bleiben weg.
• Symbole: Ein Emoji als Symbol eines Dokuments, Ordners oder einer Sammlung wird zum Symbol der Seite. Symbole aus AFFiNEs eigener Symbolbibliothek haben keine Entsprechung; die Vorschau nennt ihre Zahl.
• Bilder und Anhänge werden hochgeladen und an ihrer Stelle gezeigt – wie beim Hochladen im Editor: Bilder als Bild, PDFs mit Vorschau (öffnen sich im Betrachter), Audio und Video mit Abspieler, andere Dateien als Link. Lesezeichen und Einbettungen (YouTube, Figma, GitHub …) werden zu Links.
• Datenbanken werden zu einer Datenbank-Seite unter ihrem Dokument und erscheinen im Dokument an derselben Stelle als eingebettete Datenbank. Spalten: Titel, Text, Zahl, Auswahl, Mehrfachauswahl, Datum, Kontrollkästchen, Link (Adresse), Fortschritt (Zahl in Prozent) und Erstellt. Zeilen behalten ihren Inhalt als Dokument des Eintrags. Tabellenansichten bleiben Tabellen, Kanban-Ansichten werden Boards nach derselben Spalte. Die Spalten stehen in der Reihenfolge der AFFiNE-Ansicht (nicht in der, in der sie angelegt wurden); ausgeblendete Spalten bleiben ausgeblendet, Spaltenbreiten bleiben erhalten (80 bis 800 Pixel). Bild-Spalten werden nicht übernommen.
• Dokumente aus Datenbankzeilen: Hast du in AFFiNE eine Zeile einer Datenbank in ein eigenes Dokument umgewandelt (der Titel der Zeile ist dann ein Verweis auf das Dokument), wird dieses Dokument zum Inhalt des Eintrags – mit Text, Bildern, Anhängen, eingebetteten Datenbanken und Links, wie bei jeder Seite. Es entsteht keine eigene Seite dafür; Links auf das Dokument (im Text, als Karte, aus Sammlungen und auf Whiteboards) führen zum Eintrag, und ein Ordner, in dem das Dokument lag, listet einen Link darauf. Der Eintrag behält den Titel und die Spalten der Zeile; besteht der Titel nur aus dem Verweis, trägt er den Titel des Dokuments. Das gilt auch, wenn der einzige Inhalt der Zeile die Karte eines verlinkten oder synchronisierten Dokuments ist, und für Snapshots, die das Dokument enthalten.
  • Besteht ein solches Dokument nur aus einer Datenbank (in AFFiNE gibt es keine Datenbank ohne Dokument), zeigt der Eintrag diese Datenbank als eingebettete Ansicht, und die Datenbank selbst liegt unter der Datenbank-Seite des Eintrags – Einträge haben keine Unterseiten. Ebenso landen Dokumente, die nur aus solchen Einträgen verlinkt sind, unter der Datenbank statt oben im Bereich; Datenbanken, die in AFFiNE nur auf dem Whiteboard eines Dokuments stehen, werden Datenbankseiten unter ihrem Dokument.
• Vorlagen: Dokumente, die in AFFiNE als Vorlage markiert sind, werden zu Vorlagen des Arbeitsbereichs (Kategorie Sonstiges, mit Emoji und Tags) statt zu Seiten; ein Dokument, das nur aus einer Datenbank besteht, wird eine Datenbank-Vorlage. Links auf eine Vorlage werden zu Text. Ob ein Dokument eine Vorlage ist, steht nur in der Arbeitsbereichsdatei (.affine) – aus einem Snapshot werden Vorlagen gewöhnliche Seiten. Wer den Arbeitsbereich nicht bearbeiten darf, bekommt die Vorlagen als „Nur für mich“. Die Import-Vorschau zeigt die Anzahl.
  • Aus der Arbeitsbereichsdatei (.affine) kommen dazu das Emoji-Symbol des Dokuments (als Symbol des Eintrags), seine Tags in eine Mehrfachauswahl-Spalte „Tags“ (oder „Schlagwörter“) der Datenbank und seine Eigenschaften in Spalten mit demselben Namen und passendem Typ, sofern die Zeile dort nichts eingetragen hat – Werte in den Spalten der Zeile bleiben immer, wie sie sind. Hat die Datenbank keine solche Spalte, fallen Tags oder Eigenschaften weg; die Vorschau nennt ihre Zahl.
  • Verweisen mehrere Zeilen auf dasselbe Dokument, bekommt die erste (in der Reihenfolge des Imports) den Inhalt; die anderen behalten ihren eigenen Inhalt und beginnen mit einem Link auf diesen Eintrag. Ein Journal-Dokument bleibt ein Tag im Journal, und eine Zeile, die auf das Dokument mit ihrer eigenen Datenbank verweist, bekommt nur einen Link.
  • Eigene Datenbanken des Dokuments werden dort angelegt, wo das Dokument lag (im Ordner bzw. ganz oben), und bleiben im Eintrag eingebettet; ein Whiteboard des Dokuments liegt ebenfalls dort, seine Karte zeigt auf den Eintrag.
  • Beim Import als neue Datenbank fallen Datenbanken weg; solche Dokumente werden dann wie alle anderen zu Einträgen der neuen Datenbank.
• Whiteboards (Edgeless): Der Text eines Dokuments wird immer ein Dokument. Liegt auf seiner Edgeless-Fläche mehr als die Notiz mit dem Text – Formen, Verbinder, Texte, Bilder, Rahmen, weitere Notizen, Zeichnungen, Mindmaps – oder öffnet AFFiNE das Dokument im Edgeless-Modus, entsteht daneben ein Whiteboard „Name – Whiteboard“. Dokument und Whiteboard sind verlinkt: oben im Dokument steht der Link zum Whiteboard, auf dem Whiteboard zeigt eine Karte auf das Dokument (dort, wo die Notiz lag). Formen (Rechteck, abgerundet, Ellipse, Raute, Dreieck) mit Text und Farben, Verbinder (gerade, gewinkelt, gebogen, mit Pfeilen und Beschriftung, an ihren Formen befestigt), Texte, Pinselstriche, Bilder, Rahmen, weitere Notizen (als Haftnotizen), Gruppen und Mindmaps (Knoten als Formen, Äste als Verbinder) werden übernommen. Was keine Entsprechung hat, fällt weg; die Vorschau nennt die Zahl.
• Sammlungen werden je zu einer Seite „Sammlung: Name“ mit Links auf ihre Dokumente zum Zeitpunkt des Imports: die von Hand hinzugefügten und die, auf die die Regeln passen (Tags, Erstellt/Geändert, Titel, Favoriten, Journal). Die Regeln stehen als Text auf der Seite. Lassen sich nicht alle Regeln auswerten (etwa Regeln auf eigene Eigenschaften), stehen nur die von Hand hinzugefügten Dokumente darin, mit einem Hinweis. Eine Sammlung in einem Ordner liegt in diesem Ordner.
• Journal: Journal-Dokumente von AFFiNE kommen in das Journal des Arbeitsbereichs, jeweils in den passenden Tag – ins Journal im Zielbereich, sonst in eines im Arbeitsbereich, in das du schreiben darfst; gibt es keines, legt der Import eines an. Fehlt der Tag, wird er angelegt; gibt es ihn schon, wird der Text unten angehängt (mit dem Titel des AFFiNE-Dokuments als Überschrift).
• Dokumente im Papierkorb von AFFiNE werden nicht übernommen. HTML-Einbettungen und Data Views fallen weg; die Vorschau nennt sie.
• Whiteboards, Datenbanken und Journal-Tage gibt es nur beim Import als Seiten; als neue Datenbank wird jedes Dokument ein Eintrag.
• Große Arbeitsbereiche: Die .affine-Datei darf größer als 100 MB sein (siehe Grenzen oben). Der Server schreibt sie beim Hochladen direkt auf die Platte, liest die Dokumente beim Umwandeln einzeln und Bilder und Anhänge erst beim Schreiben einzeln – der Arbeitsspeicher hält immer nur ein Dokument und eine Datei. Arbeitsbereiche mit tausenden Dokumenten gehen in einem Import (bis FLOWPLAN_IMPORT_MAX_DOCS, standardmäßig 10.000 Seiten); Ordner tiefer als 50 Ebenen werden zusammengefasst. Steht ein Reverse-Proxy davor, muss er so große Anfragen durchlassen (siehe Coolify und Reverse Proxy).
• Sicherheit: Die Datei wird nur gelesen; Größe, Anzahl und Verschachtelung der Dokumente sind begrenzt, Text wird nie als HTML übernommen, Links behalten nur http, https und mailto.