Hyperbook

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Hyperbook baut interaktive Arbeitshefte aus Markdown-Dateien.

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 ~/hyperbook-lab

4. Projektordner öffnen

Die weiteren Befehle beziehen sich auf diesen Ordner.

cd ~/hyperbook-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. Hyperbook installieren

Installiert die CLI im übergeordneten Projektordner. Sie bleibt dadurch auch im Unterordner buch über npx erreichbar.

npm install --save-dev hyperbook

8. Buch erzeugen

Der Assistent fragt nach Beschreibung, Autor, Lizenz und Sprache. Gib für die Sprache de an. Wähle die Lizenz für deine eigenen Inhalte bewusst; sie ist von Hyperbooks MIT-Lizenz getrennt.

npx hyperbook new buch

9. Buchordner öffnen

Wechselt zum erzeugten Arbeitsheft. Die Paketverwaltung liegt eine Ebene darüber; hier ist kein weiteres npm install nötig.

cd buch

10. Vorschau starten

Öffne die vom Terminal angezeigte Adresse, üblicherweise localhost:8080. Prüfe die Navigation und ändere eine Markdown-Seite im Ordner book. Strg + C beendet die Vorschau.

npx hyperbook dev

11. Arbeitsheft bauen

Erzeugt die statische Ausgabe. Der Befehl muss ohne Fehler enden; das Terminal nennt den Ausgabeordner.

npx hyperbook build

Installation prüfen

1. Paketstand anzeigen

Dokumentiert die installierte Hyperbook-Version. Bewahre package-lock.json für spätere Neuinstallationen auf.

npm ls hyperbook

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 -- ~/hyperbook-lab

2. Entfernung prüfen

Die Bestätigung erscheint nur, wenn der Ordner entfernt wurde.

test ! -e ~/hyperbook-lab && echo 'Projekt entfernt'

Quellen und Lizenz

Einstieg und Quellcode. Lizenz: MIT. Einzelne eingebundene Laufzeiten können eigene Lizenzen haben.

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.

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.

Autor: Thorsten · Installationsanleitungen für Ubuntu

Alle Anleitungen ohne Gewähr. Befehle mit sudo verändern das System – vorher lesen, dann ausführen.