CodeTour

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

CodeTour führt Schritt für Schritt durch Dateien eines Projekts in VS Code.

Die Anleitung gilt für Ubuntu 26.04 LTS (amd64). Voraussetzung ist Visual Studio Code. Das Beispiel benötigt keine Cloud und keine automatische Bewertung.

Installation

1. Paketlisten aktualisieren

Aktualisiert die Paketinformationen für Python.

sudo apt update

2. Python installieren

Wird für das kleine Projektbeispiel gebraucht.

sudo apt install python3

3. Erweiterung installieren

Verwendet die offizielle Marketplace-Kennung.

code --install-extension vsls-contrib.codetour

4. Projektordner anlegen

Verwende einen noch nicht vorhandenen Zielordner.

mkdir ~/codetour-lab

5. Projektordner öffnen

Die folgenden Dateien gehören zu diesem Projekt.

cd ~/codetour-lab

6. Beispielprogramm schreiben

Zwei Zeilen genügen, um Navigation und Erläuterung zu erproben.

cat > beispiel.py <<'EOF'
orte = ["Bremen", "Ulm", "Jena"]
print(sorted(orte))
EOF

7. Tourordner anlegen

CodeTour findet gespeicherte Touren im Verzeichnis .tours.

mkdir .tours

8. Tour schreiben

Die zwei Schritte zeigen auf vorhandene Zeilen des eigenen Beispiels.

cat > .tours/einstieg.tour <<'EOF'
{
  "title": "Ortsliste verstehen",
  "steps": [
    {
      "file": "beispiel.py",
      "line": 1,
      "description": "Hier wird die Liste angelegt. Ergänze einen vierten Ort."
    },
    {
      "file": "beispiel.py",
      "line": 2,
      "description": "Die Ausgabe ist alphabetisch sortiert. Prüfe sie anschließend im Terminal."
    }
  ]
}
EOF

9. Projekt in VS Code öffnen

CodeTour erkennt die Tour im geöffneten Ordner.

code --new-window .

10. Tour starten

Wähle im CodeTour-Bereich des Explorers Ortsliste verstehen und starte die Tour. Kontrolliere, dass beide Schritte die passenden Zeilen öffnen. Falls der Bereich fehlt, lade das Fenster mit Developer: Reload Window neu.

Installation prüfen

1. Erweiterung anzeigen

Die Ausgabe muss vsls-contrib.codetour mit Versionsnummer enthalten.

code --list-extensions --show-versions

2. Beispiel ausführen

Zeigt die sortierte Liste; dies ist ein manuell gestarteter Befehl und keine automatische CodeTour-Bewertung.

python3 beispiel.py

Deinstallieren

1. Erweiterung entfernen

Entfernt CodeTour aus dem aktiven VS-Code-Profil.

code --uninstall-extension vsls-contrib.codetour

2. Projekt optional entfernen

Löscht auch die eigene Tour und das Beispielprogramm.

rm -rf -- ~/codetour-lab

3. Entfernung prüfen

vsls-contrib.codetour soll nicht mehr in der Ausgabe stehen.

code --list-extensions

Quellen und Lizenz

CodeTour-Projekt, Paketkennung und Tourformat. Lizenz: MIT.

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.