chore(i18n,docs): processed translations (#45618)
This commit is contained in:
camperbot
GitHub
@ -36,11 +36,11 @@ Por favor, no crees Tema de GitHub para problemas de seguridad. En su lugar, por
|
||||
|
||||
### Soy estudiante. ¿Puedo trabajar en una característica para los créditos académicos?
|
||||
|
||||
Sí. Please note we are unable to commit to any timelines or paperwork that may be a requirement by your college or university. We receive many pull-requests and code contributions from volunteer developers, and we respect their time and efforts. Out of respect for all of our other contributors, we will not give any PR special priority just because it happens to be school-related.
|
||||
Sí. Tenga en cuenta que no podemos comprometernos con ningún plazo o papeleo que pueda ser un requisito de su colegio o universidad. Recibimos muchas solicitudes de incorporación de cambios y contribuciones de código de desarrolladores voluntarios, y respetamos su tiempo y esfuerzos. Por respeto a todos nuestros otros colaboradores, no le daremos prioridad especial a las relaciones públicas solo porque esté relacionado con la escuela.
|
||||
|
||||
We request you to plan ahead and work on code contributions with this in mind.
|
||||
Le solicitamos que planifique con anticipación y trabaje en las contribuciones de código teniendo esto en cuenta.
|
||||
|
||||
### What do these different labels that are tagged on issues mean?
|
||||
### ¿Qué significan estas diferentes etiquetas que se etiquetan en los problemas?
|
||||
|
||||
The code maintainers [triage](https://en.wikipedia.org/wiki/Software_bug#Bug_management) issues and pull requests based on their priority, severity, and other factors. You can [find a complete glossary of their meanings here](https://github.com/freecodecamp/freecodecamp/labels).
|
||||
|
||||
|
||||
@ -867,17 +867,17 @@ pm2 logs
|
||||
|
||||
Consulta: https://docs.microsoft.com/es-es/azure/devops/pipelines/agents/v2-linux?view=azure-devops y sigue las instrucciones para detener, eliminar y reinstalar agentes. En términos generales, puedes seguir los pasos que se enumeran aquí.
|
||||
|
||||
You would need a PAT, that you can grab from here: https://dev.azure.com/freeCodeCamp-org/_usersSettings/tokens
|
||||
Necesitarás una PAT, que puedes obtener desde aquí: https://dev.azure.com/freeCodeCamp-org/_usersSettings/tokens
|
||||
|
||||
### Installing agents on Deployment targets
|
||||
### Instalación de agentes en objetivos de despliegue
|
||||
|
||||
Navigate to [Azure Devops](https://dev.azure.com/freeCodeCamp-org) and register the agent from scratch in the requisite [deployment groups](https://dev.azure.com/freeCodeCamp-org/freeCodeCamp/_machinegroup).
|
||||
Navega a [Azure Devops](https://dev.azure.com/freeCodeCamp-org) y registra el agente desde cero en el requisito [deployment groups](https://dev.azure.com/freeCodeCamp-org/freeCodeCamp/_machinegroup).
|
||||
|
||||
> [!NOTE] You should run the scripts in the home directory, and make sure no other `azagent` directory exists.
|
||||
> [!NOTE] Debes ejecutar los scripts en el directorio de inicio, y asegurarte de que no existe ningún otro directorio `azagent`.
|
||||
|
||||
### Updating agents
|
||||
### Actualizando agentes
|
||||
|
||||
Currently updating agents requires them to be removed and reconfigured. This is required for them to correctly pick up `PATH` values and other system environment variables. We need to do this for instance updating Node.js on our deployment target VMs.
|
||||
Actualmente actualizar los agentes requiere que sean eliminados y reconfigurados. Esto es necesario para que recojan correctamente los valores `PATH` y otras variables de entorno del sistema. Necesitamos hacer esto, por ejemplo, para actualizar Node.js en nuestras MV objetivo de implemetación.
|
||||
|
||||
1. Navega y revisa el estado del servicio
|
||||
|
||||
@ -911,11 +911,11 @@ Currently updating agents requires them to be removed and reconfigured. This is
|
||||
rm -rf ~/azagent
|
||||
```
|
||||
|
||||
Once You have completed the steps above, you can repeat the same steps as installing the agent.
|
||||
Una vez que hayas completado los pasos de arriba, puedes repetir los mismos pasos que para instalar el agente.
|
||||
|
||||
# Manual de piloto - Correo masivo
|
||||
|
||||
We use [a CLI tool](https://github.com/freecodecamp/sendgrid-email-blast) to send out the weekly newsletter. To spin this up and begin the process:
|
||||
Utilizamos [una herramienta CLI](https://github.com/freecodecamp/sendgrid-email-blast) para enviar el boletín semanal. Para actualizar y comenzar el proceso:
|
||||
|
||||
1. Inicia sesión en DigitalOcean, e inicia nuevas droplets bajo el proyecto `Sendgrid`. Usa el snapshot de Ubuntu Sendgrid con la fecha más reciente. Esto viene precargado con la herramienta CLI y el script para obtener correos electrónicos desde la base de datos. Con el volumen actual, tres droplets son suficientes para enviar los correos electrónicos de manera oportuna.
|
||||
|
||||
@ -944,19 +944,19 @@ We use [a CLI tool](https://github.com/freecodecamp/sendgrid-email-blast) to sen
|
||||
|
||||
7. Cuando el correo masivo haya terminado, verifica que no hay correos fallados antes de destruir los droplets.
|
||||
|
||||
# Flight Manual - Adding news instances for new languages
|
||||
# Manual de vuelo - Agregando instancias de noticias para nuevos idiomas
|
||||
|
||||
### Theme Changes
|
||||
### Cambios de tema
|
||||
|
||||
We use a custom [theme](https://github.com/freeCodeCamp/news-theme) for our news publication. Adding the following changes to the theme enables the addition of new languages.
|
||||
Utilizamos un [tema](https://github.com/freeCodeCamp/news-theme) personalizado para nuestra publicación de noticias. Los siguientes cambios en el tema permiten añadir nuevos idiomas.
|
||||
|
||||
1. Include an `else if` statement for the new [ISO language code](https://www.loc.gov/standards/iso639-2/php/code_list.php) in [`setup-locale.js`](https://github.com/freeCodeCamp/news-theme/blob/main/assets/config/setup-locale.js)
|
||||
2. Create an initial config folder by duplicating the [`assets/config/en`](https://github.com/freeCodeCamp/news-theme/tree/main/assets/config/en) folder and changing its name to the new language code. (`en` —> `es` for Spanish)
|
||||
3. Inside the new language folder, change the variable names in `main.js` and `footer.js` to the relevant language short code (`enMain` —> `esMain` for Spanish)
|
||||
4. Duplicate the [`locales/en.json`](https://github.com/freeCodeCamp/news-theme/blob/main/locales/en.json) and rename it to the new language code.
|
||||
5. In [`partials/i18n.hbs`](https://github.com/freeCodeCamp/news-theme/blob/main/partials/i18n.hbs), add scripts for the newly created config files.
|
||||
6. Add the related language `day.js` script from [cdnjs](https://cdnjs.com/libraries/dayjs/1.10.4) to the [freeCodeCamp CDN](https://github.com/freeCodeCamp/cdn/tree/main/build/news-assets/dayjs/1.10.4/locale)
|
||||
1. Incluya una sentencia `else if` para el nuevo [código de idioma ISO](https://www.loc.gov/standards/iso639-2/php/code_list.php) en [`setup-locale.js`](https://github.com/freeCodeCamp/news-theme/blob/main/assets/config/setup-locale.js)
|
||||
2. Crea una carpeta de configuración inicial duplicando la carpeta [`assets/config/es`](https://github.com/freeCodeCamp/news-theme/tree/main/assets/config/en) y cambiando su nombre al nuevo código de idioma. (`en` —> `es` para Español)
|
||||
3. Dentro de la nueva carpeta de idioma, cambie los nombres de las variables en `main.js` y `footer.js` al código corto de idioma relevante (`enMain` —> `esMain` para Español)
|
||||
4. Duplicar el [`locales/en.json`](https://github.com/freeCodeCamp/news-theme/blob/main/locales/en.json) y renombrarlo al nuevo código de idioma.
|
||||
5. En [`partials/i18n.hbs`](https://github.com/freeCodeCamp/news-theme/blob/main/partials/i18n.hbs), agrega scripts para los archivos de configuración creados recientemente.
|
||||
6. Agregue el lenguaje relacionado `day.js` script de [cdnjs](https://cdnjs.com/libraries/dayjs/1.10.4) al [CDN freeCodeCamp](https://github.com/freeCodeCamp/cdn/tree/main/build/news-assets/dayjs/1.10.4/locale)
|
||||
|
||||
### Ghost Dashboard Changes
|
||||
### Cambios en el Dashboard de Ghost
|
||||
|
||||
Update the publication assets by going to the Ghost dashboard > settings > general and uploading the publications's [icon](https://github.com/freeCodeCamp/design-style-guide/blob/master/assets/fcc-puck-500-favicon.png), [logo](https://github.com/freeCodeCamp/design-style-guide/blob/master/downloads/fcc_primary_large.png), and [cover](https://github.com/freeCodeCamp/design-style-guide/blob/master/assets/fcc_ghost_publication_cover.png).
|
||||
Actualice los recursos de la publicación yendo al panel de Ghost > ajustes > generales y subiendo el icono [de las publicaciones](https://github.com/freeCodeCamp/design-style-guide/blob/master/assets/fcc-puck-500-favicon.png), [logo](https://github.com/freeCodeCamp/design-style-guide/blob/master/downloads/fcc_primary_large.png)y [portada](https://github.com/freeCodeCamp/design-style-guide/blob/master/assets/fcc_ghost_publication_cover.png).
|
||||
|
||||
@ -57,40 +57,40 @@ Una vez tengas los prerrequisitos instalados, necesitas preparar tu entorno de d
|
||||
|
||||
## Bifurcar el repositorio en GitHub
|
||||
|
||||
[Forking](https://help.github.com/articles/about-forks/) is a step where you get your own copy of freeCodeCamp's main repository (a.k.a _repo_) on GitHub.
|
||||
[Bifurcar](https://help.github.com/articles/about-forks/) es un paso donde consigues tu propia copia del repositorio de freeCodeCamp's (conocido como _repo_) en GitHub.
|
||||
|
||||
This is essential, as it allows you to work on your own copy of freeCodeCamp on GitHub, or to download (clone) your repository to work on locally. Later, you will be able to request changes to be pulled into the main repository from your fork via a pull request (PR).
|
||||
Esto es esencial, te permite trabajar en tu propia copia de FreeCodeCamp en GitHub, o descargar o clonar un repuesto para trabajar localmente. Más tarde, podrás solicitar cambios para que se muestren en el repositorio principal de tu "fork" (bifurcación) a través de una "pull request" (PR).
|
||||
|
||||
> [!TIP] El repositorio principal en `https://github.com/freeCodeCamp/freeCodeCamp` es frecuentemente conocido como el repositorio `upstream`.
|
||||
>
|
||||
> Tu fork en `https://github.com/YOUR_USER_NAME/freeCodeCamp` suele referirse como el repositorio `origin`. `YOUR_USER_NAME` será remplazado con tu nombre de usuario de GitHub.
|
||||
|
||||
**Follow these steps to fork the `https://github.com/freeCodeCamp/freeCodeCamp` repository:**
|
||||
**Sigue estos pasos para bifurcar el repositorio `https://github.com/freeCodeCamp/freeCodeCamp`:**
|
||||
|
||||
1. Ve al repositorio freeCodeCamp en GitHub: <https://github.com/freeCodeCamp/freeCodeCamp>
|
||||
|
||||
2. Haga clic en el botón "Fork" en la esquina superior derecha de la interfaz ([Más detalles aquí](https://help.github.com/articles/fork-a-repo/))
|
||||
|
||||
3. After the repository has been forked, you will be taken to your copy of the freeCodeCamp repository at `https://github.com/YOUR_USER_NAME/freeCodeCamp` (`YOUR_USER_NAME` would be replaced with your GitHub user name.)
|
||||
3. Después de que el repositorio haya sido bifurcado, serás llevado a tu copia del repositorio de freeCodeCamp en `https://github.com/YOUR_USER_NAME/freeCodeCamp` (`YOUR_USER_NAME` será remplazado con tu nombre de usuario de GitHub).
|
||||
|
||||
<details>
|
||||
<summary>
|
||||
How to fork freeCodeCamp on GitHub (screenshot)
|
||||
Cómo bifurcar freeCodeCamp en GitHub (captura de pantalla)
|
||||
</summary>
|
||||
|
||||
<br>
|
||||
<img src="https://raw.githubusercontent.com/freeCodeCamp/freeCodeCamp/main/docs/images/github/how-to-fork-freeCodeCamp.gif" alt="How to fork freeCodeCamp on GitHub" />
|
||||
<img src="https://raw.githubusercontent.com/freeCodeCamp/freeCodeCamp/main/docs/images/github/how-to-fork-freeCodeCamp.gif" alt="Cómo bifurcar freeCodeCamp en Github" />
|
||||
</details>
|
||||
|
||||
## Clona tu bifurcación desde GitHub
|
||||
|
||||
[Cloning](https://help.github.com/articles/cloning-a-repository/) is where you **download** a copy of a repository from a `remote` location that is either owned by you or by someone else. In your case, this remote location is your `fork` of freeCodeCamp's repository that should be available at `https://github.com/YOUR_USER_NAME/freeCodeCamp`. (`YOUR_USER_NAME` would be replaced with your GitHub user name.)
|
||||
"[Cloning](https://help.github.com/articles/cloning-a-repository/)" es donde tú "**download**" (descargas) una copia de un repositorio de una localización "`remote`" (remota) que es propiedad tuya o de alguien más. En tu caso, esta localización remota es tu "`fork`" bifurcación del repositorio de freeCodeCamp que debería estar disponible en `https://github.com/YOUR_USER_NAME/freeCodeCamp`. ("`YOUR_USER_NAME`" (Tu nombre de usuario) debería ser reemplazado con tu nombre de usuario de GitHub)
|
||||
|
||||
> [!WARNING] If you are working on a WSL2 Linux Distro, you might get performance and stability issues by running this project in a folder which is shared between Windows and WSL2 (e.g. `/mnt/c/Users/`). Therefore we recommend to clone this repo into a folder which is mainly used by your WSL2 Linux Distro and not directly shared with Windows (e.g. `~/PROJECTS/`).
|
||||
> [!WARNING] Si estás trabajando en una Distribución Linux WSL2, puedes presentar problemas de rendimiento y estabilidad por ejecutar este proyecto en una carpeta compartida entre Windows y WSL2 (p.ej. `/mnt/c/Users/`). Por lo tanto, recomendamos clonar este repositorio dentro de una carpeta que sea principalmente utilizada por su Distribución Linux WSL2 y no directamente compartida con Windows (p.ej. `~/PROJECTS/`).
|
||||
>
|
||||
> See [this GitHub Issue](https://github.com/freeCodeCamp/freeCodeCamp/issues/40632) for further Information about this problem.
|
||||
> Vea [Este reporte en GitHub](https://github.com/freeCodeCamp/freeCodeCamp/issues/40632) para más información acerca de este problema.
|
||||
|
||||
Run these commands on your local machine:
|
||||
Ejecuta estos comandos en tu computador:
|
||||
|
||||
1. Abrir una Terminal / Símbolo del sistema / Shell en el directorio de proyectos
|
||||
|
||||
@ -102,17 +102,17 @@ Run these commands on your local machine:
|
||||
git clone --depth=1 https://github.com/YOUR_USER_NAME/freeCodeCamp.git
|
||||
```
|
||||
|
||||
This will download the entire freeCodeCamp repository to your projects directory.
|
||||
Esto descargará el repositorio entero de freeCodeCamp en tu directorio de proyectos.
|
||||
|
||||
Note: `--depth=1` creates a shallow clone of your fork, with only the most recent history/commit.
|
||||
Nota: "`--depth=1`" crea un clon superficial de tu bifurcación con solo la historia/commit más reciente.
|
||||
|
||||
## Configurar sincronización desde el padre
|
||||
|
||||
Now that you have downloaded a copy of your fork, you will need to set up an `upstream` remote to the parent repository.
|
||||
Ahora que ha descargado una copia de su bifurcación, necesitará configurar un `upstream` remoto en el repositorio padre.
|
||||
|
||||
[As mentioned earlier](#fork-the-repository-on-github), the main repository is referred `upstream` repository. Your fork referred to as the `origin` repository.
|
||||
[Como se mencionó anteriormente](#fork-the-repository-on-github), el repositorio principal es referido repositorio `upstream` . Su bifurcación conocida como repositorio de `origen`.
|
||||
|
||||
You need a reference from your local clone to the `upstream` repository in addition to the `origin` repository. This is so that you can sync changes from the main repository without the requirement of forking and cloning repeatedly.
|
||||
Necesita una referencia de su clon local al repositorio `upstream` además del repositorio `origin`. Esto es para que pueda sincronizar los cambios desde el repositorio principal sin el requisito de bifurcar y clonar repetidamente.
|
||||
|
||||
1. Cambiar directorio al nuevo directorio de freeCodeCamp:
|
||||
|
||||
@ -132,7 +132,7 @@ You need a reference from your local clone to the `upstream` repository in addit
|
||||
git remote -v
|
||||
```
|
||||
|
||||
The output should look something like below (replacing `YOUR_USER_NAME` with your GitHub username):
|
||||
La salida debería verse parecida a como se muestra debajo (remplazando `YOUR_USER_NAME` con tu usuario de GitHub):
|
||||
|
||||
```console
|
||||
origin https://github.com/YOUR_USER_NAME/freeCodeCamp.git (fetch)
|
||||
@ -143,31 +143,31 @@ You need a reference from your local clone to the `upstream` repository in addit
|
||||
|
||||
## Ejecutando freeCodeCamp localmente
|
||||
|
||||
Now that you have a local copy of freeCodeCamp, you can follow these instructions to run it locally. This will allow you to:
|
||||
Ahora que tienes una copia local de freeCodeCamp, puedes seguir estas instrucciones para ejecutarla localmente. Esto le permitirá:
|
||||
|
||||
- Vista previa de ediciones a páginas como aparecerían en la plataforma de aprendizaje.
|
||||
- Trabajar en temas y mejoras relacionados con la IU.
|
||||
- Depurar y arreglar problemas con los servidores de aplicaciones y aplicaciones cliente.
|
||||
|
||||
If you do run into issues, first perform a web search for your issue and see if it has already been answered. If you cannot find a solution, please search our [GitHub issues](https://github.com/freeCodeCamp/freeCodeCamp/issues) page for a solution and report the issue if it has not yet been reported.
|
||||
Si tiene problemas, primero realice una búsqueda web para su problema y compruebe si ya ha sido respondida. Si no encuentra una solución, por favor busque en nuestra página [GitHub issues](https://github.com/freeCodeCamp/freeCodeCamp/issues) para una solución e infórmese del problema si aún no ha sido reportado.
|
||||
|
||||
And as always, feel free to ask questions on the ['Contributors' category on our forum](https://forum.freecodecamp.org/c/contributors) or [our chat server](https://chat.freecodecamp.org/home).
|
||||
Y como siempre, siéntase libre de hacer preguntas en la categoría ['Contributors' en nuestro foro](https://forum.freecodecamp.org/c/contributors) o [nuestro servidor de chat](https://chat.freecodecamp.org/home).
|
||||
|
||||
> [!TIP] You may skip running freeCodeCamp locally if you are simply editing files. For instance, performing a `rebase`, or resolving `merge` conflicts.
|
||||
> [!TIP] Puedes optar por no ejecutar freeCodeCamp localmente si simplemente estas editando archivos. Por ejemplo, realizar un `rebase`, or resolver conflictos `merge`.
|
||||
>
|
||||
> You can always return to this part of the instructions later. You should **only** skip this step if you do not need to run the apps on your machine.
|
||||
> Siempre puedes regresar a esta parte de las instrucciones luego. Puedes obviar este paso **si y solo si** no necesitas ejecutar applicaciones en tu computadora.
|
||||
>
|
||||
> [Skip to making changes](#making-changes-locally).
|
||||
> [Avanza para hacer cambios](#making-changes-locally).
|
||||
|
||||
### Configurando dependencias
|
||||
|
||||
#### Step 1: Set up the environment variable file
|
||||
#### Paso 1: Configurar el archivo de variable de entorno
|
||||
|
||||
The default API keys and environment variables are stored in the file `sample.env`. This file needs to be copied to a new file named `.env` that is accessed dynamically during the installation step.
|
||||
Las claves de la API por defecto y las variables de entorno se almacenan en el archivo `sample.env`. El contenido de este archivo necesita ser copiado a un nuevo archivo llamado `.env` para que se acceda dinámicamente durante el paso de la instalación.
|
||||
|
||||
```console
|
||||
# Crear una copia de la "sample.env" y nombrarla ".env".
|
||||
# Populate it with the necessary API keys and secrets:
|
||||
# Completarlo con las claves y secretos de la API necesarios:
|
||||
```
|
||||
|
||||
<!-- tabs:start -->
|
||||
@ -186,25 +186,25 @@ copy sample.env .env
|
||||
|
||||
<!-- tabs:end -->
|
||||
|
||||
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.
|
||||
Las claves dentro del archivo `.env` _no_ requieren ser cambiadas para correr la aplicación de forma local. Puedes dejar los valores por defecto copiados desde `sample.env`.
|
||||
|
||||
> [!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.
|
||||
> [!TIP] Ten en mente que si quieres usar APIs como Auth0 o Algolia, tienes que adquirir tus propias credenciales o API keys para usar esos servicios, de acuerdo a su archivo `.env`.
|
||||
|
||||
#### Step 2: Install dependencies
|
||||
#### Paso 2: Instalar dependencias
|
||||
|
||||
This step will install the dependencies required for the application to run:
|
||||
Este paso instalará las dependencias necesarias para que la aplicación se ejecute:
|
||||
|
||||
```console
|
||||
npm ci
|
||||
```
|
||||
|
||||
#### Step 3: Start MongoDB and seed the database
|
||||
#### Paso 3: Iniciar MongoDB y "sembrar" la base de datos
|
||||
|
||||
Before you can run the application locally, you will need to start the MongoDB service.
|
||||
Antes de que pueda ejecutar la aplicación localmente, necesitará iniciar el servicio MongoDB.
|
||||
|
||||
> [!NOTE] Unless you have MongoDB running in a setup different than the default, the URL stored as the `MONGOHQ_URL` value in the `.env` file should work fine. If you are using a custom configuration, modify this value as needed.
|
||||
> [!NOTE] A menos que MongoDB haya sido configurado de forma diferente a la configuración por defecto, la URL `MONGOHQ_URL` en el archivo `.env` debería funcionar sin problemas. Si estás usando una configuración diferente a la por defecto, modifica ese valor según lo requiera.
|
||||
|
||||
Start the MongoDB server in a separate terminal:
|
||||
Iniciar el servidor MongoDB en un terminal separado:
|
||||
|
||||
<!-- tabs:start -->
|
||||
|
||||
@ -216,64 +216,64 @@ mongod
|
||||
|
||||
#### **Windows**
|
||||
|
||||
- On Windows, you must specify the full path to the `mongod` binary
|
||||
- En Windows, debes especificar la ruta completa al binario `mondios`
|
||||
|
||||
```console
|
||||
"C:\Program Files\MongoDB\Server\3.6\bin\mongod"
|
||||
```
|
||||
|
||||
Make sure to replace `3.6` with the version you have installed
|
||||
Asegúrate de reemplazar `3.6` con la versión instalada
|
||||
|
||||
<!-- tabs:end -->
|
||||
|
||||
> [!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/)
|
||||
> [!TIP] Puedes evitar tener que iniciar MongoDB cada vez que enciendes tu PC si instalas MongoDB como servicio de segundo plano. Puedes aprender más [consultando la documentación de tu sistema operativo](https://docs.mongodb.com/manual/administration/install-community/)
|
||||
|
||||
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.
|
||||
A continuación, vamos a "sembrar" la base de datos. En este paso, ejecutamos el siguiente comando que rellena el servidor MongoDB con algunos conjuntos de datos iniciales que son requeridos por los servicios. Estos incluyen algunos esquemas, entre otras cosas.
|
||||
|
||||
```console
|
||||
npm run seed
|
||||
```
|
||||
|
||||
#### Step 4: Start the freeCodeCamp client application and API server
|
||||
#### Paso 4: Iniciar la aplicación del cliente freeCodeCamp y el servidor de la API
|
||||
|
||||
You can now start up the API server and the client applications.
|
||||
Ahora puedes poner en marcha el servidor API y las aplicaciones de cliente.
|
||||
|
||||
```console
|
||||
npm run develop
|
||||
```
|
||||
|
||||
This single command will fire up all the services, including the API server and the client applications available for you to work on.
|
||||
Este único comando lanzará todos los servicios, incluyendo el servidor API y las aplicaciones cliente disponibles para que usted trabaje.
|
||||
|
||||
> [!NOTE] Once ready, open a web browser and **visit <http://localhost:8000>**. If the app loads, congratulations – you're all set! You now have a copy of freeCodeCamp's entire learning platform running on your local machine.
|
||||
> [!NOTE] Una vez listo, abre tu navegador y ** visita <http://localhost:8000>**. Si la aplicación carga, ¡felicidades! Ahora posees una copia de la plataforma freeCodeCamp's en tu PC.
|
||||
|
||||
> [!TIP] The API Server serves APIs at `http://localhost:3000`. The Gatsby app serves the client application at `http://localhost:8000`
|
||||
> [!TIP] La URL de la API es `http://localhost:3000`. La aplicación Gatsby corre en `http://localhost:8000`
|
||||
|
||||
> If you visit <http://localhost:3000/explorer> you should see the available APIs.
|
||||
> Si visitas <http://localhost:3000/explorer> deberías poder ver las API disponibles.
|
||||
|
||||
## Iniciar sesión con un usuario 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.
|
||||
Su configuración local automáticamente rellena un usuario local en la base de datos. Al hacer clic en el botón `Sign In` se autenticará automáticamente en la aplicación local.
|
||||
|
||||
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.
|
||||
Sin embargo, acceder a la página del portafolio de usuarios es un poco complicado. En desarrollo, Gatsby se hace cargo de servir las páginas del lado del cliente y por lo tanto obtendrás una página `404` para el portafolio de usuarios cuando trabajes localmente.
|
||||
|
||||
Simply clicking the **"Preview Custom 404 Page"** button will forward you to the correct page.
|
||||
Simplemente haga clic en el botón **"Vista previa de página 404 personalizada"** le redirigirá a la página correcta.
|
||||
|
||||
<details>
|
||||
<summary>
|
||||
How to sign in when working locally (screenshot)
|
||||
Cómo iniciar sesión cuando se trabaja localmente (captura de pantalla)
|
||||
</summary>
|
||||
|
||||
<br>
|
||||
<img src="https://user-images.githubusercontent.com/29990697/71541249-f63cdf00-2923-11ea-8a85-cefb6f9c9977.gif" alt="How to sign in when working locally" />
|
||||
<img src="https://user-images.githubusercontent.com/29990697/71541249-f63cdf00-2923-11ea-8a85-cefb6f9c9977.gif" alt="Como iniciar sesión cuando se trabaja localmente" />
|
||||
</details>
|
||||
|
||||
## Haciendo cambios localmente
|
||||
|
||||
You can now make changes to files and commit your changes to your local clone of your fork.
|
||||
Ahora puede hacer cambios en archivos y confirmar los cambios en su clon local de su bifurcación.
|
||||
|
||||
Follow these steps:
|
||||
Siga estos pasos:
|
||||
|
||||
1. Validate that you are on the `main` branch:
|
||||
1. Validar que estás en la rama de `main`:
|
||||
|
||||
```console
|
||||
git status
|
||||
@ -288,19 +288,19 @@ Follow these steps:
|
||||
nada para confirmar, limpiar directorio
|
||||
```
|
||||
|
||||
If you are not on main or your working directory is not clean, resolve any outstanding files/commits and checkout `main`:
|
||||
Si no estás en main o tu directorio de trabajo no está limpio, resuelve cualquier archivo/commits pendientes y comprueba `main`:
|
||||
|
||||
```console
|
||||
git checkout main
|
||||
```
|
||||
|
||||
2. Sync the latest changes from the freeCodeCamp upstream `main` branch to your local main branch:
|
||||
2. Sincroniza los últimos cambios desde la rama principal `main` de freeCodeCamp a tu rama main local:
|
||||
|
||||
> [!WARNING] If you have any outstanding pull request that you made from the `main` branch of your fork, you will lose them at the end of this step.
|
||||
> [!WARNING] Si tienes algún pull request pendiente que hayas hecho desde la rama `main` de tu bifurcación, los perderás al final de este paso.
|
||||
>
|
||||
> Debería asegurarse de que su pull request está fusionado por un moderador antes de realizar este paso. To avoid this scenario, you should **always** work on a branch other than the `main`.
|
||||
> Debería asegurarse de que su pull request está fusionado por un moderador antes de realizar este paso. Para evitar este escenario, deberías **siempre** trabajar en una rama que no sea `main`.
|
||||
|
||||
Este paso **sincronizará los últimos cambios** desde el repositorio principal de freeCodeCamp. It is important that you rebase your branch on top of the latest `upstream/main` as often as possible to avoid conflicts later.
|
||||
Este paso **sincronizará los últimos cambios** desde el repositorio principal de freeCodeCamp. Es importante que rebase su rama sobre la última `upstream/main` tan a menudo como sea posible para evitar conflictos más tarde.
|
||||
|
||||
Actualiza tu copia local del repositorio de freeCodeCamp upstream:
|
||||
|
||||
@ -308,19 +308,19 @@ Follow these steps:
|
||||
git fetch upstream
|
||||
```
|
||||
|
||||
Hard reset your main branch with the freeCodeCamp main:
|
||||
Restablece tu rama main con el main de freeCodeCamp:
|
||||
|
||||
```console
|
||||
git reset --hard upstream/main
|
||||
```
|
||||
|
||||
Push your main branch to your origin to have a clean history on your fork on GitHub:
|
||||
Empuje su rama main a su origen para tener un historial limpio en su bifurcación en GitHub:
|
||||
|
||||
```console
|
||||
git push origin main --force
|
||||
```
|
||||
|
||||
You can validate your current main matches the upstream/main by performing a diff:
|
||||
Puedes validar que tu main actual concuerda con el upstream/main realizando un diff:
|
||||
|
||||
```console
|
||||
git diff upstream/main
|
||||
@ -330,9 +330,9 @@ Follow these steps:
|
||||
|
||||
3. Crear una nueva rama:
|
||||
|
||||
Trabajar en una rama separada para cada asunto le ayuda a mantener limpia su copia de trabajo local. You should never work on the `main`. Esto sumergirá su copia de freeCodeCamp y puede que tenga que empezar con un clon o un tenedor fresco.
|
||||
Trabajar en una rama separada para cada asunto le ayuda a mantener limpia su copia de trabajo local. Nunca deberías trabajar en `main`. Esto sumergirá su copia de freeCodeCamp y puede que tenga que empezar con un clon o un tenedor fresco.
|
||||
|
||||
Check that you are on `main` as explained previously, and branch off from there:
|
||||
Comprueba que estás en `main` como se explicó anteriormente, y ramifica desde ahí:
|
||||
|
||||
```console
|
||||
git checkout -b fix/update-guide-for-xyz
|
||||
@ -446,7 +446,7 @@ Follow these steps:
|
||||
|
||||
Puedes aprender más sobre por qué debes usar commits convencionales [aquí](https://www.conventionalcommits.org/en/v1.0.0-beta.2/#why-use-conventional-commits).
|
||||
|
||||
9. If you realize that you need to edit a file or update the commit message after making a commit you can do so after editing the files with:
|
||||
9. Si te das cuenta de que necesitas editar un archivo o actualizar el mensaje de confirmación después de hacer un commit puedes hacerlo después de editar los archivos con:
|
||||
|
||||
```console
|
||||
git commit --amend
|
||||
@ -462,45 +462,45 @@ Follow these steps:
|
||||
|
||||
## Proponer una Pull Request (PR)
|
||||
|
||||
After you've committed your changes, check here for [how to open a Pull Request](how-to-open-a-pull-request.md).
|
||||
Después de que hayas cometido tus cambios, consulta aquí [cómo abrir una Pull Request](how-to-open-a-pull-request.md).
|
||||
|
||||
## Referencia de comandos rápidos
|
||||
|
||||
A quick reference to the commands that you will need when working locally.
|
||||
Una referencia rápida a los comandos que necesitará cuando trabaje localmente.
|
||||
|
||||
| comando | descripción |
|
||||
| -------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
|
||||
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
|
||||
| `npm ci` | Instala / reinstala todas las dependencias y arranca los diferentes servicios. |
|
||||
| `npm run seed` | Analiza todos los archivos markdown del desafío e inserta en MongoDB. |
|
||||
| `npm run develop` | Inicia el servidor freeCodeCamp API y las aplicaciones de cliente. |
|
||||
| `npm run storybook` | Starts Storybook for component library development. |
|
||||
| `npm test` | Run all JS tests in the system, including client, server, lint and challenge tests. |
|
||||
| `npm run test-client` | Run the client test suite. |
|
||||
| `npm run test:curriculum` | Run the curriculum test suite. |
|
||||
| `npm run test:curriculum --block='Basic HTML and HTML5'` | Test a specific Block. |
|
||||
| `npm run test:curriculum --superblock='responsive-web-design'` | Test a specific SuperBlock. |
|
||||
| `npm run test-curriculum-full-output` | Run the curriculum test suite, without bailing after the first error |
|
||||
| `npm run test-server` | Run the server test suite. |
|
||||
| `npm run e2e` | Run the Cypress end to end tests. |
|
||||
| `npm run clean` | Uninstalls all dependencies and cleans up caches. |
|
||||
| `npm run storybook` | Inicia Storybook para el desarrollo de la biblioteca de componentes. |
|
||||
| `npm test` | Ejecuta todas las pruebas JS en el sistema, incluidas las pruebas de cliente, servidor, lint y pruebas de desafío. |
|
||||
| `npm run test-client` | Ejecuta el conjunto de pruebas del cliente. |
|
||||
| `npm run test:curriculum` | Ejecuta el conjunto de pruebas del curriculum. |
|
||||
| `npm run test:curriculum --block='Basic HTML and HTML5'` | Prueba un bloque específico. |
|
||||
| `npm run test:curriculum --superblock='responsive-web-design'` | Evalúa un SuperBlock específico. |
|
||||
| `npm run test-curriculum-full-output` | Ejecutar el programa de prueba de currículo, sin tener que pagar después del primer error |
|
||||
| `npm run test-server` | Ejecute la suite de pruebas del servidor. |
|
||||
| `npm run e2e` | Ejecute el Cypress end para terminar las pruebas. |
|
||||
| `npm run clean` | Desinstala todas las dependencias y limpia las cachés. |
|
||||
|
||||
## Solución de problemas
|
||||
|
||||
### Problemas con la instalación de los prerrequisitos recomendados
|
||||
|
||||
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).
|
||||
Regularmente desarrollamos en los últimos o más populares sistemas operativos como macOS 10.15 o posterior, Ubuntu 18.04 o posterior y Windows 10 (con WSL2).
|
||||
|
||||
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 recomienda buscar tu problema específico en recursos como Google, Stack Overflow y Stack Exchange. Existe la posibilidad de que alguien haya tenido al mismo problema y ya haya una respuesta a tu pregunta específica.
|
||||
|
||||
If you are on a different OS and/or are still running into issues, see [getting help](#getting-help).
|
||||
Si estás en un sistema operativo diferente y/o todavía tienes problemas, consulta [obtener ayuda](#getting-help).
|
||||
|
||||
> [!WARNING]
|
||||
>
|
||||
> Please avoid creating GitHub issues for prerequisite issues. They are out of the scope of this project.
|
||||
> Por favor, evite crear problemas de GitHub para problemas de prerrequisitos. Están fuera del ámbito de este proyecto.
|
||||
|
||||
### Issues with the UI, Fonts, build errors, etc.
|
||||
### Problemas con la interfaz de usuario, fuentes, errores de compilación, etc.
|
||||
|
||||
If you face issues with the UI, Fonts or see builds errors a cleanup can be useful:
|
||||
Si usted se enfrenta a problemas con la interfaz de usuario, fuentes o ver errores de compilación, una limpieza puede ser útil:
|
||||
|
||||
```console
|
||||
npm run clean
|
||||
@ -509,17 +509,17 @@ npm run seed
|
||||
npm run develop
|
||||
```
|
||||
|
||||
OR
|
||||
O
|
||||
|
||||
Use the shortcut
|
||||
Usa el atajo
|
||||
|
||||
```
|
||||
npm run clean-and-develop
|
||||
```
|
||||
|
||||
If you continue to face issues with the build, cleaning up the workspace is recommend.
|
||||
Si continúa enfrentándose a problemas con la construcción, se recomienda limpiar el espacio de trabajo.
|
||||
|
||||
Use `git clean` in interactive mode:
|
||||
Usa `git clean` en modo interactivo:
|
||||
|
||||
```
|
||||
git clean -ifdX
|
||||
@ -527,20 +527,20 @@ git clean -ifdX
|
||||
|
||||
<details>
|
||||
<summary>
|
||||
How to clean git untracked files (screenshot)
|
||||
Cómo limpiar archivos sin seguimiento de git (captura de pantalla)
|
||||
</summary>
|
||||
|
||||
<br>
|
||||
<img src="https://user-images.githubusercontent.com/1884376/94270515-ca579400-ff5d-11ea-8ff1-152cade31654.gif" alt="How to clean git untracked files" />
|
||||
<img src="https://user-images.githubusercontent.com/1884376/94270515-ca579400-ff5d-11ea-8ff1-152cade31654.gif" alt="Como limpiar archivos sin seguimientos de git" />
|
||||
</details>
|
||||
|
||||
### Issues with API, login, Challenge Submissions, etc.
|
||||
### Problemas con API, login, Desafío de Submisiones, etc.
|
||||
|
||||
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.
|
||||
Si no puedes iniciar sesión, y en su lugar ves un banner con un mensaje de error que será reportado a freeCodeCamp, por favor, comprueba que tu puerto local `3000` no esté en uso por un programa diferente.
|
||||
|
||||
<!-- tabs:start -->
|
||||
|
||||
#### **macOS/Linux/WSL on Windows - From Terminal:**
|
||||
#### **macOS/Linux/WSL en Windows - Desde la terminal:**
|
||||
|
||||
```console
|
||||
netstat -a | grep "3000"
|
||||
@ -548,7 +548,7 @@ netstat -a | grep "3000"
|
||||
tcp4 0 0 0.0.0.0:3000 DESKTOP LISTEN
|
||||
```
|
||||
|
||||
#### **On Windows - From Elevated PowerShell:**
|
||||
#### **En Windows - Desde Elevated PowerShell:**
|
||||
|
||||
```powershell
|
||||
netstat -ab | Select-String "3000"
|
||||
@ -562,14 +562,14 @@ 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.
|
||||
Si obtiene errores durante la instalación de las dependencias, por favor asegúrese de que no está en una red restringida o sus ajustes de cortafuegos no le impiden acceder a los recursos.
|
||||
|
||||
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.
|
||||
La primera configuración puede tardar un rato dependiendo del ancho de banda de su red. Tenga paciencia, y si todavía está atascado le recomendamos usar GitPod en lugar de una configuración sin conexión.
|
||||
|
||||
> [!NOTE] If you are using Apple Devices with M1 Chip to run the application locally, it is suggested to use Node v14.7 or above. You might run into issues with dependencies like Sharp otherwise.
|
||||
> [!NOTE] Si está utilizando dispositivos Apple con chip M1 para ejecutar la aplicación localmente, se sugiere usar Node v14.7 o superior. De lo contrario, es posible que tenga problemas con dependencias como Sharp.
|
||||
|
||||
## Obteniendo ayuda
|
||||
|
||||
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).
|
||||
Si estas atascado y necesitas ayuda, siéntete libre de realizar preguntas en la [Categoria "Contribuyentes" en nuestro foro](https://forum.freecodecamp.org/c/contributors) o en la [Sala de Chat de los Contribuyentes](https://chat.freecodecamp.org/channel/contributors).
|
||||
|
||||
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.
|
||||
Puede haber un error en la consola de su navegador o en Bash / Terminal / Command Line que le ayudará a identificar el problema. Proporcione este mensaje de error en la descripción de su problema para que otros puedan identificar el problema más fácilmente y ayudarle a encontrar una solución.
|
||||
|
||||
@ -8,11 +8,11 @@ En caso de que quieras probar tus traducciones en una instancia local del sitio
|
||||
|
||||
Hay algunos pasos a seguir para permitirle a la base de código compilar en tu lenguaje deseado.
|
||||
|
||||
First, visit the `config/i18n/all-langs.ts` file to add the language to the available languages list and configure the values. Hay cuatro objetos aquí.
|
||||
Primero, visita el archivo `config/i18n/all-langs.ts` para agregar el idioma a la lista de lenguajes disponibles y configurar los valores. Hay cuatro objetos aquí.
|
||||
|
||||
- `avaliableLangs`: Tanto para el arreglo `client` como para el arreglo `curriculum`, añade el nombre en texto del lenguaje. Este es el valor que se utilizará en el archivo `.env` más tarde.
|
||||
- `auditedCerts`: Add the text name of the language as the _key_, and add an array of `SuperBlocks.{cert}` variables as the _value_. This tells the client which certifications are fully translated.
|
||||
- `i18nextCodes`: These are the ISO language codes for each language. You will need to add the appropriate ISO code for the language you are enabling. These do need to be unique for each language.
|
||||
- `auditedCerts`: Add the text name of the language as the _key_, and add an array of `SuperBlocks.{cert}` variables as the _value_. Esto le dice al cliente qué certificaciones están totalmente traducidas.
|
||||
- `i18nextCodes`: Estos son los codigos de idioma ISO para cada lenguaje. You will need to add the appropriate ISO code for the language you are enabling. These do need to be unique for each language.
|
||||
- `langDisplayNames`: These are the display names for the language selector in the navigation menu.
|
||||
- `langCodes`: These are the language codes used for formatting dates and numbers. These should be Unicode CLDR codes instead of ISO codes.
|
||||
|
||||
@ -94,13 +94,13 @@ const langCodes = {
|
||||
};
|
||||
```
|
||||
|
||||
Next, open the `client/src/utils/algolia-locale-setup.ts` file. Estos datos son utilizados por la barra de búsqueda que carga artículos de `/news` (noticias). While it is unlikely that you are going to test this functionality, missing the data for your language can lead to errors when attempting to build the codebase locally.
|
||||
Next, open the `client/src/utils/algolia-locale-setup.ts` file. Estos datos son utilizados por la barra de búsqueda que carga artículos de `/news` (noticias). Si bien es poco probable que pruebe esta funcionalidad, la falta de datos para su idioma puede provocar errores al intentar crear la base de código localmente.
|
||||
|
||||
Add an object for your language to the `algoliaIndices` object. You should use the values for the `english` object for local testing, replacing the `english` key with your language's `availableLangs` value.
|
||||
Agregue un objeto para su idioma al objeto `algoliaIndices`. Debes usar los valores del objeto `english` para las pruebas locales, reemplazando la clave `english` con el valor `availableLangs` de tu idioma.
|
||||
|
||||
> [!NOTE] If we have already deployed an instance of news in your target language, you can update the values to reflect the live instance. Otherwise, use the English values.
|
||||
|
||||
If you were to add Dothraki:
|
||||
Si tuvieras que agregar Dothraki:
|
||||
|
||||
```js
|
||||
const algoliaIndices = {
|
||||
@ -119,12 +119,7 @@ const algoliaIndices = {
|
||||
'chinese-traditional': {
|
||||
name: 'news-zh',
|
||||
searchPage: 'https://chinese.freecodecamp.org/news/search'
|
||||
},
|
||||
dothraki: {
|
||||
name: 'news',
|
||||
searchPage: 'https://www.freecodecamp.org/news/search/'
|
||||
}
|
||||
};
|
||||
};
|
||||
```
|
||||
|
||||
Finally, in your `.env` file, set `CLIENT_LOCALE` and `CURRICULUM_LOCALE` to your new language (use the `availableLangs` value.)
|
||||
@ -134,7 +129,7 @@ CLIENT_LOCALE="dothraki"
|
||||
CURRICULUM_LOCALE="dothraki"
|
||||
```
|
||||
|
||||
## Enabling Localized Videos
|
||||
## Habilitar Videos Localizados
|
||||
|
||||
For the video challenges, you need to change a few things. First add the new locale to the GraphQL query in the `client/src/templates/Challenges/video/Show.tsx` file. For example, adding Dothraki to the query:
|
||||
|
||||
@ -188,7 +183,7 @@ videoLocaleIds: Joi.when('challengeType', {
|
||||
}),
|
||||
```
|
||||
|
||||
## Loading Translations
|
||||
## Cargando traducciones
|
||||
|
||||
Because the language has not been approved for production, our scripts are not automatically downloading the translations yet. Only staff have the access to directly download the translations - you are welcome to reach out to us in our [contributors chat room](https://chat.freecodecamp.org/channel/contributors), or you can translate the English markdown files locally for testing purposes.
|
||||
|
||||
|
||||
@ -10,7 +10,7 @@ Si deseas crear nuevos pasos, las siguientes herramientas simplifican este proce
|
||||
|
||||
## Crea el siguiente paso
|
||||
|
||||
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.
|
||||
Un script único que automáticamente agregará el siguiente paso basado en el último paso del proyecto. El código de semilla de desafío utilizará el código de semilla de desafío del paso anterior.
|
||||
|
||||
### Cómo ejecutar un script:
|
||||
|
||||
@ -23,57 +23,57 @@ Ejecuta npm crear siguiente paso
|
||||
|
||||
## Crea pasos vacíos
|
||||
|
||||
A one-off script that automatically adds a specified number of steps. The challenge seed code for all steps created will be empty.
|
||||
Un script único que agrega automáticamente un número determinado de pasos. El código para todos los pasos creados estará vacío.
|
||||
|
||||
**Note:** This script also runs [update-step-titles](#update-step-titles).
|
||||
**Nota:** Este script también ejecuta [reorder-steps](#update-step-titles).
|
||||
|
||||
### How to run script:
|
||||
### Cómo ejecutar un script:
|
||||
|
||||
1. Change to the directory of the project.
|
||||
2. Run the following npm command:
|
||||
1. Redirígete al directorio del proyecto.
|
||||
2. Ejecuta el siguiente comando npm:
|
||||
|
||||
```bash
|
||||
npm run create-empty-steps X # where X is the number of steps to create.
|
||||
npm run create-empty-steps X # donde X es el número de pasos a crear.
|
||||
```
|
||||
|
||||
## insert-step
|
||||
|
||||
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.
|
||||
Un script único que agrega automáticamente un nuevo paso en una posición especificada, incrementando todos los pasos posteriores (tanto sus títulos como en su meta.json). El código principal del desafío, utilizará el código de los desafíos de pasos anteriores, con los marcadores de región editables (ERM) eliminados.
|
||||
|
||||
**Note:** This script also runs [update-step-titles](#update-step-titles).
|
||||
**Nota:** Este script también ejecuta [reorder-steps](#update-step-titles).
|
||||
|
||||
### How to run script:
|
||||
### Cómo ejecutar el script:
|
||||
|
||||
1. Change to the directory of the project.
|
||||
2. Run the following npm command:
|
||||
1. Redirígete al directorio principal del proyecto.
|
||||
2. Ejecuta el siguiente comando npm:
|
||||
|
||||
```bash
|
||||
npm run insert-step X # where X is the position to insert the new step.
|
||||
npm run insert-step X # donde X es la posición para insertar el nuevo paso.
|
||||
```
|
||||
|
||||
## delete-step
|
||||
## Eliminar un paso
|
||||
|
||||
A one-off script that deletes an existing step, decrementing all subsequent steps (both their titles and in their meta.json)
|
||||
Un script único que elimina un paso existente, decrementando todos los pasos posteriores (tanto sus títulos como en su meta.json)
|
||||
|
||||
**Note:** This script also runs [update-step-titles](#update-step-titles).
|
||||
**Nota:** Este script también ejecuta [reorder-steps](#update-step-titles).
|
||||
|
||||
### How to run script
|
||||
### Cómo ejecutar el script
|
||||
|
||||
1. Change to the directory of the project.
|
||||
2. Run the following npm command:
|
||||
1. Redirígete al directorio principal del proyecto.
|
||||
2. Ejecuta el siguiente comando npm:
|
||||
|
||||
```bash
|
||||
npm run delete-step X # where X is the step number to be deleted.
|
||||
npm ejecuta delete-step X # donde X es el número de paso a ser eliminado.
|
||||
```
|
||||
|
||||
## update-step-titles
|
||||
|
||||
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.
|
||||
Un script único que actualiza automáticamente la materia frontal en los archivos markdown de un proyecto para que sean consistentes con el meta.json del proyecto. Garantiza que el título de cada paso (y dashedName) coincida con el challengeOrder del meta.
|
||||
|
||||
### How to run script
|
||||
### Cómo ejecutar un script
|
||||
|
||||
1. Change to the directory of the project.
|
||||
2. Run the following npm command:
|
||||
1. Redirígete al directorio del proyecto.
|
||||
2. Ejecuta el siguiente comando npm:
|
||||
|
||||
```bash
|
||||
npm run update-step-titles
|
||||
|
||||
@ -1,76 +1,76 @@
|
||||
This page describes how to contribute to the freeCodeCamp tutorials and projects that are completed using the CodeRoad VS Code extension.
|
||||
Esta página describe cómo contribuir a los tutoriales y proyectos de freeCodeCamp que se complementan usando la extensión CodeRoad de VS Code.
|
||||
|
||||
## How the tutorials work
|
||||
## Cómo funcionan los tutoriales
|
||||
|
||||
The freeCodeCamp tutorials that use CodeRoad each have their own repo under the freeCodeCamp GitHub organization. They all start with `learn-`. For example, `https://github.com/freeCodeCamp/learn-bash-by-building-a-boilerplate/`.
|
||||
Los tutoriales de freeCodeCamp que utilizan CodeRoad tienen cada uno su propio repositorio bajo la organización freeCodeCamp en GitHub. Todos comienzan con `learn-`. Por ejemplo, `https://github.com/freeCodeCamp/learn-bash-by-building-a-boilerplate/`.
|
||||
|
||||
Each tutorial repo has a `main` branch and a "version" branch, e.g. `v1.0.0`.
|
||||
Cada repositorio tiene una rama principal `main` y una "versión" de rama, por ejemplo. `v1.0.0`.
|
||||
|
||||
The two main files on the `main` branch are `TUTORIAL.md` and `coderoad.yaml`. `TUTORIAL.md` contains all the instructions, hints, titles, and so on, for the tutorial. `coderoad.yaml` contains instructions for CodeRoad, such as what commands to run and when, what files to watch for changes, and what version branch to use for the steps.
|
||||
Los dos archivos principales en la rama `main` son `TUTORIAL.md` y `coderoad.yaml`. `TUTORIAL.md` contiene todas las instrucciones, pistas, títulos y todo lo necesario para el tutorial. `coderoad.yaml` contiene instrucciones para CodeRoad, tales como qué comandos correr y cuándo, qué archivos visualizar para cambios, y qué rama de versiones utilizar para los pasos.
|
||||
|
||||
The "version" branch contains the commits that will be loaded on each step of a tutorial. The commit messages on this branch have to be specific. The first commit needs `INIT` for its message and contains all the files to load before the first lesson.
|
||||
La rama de "versión" contiene los commits que serán cargados en cada paso de un tutorial. Los mensajes de commit en esta rama deben ser específicos. El primer commit necesita `INIT` para su mensaje y contiene todos los archivos a cargar antes de la primera lección.
|
||||
|
||||
Subsequent commit messages have to match the step number in `TUTORIAL.md` from the `main` branch. For example, the commit with the message `10.1` will be loaded when a user goes to step `10.1`.
|
||||
Los mensajes de commit subsecuentes deben coincidir con el número de pasos en `TUTORIAL.md` de la rama `main`. Por ejemplo, el commit con el mensaje `10.1` será cargado cuando un usuario va al paso `10.1`.
|
||||
|
||||
In order to make changes to commits on a version branch, you would need to rebase and edit the commits you want to change. This will rewrite the Git history, so we cannot accept PRs to these types of branches. Once a version branch is on the freeCodeCamp repo, it should never change.
|
||||
Para realizar cambios a los commits en una rama de versión, necesitaría realizar un rebase y editar los commits que desea cambiar. Esto sobreescribirá la historia del Git, por lo que no podemos aceptar PRs a ese tipo de ramas. Una vez que una rama de versión está en el repositorio de freeCodeCamp, no debería cambiar nunca.
|
||||
|
||||
> [!WARNING]
|
||||
>
|
||||
> Never make or push changes to a version branch that is on one of the freeCodeCamp repos. Always create a new one
|
||||
> Nunca realice o envíe cambios a una rama de versión que se encuentre en uno de los repositorios de freeCodeCamp. Siempre cree una nueva
|
||||
|
||||
## How to contribute
|
||||
## Cómo contribuir
|
||||
|
||||
### Prerequisites
|
||||
### Requisitos previos
|
||||
|
||||
Install the [CodeRoad CLI tools](https://www.npmjs.com/package/@coderoad/cli) with `npm install -g @coderoad/cli`.
|
||||
Instala [CodeRoad CLI tools](https://www.npmjs.com/package/@coderoad/cli) con `npm install -g @coderoad/cl`.
|
||||
|
||||
There have been some issues with the latest version. If `coderoad --version` doesn't work after installing, downgrade to `0.7.0` with `npm install -g @coderoad/cli@0.7.0`.
|
||||
Ha habido algunos problemas con la última versión. Si `coderoad --version` no funciona después de instalar, baje a la versión `0.7.0` con `npm install -g @coderoad/cli@0.7.0`.
|
||||
|
||||
### Working on `main`
|
||||
### Trabajando en `main`
|
||||
|
||||
This set of instructions is for PRs that only make minor changes on `main` to **existing lessons**. That mainly consists of typo, grammar, hint, and instructional changes or fixes in the `TUTORIAL.md` file.
|
||||
Este conjunto de instrucciones es para PRs que sólo realizan cambios minor (menores) en `main` a **lecciones existentes**. Eso se constituye principalmente de cambios de errores de tipografía, gramática, indicios e instructivos o arreglos en el archivo `TUTORIAL.md`.
|
||||
|
||||
For everything else, including adding or deleting lessons, follow the [working on a version branch instructions](#working-on-version-branch). You will not need to create a new version branch for this - you can create a PR following the instructions below.
|
||||
Para todo lo demás, incluyendo agregando y eliminando lecciones, siga las [instrucciones para trabajar en una rama de versión](#working-on-version-branch). No necesitará crear una nueva rama de versión para esto - puedes crear una PR siguiendo las instrucciones anteriores.
|
||||
|
||||
> [!NOTE]
|
||||
>
|
||||
> These changes will use the existing version branch. If they are substantial, feel free to add them to `CHANGELOG.md`. Most of the time, a good commit message should work
|
||||
> Estos cambios utilizarán la rama de versión existente. Si son sustanciales, siéntase libre de agregarlos a `CHANGELOG.md`. La mayor parte del tiempo, un buen mensaje de commit debería funcionar
|
||||
|
||||
You never need to modify the `tutorial.json` file directly. That will be created with the CLI tools.
|
||||
Nunca necesitas modificar directamente el archivo `tutorial.json`. Esto se creará con las herramientas CLI.
|
||||
|
||||
If you are only making minor changes like fixing a typo or grammatical error, you don't have to test your changes.
|
||||
Si sólo está haciendo cambios menores como corregir un error tipográfico o gramatical, no tiene que probar los cambios.
|
||||
|
||||
Follow these instructions to make a PR, keeping in mind that instructions usually use the lessons around them for context:
|
||||
Siga estas instrucciones para hacer un PR, teniendo en cuenta que las instrucciones usualmente usan las lecciones a su alrededor para el contexto:
|
||||
|
||||
- Create a copy of the latest version branch with `git branch vX.X.X upstream/vX.X.X` - you do not need to check this branch out, it just needs to exist.
|
||||
- Create and checkout a new branch off of `main`
|
||||
- Make **and commit** your changes. Reminder: You don't need to change anything in the `tutorial.json` file. You likely only need to make changes to `TUTORIAL.md`
|
||||
- Run `coderoad build` to recreate the `tutorial.json` file
|
||||
- Commit the changes with `update json` as the message
|
||||
- Make a PR
|
||||
- Crea una copia de la última rama de la versión con `git branch vX.X.X upstream/vX.X.X` - no necesitas verificarla, solo debe existir.
|
||||
- Crea y consulta una nueva bifurcación de `main`
|
||||
- Haz **y envía** tus cambios. Recordatorio: No necesitas cambiar nada en el archivo `tutorial.json`. Es probable que sólo necesite hacer cambios en `TUTORIAL.md`
|
||||
- Ejecute `coderoad build` para recrear el archivo `tutorial.json`
|
||||
- Confirme los cambios con `update json` como mensaje
|
||||
- Hacer un PR
|
||||
|
||||
### Testing changes on `main`
|
||||
### Probando cambios en `main`
|
||||
|
||||
If you want to test your changes to `main` after using the above instructions, follow these instructions:
|
||||
Si deseas probar sus cambios en `main` después de seguir las instrucciones anteriores, sigue estas instrucciones:
|
||||
|
||||
- Follow the instructions on the [rdb-alpha repo](https://github.com/freeCodeCamp/rdb-alpha) to run a container
|
||||
- Start the tutorial using the `tutorial.json` file on the new branch
|
||||
- Siga las instrucciones del [rdb-alpha repo](https://github.com/freeCodeCamp/rdb-alpha) para ejecutar un contenedor
|
||||
- Comienza el tutorial usando el archivo `tutorial.json` en la nueva rama
|
||||
|
||||
### Reviewing PR's to `main`
|
||||
### Revisiando las relaciones públicas en `main`
|
||||
|
||||
If reviewing a PR that only changes `main` with instructional or grammar issues as described above, the changes in `TUTORIAL.md` should match the changes in `tutorial.json`.
|
||||
Si revisa un PR que solo cambia `main` con problemas de instrucción o gramática como se describe anteriormente, los cambios en `TUTORIAL.md` deberían coincidir con los cambios en `tutorial.json`.
|
||||
|
||||
The `tutorial.json` file should not have changes to commit hashes, or step/level ids. Startup or level commands or file watchers likely should not be changed either. There are exceptions if there's an issue with a step, but they should be treated with more caution.
|
||||
El archivo `tutorial.json` no debería tener cambios para los hash de commit, o ids de paso/nivel. Los comandos de inicio o de nivel o los monitores de archivos probablemente no deberían cambiarse. Hay excepciones si hay un problema con un paso, pero deben ser tratados con más precaución.
|
||||
|
||||
Also, keep in mind that instructions usually use the lessons around them for context, so make sure they make sense.
|
||||
Además, ten en cuenta que las instrucciones usualmente usan las lecciones a su alrededor para el contexto, así que asegúrate de que tienen sentido.
|
||||
|
||||
### Working on version branch
|
||||
### Trabajando en la rama de versión
|
||||
|
||||
> [!WARNING]
|
||||
> [!ADVERTENCIA]
|
||||
>
|
||||
> Reminder: Never make or push changes to a version branch that is on one of the freeCodeCamp repos. Always create a new one
|
||||
> Recordatorio: Nunca hacer o enviar cambios a una rama de versión que esté en uno de los repos de freeCodeCamp. Siempre crea una nueva
|
||||
|
||||
There's no easy way to see exactly what changed between version branches since the Git history will be rewritten. Accepting new version branches to use will need to be done with careful consideration and testing.
|
||||
No hay una manera fácil de ver exactamente qué cambió entre las ramas de versiones ya que la historia de Git será reescrita. Accepting new version branches to use will need to be done with careful consideration and testing.
|
||||
|
||||
These instructions are for changing anything on a "version" branch, such as tests, test text, reset files, adding and deleting steps, among other things.
|
||||
|
||||
@ -82,7 +82,7 @@ Follow these instructions to create a new version:
|
||||
- Push the new branch to your fork with `git push -u origin vX.X.Y`
|
||||
- Checkout the `main` branch
|
||||
- Create a new branch off `main`. e.g. `feat/version-X.X.Y`
|
||||
- Change the `uri` in `coderoad.yaml` to your fork of the repo. This is so you and reviewers can test it before pushing it to the freeCodeCamp repo. Change the version to the new branch in the two spots of that file. Add your changes for the new version to `CHANGELOG.md`. Make any other changes you need.
|
||||
- Change the `uri` in `coderoad.yaml` to your fork of the repo. This is so you and reviewers can test it before pushing it to the freeCodeCamp repo. Change the version to the new branch in the two spots of that file. Add your changes for the new version to `CHANGELOG.md`. Haz cualquier otros cambios que necesites.
|
||||
- Commit your changes with the message `feat: release version X.X.Y - <optional description>`
|
||||
- Run `coderoad build` to create a new `tutorial.json` file
|
||||
- Add and commit the file
|
||||
@ -135,4 +135,4 @@ release: version 1.0.0
|
||||
|
||||
If you want to revert to v1.0.0, revert all the commits from `release: version 1.0.1` and after
|
||||
|
||||
- Create a PR. Give it a title of `revert: to version X.X.X`
|
||||
- Crea una PR. Give it a title of `revert: to version X.X.X`
|
||||
|
||||
Reference in New Issue
Block a user