Die μEdition konfigurieren

Die μEdition konfigurieren#

Die μEdition und Jupyter Book sind sehr konfigurable. Sowohl die μEdition, wie auch die Jupyter Book Funktionalität werden über die uEdition.yml (im Wurzelverzeichnis der μEdition) konfiguriert. Der folgende Block zeigt alle verfügbaren Konfigurationsoptionen:

author:           # Die Autor:innen:information bestehend aus
  name:           #   Dem Autor:in:namen
  email:          #   Der E-Mailaddresse der/des Autor:in:s
jb_config:        # Enthält alle gültigen Jupyter Book Konfigurationseinträge
languages:        # Die in der μEdition konfigurierten Sprachen. Eine List, in der jeder Eintrag aus folgenden Teilen besteht:
- code:           #   Der ISO 639-1 zweistellige Sprachcode
  label:          #   Der Text der in der Ausgabe für die Sprache angezeigt wird
  path:           #   Der Dateipfad in dem das sprachspezifische Jupyter Book abgelegt ist
output:           # Das Ausgabeverzeichnis für die komplette μEdition
repository:       # Das Git Repository für diese μEdition:
  url:            #   Die URL für das Repository
  branch:         #   Der Repositoryzweig in der μEdition
title:            # Der Titel der μEdition in allen konfigurierten Sprachen. Jede konfigurierte Sprache muss vorkommen.
  en:             #   Abbildung vom ISO 639-1 Sprachcode auf den natürlichsprachlichen Titel
version: '1'      # Die Version der μEdition Konfigurationsdatei. Muss auf "1" gesetzt sein.

Alle Konfigurationselement der Datei sind optional und nicht angegebene Werte werden durch funktionierende Standardwerte ersetzt.

Alle Element des Jupyter Book können über den jb_config Eintrag konfiguriert werden (eine vollständige Liste findet sich hier). Die hier angebenen Einstellungen werden für alle sprachspezifischen Jupyter Books genutzt. Die Ausnahme ist die titel Einstellung, für die der Text für die jeweilige Sprache genutzt wird.