Notion

Verbinden

Druk op «Verbinden» naast Notion onder «Cloud» op het startscherm van Exporter. Log in met Apple; je browser opent de pagina van Notion, waar je de pagina’s kiest die Exporter mag lezen en toegang geeft. Exporter vraagt Notion alleen om te lezen. Kies daarna in Exporter waar de bestanden komen en druk op «Gebruik deze map».

Het token van Notion blijft verzegeld op de server van Exporter. Je Mac logt in bij die server en heeft het token nooit.

Pagina’s delen

Alleen de pagina’s die je met Exporter deelt, worden gesynchroniseerd, met elke pagina en database eronder. Om later een pagina toe te voegen, open je het menu ⋯ in Notion en voeg je de exporter.dev connection toe; de pagina komt binnen bij de volgende synchronisatie. Een pagina die je niet meer deelt, verdwijnt bij de volgende dagelijkse controle uit je map.

Onderdelen kiezen

De kiespagina toont elke gedeelde pagina en database, allemaal aangevinkt, met drie tabbladen: Alle, Pagina’s en Databases. Vink uit wat je niet wilt; de bestanden blijven dan weg.

Waar de bestanden komen

Een map direct in je thuismap, zoals ~/Documents, krijgt een map notion-export erin; een diepere map wordt gebruikt zoals hij is.

• Pagina’s: in de mappen waarin Notion ze toont, genoemd naar de titel: Projects/Plan Q4.md. Een pagina met pagina’s eronder heeft naast zijn bestand een map met dezelfde naam.
• Databases: een map met de naam van de database met één bestand per rij, en de hele tabel ernaast: Projects/Tasks/Write the plan.md en Projects/Tasks.csv
• Afbeeldingen en bestanden die Notion host: attachments/ in de map van de pagina, gelinkt vanuit de pagina

/ en : in een titel worden spaties. Als twee pagina’s in één map dezelfde titel hebben, houdt de eerst gemaakte die, en de andere krijgt de eerste 6 tekens van zijn id tussen haakjes.

Het bestand

De front matter van een pagina bevat title, id, created, modified, source_url en parent, de pagina of database waarin hij staat. Een databaserij voegt haar eigenschappen toe onder hun namen in Notion, in de volgorde van de database: tekst, getallen, datums, waar of onwaar, en lijsten met namen. Daarna de titel en de pagina als gewone Markdown. Een callout is een citaat met zijn pictogram, een toggle is een details-blok, en kleuren vervallen. Een link naar een andere geëxporteerde pagina is een relatieve link naar zijn bestand. Tijden zijn in UTC.

De CSV van de database heeft een kolom per eigenschap en een regel per rij, de oudste eerst.

Synchroniseren

Notion meldt elke bewerking, verplaatsing en verwijdering aan de server van Exporter. De server schrijft de bestanden opnieuw en laat het je Mac weten, die ze downloadt, dus een wijziging komt binnen minuten aan; Notion zelf wacht een minuut of twee voordat het iets meldt. Een pagina die je hernoemt of verplaatst, verplaatst zijn bestand en zijn bijlagen. «Nu synchroniseren» vraagt eerst de server; «Volledig opnieuw synchroniseren» schrijft elk bestand opnieuw.

Exporter Cloud

De eerste 7 dagen vanaf je eerste koppeling zijn gratis. Daarna is Exporter Cloud een abonnement in de App Store: alleen Notion, of All Cloud voor Linear, Notion en elke cloudbron die we toevoegen, per maand of per jaar. Als een plan stopt, stopt de synchronisatie en blijven je bestanden. Dertig dagen later verwijdert de server zijn kopieën en het token.

Account

Instellingen › Account toont het e-mailadres waarmee je bent ingelogd. «Log uit» houdt de koppeling voor als je weer inlogt. Notion loskoppelen trekt de toegang van Exporter in Notion in en verwijdert de kopieën van Exporter op exporter.dev. «Verwijder account…» koppelt elke workspace los en verwijdert alles wat de server voor je bewaart. De bestanden op je Mac blijven.

Opdrachtregel

exporter export --source notion --dest <folder> schrijft de bestanden van de workspace naar een map die op de kaart Opdrachtregel is vrijgegeven. Zie de opdrachtregel.

Problemen en oplossingen

• Er ontbreekt een pagina: deel hem met de exporter.dev connection via het menu ⋯ in Notion, controleer of hij is aangevinkt en druk daarna op «Nu synchroniseren».
• Een afbeelding staat er als link: Notion wilde hem niet afgeven, dus het bestand linkt in plaats daarvan naar de afbeelding in Notion.
• De kaart zegt «Opnieuw verbinden…»: Notion accepteert de koppeling niet meer, vaak omdat ze in de instellingen van Notion is verwijderd. Druk erop en geef opnieuw toegang.
• De kaart zegt «Log in…»: de sessie is verlopen. Log in met hetzelfde Apple-account en de synchronisatie gaat verder.