Auf Version 3 aktualisieren#

So bringst du eine bestehende easyWebsite auf Version 3.0.0. Die wichtigste Neuerung ist der Live-Editor.

Easy Mode#

Stelle die CI-Komponenten in der .gitlab-ci.yml von @v3 auf @v4 um:

Das gilt auch für link-checker und accessibility-checker. Der Live-Editor bleibt aus, bis du ihn aktivierst.

Developer Mode#

Aktualisiere die Pakete:

npm installiert die Editor-Abhängigkeiten @blocknote/core, @blocknote/react und @blocknote/shadcn automatisch mit. Mit pnpm oder Yarn installierst du sie selbst.

Prüfe danach diese Punkte:

• .npmrc brauchst du nicht mehr. Alle Pakete liegen auf npmjs.org.
• public/themes/ erzeugt der Build jetzt selbst. Trage den Ordner in die .gitignore ein.
• Preview gibt es nicht mehr. Nutze stattdessen EditorShell, siehe Live-Editor einrichten.
• Faqs erwartet die Fragen jetzt als <Faq question="…">-Kinder statt als faqs-Array.
• disableToc im Frontmatter ist veraltet. Verwende theme.toc: false, siehe Inhaltsverzeichnis konfigurieren.
• logoDark ist neu in der theme.config.tsx, siehe Logo und Branding anpassen.

CLI direkt nutzen#

Rufst du markdown-webbook selbst auf, sind Live-Editor und privater Modus ab 3.0.0 standardmäßig eingeschaltet. Für eine öffentliche Webseite ohne Editor schaltest du beides ab:

Alle Optionen findest du in der CLI-Referenz.