gaspersic/freeCodeCamp
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
camperbot
2022-03-09 21:01:09 +05:30
committed by GitHub
parent 386840bc66
commit 7847d2a7b5
23 changed files with 282 additions and 282 deletions
Download Patch File Download Diff File Expand all files Collapse all files

90
docs/i18n/italian/how-to-work-on-coding-challenges.md
View File

@@ -64,7 +64,7 @@ I test da eseguire sul codice scritto dall'utente, in coppie di testo markdown e
Codice per test uno
```
If you want dynamic output based on the user's code, --fcc-expected-- and --fcc-actual-- will be replaced with the expected and actual values of the test's assertion. Take care if you have multiple assertions since the first failing assertion will determine the values of --fcc-expected-- and --fcc-actual--.
Se vuoi output dinamico basato sul codice dell'utente --fcc-expected-- e --fcc-actual-- saranno sostituiti con i valori aspettati e i valori veri dell'asserzione del test. Fai attenzione se hai più di una asserzione, visto che la prima asserzione fallita determinerà i valori di --fcc-expected-- e fcc-actual--.
```js
assert.equal(
@@ -75,7 +75,7 @@ assert.equal(
# --notes--
Extra information for a challenge, in markdown
Ulteriori informazioni per una sfida, in markdown
# --seed--
@@ -93,7 +93,7 @@ Codice eseguito dopo il codice dell'utente, ma prima dei test
## --seed-contents--
Boilerplate code to render to the editor. This section should only contain code inside backticks, like the following:
Codice di partenza da far apparire nell'editor. Questa sezione deve contenere solo codice in backtick, come il seguente:
```html
<body>
@@ -118,7 +118,7 @@ console.log('freeCodeCamp is awesome!');
# --solutions--
Solutions are used for the CI tests to ensure that changes to the hints will still pass as intended
Le soluzioni sono usate dai test CI per assicurarsi che i cambiamenti alla sezione hints facciano eseguire i test correttamente
```js
// prima soluzione - il linguaggio deve combaciare con il seed.
@@ -138,27 +138,27 @@ Solutions are used for the CI tests to ensure that changes to the hints will sti
# --question--
These fields are currently used for the multiple-choice Python challenges.
Questi campi sono usati attualmente per le domande a scelta multipla nelle sfide di Python.
## --text--
The question text goes here.
Il testo della domanda va qui.
## --answers--
Answer 1
Risposta 1
---
Answer 2
Risposta 2
---
More answers
Altre risposte
## --video-solution--
The number for the correct answer goes here.
Il numero della risposta corretta va qui.
````
> [!NOTE]
@@ -190,9 +190,9 @@ $ ObjectId()
ObjectId("5a474d78df58bafeb3535d34")
````
The result is a new id, for example `5a474d78df58bafeb3535d34` above.
Il risultato è un nuovo id, per esempio sopra `5a474d78df58bafeb3535d34`.
Once you have your id, put it into the markdown file as the `id` field at the top, e.g.
Una volta che hai il tuo id, mettilo nel file markdown nel campo `id` in cima, per esempio
```yml
---
@@ -202,13 +202,13 @@ title: Challenge Title
## Dare un nome alle sfide
Naming things is hard. We've made it easier by imposing some constraints.
Dare un nome alle cose è difficile. Lo abbiamo reso più semplice dando dei limiti.
All challenge titles should be explicit and should follow this pattern:
Tutti i titoli delle sfide devono essere espliciti e seguire questo schema:
\[verb\]\[object clause\]
\[verb\]\[clausola oggetto\]
Here are some example challenge names:
Ecco alcuni esempi di nomi di sfide:
- Usare la notazione in senso orario per specificare il padding di un elemento
- Condensare array usando .reduce
@@ -216,19 +216,19 @@ Here are some example challenge names:
## Istruzioni e descrizione di una sfida
Sentences should be clear and concise with minimal jargon. If used, jargon should be immediately defined in plain English.
Le frasi dovrebbero essere chiare e concise con minimo utilizzo di linguaggio tecnico. Se il linguaggio tecnico è usato, deve essere subito seguito da una definizione in linguaggio comune.
Keep paragraphs short (around 1-4 sentences). People are more likely to read several short paragraphs than a wall of text.
I paragrafi devono essere corti (1-4 frasi circa). È più probabile che vengano lette alcune frasi corte invece di un muro di testo.
Challenge text should use the second person ("you") to help to give it a conversational tone. This way the text and instructions seem to speak directly to the camper working through the challenge. Try to avoid using the first person ("I", "we", "let's", and "us").
Il testo della sfida dovrebbe usare la seconda persona ("tu") per aiutare ad avere un tono colloquiale. In questo modo il testo e le istruzioni sembrano parlare direttamente al camper che lavora sulle sfide. Cerca di evitare la prima persona ("io", "noi", "facciamo").
Don't use outbound links. These interrupt the flow. Campers should never have to google anything during these challenges. If there are resources you think campers would benefit from, add them to the challenge's Guide-related article.
Non usare link a siti esterni. Questi interrompono il flusso. I camper non dovrebbero mai cercare qualcosa su Google durante queste sfide. Se ci sono risorse di cui pensi che il camper possa beneficiare, aggiungile all'articolo della sfida nella guida.
You can add diagrams if necessary.
Puoi aggiugere diagrammi se necessario.
Don't use emojis or emoticons in challenges. freeCodeCamp has a global community, and the cultural meaning of an emoji or emoticon may be different around the world. Also, emojis can render differently on different systems.
Non usare emoji o emoticon nelle sfide. freeCodeCamp ha una comunità globale, e il significato culturare di una emoji o emoticon può essere differente nelle varie parti del mondo. In più, le emoji possono avere un aspetto diverso su diversi sistemi.
Proper nouns should use correct capitalization when possible. Below is a list of words as they should appear in the challenges.
I nomi propri dovrebbero usare le maiuscole correttamente quando possibile. Qui sotto trovi una lista di parole come dovrebbero apparire nelle sfide.
- JavaScript (lettere maiuscole in "J" e "S" e senza abbreviazioni)
- Node.js
@@ -236,28 +236,28 @@ Proper nouns should use correct capitalization when possible. Below is a list of
### La regola dei due minuti
Each challenge should be solvable within 120 seconds by a native English speaker who has completed the challenges leading up to it. This includes the amount of time it takes to read the directions/instructions understand the seeded code, write their code and get all the tests to pass.
Ogni sfida dovrebbe essere risolvibile entro 120 secondi da un nativo inglese che ha completato tutte le sfide precedenti. Questo include l'ammontare di tempo necessario a leggere le istruzioni, comprendere il codice di partenza, scrivere il loro codice e avere tutti i test superati.
If it takes longer than two minutes to complete the challenge, you have two options:
Se servono più di due minuti a completare la sfida hai due possibilità:
- Semplificare la sfida, o
- Dividere la sfida in due sfide.
The 2-minute rule forces you, the challenge designer, to make your directions concise, your seed code clear, and your tests straight-forward.
La regola dei due minuti obbliga te, designer della sfida, a rendere le tue istruzioni concise, il tuo codice seed chiaro, e i tuoi test diretti.
We track how long it takes for campers to solve changes and use this information to identify challenges that need to be simplified or split.
Teniamo traccia di quanto tempo serve ai camper per risolvere le sfide e usiamo questa informazione per identificare sfide che devono essere semplificate o divise.
### Modularità
Each challenge should teach exactly one concept, and that concept should be apparent from the challenge's name.
Ogni sfida dovrebbe insegnare esattamente un concetto, e quel concetto dovrebbe apparire nel titolo della sfida.
We can reinforce previously covered concepts through repetition and variations - for example, introducing h1 elements in one challenge, then h3 elements a few challenges later.
Possiamo rinforzare concetti introdotti in precedenza tramite ripetizione e variazioni, per esempio introducendo gli elementi h1 in una sfida e gli elementi h3 alcune sfide più tardi.
Our goal is to have thousands of 2-minute challenges. These can flow together and reiterate previously-covered concepts.
Il nostro obbiettivo è di avere migliaia di sfide da due minuti. Queste possono scorrere insieme e rinforzare concetti già introdotti in precedenza.
### Formattare il testo delle sfide
Here are specific formatting guidelines for challenge text and examples:
Ecco le linee guidee di formattazione specifiche per il testo delle sfide e degli esempi:
- Le parole chiave del linguaggio vanno in `` \` `` backtick. Per esempio i nomi dei tag HTML o i nomi delle proprietà CSS.
- Riferimenti a parti di codice (come nomi di funzioni, metodi o variabili) dovrebbero essere in `` \` `` backtick. Vedi gli esempi seguenti:
@@ -270,9 +270,9 @@ Usa `parseInt` per convertire la variabile `realNumber` a un numero intero.
- I blocchi di codice multi-riga **devono essere preceduti da una riga vuota**. La riga successiva deve iniziare con tre backticks seguiti immediatamente da uno dei [linguaggi supportati](https://prismjs.com/#supported-languages). Per completare il blocco di codice devi iniziare una nuova riga, scrivere tre backtick e poi **un'altra riga vuota**. Vedi l'esempio seguente:
- Gli spazi bianchi hanno significato in Markdown, raccomandiamo di renderli visibili nel tuo editor.
**Note:** If you are going to use an example code in YAML, use `yaml` instead of `yml` for the language to the right of the backticks.
**Nota:** Se devi usare un esempio di codice in YAML, usa `yaml` invece di `yml` per il linguaggio a fianco dei tre backtick.
The following is an example of code:
Il seguente è un esempio di codice:
````md
```{language}
@@ -316,13 +316,13 @@ Esempio di un commento a linea singola in JavaScript:
// Only change code below this line
````
Example of a valid CSS comment:
Esempio di un commento CSS valido:
```css
/* Only change code above this line */
```
If a challenge only has a single place where code changes are needed, please use the comments in the following example to instruct the user where changes should be made.
Se la sfida ha un unico punto dove il codice ha bisogno di cambiamenti, per favore usa i commenti nel seguente esempio per istruire l'utente su dove dovrebbe fare i cambiamenti.
```js
var a = 3;
@@ -335,7 +335,7 @@ b = 9 + b;
c = c + 7;
```
If a challenge has multiple places where the user is expected to change code (i.e. the React challenges)
Se la sfida ha diversi punti dove l'utente deve fare cambiamenti al codice (come in una sfida React)
```jsx
class MyComponent extends React.Component {
@@ -368,9 +368,9 @@ class MyComponent extends React.Component {
### Traduzione dei commenti nel codice seed
There are separate comment dictionaries for each language. The [English version of the comment dictionary](/curriculum/dictionaries/english/comments.js) is the basis for the translations found in the corresponding non-English versions of the files. The non-English version of the Chinese comment dictionary would be located at `/curriculum/dictionaries/chinese/comments.js`. Each dictionary consists of an array of objects with a unique `id` property and a `text` property. Only the `text` should be modified to encompass the translation of the corresponding English comment.
Ci sono directory separate per ogni lingua. La [versione inglese della directory dei commenti](/curriculum/dictionaries/english/comments.js) è la base per le traduzioni trovate nelle corrispondenti versioni non-inglesi del file. La versione non-inglese della directory dei commenti cinese si trova in `/curriculum/dictionaries/chinese/comments.js`. Ogni directory consiste di un array di oggetti con una proprietà `id` unica e una proprietà `text` che contiene il testo del commento. Solo `text` dovrebbe essere modificato per includere la traduzione del corrispondente commento inglese.
Some comments may contain a word/phrase that should not be translated. For example, variable names or proper library names like "React" should not be translated. See the comment below as an example. The word `myGlobal` should not be translated.
Alcuni commenti potrebbero contenere delle parole o frasi che non devono essere tradotte. Per esempio, nomi di variabili o nomi propri di librerie come "React" non dovrebbero essere tradotti. Vedi il commento seguente come esempio. La parola `myGlobal` non deve essere tradotta.
```text
Declare the myGlobal variable below this line
@@ -382,13 +382,13 @@ Declare the myGlobal variable below this line
## Suggerimenti e soluzioni
Each challenge has a `Get a Hint` button, so a user can access any hints/solutions which have been created for the challenge. Curriculum hints/solutions topics are located on [our forum](https://forum.freecodecamp.org/c/guide) under the `Guide` category.
Ogni sfida ha un pulsante `Get a Hint` (Ottieni un suggerimento), cosicché un utente possa avere accesso a suggerimenti e soluzioni che sono stati creati per la sfida. I suggerimenti e le soluzioni del curriculum si trovano nei topic [del nostro forum](https://forum.freecodecamp.org/c/guide) nella categoria `Guide`.
If you find a problem with an existing challenge's hints/solutions topic, you can make suggestions in the [contributors category](https://forum.freecodecamp.org/c/contributors) on the forum. Moderators and users with trust level 3 will review the comments and decide whether or not to include the changes in the corresponding hint/solutions topic.
Se trovi un problema con i suggerimenti e le soluzioni delle sfide puoi inviare i tuoi suggerimenti aprendo un topic nella [categoria contributors](https://forum.freecodecamp.org/c/contributors) sul forum. Moderatori e utenti con un livello di fiducia 3 rivedranno i tuoi commenti e decideranno se includere o meno i cambiamenti nel topic corrispondente.
### Aggiungere nuovi topic per i suggerimenti e le soluzioni delle sfide
Take the following steps when adding a new challenge hints/solutions related topic.
Segui i seguenti step quando crei un nuovo topic per le soluzioni e i suggerimenti di una sfida.
1. Inizia seguendo gli stessi passaggi per creare un nuovo argomento, ma rivedi il successivo per creare il titolo.
2. Il titolo dell'argomento dovrebbe iniziare con `freeCodeCamp Challenge Guide:` concatenato con il titolo effettivo della sfida del curriculum. Ad esempio, se la sfida è chiamata "`Chunky Monkey`", il titolo dell'argomento sarebbe "`freeCodeCamp Challenge Guide: Chunky Monkey`".
@@ -397,7 +397,7 @@ Take the following steps when adding a new challenge hints/solutions related top
### Linee guida per il contenuto dei topic dei suggerimenti e delle soluzioni
When proposing a solution for a curriculum challenge related Guide topic, the full code must be added. This includes all the original seed code plus any changes needed to pass all the challenge tests. The following template should be used when creating new hints/solutions topics:
Quando proponi una soluzione da aggiungere al topic relativo a una sfida, devi includere tutto il codice. Questo include sia il codice seed originale sia i cambiamenti necessari per superare i test. Dovresti usare il seguente template per creare nuovi topic per suggerimenti e soluzioni:
````md
# [Qui il nome della sfida]
@@ -478,12 +478,12 @@ Puoi anche testare una sfida singola con i seguenti step:
cd curriculum
```
2. Run the following for each challenge file for which you have changed (replacing `challenge-title-goes-here` with the full title of the challenge):
2. Esegui i seguenti comandi per ogni singolo file in cui hai fatto cambiamenti (rimpiazziando `challenge-title-goes-here` con il titolo intero della sfida):
```
npm run test -- -g challenge-title-goes-here ```
Once you have verified that each challenge you've worked on passes the tests, [please create a pull request](how-to-open-a-pull-request.md).
Una volta che avrai verificato che ogni sfida su cui hai lavorato passi i test, [per favore crea una pull request](how-to-open-a-pull-request.md).
> [!TIP] Puoi impostare la variabile d'ambiente `LOCALE` nel file `.env` alla lingua usata nelle sfide che devi testare.
>
@@ -491,7 +491,7 @@ Once you have verified that each challenge you've worked on passes the tests, [p
### Link utili
Creating and Editing Challenges:
Creare e modificare sfide:
1. [Tipo della sfida (challenge type)](https://github.com/freeCodeCamp/freeCodeCamp/blob/main/client/utils/challenge-types.js#L1-L13) - cosa significa il tipo di sfida numerico (enum).