Codapi

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

Codapi ergänzt Webseiten um bearbeitbare und ausführbare Codebeispiele.

Für Ubuntu 26.04 LTS auf amd64. Hier wird das Browser-Widget mit JavaScript eingerichtet; ein eigener Ausführungsserver ist dafür nicht nötig. 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 ~/codapi-demo

4. Projektordner öffnen

Die weiteren Befehle beziehen sich auf diesen Ordner.

cd ~/codapi-demo

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. Widget installieren

Speichert JavaScript und CSS lokal im Projekt.

npm install @antonz/codapi@0.20.0

8. Webserver installieren

Python liefert die Demo per HTTP aus.

sudo apt install python3

9. Demoseite schreiben

Das Browser-Attribut führt JavaScript auf dem Gerät des Lesers aus. Die Dateien werden aus dem lokal installierten Paket geladen.

cat > index.html <<'EOF'
<!doctype html>
<html lang="de">
<meta charset="utf-8">
<title>Codapi unter Ubuntu</title>
<link rel="stylesheet" href="./node_modules/@antonz/codapi/dist/snippet.css">
<h1>Rechnen im Browser</h1>
<pre><code>const preise = [4, 7, 12];
console.log(preise.reduce((summe, preis) => summe + preis, 0));</code></pre>
<codapi-snippet engine="browser" sandbox="javascript" editor="basic"></codapi-snippet>
<script src="./node_modules/@antonz/codapi/dist/snippet.js"></script>
</html>
EOF

10. Demo starten

Öffne http://127.0.0.1:8000. Mit Run soll die Ausgabe 23 erscheinen. Ändere einen Preis über Edit und führe erneut aus. Strg + C beendet den Server.

python3 -m http.server 8000 --bind 127.0.0.1

Server und Cloud

Der offizielle selbst betriebene Server verwendet Docker für seine Sandboxes. Unter der Vorgabe dieses Buchs wird er nicht eingerichtet. Die Cloud kann alternativ serverseitige Sprachen ausführen; dabei wird der Quellcode an einen externen Dienst übertragen. Der Anbieter nennt am Prüfdatum ein Gratis-Kontingent von 1000 Ausführungen pro Monat. Prüfe die aktuellen Bedingungen vor der Nutzung. Die Browserdemo oben nutzt dieses Kontingent nicht.

1. Installation prüfen

Zeigt den lokal installierten Widgetstand.

npm ls @antonz/codapi

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 -- ~/codapi-demo

2. Entfernung prüfen

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

test ! -e ~/codapi-demo && echo 'Projekt entfernt'

Quellen und Lizenz

Widget-Einbindung, JavaScript im Browser, Cloud und Serverinstallation. Widget: MIT; Server: Apache-2.0.

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.