Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Docusaurus Live Codeblock
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Docusaurus Live Codeblock zeigt bearbeitbaren React-Code mit unmittelbarer Vorschau.
Für Ubuntu 26.04 LTS auf amd64. Verwende einen neuen Projektordner; bestehende Dateien werden bei den Beispielen teilweise überschrieben.
Installation
1. Paketlisten aktualisieren
Lädt die Paketinformationen für die Installation.
sudo apt update
2. Grundwerkzeuge installieren
Installiert die Laufzeit und deren Paketwerkzeuge aus Ubuntu.
sudo apt install nodejs npm
3. Projektordner anlegen
Hält Dateien und Abhängigkeiten dieses Beispiels zusammen.
mkdir ~/docusaurus-live-lab
4. Projektordner öffnen
Die weiteren Befehle beziehen sich auf diesen Ordner.
cd ~/docusaurus-live-lab
5. Node.js prüfen
Ubuntu 26.04 liefert Node.js 22.22.1. Für diese Beispiele mindestens 22.12 verwenden; bei einer älteren aktiven Installation hier anhalten.
node --version
6. Paketverwaltung vorbereiten
Erzeugt die Liste der Projektabhängigkeiten. npm-Befehle ohne sudo ausführen.
npm init -y
7. Docusaurus-Pakete installieren
Verwendet für alle Docusaurus-Pakete denselben veröffentlichten Stand.
npm install @docusaurus/core@3.10.2 @docusaurus/preset-classic@3.10.2 @docusaurus/theme-live-codeblock@3.10.2 react@19 react-dom@19
8. Seitenordner anlegen
Eine eigene MDX-Seite genügt für die Demo.
mkdir -p src/pages
9. Konfiguration schreiben
Schaltet Dokumentation und Blog für diese reine Demoseite ab und aktiviert das Live-Theme.
cat > docusaurus.config.js <<'EOF'
module.exports = {
title: 'React-Labor',
url: 'https://example.org',
baseUrl: '/',
presets: [['classic', { docs: false, blog: false }]],
themes: ['@docusaurus/theme-live-codeblock'],
i18n: { defaultLocale: 'de', locales: ['de'] }
};
EOF
10. Live-Seite schreiben
Die Markierung live aktiviert die React-Vorschau. Das Beispiel benötigt keinen eigenen Ausführungsserver.
cat > src/pages/index.mdx <<'EOF'
import Layout from '@theme/Layout';
<Layout title="React ausprobieren">
# Mein React-Labor
Ändere den Text oder den Farbwert.
```jsx live
<button style={{ background: '#176b45', color: 'white', padding: 16 }}>
Mein erster Versuch
</button>
```
</Layout>
EOF
11. Vorschau starten
Öffne http://127.0.0.1:3000. Ändere den Text im Live-Editor: die Schaltfläche soll sich sofort ändern. Strg + C beendet die Vorschau.
npx docusaurus start --host 127.0.0.1 --no-open
Installation prüfen
1. Seite bauen
Erzeugt build/. Das bestätigt den MDX- und React-Bau; prüfe die Interaktion zusätzlich in der Vorschau.
npx docusaurus build
2. Paketstände prüfen
Die drei Docusaurus-Pakete sollen dieselbe Version haben.
npm ls @docusaurus/core @docusaurus/preset-classic @docusaurus/theme-live-codeblock
Deinstallieren
Beende eine laufende Vorschau mit Strg + C. Sichere eigene Inhalte vor dem Löschen. Die über apt installierten Grundwerkzeuge bleiben für andere Programme erhalten.
1. Projekt entfernen
Löscht alle Dateien dieses Beispielprojekts einschließlich seiner Abhängigkeiten.
rm -rf -- ~/docusaurus-live-lab
2. Entfernung prüfen
Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.
test ! -e ~/docusaurus-live-lab && echo 'Projekt entfernt'
Quellen und Lizenz
Live-Theme und interaktive Codeblöcke. Lizenz: MIT. Für ein vollständiges Dokumentationsprojekt siehe Docusaurus.
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.