chore(i18n,docs): processed translations (#45331)

This commit is contained in:
camperbot
2022-03-04 00:25:50 +05:30
committed by GitHub
parent 3428d46f7e
commit 7c9acca087
8 changed files with 124 additions and 468 deletions

View File

@@ -10,9 +10,7 @@ Se vuoi creare nuovi passi, i seguenti strumenti semplificano quel processo.
## create-next-step
Uno script eseguito una sola volta che aggiungerà automaticamente il prossimo passo basandosi sull'ultimo numerato come `step-xxx.md`, dove `xxx` rappresenta il numero a 3 cifre dell'ultimo passo. Il codice seed della sfida userà il codice seed di quella precedente, rimuovendo i marcatori delle regioni editabili (MRE).
**Nota:** Questo script esegue anche [reorder-steps](#reorder-steps).
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.
### Come eseguire lo script:
@@ -25,9 +23,9 @@ npm run create-next-step
## create-empty-steps
Uno script eseguito una sola volta che aggiunge automaticamente un determinato numero di passi a partire da un passo specifico. Il codice seed della sfida per tutti i passi creati sarà vuoto.
A one-off script that automatically adds a specified number of steps. The challenge seed code for all steps created will be empty.
**Nota:** Questo script esegue anche [reorder-steps](#reorder-steps).
**Note:** This script also runs [update-step-titles](#update-step-titles).
### Come eseguire lo script:
@@ -35,14 +33,14 @@ Uno script eseguito una sola volta che aggiunge automaticamente un determinato
2. Esegui il seguente comando npm:
```bash
npm run create-empty-steps start=X num=Y # dove X è il numero del passo da cui iniziare e Y è il numero di passi da creare.
npm run create-empty-steps X # where X is the number of steps to create.
```
## create-step-between
## insert-step
Uno script eseguito una sola volta che aggiunge automaticamente un passo in mezzo a due passi consecutivi già esistenti. Il codice seed della sfida userà il codice seed della sfida al passo di partenza già esistente, rimuovendo i marcatori delle regioni editabili (MRE).
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.
**Nota:** Questo script esegue anche [reorder-steps](#reorder-steps).
**Note:** This script also runs [update-step-titles](#update-step-titles).
### Come eseguire lo script:
@@ -50,12 +48,14 @@ Uno script eseguito una sola volta che aggiunge automaticamente un passo in mezz
2. Esegui il seguente comando npm:
```bash
npm run create-step-between start=X # dove X è il passo iniziale di partenza
npm run insert-step X # where X is the position to insert the new step.
```
## delete-step
Uno script eseguito una sola volta che cancella un passo esistente e poi riordina i passi rimanenti nella cartella del progetto e che aggiorna l'array della proprietà `challengeOrder` nel `meta.json` del progetto secondo il nuovo ordine dei passi.
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).
### Come eseguire lo script
@@ -63,61 +63,18 @@ Uno script eseguito una sola volta che cancella un passo esistente e poi riordin
2. Esegui il seguente comando npm:
```bash
npm run delete-step num=x # dove x è il numero dello step da eliminare.
npm run delete-step X # where X is the step number to be deleted.
```
## reorder-steps
## update-step-titles
Uno script eseguito una sola volta che riordina automaticamente i file dei passi nel markdown del progetto basandosi sui nomi dei file. Aggiorna anche l'array della proprietà `challengeOrder` nel `meta.json` del progetto secondo il nuovo ordine dei passi.
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.
### Esempi di funzionamento
Diciamo che inizi con la seguente struttura:
```bash
step-001.md
step-002.md
step-003.md
step-004.md
step-005.md
step-006.md
```
A un certo punto decidi che hai bisogno di eliminare `part-002.md`, perché quel passo non è più necessario. Inoltre, decidi di dividere `step-004.md` in tre passi invece di uno.
Per ottenere questa ristrutturazione, avresti bisogno di eliminare `step-002.md` e poi aggiungere un `step-4a.md` e un `step-4b.md`. La nuova struttura della cartella assomiglierà alla seguente:
```bash
step-001.md
step-003.md
step-004.md
step-004a.md
step-004b.md
step-005.md
step-006.md
```
Adesso serve che i nomi dei file vadano da `step-001.md` a `step-007.md`, poiché ne hai rimosso uno ma ne hai aggiunti due, con una differenza netta di un file. Inoltre, la presentazione di ogni file sotto un passo rimosso o aggiunto dovrà essere modificata rendendo il valore della chiave `title` uguale al nuovo numero del passo. Ad esempio, dopo aver rinominato `part-3.md` in `step-2.md`, dovrai cambiare il titolo di `step-2.md` da `Step 03` a `Step 02`.
Vedi qui sotto per gli effettivi cambiamenti necessari alla cartella del progetto:
```bash
step-001.md
step-003.md rinominato a step-002.md e titolo cambiato a "Step 2"
step-004.md rinominato a step-003.md e titolo cambiato a "Step 3"
step-004a.md rinominato a step-004.md e titolo cambiato a "Step 4"
step-004b.md rinominato a step-005.md e titolo cambiato a"Step 5"
step-005.md rinominato a step-006.md e titolo cambiato a "Step 6"
step-006.md rinominato a step-007.md e titolo cambiato a "Step 7"
```
Insieme ai cambi qui sopra, la chiave `challengeOrder` nel file `meta.json` del progetto deve riflettere il nuovo ordine dei passi. Questo è necessario perché ogni passo sotto la cancellazione e/o l'aggiunta di un passo cambia il `title` associato ad ognuno degli `id` delle sfide ai passi interessati.
### Come eseguire lo script
### How to run script
1. Vai alla directory del progetto.
2. Esegui il seguente comando npm:
```bash
npm run reorder-steps
npm run update-step-titles
```