Eine μEdition erstellen

Jetzt wo alle notwendigen Basiskomponenten installiert sind, zeigt das nächste Video, wie eine neue μEdition erstellt wird:

Einzelschritte

1. Die ../_static/pyproject.toml Datei herunterladen.

2. Einen neuen Ordern für die μEdition erstellen.

3. Die pyproject.toml Datei in den neuen Ordner verschieben.

4. Ein neues Terminal im neu angelegten Ordern öffnen.

5. Folgenden Befehl ausführen, um die neue μEdition zu initialisieren:

   $ hatch run init
   

   Dieser Vorgang kann ein paar Minuten dauern.

6. Folgenden Befehl ausführen, um der μEdition eine neue Sprache hinzuzufügen (jede μEdition braucht mindestens eine Sprache):

   $ hatch run language add
   

   Der Befehl fragt um drei Informationen:

   • Language code: ISO Sprachkürzel der neuen Sprache. Dieser wird für den Ordnernamen für die sprachspezifischen Inhalte genutzt.

   • Language name: Name der neuen Sprache. Diese wird für die Sprachwechselfunktionen der μEdition genutzt.

   • Title: Titel der neuen μEdition in der Sprache.

7. Folgenden Befehl ausführen, um die HTML Version der μEdition zu erstellen:

   $ hatch run serve
   

   Dies startet einen kleinen lokalen Webserver und die HTML Version der μEdition kann dann über folgende URL aufgerufen werden: http://localhost:8000. Der Start kann ein paar Sekunden dauern. Bitte geduldig sein :-).

Wenn sie nach dem letzten Schritt die μEdition im Browser sehen, dann sind sie bereit für die nächsten Schritte. Falls die μEdition nicht im Browser erscheint, dann sollte im Terminal ein Fehler auftauchen. Beheben sie den Fehler und dann sollte alles funktionieren.

Bemerkung

Um den Webserver zu stoppen, wechseln sie zum Terminal zurück und drücken dann Strg+c.

Vor dem Weiterarbeiten an der μEdition muss der Webserver dann mittels hatch run serve wieder gestartet werden.