The Lucid Factory

TheBrain

TLF 0.98 beta · Build 0.5.25

Van een echte Brain naar je website

Dit voorbeeld bevat Welcome, About en Contact. Metta en andere TheBrain-gebruikers kunnen de inhoud in TheBrain wijzigen en vervolgens hun website in TLF bijwerken. Hosting is niet nodig.

1 Importeer het archief als nieuwe Brain

Start TheBrain. Open Import of Import/Export in het hoofdmenu, kies Import en vervolgens Brain Archive (.brz). Kies Create a new brain, selecteer My-first-website.brz uit deze map en voer de import uit. Voeg het voorbeeld niet toe aan een bestaande persoonlijke Brain. Menuwoorden kunnen per TheBrain-versie verschillen.

2 Bekijk de inhoud en wijzig een zin

Welcome is de bovenste Thought en heeft About en Contact als kinderen. Elke Thought heeft een notitie. Wijzig in Welcome bijvoorbeeld “Welcome to your new website” in “Welcome to my test website”. Laat “Source example: TheBrain.” staan als herkenningspunt.

3 Maak een nieuw TLF-project

Kies in TLF New project, geef het project een naam en kies TheBrain als Content source. Begin met Default Light. Maak het project aan. Open in de stap Source de map met Open folder of Open source folder. Dit is de exportdoelmap van het project, eindigend op brain/export. Noteer of kopieer het volledige pad uit Verkenner.

4 Exporteer vanuit TheBrain naar die lege map

Open in TheBrain Import/Export, kies Export → JSON Files en klik op Export. Kies de lege brain/export-map van je TLF-project en klik op Map selecteren. Kies de exportmap zelf, niet de bovenliggende map brain. Gebruik voor een eerste oefening steeds een leeg exportdoel.

TheBrain exportvenster met JSON Files geselecteerd — Dit is de juiste exportoptie voor TLF: JSON Files.

Windows mapselectie met een lege exportdoelmap — Deze afbeelding toont een losse oefenmap Brain export. Voor rechtstreeks bijwerken in TLF kies je dezelfde soort lege map, maar dan de brain/export-map van jouw project.

5 Verwerk de export in TLF

Ga terug naar TLF. Klik op Update website content en wacht op de succesmelding. Doe daarna Preflight → Build → Preview. Controleer de homepage en de twee andere pagina’s. Je aangepaste zin moet op de homepage staan.

6 Herhaal met een wijziging en een ander thema

Na een geslaagde bronupdate maakt TLF de exportmap opnieuw leeg. Je werkende bronkopie staat apart in het project. Wijzig weer een zin in TheBrain, exporteer opnieuw naar dezelfde lege map en voer Update website content uit. Is de map nog gevuld na een mislukte update, los die melding dan eerst op of meld het aan Ton; wis niet zelf de werkende bronkopie.

Kies daarna in Project workspace → Appearance een ander thema. Sla op, voer Preflight en Build opnieuw uit en bekijk het resultaat in Preview. Controleer zowel de tekstwijziging als de nieuwe vormgeving.

De meegeleverde export bekijken zonder TheBrain

Je kunt ook de inhoud van de meegeleverde map export naar de lege brain/export-map van een nieuw TLF-project kopiëren. thoughts.json en links.json moeten rechtstreeks in die doelmap staan, met de UUID-mappen ernaast. export.zip is dezelfde export verpakt; pak die eerst uit. TLF importeert het .brz-archief niet rechtstreeks.

Dit is Tons echte voorbeeld-Brain met een distributiekopie van de export. Accountgegevens zijn geanonimiseerd en de losse ongebruikte Thought My first website is uit deze distributiekopie verwijderd. De originele uploads zijn behouden. De archiefstructuur en TLF-omzetting zijn gecontroleerd; het openen van de distributiekopie in TheBrain is door Ton bevestigd.

From a real Brain to your website

This example contains Welcome, About and Contact. Metta and other TheBrain users can edit the content in TheBrain, then update their website in TLF. No hosting is needed.

1 Import the archive as a new Brain

Start TheBrain. Open Import or Import/Export from the main menu, choose Import and then Brain Archive (.brz). Select Create a new brain, choose My-first-website.brz from this folder and complete the import. Do not merge the example into an existing personal Brain. Menu wording may differ between TheBrain versions.

2 Look at the content and change a sentence

Welcome is the top Thought, with About and Contact as children. Each Thought has a note. In Welcome, change “Welcome to your new website” to “Welcome to my test website”, for example. Keep “Source example: TheBrain.” as an identifying label.

3 Create a new TLF project

In TLF, choose New project, enter a name and select TheBrain as the Content source. Start with Default Light and create the project. In the Source step, click Open folder or Open source folder. This opens the project’s export destination, ending in brain/export. Copy or note its full path from File Explorer.

4 Export from TheBrain into that empty folder

In TheBrain, open Import/Export, choose Export → JSON Files and click Export. Select the empty brain/export folder belonging to your TLF project and confirm the folder selection. Choose the export folder itself, not its parent folder brain. Use an empty destination for the first exercise.

TheBrain export dialog with JSON Files selected — The correct export option for TLF is JSON Files.

Windows folder selection dialog showing an empty export folder — This Dutch screenshot shows a separate practice folder called Brain export. To update TLF directly, select the same kind of empty destination, but use your project’s brain/export folder. Map selecteren means Select folder.

5 Process the export in TLF

Return to TLF. Click Update website content and wait for the success message. Then run Preflight → Build → Preview. Check the homepage and the other two pages. Your changed sentence should appear on the homepage.

6 Repeat with another change and a different theme

After a successful source update, TLF empties the export folder again. It keeps the working source copy separately in the project. Change another sentence in TheBrain, export again into the same empty folder and run Update website content. If the folder still contains files after a failed update, resolve or report that message first; do not manually delete the working source copy.

Then select another theme under Project workspace → Appearance. Save, run Preflight and Build again and inspect Preview. Check both the changed text and the new design.

Try the included export without TheBrain

You can also copy the contents of the included export folder into a new TLF project’s empty brain/export folder. thoughts.json and links.json must be directly inside that destination, with the UUID folders beside them. export.zip contains the same export; extract it first. TLF does not import the .brz archive directly.

This is Ton’s actual example Brain with a distribution copy of its export. Account metadata has been anonymised and the unused standalone Thought My first website has been removed from this distribution copy. The original uploads have been preserved. Archive integrity and conversion in TLF have been checked; Ton has confirmed that the distribution copy opens in TheBrain.

Download TheBrain example ZIP with My-first-website.brz · Download all sample sources