chore(i18n,docs): processed translations (#45331)
This commit is contained in:
camperbot
GitHub
@@ -10,9 +10,7 @@ Wenn du neue Schritte erstellen willst, vereinfachen die folgenden Tools diesen
|
||||
|
||||
## Nächsten Schritt erstellen
|
||||
|
||||
Ein einmaliges Skript, das automatisch den nächsten Schritt hinzufügt, basierend auf dem letzten Schritt, der als `step-xxx.md` nummeriert ist, wobei `xxx` die dreistellige Schrittnummer des letzten Schritts darstellt. Der Aufgaben-Seed-Code (initialer Startcode im Editor) verwendet den Aufgaben-Seed-Code des vorherigen Schritts, wobei die Editable Region Markers (ERMs) entfernt werden.
|
||||
|
||||
**Hinweis:** Dieses Skript führt auch [reorder-steps](#reorder-steps) aus.
|
||||
A one-off script that will automatically add the next step based on the last step in the project. The challenge seed code will use the previous step's challenge seed code.
|
||||
|
||||
### So führst du das Skript aus:
|
||||
|
||||
@@ -25,9 +23,9 @@ npm run create-next-step
|
||||
|
||||
## leere Schritte erstellen
|
||||
|
||||
Ein einmaliges Skript, das automatisch eine bestimmte Anzahl von Schritten bei einer bestimmten Startschrittnummer hinzufügt. Der Aufgaben-Seed-Code für alle erstellten Schritte wird leer sein.
|
||||
A one-off script that automatically adds a specified number of steps. The challenge seed code for all steps created will be empty.
|
||||
|
||||
**Hinweis:** Dieses Skript führt auch [reorder-steps](#reorder-steps) aus.
|
||||
**Note:** This script also runs [update-step-titles](#update-step-titles).
|
||||
|
||||
### So führst du das Skript aus:
|
||||
|
||||
@@ -35,14 +33,14 @@ Ein einmaliges Skript, das automatisch eine bestimmte Anzahl von Schritten bei e
|
||||
2. Führe den folgenden npm-Befehl aus:
|
||||
|
||||
```bash
|
||||
npm run create-empty-steps start=X num=Y # wobei X die Startschrittnummer und Y die Anzahl der zu erstellenden Schritte ist.
|
||||
npm run create-empty-steps X # where X is the number of steps to create.
|
||||
```
|
||||
|
||||
## Zwischenschritt erstellen
|
||||
## insert-step
|
||||
|
||||
Ein einmaliges Skript, das automatisch einen neuen Schritt zwischen zwei bestehenden, aufeinanderfolgenden Schritten einfügt. Der Aufgaben-Seed-Code verwendet den bestehenden Aufgaben-Seed-Code des Startschritts, wobei die ERMs (Editable Region Markers) entfernt werden.
|
||||
A one-off script that automatically adds a new step at a specified position, incrementing all subsequent steps (both their titles and in their meta.json). The challenge seed code will use the previous step's challenge seed code with the editable region markers (ERMs) removed.
|
||||
|
||||
**Hinweis:** Dieses Skript führt auch [reorder-steps](#reorder-steps) aus.
|
||||
**Note:** This script also runs [update-step-titles](#update-step-titles).
|
||||
|
||||
### So führst du das Skript aus:
|
||||
|
||||
@@ -50,12 +48,14 @@ Ein einmaliges Skript, das automatisch einen neuen Schritt zwischen zwei bestehe
|
||||
2. Führe den folgenden npm-Befehl aus:
|
||||
|
||||
```bash
|
||||
npm run create-step-between start=X # wobei X die Nummer des Anfangsschritts ist
|
||||
npm run insert-step X # where X is the position to insert the new step.
|
||||
```
|
||||
|
||||
## Lösche eine Schritt
|
||||
|
||||
Ein einmaliges Skript, das einen bestehenden Schritt löscht und dann die verbleibenden Schrittdateien im Projektordner neu anordnet sowie das Eigenschaftsarray `challengeOrder` in der `meta.json` des Projekts mit der neuen Reihenfolge der Schritte aktualisiert.
|
||||
A one-off script that deletes an existing step, decrementing all subsequent steps (both their titles and in their meta.json)
|
||||
|
||||
**Note:** This script also runs [update-step-titles](#update-step-titles).
|
||||
|
||||
### So führst du das Skript aus
|
||||
|
||||
@@ -63,61 +63,18 @@ Ein einmaliges Skript, das einen bestehenden Schritt löscht und dann die verble
|
||||
2. Führe den folgenden npm-Befehl aus:
|
||||
|
||||
```bash
|
||||
npm run delete-step num=x # wobei x die Schrittnummer ist, die gelöscht werden soll.
|
||||
npm run delete-step X # where X is the step number to be deleted.
|
||||
```
|
||||
|
||||
## Schritte neu ordnen
|
||||
## update-step-titles
|
||||
|
||||
Ein einmaliges Skript, das die Schrittdateien in den Markdown-Dateien eines Projekts automatisch anhand des Dateinamens neu anordnet. Außerdem wird das `challengeOrder` Eigenschaftsarray in der `meta.json` des Projekts mit der neuen Reihenfolge der Schritte aktualisiert.
|
||||
A one-off script that automatically updates the frontmatter in a project's markdown files so that they are consistent with the project's meta.json. It ensures that each step's title (and dashedName) match the meta's challengeOrder.
|
||||
|
||||
### Praxisbeispiel
|
||||
|
||||
Nehmen wir an, du beginnst mit der folgenden Projektstruktur:
|
||||
|
||||
```bash
|
||||
step-001.md
|
||||
step-002.md
|
||||
step-003.md
|
||||
step-004.md
|
||||
step-005.md
|
||||
step-006.md
|
||||
```
|
||||
|
||||
Irgendwann entscheidest du, dass du `Schritt-002.md` löschen musst, weil du diesen Schritt nicht mehr brauchst. Außerdem entscheidest du dich, `Schritt-004.md` in drei Schritte aufzuteilen, statt nur in einen.
|
||||
|
||||
Um diese Umstrukturierung zu erreichen, musst du `step-002.md` löschen und dann eine `step-004a.md` und eine `step-004b.md` hinzufügen. Die neue Ordnerstruktur würde wie folgt aussehen:
|
||||
|
||||
```bash
|
||||
step-001.md
|
||||
step-003.md
|
||||
step-004.md
|
||||
step-004a.md
|
||||
step-004b.md
|
||||
step-005.md
|
||||
step-006.md
|
||||
```
|
||||
|
||||
Die Dateinamen müssen jetzt `step-001.md` bis `step-007.md` lauten, denn du hast eine Datei entfernt, aber zwei weitere hinzugefügt, so dass die Differenz nur eine Datei beträgt. Außerdem muss das Frontmatter jeder Datei unterhalb eines gelöschten oder hinzugefügten Schritts geändert werden, indem der Schlüsselwert `title` an die neue Schrittnummer angepasst wird. Wenn du zum Beispiel `step-3.md` in `step-2.md` umbenannt hast, musst du den Titel von `step-2.md` von `Step 03` in `Step 02` ändern.
|
||||
|
||||
Weiter unten findest du die erforderlichen Änderungen am Projektordner:
|
||||
|
||||
```bash
|
||||
step-001.md
|
||||
step-003.md renamed to step-002.md and title changes to "Step 2"
|
||||
step-004.md renames to step-003.md and title changes to "Step 3"
|
||||
step-004a.md renames to step-004.md and title changes to "Step 4"
|
||||
step-004b.md renames to step-005.md and title changes to "Step 5"
|
||||
step-005.md renames to step-006.md and title changes to "Step 6"
|
||||
step-006.md renames to step-007.md and title changes to "Step 7"
|
||||
```
|
||||
|
||||
Zusammen mit den oben genannten Änderungen muss der Schlüssel `challengeOrder` in der Datei `meta.json` des Projekts die neue Schrittreihenfolge widerspiegeln. Das ist notwendig, weil jeder Schritt, der gelöscht und/oder hinzugefügt wird, den `title` ändert, der mit jeder der betroffenen Schritt-Aufgabe `id` verbunden ist.
|
||||
|
||||
### Wie man das Skript ausführt
|
||||
### How to run script
|
||||
|
||||
1. Wechsle in das Verzeichnis des Projekts.
|
||||
2. Führe den folgenden npm-Befehl aus:
|
||||
|
||||
```bash
|
||||
npm run reorder-steps
|
||||
npm run update-step-titles
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user