Skip to content

Dokumentation für Benutzer

Jump to bottom
Lasse Kristopher Meyer edited this page Sep 30, 2015 · 9 revisions

Garantierte Kompatibilität dieser Seite: <=0.1.0

Inhaltsverzeichnis:

  1. Installation
  2. Installation über den Texteditor (empfohlen)
  3. Installation über die Kommandozeile
  4. Verwendung
  5. Level-Sprache installieren
  6. Level-Sprache deinstallieren
  7. Level-Sprache konfigurieren
  8. Level-Sprache auswählen
  9. Level auswählen
  10. Level-Code-Programm ausführen
  11. Globale Einstellungen
  12. Liste aller Shortcuts

Installation

Grundsätzlich muss natürlich zunächst der Texteditor Atom installiert werden. Für die Installation des Pakets Levels gibt es anschließend zwei Möglichkeiten:

Installation über den Texteditor (empfohlen)

Voraussetzung: Beherrschung von Maus und Tastatur

Innerhalb von Atom können registrierte Pakete über das Settings-Tab (Atom > Preferences... oder cmd-,) installiert werden. Dazu einfach links den Menüpunkt Install auswählen, über die Suchleiste das entsprechende Paket ausfindig machen und über den Install-Button (rot markiert) die Installation des Pakets starten:

Installation über die Kommandozeile

Voraussetzung: Verfügbarkeit des Kommandozeilenbefehls apm (siehe hier)

Ist apm verfügbar, kann die aktuellste Version des Pakets über den folgenden Befehl installiert werden:

apm install levels

Um eine bestimmte Version des Pakets zu installieren kann wiederum der Befehl

apm install levels@<package_version>

verwendet werden, wobei <package_version> durch die jeweilige Versionsnummer zu ersetzen ist (z.B. apm install [email protected] zur Installation der Version 0.1.0).

Wenn alles geklappt hat, wird Levels nun in den Community Packages unter Atom > Preferences... > Packages aufgeführt. Ggf. kann das Paket hier auch aktiviert bzw. deaktiviert werden. Des Weiteren sind hier auch die globalen Paketeinstellungen zu finden.

Verwendung

Level-Sprache installieren

Level-Sprachen können über den integrierten Language Manager installiert werden. Ist Levels aktiviert kann dieser über Packages > Levels > Toggle Level Manager oder über das Shortcut ctrl-alt-m geöffnet (geschlossen) werden.

Zur Installation einer Sprache einfach Install Languages (rot markiert) wählen und im folgenden Dialog die Konfigurationsdatei config.json aus dem Stammverzeichnis des Sprach-Projektordners wählen.

Nach der erfolgreichen Installation wird die Sprache im Language Manager aufgeführt.

Level-Sprache deinstallieren

Über den Language Manager (siehe Abschnitt zur Sprachinstallation) lassen sich installierte Sprachen auch wieder deinstallieren.

Dazu einfach für die zu deinstallierende Sprache aus der Sprachliste Uninstall (rot markiert) wählen und den Vorgang bestätigen.

Level-Sprache konfigurieren

Auch die Konfiguration installierter Sprachen erfolgt über den Language Manager (siehe Abschnitt zur Sprachinstallation).

Über den Configure-Button der entsprechenden Sprache öffnet sich das Konfigurations-Panel:

(Anmerkung: Momentan lassen sich im Konfigurations-Panel nur Einstellungen bzgl. der Command Pattern und des Execution Modes vornehmen. Zukünftig soll die Sprachkonfiguration allerdings noch ausgebaut werden.)

Level-Sprache auswählen

Die Auswahl einer Level-Sprache entspricht der Auswahl einer Grammatik für das Syntax-Highlighting über den Grammar Selector. Dieser kann über den Link unten rechts in der Statusleiste (rot markiert) oder über das Shortcut ctrl-shift-l getriggert werden. Mit dem Levels-Paket assoziierte Sprachen sind mit dem Suffix (Levels) gekennzeichnet (also z.B. Ruby (Levels)):

Nach der Auswahl einer Level-Sprache sollten im Interface das aktuelle Level (unten rechts neben der Grammatik in der Statusleiste) und das Terminal Panel erscheinen:

Das initiale Level nach der Sprachwahl entspricht dabei dem zuletzt durch den Benutzer ausgewählten Level für diese Sprache. Falls kein solches existiert, wird initial das erste Level der Sprache gewählt.

Level auswählen

Falls eine Level-Sprache ausgewählt wurde, erfolgt die Levelauswahl analog zur Sprachauswahl über den Level Selector. Dieser wird über den Link unten rechts in der Statusleiste (rot markiert) oder über das Shortcut ctrl-alt-l getriggert:

Level-Code-Programm ausführen

Wurde eine Level-Sprache ausgewählt, kann der aktuelle Level-Code im Texteditor-Tab über den Run-Button im Terminal (rot markiert) oder das Shortcut ctrl-alt-r ausgeführt werden (vorher abspeichern! - die Executable benötigt nämlich einen Dateipfad):

Wie zu sehen ist, werden Warnungen und Ausführungsfehler sowohl im Terminal als auch im Texteditor-Fenster farbig hervorgehoben. Durch einen Klick auf die erste Zeile einer Warnung oder eines Fehlers im Terminal wird der Cursor im Texteditor an die entsprechende Position gesetzt. Befindet sich der Cursor in einer Zeile, die eine Warnung oder einen Fehler enthält, wird zudem eine entsprechende Annotation im Texteditor angezeigt.

Globale Einstellungen

Die globalen Paketeinstellungen sind unter Atom > Preferences... > Packages > levels zu finden. Hier lassen sich momentan folgende Konfigurationen vornehmen:

  • Default Terminal Font Size (Default: 12): Die initiale Schriftgröße (in px) im Terminal. Die Schriftgröße für einzelne Terminals lässt sich über die Kontrollleiste des Terminal-Panels anpassen. Die Default Terminal Font Size bestimmt die Standard-Schriftgröße für neue Terminals.

  • Initially Hide The Terminal (Default: false): Terminals lassen sich ein- und aufklappen. Diese Einstellung bestimmt, ob neue Terminals initial standardmäßig ein- oder aufgeklappt sein sollen.

  • Default Terminal Size (Default: 20): Die initiale Größe (in Zeilen) von Terminals. Über die Kontrollleiste lassen sich Terminals in der Vertikalen verkleinern bzw. vergrößern. Die Default Terminal Size bestimmt die Standardgröße neuer Terminals.

  • Show All Error Notifications (Default: true): Legt fest ob alle Paketbenachrichtigungen vom Typ Error angezeigt werden, oder nur wichtige.

  • Show All Info Notifications (Default: true): Legt fest ob alle Paketbenachrichtigungen vom Typ Info angezeigt werden, oder nur wichtige.

  • Show All Success Notifications (Default: true): Legt fest ob alle Paketbenachrichtigungen vom Typ Success angezeigt werden, oder nur wichtige.

  • Show All Warning Notifications (Default: true): Legt fest ob alle Paketbenachrichtigungen vom Typ Warning angezeigt werden, oder nur wichtige.

  • When To Write The Language Information File Header (Default: before saving the buffer): Um Level-Code-Programme sitzungsübergreifend mit einer Level-Sprache und insbesondere auch mit einem bestimmten Level dieser Sprache verknüpfen zu können, verwendet Levels File Header. Ein File Header ist ein Kommentar in der ersten Zeile der Datei und hat die Form Language: <languageName>, Level: <levelName>. Mit dieser Einstellung wird festgelegt, wann File Header in der erste Zeile der Datei geschrieben werden. Hier gibt es zwei Möglichkeiten:

    • before saving the buffer: Beim Speichern eines Level-Code-Programms wird der File Header noch vor dem Abspeichern hinzugefügt bzw. aktualisiert.
    • after setting the level: Der File Header wird jedes Mal geschrieben/aktualisiert, wenn das Level eingestellt wird.

Liste aller Shortcuts

Shortcut Beschreibung
ctrl-alt-m Öffnet (Schließt) den Language Manager
ctrl-alt-l Öffnet (Schließt) den Level Selector
ctrl-alt-t Klappt das Terminal ein (auf)
ctrl-alt-+ Inkrementiert die Schriftgröße im Terminal
ctrl-alt-- Dekrementiert die Schriftgröße im Terminal
ctrl-alt-f Wechselt den Fokus zwischen Texteditor und Terminal
ctrl-alt-up Scrollt zum Anfang des Terminalinhalts
ctrl-alt-down Scrollt zum Ende des Terminalinhalts
ctrl-alt-r Führt das Level-Code-Programm aus
ctrl-alt-s Stoppt die Ausführung (noch nicht unterstützt)
Clone this wiki locally