diff --git a/terminal_tutorial.md b/terminal_tutorial.md index 8adcd2549..8d4af86e7 100644 --- a/terminal_tutorial.md +++ b/terminal_tutorial.md @@ -86,7 +86,7 @@ This tutorial is also available in [other languages](/translations/README.md) | [English](/terminal_tutorial.md) | [Bangla](/translations/terminal_tutorial/terminal_tutorial.ben.md) | [Chinese (Traditional)](/translations/terminal_tutorial/terminal_tutorial.zho-tc.md) | [German](/translations/terminal_tutorial/terminal_tutorial.ger.md) | [Hindi](/translations/terminal_tutorial/terminal_tutorial.hin.md) | | :----: | :----: | :----: | :----: | :----: | -| [Portuguese (Brazilian)](/translations/terminal_tutorial/terminal_tutorial.por-br.md) | [Ukrainian](/translations/terminal_tutorial/terminal_tutorial.ukr.md) | +| [Portuguese (Brazilian)](/translations/terminal_tutorial/terminal_tutorial.por-br.md) | [Ukrainian](/translations/terminal_tutorial/terminal_tutorial.ukr.md) | [Spanish](/translations/terminal_tutorial/terminal_tutorial.spa.md) > Translations for projects documentations are welcome. Read [`Translation Guide`](/translations/README.md) to contribute. diff --git a/translations/terminal_tutorial/terminal_tutorial.spa.md b/translations/terminal_tutorial/terminal_tutorial.spa.md new file mode 100644 index 000000000..52e177465 --- /dev/null +++ b/translations/terminal_tutorial/terminal_tutorial.spa.md @@ -0,0 +1,385 @@ +# [Contribute To This Project](https://syknapse.github.io/Contribute-To-This-Project/) + + + +> Logo creado con :sparkling_heart: por [CandidDeer](https://github.com/CandidDeer) + +[][twit] + +[](https://discord.gg/tWkvS4ueVF '¡Únete a nuestro servidor de Discord!') +[](https://syknapse.github.io/Contribute-To-This-Project/) +[](https://syknapse.github.io/Contribute-To-This-Project/) + +--- + +> ## **Anuncio:** +> +> ¿Te gustaría convertirte en mantenedor de este proyecto y ayudar a mantenerlo activo? Si estás interesado, lee la [guía de mantenedores](/maintainer_guide.md) y envíame un mensaje directo en [Twitter](https://twitter.com/Syknapse). + +--- + +### Índice de acceso rápido + +#### Vista general + +- [Anuncios](#announcement) +- [Introducción](#introduction) +- [¿Para quién es esto?](#who-is-this-for) +- [¿Por qué necesito hacer esto?](#why-do-i-need-to-do-this) +- [¿A qué voy a contribuir?](#what-am-i-going-to-contribute) +- [Traducciones](#translations) +- [Configuración](#setup-) +- [Próximos pasos](#next-steps) +- [Agradecimientos](#acknowledgements) +- [Top 100 Contribuidores](#top-100-contributors) + +#### Pasos + +- [Contribuir](#contribute) +- [Paso 1 - Fork](#step-1-fork-this-repository) +- [Paso 2 - Clonar](#step-2-clone-the-repository) +- [Paso 3 - Crear una nueva rama](#step-3-create-a-new-branch) +- [Paso 4 - Abrir el archivo index.html](#step-4-open-the-indexhtml-file) +- [Paso 5 - Copiar la plantilla de tarjeta](#step-5-copy-the-card-template) +- [Paso 6 - Aplicar tus cambios](#step-6-apply-your-changes) +- [Paso 7 - Hacer commit](#step-7-commit-your-changes) +- [Paso 8 - Hacer push a GitHub](#step-8-push-your-changes-to-github) +- [Paso 9 - Enviar un PR](#step-9-submit-a-prpull-request) +- [Paso 10 - Celebrar](#step-10-celebrate) + +--- + +## Introducción + +Aquí aprenderemos cómo contribuir a este proyecto o a GitHub/Git utilizando la _Terminal_. +Este es un tutorial para ayudar a contribuyentes primerizos a participar en un proyecto simple y fácil. + +### Objetivos + +- Realizar una contribución a un proyecto de código abierto. +- Sentirte más cómodo usando GitHub. + +### ¿Para quién es esto? + +- Esto es para principiantes absolutos. Si sabes cómo escribir y editar una etiqueta `` puedes hacerlo. +- También es para quienes ya tienen un poco de experiencia pero quieren hacer su primera contribución open source, o sumar más contribuciones para ganar experiencia y confianza. + +### ¿Por qué necesito hacer esto? + +Cualquier desarrollador web, aspirante o experimentado, necesita usar el control de versiones Git, y GitHub es el servicio de hosting de Git más popular utilizado por todos. También es el corazón de la comunidad de código abierto. Sentirse cómodo usando GitHub es una habilidad esencial. Hacer una contribución a un proyecto aumenta tu confianza y te da algo que mostrar en tu perfil de GitHub. + +Si eres un desarrollador nuevo y te preguntas si necesitas aprender Git y GitHub, aquí tienes la respuesta: +[Deberías haber aprendido Git ayer (eng., You Should've Learned Git Yesterday)](https://codeburst.io/number-one-piece-of-advice-for-new-developers-ddd08abc8bfa '¿Eres un desarrollador nuevo? Deberías haber aprendido Git ayer. por Brandon Morelli, creador de CodeBurst.io'). + +### ¿A qué voy a contribuir? + + + +Vas a contribuir una tarjeta como esta en la [página web del proyecto](https://syknapse.github.io/Contribute-To-This-Project/ 'https://syknapse.github.io/Contribute-To-This-Project'). Incluirá tu nombre, tu usuario de Twitter, una descripción corta y 3 enlaces a recursos útiles para desarrolladores web. + +Harás una copia de la plantilla dentro del archivo HTML y la personalizarás con tu información. + +--- + +### Traducciones + +Este tutorial también está disponible en [otros idiomas](/translations/README.md) + +| [English](/terminal_tutorial.md) | [Bangla](/translations/terminal_tutorial/terminal_tutorial.ben.md) | [Chinese (Traditional)](/translations/terminal_tutorial/terminal_tutorial.zho-tc.md) | [German](/translations/terminal_tutorial/terminal_tutorial.ger.md) | [Hindi](/translations/terminal_tutorial/terminal_tutorial.hin.md) | +| :----: | :----: | :----: | :----: | :----: | +| [Portuguese (Brazilian)](/translations/terminal_tutorial/terminal_tutorial.por-br.md) | [Ukrainian](/translations/terminal_tutorial/terminal_tutorial.ukr.md) | [Spanish](/translations/terminal_tutorial/terminal_tutorial.spa.md) + +> Las traducciones de la documentación del proyecto son bienvenidas. Leer [`Guía de traducciones`](/translations/README.md) para contribuir. + +--- + +### ¡Configuración! :) + +> [!Note] +> Si no eres bueno con la interfaz de línea de comandos, aquí tienes el [tutorial GUI usando GitHub Desktop](/README.md) + +Primero configuremos todo para comenzar. + +1. Inicia sesión en tu cuenta de GitHub. Si aún no tienes cuenta, puedes [crear una aquí](https://github.com/join). Se recomienda completar el [tutorial GitHub Hello World](https://guides.github.com/activities/hello-world/) antes de continuar. +2. Si no tienes Git instalado, [descárgalo desde aquí](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) + +> Ahora que ya tienes todo configurado, continuemos con la tarea de contribuir al proyecto. + +[↑ Volver arriba ↑](#quick-access-index) + +--- + +### Contribuir + +Conviértete en contribuidor open source en 10 pasos fáciles. + +_Tiempo estimado: Menos de 30 minutos._ + +#### Paso 1: Hacer un fork de este repositorio + +- El objetivo aquí es hacer una copia de este proyecto y colocarla en tu cuenta. +- Un repositorio (repo) es como se llama a un proyecto en GitHub y un fork es una copia del mismo. +- Asegúrate de estar en la [página principal](https://github.com/Syknapse/Contribute-To-This-Project 'https://github.com/Syknapse/Contribute-To-This-Project') de este repositorio. + +|  | +| :---------------------------------------------: | +| **Haz clic en el botón _Fork_** | + +- Ahora tienes una copia completa del proyecto en tu propia cuenta. + +[↑ Volver arriba ↑](#quick-access-index) + +--- + +### Paso 2: Clonar el repositorio + +- Ahora queremos hacer una copia local del proyecto. Es decir, una copia guardada en tu propia máquina. + + + +- Ahora clona este repositorio en tu máquina. Haz clic en el botón de clonar y luego en el icono de copiar al portapapeles. +- Un repositorio (repo) es como se llama a un proyecto en GitHub y un fork es una copia del mismo. + +Abre la terminal y ejecuta el siguiente comando: + +```bash +git clone "url que acabas de copiar" +``` + +Por ejemplo: + +```bash +git clone https://github.com/$Username/Contribute-To-This-Project.git +``` + +donde `$Username` es tu nombre de usuario de GitHub. Aquí estás copiando el contenido del repositorio first-contributions en GitHub a tu computadora. + +[↑ Volver arriba ↑](#quick-access-index) + +--- + +#### Paso 3: Crear una nueva rama + +Cambia al directorio del repositorio en tu computadora (si aún no estás allí): + +```bash +cd Contribute-To-This-Project +``` + +Ahora crea una nueva rama usando el comando `git checkout` + +```bash +git checkout -b tu-nombre-de-rama-nueva +``` + +Por ejemplo: + +```bash +git checkout -b add-$Username-card +``` + +Nota: Cambia `$Username` con tu nombre de usuario de GitHub. + +- Ahora has creado una nueva rama separada de la master. +- Para los siguientes pasos, asegúrate de estar trabajando en esta rama. Verás el nombre de la rama en la que estás en la parte inferior izquierda del editor de texto que estés usando, donde dice `$Username-card` como nombre de tu rama. + +**NO trabajes en la rama `master`** + +[↑ Volver arriba ↑](#quick-access-index) + +--- + +#### Paso 4: Abrir el archivo index.html + +Ahora necesitamos abrir el archivo que vamos a editar con tu editor de código favorito. Nosotros usamos [VSCode](https://code.visualstudio.com/) como nuestro editor de código preferido. + +- El archivo `index.html` está directamente en la carpeta `Contribute-To-This-Project`. +- Puedes abrir el archivo con el siguiente comando: + +```bash +code index.html +``` + +Nota: Este es un código de terminal para abrir el archivo: `index.html` en `VSCode`. + +- Ahora tienes el archivo que vas a editar abierto en tu editor y estás listo para comenzar a hacer cambios en él. + +[↑ Volver arriba ↑](#quick-access-index) + +--- + +#### Paso 5: Copiar la plantilla de la tarjeta + +- Haremos una copia de la plantilla de la tarjeta para comenzar a trabajar en ella +- En la parte superior del archivo html, debajo del `
` justo dentro del elemento ``, hay disponible `