From 7f59c81b29c8bdb36ead2c3ff34bc984f0833395 Mon Sep 17 00:00:00 2001 From: camperbot Date: Wed, 13 Oct 2021 09:33:08 -0700 Subject: [PATCH] chore(i18n,docs): update translations (#43845) --- .../how-to-setup-freecodecamp-locally.md | 46 +++++-- .../how-to-setup-freecodecamp-locally.md | 50 +++++--- .../how-to-setup-freecodecamp-locally.md | 112 +++++++++++------- .../how-to-setup-freecodecamp-locally.md | 46 +++++-- .../how-to-setup-freecodecamp-locally.md | 110 ++++++++++------- 5 files changed, 237 insertions(+), 127 deletions(-) diff --git a/docs/i18n/chinese/how-to-setup-freecodecamp-locally.md b/docs/i18n/chinese/how-to-setup-freecodecamp-locally.md index 7d74162552..b0b88f90a4 100644 --- a/docs/i18n/chinese/how-to-setup-freecodecamp-locally.md +++ b/docs/i18n/chinese/how-to-setup-freecodecamp-locally.md @@ -168,14 +168,24 @@ The default API keys and environment variables are stored in the file `sample.en ```console # Create a copy of the "sample.env" and name it ".env". # Populate it with the necessary API keys and secrets: +``` -# macOS / Linux + + +#### **macOS/Linux** + +```console cp sample.env .env +``` -# Windows +#### **Windows** + +```console copy sample.env .env ``` + + The keys in the `.env` file are _not_ required to be changed to run the app locally. You can leave the default values copied over from `sample.env` as-is. > [!TIP] Keep in mind if you want to use services like Auth0 or Algolia, you'll have to acquire your own API keys for those services and edit the entries accordingly in the `.env` file. @@ -196,19 +206,25 @@ Before you can run the application locally, you will need to start the MongoDB s Start the MongoDB server in a separate terminal: -- On macOS & Ubuntu: + - ```console - mongod - ``` +#### **macOS/Linux** + +```console +mongod +``` + +#### **Windows** - On Windows, you must specify the full path to the `mongod` binary - ```console - "C:\Program Files\MongoDB\Server\3.6\bin\mongod" - ``` +```console +"C:\Program Files\MongoDB\Server\3.6\bin\mongod" +``` - Make sure to replace `3.6` with the version you have installed + + +Make sure to replace `3.6` with the version you have installed > [!TIP] You can avoid having to start MongoDB every time by installing it as a background service. You can [learn more about it in their documentation for your OS](https://docs.mongodb.com/manual/administration/install-community/) @@ -522,7 +538,9 @@ git clean -ifdX If you can't sign in, and instead you see a banner with an error message that it will be reported to freeCodeCamp, please double-check that your local port `3000` is not in use by a different program. -**On Linux / macOS / WSL on Windows - From Terminal:** + + +#### **macOS/Linux/WSL on Windows - From Terminal:** ```console netstat -a | grep "3000" @@ -530,7 +548,7 @@ netstat -a | grep "3000" tcp4 0 0 0.0.0.0:3000 DESKTOP LISTEN ``` -**On Windows - From Elevated PowerShell:** +#### **On Windows - From Elevated PowerShell:** ```powershell netstat -ab | Select-String "3000" @@ -538,6 +556,10 @@ netstat -ab | Select-String "3000" TCP 0.0.0.0:3000 DESKTOP LISTENING ``` + + +--- + ### Issues installing dependencies If you get errors while installing the dependencies, please make sure that you are not in a restricted network or your firewall settings do not prevent you from accessing resources. diff --git a/docs/i18n/espanol/how-to-setup-freecodecamp-locally.md b/docs/i18n/espanol/how-to-setup-freecodecamp-locally.md index f0f90866bb..31aa479433 100644 --- a/docs/i18n/espanol/how-to-setup-freecodecamp-locally.md +++ b/docs/i18n/espanol/how-to-setup-freecodecamp-locally.md @@ -167,15 +167,25 @@ The default API keys and environment variables are stored in the file `sample.en ```console # Crear una copia de la "sample.env" y nombrarla ".env". -# Completelos con las credenciales de la API necesarias: +# Populate it with the necessary API keys and secrets: +``` -# macOS / Linux + + +#### **macOS/Linux** + +```console cp sample.env .env +``` -# Windows +#### **Windows** + +```console copy sample.env .env ``` + + The keys in the `.env` file are _not_ required to be changed to run the app locally. You can leave the default values copied over from `sample.env` as-is. > [!TIP] Keep in mind if you want to use services like Auth0 or Algolia, you'll have to acquire your own API keys for those services and edit the entries accordingly in the `.env` file. @@ -196,19 +206,25 @@ Before you can run the application locally, you will need to start the MongoDB s Start the MongoDB server in a separate terminal: -- En macOS & Ubuntu: + - ```console - mongod - ``` +#### **macOS/Linux** -- En Windows, debe especificar la ruta completa al binario `mondios` +```console +mongod +``` - ```console - "C:\Program Files\MongoDB\Server\3.6\bin\mongod" - ``` +#### **Windows** - Asegúrate de reemplazar `3.6` con la versión instalada +- On Windows, you must specify the full path to the `mongod` binary + +```console +"C:\Program Files\MongoDB\Server\3.6\bin\mongod" +``` + + + +Make sure to replace `3.6` with the version you have installed > [!TIP] You can avoid having to start MongoDB every time by installing it as a background service. You can [learn more about it in their documentation for your OS](https://docs.mongodb.com/manual/administration/install-community/) @@ -522,7 +538,9 @@ git clean -ifdX If you can't sign in, and instead you see a banner with an error message that it will be reported to freeCodeCamp, please double-check that your local port `3000` is not in use by a different program. -**On Linux / macOS / WSL on Windows - From Terminal:** + + +#### **macOS/Linux/WSL on Windows - From Terminal:** ```console netstat -a | grep "3000" @@ -530,7 +548,7 @@ netstat -a | grep "3000" tcp4 0 0 0.0.0.0:3000 DESKTOP LISTEN ``` -**On Windows - From Elevated PowerShell:** +#### **On Windows - From Elevated PowerShell:** ```powershell netstat -ab | Select-String "3000" @@ -538,6 +556,10 @@ netstat -ab | Select-String "3000" TCP 0.0.0.0:3000 DESKTOP LISTENING ``` + + +--- + ### Problemas instalando dependencias If you get errors while installing the dependencies, please make sure that you are not in a restricted network or your firewall settings do not prevent you from accessing resources. diff --git a/docs/i18n/italian/how-to-setup-freecodecamp-locally.md b/docs/i18n/italian/how-to-setup-freecodecamp-locally.md index cd3ba70eb0..32570ed37b 100644 --- a/docs/i18n/italian/how-to-setup-freecodecamp-locally.md +++ b/docs/i18n/italian/how-to-setup-freecodecamp-locally.md @@ -167,20 +167,30 @@ Le chiavi API predefinite e le variabili d'ambiente sono memorizzate nel file `s ```console # Creare una copia del "sample.env" e denominarlo ".env". -# Popolarlo con le necessarie chiavi API e secrets: +# Populate it with the necessary API keys and secrets: +``` -# macOS / Linux -cp esempio. nv .env + -# Windows +#### **macOS/Linux** + +```console +cp sample.env .env +``` + +#### **Windows** + +```console copy sample.env .env ``` + + _Non_ è necessario cambiare le chiavi nel file `.env` per eseguire l'applicazione localmente. Puoi lasciare i valori predefiniti copiati da `sample.env` così come sono. > [!TIP] Tieni a mente che se vuoi usare servizi come Auth0 o Algolia, dovrai ottenere delle API key per quei servizi per conto tuo e modificare il file `.env` di conseguenza. -#### Passo 2: Installa le dipendenze +#### Step 2: Install dependencies Questo passaggio installerà le dipendenze richieste per l'esecuzione dell'applicazione: @@ -188,7 +198,7 @@ Questo passaggio installerà le dipendenze richieste per l'esecuzione dell'appli npm ci ``` -#### Passo 3: Avvia MongoDB e fai il seed del database +#### Step 3: Start MongoDB and seed the database Prima di poter eseguire l'applicazione localmente, è necessario avviare il servizio MongoDB. @@ -196,37 +206,43 @@ Prima di poter eseguire l'applicazione localmente, è necessario avviare il serv Avvia il server MongoDB in un terminale separato: -- Su macOS & Ubuntu: + - ```console - mongod - ``` +#### **macOS/Linux** -- Su Windows, è necessario specificare il percorso completo dell'eseguibile `mongod` +```console +mongod +``` - ```console - "C:\Program Files\MongoDB\Server\3.6\bin\mongod" - ``` +#### **Windows** - Assicurati di sostituire `3.6` con la versione che hai installato +- On Windows, you must specify the full path to the `mongod` binary + +```console +"C:\Program Files\MongoDB\Server\3.6\bin\mongod" +``` + + + +Make sure to replace `3.6` with the version you have installed > [!TIP] Puoi evitare di dover avviare MongoDB ogni volta se lo installi come servizio in background. Puoi [saperne di più nella loro documentazione per il tuo sistema operativo](https://docs.mongodb.com/manual/administration/install-community/) -Successivamente, facciamo il seed del database. In questo passaggio, eseguiamo il comando sottostante che popola il server MongoDB con alcuni set di dati iniziali richiesti dai servizi. Tra questi figurano alcuni schemi, tra le altre cose. +Next, let's seed the database. In this step, we run the below command that fills the MongoDB server with some initial data sets that are required by services. These include a few schemas, among other things. ```console npm run seed ``` -#### Passo 4: Avviare l'applicazione client freeCodeCamp e il server API +#### Step 4: Start the freeCodeCamp client application and API server -Ora è possibile avviare il server API e le applicazioni client. +You can now start up the API server and the client applications. ```console npm run develop ``` -Questo singolo comando attiverà tutti i servizi, compreso il server API e le applicazioni client disponibili su cui lavorare. +This single command will fire up all the services, including the API server and the client applications available for you to work on. > [!NOTE] Una volta pronto, apri un browser web e **visita **. Se l'app si carica, congratulazioni, sei a posto! Hai ora una copia dell'intera piattaforma di apprendimento di freeCodeCamp in esecuzione sul tuo computer. @@ -236,26 +252,26 @@ Questo singolo comando attiverà tutti i servizi, compreso il server API e le ap ## Accedi con un utente locale -La tua configurazione locale crea automaticamente un utente locale nel database. Facendo clic sul pulsante `Accedi` ti autenticherai automaticamente nell'applicazione locale. +Your local setup automatically populates a local user in the database. Clicking the `Sign In` button will automatically authenticate you into the local application. -Tuttavia, accedere alla pagina del portfolio utente è un po' difficile. In fase di sviluppo, Gatsby si occupa di servire le pagine lato client e quindi otterrai una pagina `404` per il portfolio utente quando lavorerai localmente. +However, accessing the user portfolio page is a little tricky. In development, Gatsby takes over serving the client-side pages and hence you will get a `404` page for the user portfolio when working locally. -Basta cliccare sul pulsante **"Preview Custom 404 Page"** per passare alla pagina corretta. +Simply clicking the **"Preview Custom 404 Page"** button will forward you to the correct page.
- Come accedere quando si lavora localmente (screenshot) + How to sign in when working locally (screenshot)
- Come accedere quando si lavora localmente + How to sign in when working locally
## Apportare modifiche a livello locale -Ora puoi apportare modifiche ai file e inviare le modifiche al clone locale del tuo fork. +You can now make changes to files and commit your changes to your local clone of your fork. -Segui questi passaggi: +Follow these steps: 1. Controlla di essere sul ramo `main`: @@ -446,11 +462,11 @@ Segui questi passaggi: ## Proporre una Pull Request (PR) -Dopo aver effettuato le modifiche, controlla qui [come aprire una Pull Request](how-to-open-a-pull-request.md). +After you've committed your changes, check here for [how to open a Pull Request](how-to-open-a-pull-request.md). ## Comandi rapidi -Un rapido riferimento ai comandi di cui avrai bisogno quando lavorerai localmente. +A quick reference to the commands that you will need when working locally. | comando | descrizione | | -------------------------------------------------------------- | ----------------------------------------------------------------------------------- | @@ -472,11 +488,11 @@ Un rapido riferimento ai comandi di cui avrai bisogno quando lavorerai localment ### Problemi con l'installazione dei prerequisiti raccomandati -Sviluppiamo regolarmente sui sistemi operativi più recenti o più popolari come macOS 10.15 o successivi, Ubuntu 18.04, e Windows 10 con WSL2. +We regularly develop on the latest or most popular operating systems like macOS 10.15 or later, Ubuntu 18.04 or later, and Windows 10 (with WSL2). -Ti raccomandiamo di fare ricerche sui tuoi problemi specifici usando risorse come Google, Stack Overflow, e Stack Exchange. C'è una buona probabilità che qualcuno abbia incontrato lo stesso problema e ci sia già una risposta alla tua domanda specifica. +It is recommended to research your specific issue on resources such as Google, Stack Overflow, and Stack Exchange. There is a good chance that someone has faced the same issue and there is already an answer to your specific query. -Se sei su un sistema operativo diverso e/o continui ad avere dei problemi, visita [ottenere aiuto](#getting-help). +If you are on a different OS and/or are still running into issues, see [getting help](#getting-help). > [!WARNING] > @@ -484,7 +500,7 @@ Se sei su un sistema operativo diverso e/o continui ad avere dei problemi, visit ### Problemi con UI, Font, errori di build, ecc. -Se incontri problemi con l'interfaccia utente, i caratteri o vedi errori di compilazione, potrebbe essere utile una pulizia: +If you face issues with the UI, Fonts or see builds errors a cleanup can be useful: ```console npm run clean @@ -493,17 +509,17 @@ npm run seed npm run develop ``` -O +OR -Usa il collegamento +Use the shortcut ``` npm run clean-and-develop ``` -Se continui ad incontrare problemi con la compilazione, ti consigliamo di ripulire lo spazio di lavoro. +If you continue to face issues with the build, cleaning up the workspace is recommend. -Usa `git clean` in modalità interattiva: +Use `git clean` in interactive mode: ``` git clean -ifdX @@ -511,18 +527,20 @@ git clean -ifdX
- Come pulire i file git non tracciati (screenshot) + How to clean git untracked files (screenshot)
- Come pulire i file git non tracciati + How to clean git untracked files
### Problemi con API, logic, invio delle sfide, ecc. -Se non riesci ad accedere e invece vedi un banner con un messaggio di errore che il problema sarà segnalato a freeCodeCamp, ti preghiamo di controllare che la porta locale `3000` non sia usata da un programma diverso. +If you can't sign in, and instead you see a banner with an error message that it will be reported to freeCodeCamp, please double-check that your local port `3000` is not in use by a different program. -**Su Linux / macOS / WSL su Windows - dal terminale:** + + +#### **macOS/Linux/WSL on Windows - From Terminal:** ```console netstat -a | grep "3000" @@ -530,7 +548,7 @@ netstat -a | grep "3000" tcp4 0 0 0.0.0.0:3000 DESKTOP LISTEN ``` -**Su Windows - da PowerShell con privilegi elevati:** +#### **On Windows - From Elevated PowerShell:** ```powershell netstat -ab | Select-String "3000" @@ -538,16 +556,20 @@ netstat -ab | Select-String "3000" TCP 0.0.0.0:3000 DESKTOP LISTENING ``` + + +--- + ### Problemi nell'installazione delle dipendenze -Se incontri degli errori durante l'installazione delle dipendenze, assicurati di non essere in una rete ristretta o che le impostazioni del tuo firewall non ti impediscono di accedere alle risorse. +If you get errors while installing the dependencies, please make sure that you are not in a restricted network or your firewall settings do not prevent you from accessing resources. -La prima configurazione può richiedere un po' di tempo a seconda della larghezza di banda della rete. Sii paziente, e se continui a rimanere bloccato ti raccomandiamo di usare GitPod invece di un setup offline. +The first time setup can take a while depending on your network bandwidth. Be patient, and if you are still stuck we recommend using GitPod instead of an offline setup. > [!NOTE] Se stai usando un device Apple con Chip M1 per eseguire l'applicazione in locale, suggeriamo di usare Node v14.7 o superiore. Altrimenti potresti avere problemi con dipendenze come Sharp. ## Ottenere Aiuto -Se sei bloccato e hai bisogno di aiuto, poni liberamente le tue domande nella [categoria 'Contributors' sul nostro forum](https://forum.freecodecamp.org/c/contributors) o [nella chat room per i contributori](https://chat.freecodecamp.org/channel/contributors). +If you are stuck and need help, feel free to ask questions on the ['Contributors' category on our forum](https://forum.freecodecamp.org/c/contributors) or [the contributors chat room](https://chat.freecodecamp.org/channel/contributors). -Potrebbe esserci un errore nella console del browser o in Bash / Terminal / Linea di comando che ti aiuterà a identificare il problema. Fornisci questo messaggio di errore nella descrizione del problema in modo che gli altri possano identificalo più facilmente e aiutarti a risolverlo. +There might be an error in the console of your browser or in Bash / Terminal / Command Line that will help identify the problem. Provide this error message in your problem description so others can more easily identify the issue and help you find a resolution. diff --git a/docs/i18n/japanese/how-to-setup-freecodecamp-locally.md b/docs/i18n/japanese/how-to-setup-freecodecamp-locally.md index 7d74162552..b0b88f90a4 100644 --- a/docs/i18n/japanese/how-to-setup-freecodecamp-locally.md +++ b/docs/i18n/japanese/how-to-setup-freecodecamp-locally.md @@ -168,14 +168,24 @@ The default API keys and environment variables are stored in the file `sample.en ```console # Create a copy of the "sample.env" and name it ".env". # Populate it with the necessary API keys and secrets: +``` -# macOS / Linux + + +#### **macOS/Linux** + +```console cp sample.env .env +``` -# Windows +#### **Windows** + +```console copy sample.env .env ``` + + The keys in the `.env` file are _not_ required to be changed to run the app locally. You can leave the default values copied over from `sample.env` as-is. > [!TIP] Keep in mind if you want to use services like Auth0 or Algolia, you'll have to acquire your own API keys for those services and edit the entries accordingly in the `.env` file. @@ -196,19 +206,25 @@ Before you can run the application locally, you will need to start the MongoDB s Start the MongoDB server in a separate terminal: -- On macOS & Ubuntu: + - ```console - mongod - ``` +#### **macOS/Linux** + +```console +mongod +``` + +#### **Windows** - On Windows, you must specify the full path to the `mongod` binary - ```console - "C:\Program Files\MongoDB\Server\3.6\bin\mongod" - ``` +```console +"C:\Program Files\MongoDB\Server\3.6\bin\mongod" +``` - Make sure to replace `3.6` with the version you have installed + + +Make sure to replace `3.6` with the version you have installed > [!TIP] You can avoid having to start MongoDB every time by installing it as a background service. You can [learn more about it in their documentation for your OS](https://docs.mongodb.com/manual/administration/install-community/) @@ -522,7 +538,9 @@ git clean -ifdX If you can't sign in, and instead you see a banner with an error message that it will be reported to freeCodeCamp, please double-check that your local port `3000` is not in use by a different program. -**On Linux / macOS / WSL on Windows - From Terminal:** + + +#### **macOS/Linux/WSL on Windows - From Terminal:** ```console netstat -a | grep "3000" @@ -530,7 +548,7 @@ netstat -a | grep "3000" tcp4 0 0 0.0.0.0:3000 DESKTOP LISTEN ``` -**On Windows - From Elevated PowerShell:** +#### **On Windows - From Elevated PowerShell:** ```powershell netstat -ab | Select-String "3000" @@ -538,6 +556,10 @@ netstat -ab | Select-String "3000" TCP 0.0.0.0:3000 DESKTOP LISTENING ``` + + +--- + ### Issues installing dependencies If you get errors while installing the dependencies, please make sure that you are not in a restricted network or your firewall settings do not prevent you from accessing resources. diff --git a/docs/i18n/portuguese/how-to-setup-freecodecamp-locally.md b/docs/i18n/portuguese/how-to-setup-freecodecamp-locally.md index ff6829acab..9c24f7447c 100644 --- a/docs/i18n/portuguese/how-to-setup-freecodecamp-locally.md +++ b/docs/i18n/portuguese/how-to-setup-freecodecamp-locally.md @@ -167,20 +167,30 @@ As chaves de API padrão e variáveis de ambiente são armazenadas no arquivo `s ```console # Crie uma cópia da "sample.env" e a nomeie como ".env". -# Preencha com as chaves secretas da API necessárias: +# Populate it with the necessary API keys and secrets: +``` -# macOS / Linux + + +#### **macOS/Linux** + +```console cp sample.env .env +``` -# Windows +#### **Windows** + +```console copy sample.env .env ``` + + As chaves no arquivo `.env` _ não _ precisam ser alteradas para executar o aplicativo localmente. Você pode deixar os valores padrão copiados de `sample.env` como estão. > [!TIP] Lembre-se: se quiser usar serviços como Auth0 ou Algolia, você terá que adquirir suas próprias chaves da API para estes serviços e editar as entradas no arquivo `.env`. -#### Etapa 2: Instale as dependências +#### Step 2: Install dependencies Esta etapa vai instalar as dependências necessárias para a execução do aplicativo: @@ -188,7 +198,7 @@ Esta etapa vai instalar as dependências necessárias para a execução do aplic npm ci ``` -#### Etapa 3: Inicie o MongoDB e crie o banco de dados +#### Step 3: Start MongoDB and seed the database Antes de executar o aplicativo localmente, você precisará iniciar o serviço MongoDB. @@ -196,37 +206,43 @@ Antes de executar o aplicativo localmente, você precisará iniciar o serviço M Inicie o servidor do MongoDB em um terminal separado: -- No macOS e no Ubuntu: + - ```console - mongod - ``` +#### **macOS/Linux** -- No Windows, você deve especificar o caminho completo para o binário do `mongod` +```console +mongod +``` - ```console - "C:\Program Files\MongoDB\Server\3.6\bin\mongod" - ``` +#### **Windows** - Certifique-se de substituir `3.6` pela versão que você instalou +- On Windows, you must specify the full path to the `mongod` binary + +```console +"C:\Program Files\MongoDB\Server\3.6\bin\mongod" +``` + + + +Make sure to replace `3.6` with the version you have installed > [!TIP] Você pode evitar ter que executar o MongoDB toda vez instalando-o como um serviço em segundo plano. Você pode [aprender mais sobre isso na documentação para seu OS](https://docs.mongodb.com/manual/administration/install-community/) -Em seguida, vamos criar o banco de dados. Nesta etapa, executamos o comando abaixo que preenche o servidor MongoDB com alguns conjuntos de dados iniciais que são requeridos pelos serviços. Dentre outras coisas, incluem alguns esquemas. +Next, let's seed the database. In this step, we run the below command that fills the MongoDB server with some initial data sets that are required by services. These include a few schemas, among other things. ```console npm run seed ``` -#### Passo 4: Inicie o aplicativo de client do freeCodeCamp e o servidor de API +#### Step 4: Start the freeCodeCamp client application and API server -Agora você pode iniciar o servidor de API e os aplicativos do client. +You can now start up the API server and the client applications. ```console npm run develop ``` -Este único comando vai disparar todos os serviços, incluindo o servidor API e os aplicativos do cliente disponíveis para você trabalhar. +This single command will fire up all the services, including the API server and the client applications available for you to work on. > [!NOTE] Uma vez pronto, abra um navegador e **acesse **. Se o aplicativo carregar, parabéns - você está com tudo configurado! Agora você tem uma cópia da plataforma do freeCodeCamp de aprendizagem inteira rodando em sua máquina local. @@ -236,26 +252,26 @@ Este único comando vai disparar todos os serviços, incluindo o servidor API e ## Entre com um usuário local -Sua configuração local preenche automaticamente um usuário local no banco de dados. Clicar no botão `Sign In` vai autenticá-lo automaticamente no aplicativo local. +Your local setup automatically populates a local user in the database. Clicking the `Sign In` button will automatically authenticate you into the local application. -No entanto, acessar a página do portfólio do usuário é um pouco complicado. Em desenvolvimento, o Gatsby controla as páginas do lado do client e, portanto, você terá uma página `404` no portfólio do usuário quando estiver trabalhando localmente. +However, accessing the user portfolio page is a little tricky. In development, Gatsby takes over serving the client-side pages and hence you will get a `404` page for the user portfolio when working locally. -Apenas clique em **"Visualizar página personalizada 404"** e você será redirecionado para a página correta. +Simply clicking the **"Preview Custom 404 Page"** button will forward you to the correct page.
- Como fazer login ao trabalhar localmente (captura de tela) + How to sign in when working locally (screenshot)
- Como fazer login ao trabalhar localmente + How to sign in when working locally
## Fazendo alterações localmente -Agora você pode fazer alterações nos arquivos e fazer commit das suas alterações no seu clone local do seu fork. +You can now make changes to files and commit your changes to your local clone of your fork. -Siga estes passos: +Follow these steps: 1. Certifique-se que está no branch `main`: @@ -446,11 +462,11 @@ Siga estes passos: ## Propondo um Pull Request (PR) -Após ter feito as alterações, veja [como abrir um Pull Request](how-to-open-a-pull-request.md). +After you've committed your changes, check here for [how to open a Pull Request](how-to-open-a-pull-request.md). ## Referência de comandos rápidos -Uma rápida referência aos comandos que você precisará ao trabalhar localmente. +A quick reference to the commands that you will need when working locally. | comando | descrição | | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | @@ -472,11 +488,11 @@ Uma rápida referência aos comandos que você precisará ao trabalhar localment ### Problemas com a instalação dos pré-requisitos recomendados -Desenvolvemos regularmente nos sistemas mais recentes e populares, como o macOS 10.15, o Ubuntu 18.04 e o Windows 10 (com WSL2). +We regularly develop on the latest or most popular operating systems like macOS 10.15 or later, Ubuntu 18.04 or later, and Windows 10 (with WSL2). -É recomendado pesquisar seu issue específico em recursos como Google, Stack Overflow e Stack Exchange. É possível que alguém já tenha enfrentado o mesmo problema que o seu e já possua uma solução. +It is recommended to research your specific issue on resources such as Google, Stack Overflow, and Stack Exchange. There is a good chance that someone has faced the same issue and there is already an answer to your specific query. -Se você está em um sistema operacional diferente e/ou ainda está com problemas, veja [obtendo ajuda](#getting-help). +If you are on a different OS and/or are still running into issues, see [getting help](#getting-help). > [!WARNING] > @@ -484,7 +500,7 @@ Se você está em um sistema operacional diferente e/ou ainda está com problema ### Problemas com a Interface do Usuário, fontes, errors de build, etc. -Se você enfrenta problemas com a interface do usuário, fontes ou erros de build, uma limpeza pode ser útil: +If you face issues with the UI, Fonts or see builds errors a cleanup can be useful: ```console npm run clean @@ -493,17 +509,17 @@ npm run seed npm run develop ``` -OU +OR -Use o atalho +Use the shortcut ``` npm run clean-and-develop ``` -Se você continua enfrentando problemas com a compilação, é recomendável limpar o espaço de trabalho. +If you continue to face issues with the build, cleaning up the workspace is recommend. -Use `git clean` no modo interativo: +Use `git clean` in interactive mode: ``` git clean -ifdX @@ -511,18 +527,20 @@ git clean -ifdX
- Como limpar arquivos não rastreados do git (captura de tela) + How to clean git untracked files (screenshot)
- Como limpar arquivos não rastreados do git + How to clean git untracked files
### Problemas com API, login, Envios de Desafios, etc. -Se você não conseguir fazer o login e se vir um banner com uma mensagem de erro dizendo que isso será reportado ao freeCodeCamp, verifique novamente se a porta local `3000` não está em uso por um programa diferente. +If you can't sign in, and instead you see a banner with an error message that it will be reported to freeCodeCamp, please double-check that your local port `3000` is not in use by a different program. -**No Linux/macOS/WSL no Windows – no terminal:** + + +#### **macOS/Linux/WSL on Windows - From Terminal:** ```console netstat -a | grep "3000" @@ -530,7 +548,7 @@ netstat -a | grep "3000" tcp4 0 0 0.0.0.0:3000 DESKTOP LISTEN ``` -**No Windows – no PowerShell com privilégios:** +#### **On Windows - From Elevated PowerShell:** ```powershell netstat -ab | Select-String "3000" @@ -538,16 +556,20 @@ netstat -ab | Select-String "3000" TCP 0.0.0.0:3000 DESKTOP LISTENING ``` + + +--- + ### Problemas ao instalar dependências -Se você receber erros durante a instalação das dependências, certifique-se de que você não está em uma rede restrita ou suas configurações de firewall não impedem você de acessar os recursos. +If you get errors while installing the dependencies, please make sure that you are not in a restricted network or your firewall settings do not prevent you from accessing resources. -A primeira configuração pode demorar um pouco, dependendo da largura de banda da sua rede. Tenha paciência. Se você ainda tiver problemas, recomendamos usar o GitPod invés de uma configuração off-line. +The first time setup can take a while depending on your network bandwidth. Be patient, and if you are still stuck we recommend using GitPod instead of an offline setup. > [!NOTE] Se estiver usando dispositivos da Apple com o chip M1 para executar a aplicação localmente, sugerimos usar o Node v14.7 ou uma versão mais recente. Do contrário, você poderá ter problemas com dependências como o Sharp. ## Obtendo ajuda -Se você está com dificuldades e precisa de ajuda, fique à vontade em perguntar na categoria ['Contribuidores' em nosso fórum](https://forum.freecodecamp.org/c/contributors) ou [no chat de contribuidores](https://chat.freecodecamp.org/channel/contributors). +If you are stuck and need help, feel free to ask questions on the ['Contributors' category on our forum](https://forum.freecodecamp.org/c/contributors) or [the contributors chat room](https://chat.freecodecamp.org/channel/contributors). -Pode haver um erro no console do seu navegador ou no bash/terminal/linha de comando que ajudará a identificar o problema. Forneça esta mensagem de erro na descrição do seu problema para que outros possam identificá-lo mais facilmente e ajudá-lo a encontrar uma solução. +There might be an error in the console of your browser or in Bash / Terminal / Command Line that will help identify the problem. Provide this error message in your problem description so others can more easily identify the issue and help you find a resolution.