diff --git a/docs/i18n/chinese/how-to-work-on-practice-projects.md b/docs/i18n/chinese/how-to-work-on-practice-projects.md index 16782c1977c..9dc283fb5a0 100644 --- a/docs/i18n/chinese/how-to-work-on-practice-projects.md +++ b/docs/i18n/chinese/how-to-work-on-practice-projects.md @@ -10,7 +10,7 @@ If you want to create new steps, the following tools simplify that process. ## create-next-step -A one-off script that will automatically add the next step based on the last step numbered as `part-xxx.md` where `xxx` represents the 3-digit step number of the last step. The challenge seed code will use the previous step's challenge seed code with the editable region markers (ERMs) removed. +A one-off script that will automatically add the next step based on the last step numbered as `step-xxx.md` where `xxx` represents the 3-digit step number of the last step. The challenge seed code will use the previous step's challenge seed code with the editable region markers (ERMs) removed. **Note:** This script also runs [reorder-steps](#reorder-steps). @@ -75,40 +75,40 @@ A one-off script that automatically reorders the step files in a project's markd Let's say you start with the following project structure: ```bash -part-1.md -part-2.md -part-3.md -part-4.md -part-5.md -part-6.md +step-001.md +step-002.md +step-003.md +step-004.md +step-005.md +step-006.md ``` -At some point you decide you need to delete `part-2.md`, because that step is no longer needed. Also, you decide to break down `part-4.md` into three steps instead of just one. +At some point you decide you need to delete `step-002.md`, because that step is no longer needed. Also, you decide to break down `step-004.md` into three steps instead of just one. -To accomplish this restructure, you would need to delete `part-2.md` and then add a `part-4a.md` and a `part-4b.md`. The new folder structure would look like the following: +To accomplish this restructure, you would need to delete `step-002.md` and then add a `step-004a.md` and a `step-004b.md`. The new folder structure would look like the following: ```bash -part-001.md -part-003.md -part-004.md -part-004a.md -part-004b.md -part-005.md -part-006.md +step-001.md +step-003.md +step-004.md +step-004a.md +step-004b.md +step-005.md +step-006.md ``` -You now need the file names to be `part-1.md` through `part-7.md`, because you removed one but gained two more for a net difference of one file. Also, the frontmatter of each file below a deleted step or added step will need to be modified by making the `title` key value match the new step number. For example, after renaming `part-3.md` to `part-2.md`, you would need to change `part-2.md`'s title from `Part 03` to `Part 02`. +You now need the file names to be `step-001.md` through `step-007.md`, because you removed one but gained two more for a net difference of one file. Also, the frontmatter of each file below a deleted step or added step will need to be modified by making the `title` key value match the new step number. For example, after renaming `step-3.md` to `step-2.md`, you would need to change `step-2.md`'s title from `Step 03` to `Step 02`. See below for the actual project folder changes needed: ```bash -part-001.md -part-003.md renamed to part-002.md and title changes to "Part 2" -part-004.md renames to part-003.md and title changes to "Part 3" -part-004a.md renames to part-004.md and title changes to "Part 4" -part-004b.md renames to part-005.md and title changes to "Part 5" -part-005.md renames to part-006.md and title changes to "Part 6" -part-006.md renames to part-007.md and title changes to "Part 7" +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" ``` Along with the above changes, the `challengeOrder` key in the project's `meta.json` file needs to reflect the new step order. This is needed because each step below a step deletion and/or step addition changes the `title` associated with each of the affected step's challenge `id`. diff --git a/docs/i18n/espanol/how-to-work-on-practice-projects.md b/docs/i18n/espanol/how-to-work-on-practice-projects.md index 16782c1977c..9dc283fb5a0 100644 --- a/docs/i18n/espanol/how-to-work-on-practice-projects.md +++ b/docs/i18n/espanol/how-to-work-on-practice-projects.md @@ -10,7 +10,7 @@ If you want to create new steps, the following tools simplify that process. ## create-next-step -A one-off script that will automatically add the next step based on the last step numbered as `part-xxx.md` where `xxx` represents the 3-digit step number of the last step. The challenge seed code will use the previous step's challenge seed code with the editable region markers (ERMs) removed. +A one-off script that will automatically add the next step based on the last step numbered as `step-xxx.md` where `xxx` represents the 3-digit step number of the last step. The challenge seed code will use the previous step's challenge seed code with the editable region markers (ERMs) removed. **Note:** This script also runs [reorder-steps](#reorder-steps). @@ -75,40 +75,40 @@ A one-off script that automatically reorders the step files in a project's markd Let's say you start with the following project structure: ```bash -part-1.md -part-2.md -part-3.md -part-4.md -part-5.md -part-6.md +step-001.md +step-002.md +step-003.md +step-004.md +step-005.md +step-006.md ``` -At some point you decide you need to delete `part-2.md`, because that step is no longer needed. Also, you decide to break down `part-4.md` into three steps instead of just one. +At some point you decide you need to delete `step-002.md`, because that step is no longer needed. Also, you decide to break down `step-004.md` into three steps instead of just one. -To accomplish this restructure, you would need to delete `part-2.md` and then add a `part-4a.md` and a `part-4b.md`. The new folder structure would look like the following: +To accomplish this restructure, you would need to delete `step-002.md` and then add a `step-004a.md` and a `step-004b.md`. The new folder structure would look like the following: ```bash -part-001.md -part-003.md -part-004.md -part-004a.md -part-004b.md -part-005.md -part-006.md +step-001.md +step-003.md +step-004.md +step-004a.md +step-004b.md +step-005.md +step-006.md ``` -You now need the file names to be `part-1.md` through `part-7.md`, because you removed one but gained two more for a net difference of one file. Also, the frontmatter of each file below a deleted step or added step will need to be modified by making the `title` key value match the new step number. For example, after renaming `part-3.md` to `part-2.md`, you would need to change `part-2.md`'s title from `Part 03` to `Part 02`. +You now need the file names to be `step-001.md` through `step-007.md`, because you removed one but gained two more for a net difference of one file. Also, the frontmatter of each file below a deleted step or added step will need to be modified by making the `title` key value match the new step number. For example, after renaming `step-3.md` to `step-2.md`, you would need to change `step-2.md`'s title from `Step 03` to `Step 02`. See below for the actual project folder changes needed: ```bash -part-001.md -part-003.md renamed to part-002.md and title changes to "Part 2" -part-004.md renames to part-003.md and title changes to "Part 3" -part-004a.md renames to part-004.md and title changes to "Part 4" -part-004b.md renames to part-005.md and title changes to "Part 5" -part-005.md renames to part-006.md and title changes to "Part 6" -part-006.md renames to part-007.md and title changes to "Part 7" +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" ``` Along with the above changes, the `challengeOrder` key in the project's `meta.json` file needs to reflect the new step order. This is needed because each step below a step deletion and/or step addition changes the `title` associated with each of the affected step's challenge `id`. diff --git a/docs/i18n/italian/how-to-work-on-practice-projects.md b/docs/i18n/italian/how-to-work-on-practice-projects.md index 35f4186cc95..49e941fd130 100644 --- a/docs/i18n/italian/how-to-work-on-practice-projects.md +++ b/docs/i18n/italian/how-to-work-on-practice-projects.md @@ -10,7 +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 `part-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). +A one-off script that will automatically add the next step based on the last step numbered as `step-xxx.md` where `xxx` represents the 3-digit step number of the last step. 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). @@ -75,40 +75,40 @@ Uno script eseguito una sola volta che riordina automaticamente i file dei passi Diciamo che inizi con la seguente struttura: ```bash -part-1.md -part-2.md -part-3.md -part-4.md -part-5.md -part-6.md +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-2.md`, perché quel passo non è più necessario. Inoltre, decidi di dividere `part-4.md` in tre passi invece di uno. +At some point you decide you need to delete `step-002.md`, because that step is no longer needed. Also, you decide to break down `step-004.md` into three steps instead of just one. -Per ottenere questa ristrutturazione, avresti bisogno di eliminare `part-2.md` e poi aggiungere un `part-4a.md` e un `part-4b.md`. La nuova struttura della cartella assomiglierà alla seguente: +To accomplish this restructure, you would need to delete `step-002.md` and then add a `step-004a.md` and a `step-004b.md`. La nuova struttura della cartella assomiglierà alla seguente: ```bash -part-001.md -part-003.md -part-004.md -part-004a.md -part-004b.md -part-005.md -part-006.md +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 `part-1.md` a `part-7.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 `part-2.md`, dovrai cambiare il titolo di `part-2.md` da `Part 03` a `Part 02`. +You now need the file names to be `step-001.md` through `step-007.md`, because you removed one but gained two more for a net difference of one 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. For example, after renaming `step-3.md` to `step-2.md`, you would need to change `step-2.md`'s title from `Step 03` to `Step 02`. Vedi qui sotto per gli effettivi cambiamenti necessari alla cartella del progetto: ```bash -part-001.md -part-003.md rinominato in part-002.md e titolo cambiato in "Part 2" -part-004.md rinominato in part-003.md e titolo cambiato in "Part 3" -part-004a.md rinominato in part-004.md e titolo cambiato in "Part 4" -part-004b.md rinominato in part-005.md e titolo cambiato in "Part 5" -part-005.md rinominato in part-006.md e titolo cambiato in "Part 6" -part-006.md rinominato in part-007.md e titolo cambiato in "Part 7" +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" ``` 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. diff --git a/docs/i18n/japanese/how-to-work-on-practice-projects.md b/docs/i18n/japanese/how-to-work-on-practice-projects.md index 16782c1977c..9dc283fb5a0 100644 --- a/docs/i18n/japanese/how-to-work-on-practice-projects.md +++ b/docs/i18n/japanese/how-to-work-on-practice-projects.md @@ -10,7 +10,7 @@ If you want to create new steps, the following tools simplify that process. ## create-next-step -A one-off script that will automatically add the next step based on the last step numbered as `part-xxx.md` where `xxx` represents the 3-digit step number of the last step. The challenge seed code will use the previous step's challenge seed code with the editable region markers (ERMs) removed. +A one-off script that will automatically add the next step based on the last step numbered as `step-xxx.md` where `xxx` represents the 3-digit step number of the last step. The challenge seed code will use the previous step's challenge seed code with the editable region markers (ERMs) removed. **Note:** This script also runs [reorder-steps](#reorder-steps). @@ -75,40 +75,40 @@ A one-off script that automatically reorders the step files in a project's markd Let's say you start with the following project structure: ```bash -part-1.md -part-2.md -part-3.md -part-4.md -part-5.md -part-6.md +step-001.md +step-002.md +step-003.md +step-004.md +step-005.md +step-006.md ``` -At some point you decide you need to delete `part-2.md`, because that step is no longer needed. Also, you decide to break down `part-4.md` into three steps instead of just one. +At some point you decide you need to delete `step-002.md`, because that step is no longer needed. Also, you decide to break down `step-004.md` into three steps instead of just one. -To accomplish this restructure, you would need to delete `part-2.md` and then add a `part-4a.md` and a `part-4b.md`. The new folder structure would look like the following: +To accomplish this restructure, you would need to delete `step-002.md` and then add a `step-004a.md` and a `step-004b.md`. The new folder structure would look like the following: ```bash -part-001.md -part-003.md -part-004.md -part-004a.md -part-004b.md -part-005.md -part-006.md +step-001.md +step-003.md +step-004.md +step-004a.md +step-004b.md +step-005.md +step-006.md ``` -You now need the file names to be `part-1.md` through `part-7.md`, because you removed one but gained two more for a net difference of one file. Also, the frontmatter of each file below a deleted step or added step will need to be modified by making the `title` key value match the new step number. For example, after renaming `part-3.md` to `part-2.md`, you would need to change `part-2.md`'s title from `Part 03` to `Part 02`. +You now need the file names to be `step-001.md` through `step-007.md`, because you removed one but gained two more for a net difference of one file. Also, the frontmatter of each file below a deleted step or added step will need to be modified by making the `title` key value match the new step number. For example, after renaming `step-3.md` to `step-2.md`, you would need to change `step-2.md`'s title from `Step 03` to `Step 02`. See below for the actual project folder changes needed: ```bash -part-001.md -part-003.md renamed to part-002.md and title changes to "Part 2" -part-004.md renames to part-003.md and title changes to "Part 3" -part-004a.md renames to part-004.md and title changes to "Part 4" -part-004b.md renames to part-005.md and title changes to "Part 5" -part-005.md renames to part-006.md and title changes to "Part 6" -part-006.md renames to part-007.md and title changes to "Part 7" +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" ``` Along with the above changes, the `challengeOrder` key in the project's `meta.json` file needs to reflect the new step order. This is needed because each step below a step deletion and/or step addition changes the `title` associated with each of the affected step's challenge `id`. diff --git a/docs/i18n/portuguese/how-to-work-on-practice-projects.md b/docs/i18n/portuguese/how-to-work-on-practice-projects.md index 8a86084b814..a814101d17d 100644 --- a/docs/i18n/portuguese/how-to-work-on-practice-projects.md +++ b/docs/i18n/portuguese/how-to-work-on-practice-projects.md @@ -10,7 +10,7 @@ Se você quer criar novos passos, as ferramentas a seguir vão simplificar o pro ## create-next-step (criar próximo passo) -Um script único que automaticamente adiciona um novo passo baseado no último passo numerado como `part-xxx.md` onde `xxx` representa o número de 3 dígitos do último passo. O código inicial de desafio usará o código inicial de desafio da etapa anterior com os marcadores de região editáveis ​​(ERMs) removidos. +A one-off script that will automatically add the next step based on the last step numbered as `step-xxx.md` where `xxx` represents the 3-digit step number of the last step. O código inicial de desafio usará o código inicial de desafio da etapa anterior com os marcadores de região editáveis ​​(ERMs) removidos. **Observação:** esse script também executa [reorder-steps](#reorder-steps). @@ -75,40 +75,40 @@ Um script único que automaticamente reordena os aquivos de passos em arquivos m Digamos que você começa com a estrutura de projeto a seguir: ```bash -part-1.md -part-2.md -part-3.md -part-4.md -part-5.md -part-6.md +step-001.md +step-002.md +step-003.md +step-004.md +step-005.md +step-006.md ``` -Em algum momento, você decide que precisa deletar `part-2.md`, porque os passos nele não são mais necessários. Você também decide que vai diluir as partes dentro de `part-4.md` em três passos ao invés de um. +At some point you decide you need to delete `step-002.md`, because that step is no longer needed. Also, you decide to break down `step-004.md` into three steps instead of just one. -Para completar essa reestruturação, você precisará excluir a `part-2.md` e então adicionar a `part-4a.md` e a `part-4b.md`. A nova estrutura da pasta deve ficar assim: +To accomplish this restructure, you would need to delete `step-002.md` and then add a `step-004a.md` and a `step-004b.md`. A nova estrutura da pasta deve ficar assim: ```bash -part-001.md -part-003.md -part-004.md -part-004a.md -part-004b.md -part-005.md -part-006.md +step-001.md +step-003.md +step-004.md +step-004a.md +step-004b.md +step-005.md +step-006.md ``` -Você precisa agora que os nomes dos arquivos sejam `part-1.md` a `part-7.md`, porque você removeu um, mas ganhou dois arquivos novos, assim gerando somente um arquivo novo. Além disso, o frontmatter de cada arquivo abaixo de um passo adicionado ou excluído precisará ser modificado, onde o valor chave do `title` tem que ser igual ao novo número do passo. Por exemplo, depois de renomeaer `part-3.md` para `part-2.md`, você precisará alterar o título do `part-2.md` de `Part 03` para `Part 02`. +You now need the file names to be `step-001.md` through `step-007.md`, because you removed one but gained two more for a net difference of one file. Além disso, o frontmatter de cada arquivo abaixo de um passo adicionado ou excluído precisará ser modificado, onde o valor chave do `title` tem que ser igual ao novo número do passo. For example, after renaming `step-3.md` to `step-2.md`, you would need to change `step-2.md`'s title from `Step 03` to `Step 02`. Veja abaixo as mudanças necessárias na pasta do projeto: ```bash -part-001.md -part-003.md renamed to part-002.md and title changes to "Part 2" -part-004.md renames to part-003.md and title changes to "Part 3" -part-004a.md renames to part-004.md and title changes to "Part 4" -part-004b.md renames to part-005.md and title changes to "Part 5" -part-005.md renames to part-006.md and title changes to "Part 6" -part-006.md renames to part-007.md and title changes to "Part 7" +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" ``` Junto com as mudanças acima, a chave `challengeOrder` no arquivo `meta.json` do projeto precisará refletir a nova ordem dos passos. Isso é necessário porque cada etapa abaixo de uma exclusão de etapa e/ou adição de etapa altera o `title` associado a cada um dos `id` do desafio da etapa afetada.