Merge pull request #30 from githubtraining/release

Spanish + Japanese localized versions ready for release
githubtraining · Aug 14, 2019 · bf4badf · bf4badf
2 parents 009d1f6 + 8dfbe03
commit bf4badf
Show file tree

Hide file tree

Showing 33 changed files with 1,188 additions and 0 deletions.
diff --git a/config.yml b/config.yml
@@ -17,6 +17,17 @@ preferences:
     value: cli
   - label: Use Visual Studio Code
     value: vscode
+- type: dropdown
+  name: language
+  label: Language
+  description: Choose your preferred language.
+  options:
+  - label: English
+    value: en
+  - label: Español
+    value: es
+  - label: 日本語
+    value: ja
 before:
 - type: updateBranchProtection
 - type: createIssue
@@ -35,6 +46,13 @@ steps:
 # 1
 - title: Assign yourself
   description: Assign the first issue to yourself.
+  translations:
+    es:
+      title: Asígnate
+      description: Asígnate la primera propuesta. 
+    ja:
+      title: 担当者になろう
+      description: 初めてのイシューの担当者になりましょう。
   event: issues.assigned
   link: '{{ repoUrl }}/issues/1'
   actions:
@@ -48,6 +66,13 @@ steps:
 # 2
 - title: Turn on GitHub Pages
   description: Turn on GitHub Pages in the settings page of the repository.
+  translations:
+    es:
+      title: Activa GitHub Pages
+      description: Activa GitHub Pages en la página de configuración del repositorio. 
+    ja:
+      title: GitHub Pagesを有効化しよう
+      description: リポジトリの設定画面でGitHub Pagesを有効化しましましょう。
   event: page_build
   link: '{{ repoUrl }}/issues/1'
   actions:
@@ -65,6 +90,14 @@ steps:
 # 3
 - title: Close an issue
   description: Cease a conversation by closing an issue.
+  translations:
+    es:
+      title: Cierra una propuesta
+      description: Termina una conversación al cerrar una propuesta. 
+    ja:
+      title: Issueを閉じよう
+      description: Issueを閉じることで議論を終えましょう。
+
   event: issues.closed
   link: '{{ repoUrl }}/issues/1'
   actions:
@@ -84,6 +117,13 @@ steps:
 # 4
 - title: Create a branch
   description: Create a branch for introducing new changes.
+  translations:
+    es:
+      title: Crea una rama
+      description: Crea una rama para introducir nuevos cambios. 
+    ja:
+      title: ブランチを作ろう
+      description: 新しい変更をするためのブランチを作りましょう。
   event: create
   link: '{{ repoUrl }}/issues/2'
   actions:
@@ -96,6 +136,13 @@ steps:
 # 5
 - title: Commit a file
   description: Commit your file to the branch.
+  translations:
+    es:
+      title: Confirma un archivo
+      description: Confirma un archivo a tu rama. 
+    ja:
+      title: ファイルをコミットしよう
+      description: ブランチにファイルをコミットしましょう。
   event: push
   link: '{{ repoUrl }}/issues/2'
   actions:
@@ -109,6 +156,13 @@ steps:
 # 6
 - title: Open a pull request
   description: Open a pull request to propose your new file to the codebase.
+  translations:
+    es:
+      title: Abre una solicitud de extracción
+      description: Abre una solicitud de extracción para proponer agregar tu nuevo archivo al proyecto.
+    ja:
+      title: プルリクエストをオープンしよう
+      description: 新しいファイルをコードベースに追加する提案をするためにプルリクエストをオープンしましょう。 
   event: pull_request
   link: '{{ repoUrl }}/issues/2'
   actions:
@@ -164,6 +218,13 @@ steps:
 # 7
 - title: Respond to a review
   description: Respond to a PR review.
+  translations:
+    es:
+      title: Responde a una revisión
+      description: Responde a una revisión en tu solicitud de extracción.
+    ja:
+      title: レビューに対応しよう
+      description: プルリクエストへのレビューへの対応をしましょう。 
   event: pull_request.synchronize
   link: '{{ repoUrl }}/pull/3'
   actions:
@@ -177,6 +238,13 @@ steps:
 # 8
 - title: Merge your pull request
   description: Make your changes live by merging your PR.
+  translations:
+    es:
+      title: Fusiona tu solicitud de extracción
+      description: Publica tus cambios al fusionar tu solicitud de extracción.
+    ja:
+      title: プルリクエストをマージしよう
+      description: プルリクエストをマージすることで変更を取り込みましょう。   
   event: pull_request.closed
   link: '{{ repoUrl }}/pull/3'
   actions:

diff --git a/responses/es/assign-yourself.md b/responses/es/assign-yourself.md
@@ -0,0 +1,15 @@
+## Paso 1: Asígnate
+
+Las propuestas (issues) que no han sido asignadas no tienen dueños que se encarguen de ellas. Cuando te asignan una propuesta o solicitud de extracción, esto les dice a los visitantes y colaboradores de tu repositorio que tú vas a estar facilitando la conversación o la tarea. 
+
+### :keyboard: Actividad
+
+1. En la parte derecha de tu pantalla, bajo la sección de "Assignees", haz click en el ícono de engrane y seleccionate.  
+
+Para una versión impresa de los pasos en este curso, checa la [Quick Reference Guide]({{ host }}/public/{{ course.slug }}.pdf).
+
+<hr>
+<h3 align="center">Responderé cuando haya detectado que te hayas asignado esta propuesta.</h3>
+
+> _¡A veces respondo muy rápido antes de que la página se actualice! Si ya hiciste una acción esperada y no me ves responder, espera unos segundos y actualiza la página para mostrar los siguientes pasos._
+
diff --git a/responses/es/close-issue.md b/responses/es/close-issue.md
@@ -0,0 +1,14 @@
+## Paso 3: Cierra una propuesta
+
+¡Haz activado GitHub Pages!
+
+Ahora tu sitio es visible para el público. Chécalo en {{ pagesUrl }}.
+
+Ahora que ya completaste las tareas en esta propuesta, ¡es hora de cerrarla! Cerrar una propuesta le dice a los otros colaboradores que esta conversación o tarea en particular ha sido completada. 
+
+### :keyboard: Actividad
+
+1. Haz click en el botón de **Close issue** aquí abajo
+
+<hr>
+<h3 align="center">Responderé cuando hayas cerrado esta propuesta.</h3>
diff --git a/responses/es/commit-something.md b/responses/es/commit-something.md
@@ -0,0 +1,93 @@
+## Paso 5: Confirma un archivo
+
+:tada: ¡Haz creado una rama!
+
+Crear una rama te permite hacer modificaciones a tu proyecto sin tener que cambiar la rama `master`. Ahora que tienes una rama, es hora de crear un archivo y ¡hacer tu primera confirmación de cambios!
+
+<details><summary>Commits 101</summary>
+
+## Commits 101
+
+Cuando hayas terminado de crear o hacer cambios a tu archivo en GitHub, desplázate hasta la parte inferior de la página. Después, encuentra la sección titulada "Commit new file".
+
+En el primer campo, escribe un mensaje de confirmación . El mensaje debe informar a tus colaboradores de forma breve sobre los cambios que has introducido al archivo. 
+
+### Recomendaciones para los mensajes de confirmación:
+
+- No termines tu mensaje con un punto. 
+- Mantén tu mensaje con 50 o menos caracteres. Si es necesario añade detalles extra en la ventana de descripción extendida. Esta se encuentra justo debajo de la línea de asunto. 
+- Usa la voz activa. Por ejemplo, "añade" en vez de "añadí" y "une" en vez de "uní" 
+- Piensa en tu confirmación de cambios como una manera de expresar que quieres introducir una modificación. 
+
+<hr>
+</details>
+
+### :keyboard: Actividad: Tu primera confirmación de cambios
+
+Los siguientes pasos te guiarán a través del proceso de hacer una confirmación de cambios para una modificación en GitHub. 
+
+{% if preferences.gitTool == 'cli' %}
+1. Selecciona tu rama:
+      ```shell
+      git checkout {{ thePayload.ref }}
+      ```
+1. Crea un nuevo archivo llamado `_posts/0000-01-02-{{ user.username }}.md`.
+1. Añade el siguiente contenido a tu archivo:
+      ```yaml 
+      ---
+      layout: slide
+      title: "Welcome to our second slide!"
+      ---
+      Your text
+      Use the left arrow to go back!
+      ```
+1. Añade tu nuevo archivo:
+      ```shell
+      git add _posts/0000-01-02-{{ user.username }}.md
+      ```
+1. Después de añadir tu texto, haz una confirmación de cambios y agrega un mensaje de confirmación, checa el  **Commits 101** drop-down, justo arriba de estas instrucciones:
+      ```shell
+      git commit -m "<YOUR-MESSAGE>"
+      ```
+1. Manda tu nuevo commit a GitHub:
+      ```shell
+      git push
+      ```
+
+{% elsif preferences.gitTool == 'vscode' %}
+1. En el directorio `_posts` , crea un nuevo archivo llamado `0000-01-02-{{ user.username }}.md`. La ruta completa a tu archivo será: `_posts/0000-01-02-{{ user.username }}.md`.
+1. Añade el siguiente contenido a tu archivo y guárdalo:
+      ```yaml 
+      ---
+      layout: slide
+      title: "Welcome to our second slide!"
+      ---
+      Your text
+      Use the left arrow to go back!
+      ```
+1. Para añadir tu nuevo archivo ve a la vista de Source Control y haz clik en el botón  **+** a lado del archivo. También puedes seguir este paso con la [documentación oficial de VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_commit).
+      ![a screenshot of the staging button in the source control view](https://user-images.githubusercontent.com/16547949/53641057-d5b8d100-3bfb-11e9-9b69-53b0661cd5cd.png)
+1. Haz una confirmación de cambios escribiendo un mensaje de confirmación en el campo de texto y después presionando<kbd>Ctrl+Enter</kbd> en Windows o <kbd>Command ⌘+Enter</kbd> en macOS.
+      ![a screenshot of the commit message on VS Code](https://user-images.githubusercontent.com/16547949/53641276-698a9d00-3bfc-11e9-9b3d-01680fd01d7c.png)
+1. Haz click en los puntos suspensivos (...) y selecciona **Push**.
+
+{% else %}
+1. Crea un nuevo archivo en esta rama, en un directorio llamado `_posts` y llámalo `0000-01-02-{{ user.username }}.md`. Lo puedes hacer usando [este atajo]({{ thePayload.repository.html_url }}/new/{{ thePayload.ref }}?filename=_posts/0000-01-02-{{ user.username }}.md) o manualmente de la siguiente manera:
+      - Regresa a la pestaña "Code"
+      - En la lista desplegable de ramas, selecciona "{{ thePayload.ref }}"
+      - Haz click en **Create new file**
+      - En el campo "file name", escribe `_posts/0000-01-02-{{ user.username }}.md`. Escribir `/` en el nombre del archivo va a poner tu archivo automáticamente en el directorio `_posts`.
+1. Cuando hayas acabado de nombrar tu archivo, añade el siguiente contenido a tu archivo:
+      ```yaml
+      ---
+      layout: slide
+      title: "Welcome to our second slide!"
+      ---
+      Your text
+      Use the left arrow to go back!
+      ```
+1. Después de añadir tu texto, puedes hacer una confirmación de cambios al agregar un mensaje de confirmación en el campo text-entry abajo de la vista de edición de archivo. Para más información sobre mensajes de confirmación, checa el desplegable **Commits 101** , justo arriba de estas instrucciones:
+1. Cuando hayas escrito tu mensaje de confirmación , haz click en **Commit new file**
+{% endif %}
+<hr>
+<h3 align="center">Responderé cuando haya detectado una nueva confirmación de cambio en esta rama.</h3>
diff --git a/responses/es/create-a-branch.md b/responses/es/create-a-branch.md
@@ -0,0 +1,70 @@
+## Paso 4: Crea una rama
+
+Completemos el primer paso del flujo de GitHub: crear una rama <sup>[:book:](https://help.github.com/articles/github-glossary/#branch)</sup>.
+
+<details><summary>Creando una rama</summary>
+
+## Creando una rama
+
+:tv: [Video: Ramas](https://www.youtube.com/watch?v=xgQmu81G1yY)
+
+Acabas de aprender cómo crear una rama—el primer paso del flujo de GitHub. 
+
+Las ramas son una parte importante del flujo de GitHub porque nos permite separar nuestro trabajo de la rama principal o `master`. En otras palabras, el trabajo de todos está a salvo mientras aportas contribuciones. 
+
+### Tips para usar ramas
+Un solo proyecto puede tener cientos de ramas, cada una sugiriendo un nuevo cambio a la rama principal o `master`.
+
+La mejor manera de mantener tus ramas organizadas en un equipo es mantenerlas concisas y efímeras. En otras palabras, una sola rama debería representar solamente una nueva característica o una corrección de errores. Esto permite que haya menos confusión entre colaboradores cuando las ramas solamente están activas por unos días antes de que sean fusionadas <sup>[:book:](https://help.github.com/articles/github-glossary/#merge)</sup> con la rama principal o `master`.  
+
+<hr>
+</details>
+
+### :keyboard: Actividad: Tu primera rama
+
+{% if preferences.gitTool == 'cli' %}
+1. Abre tu interfaz de línea de comandos (CLI) preferida, a la cual llamaremos shell de aquí en adelante. 
+1. Clona este repositorio:
+      ```shell
+      git clone {{ thePayload.repository.clone_url }}
+      ```
+1. Navega a este repositorio en tu shell:
+      ```shell
+      cd {{ thePayload.repository.name }}
+      ```
+1. Crea una rama, usa el nombre que quieras. Siéntete libre de usar el nombre sugerido a continuación.  
+      ```shell
+      git branch my-slide
+      ```
+1. Sube la rama a GitHub:
+      ```
+      git push --set-upstream origin <NOMBRE-DE-LA-RAMA>
+      ```
+
+{% elsif preferences.gitTool == 'vscode' %}
+1. Descarga y abre [Visual Studio Code](https://code.visualstudio.com/Download) (referido como VS Code) si aún no lo tienes.
+1. En VS Code, abre Command Palette usando <kbd>Ctrl+Shift+P</kbd> en Windows, o <kbd>Command ⌘+Shift+P</kbd> en macOS. También puedes seguir [la documentación oficial de VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_cloning-a-repository) sobre clonar repositorios.
+1. Escribe `git clone`y presiona <kbd>Enter</kbd>
+      ![una captura de pantalla de vs code con command palette abierto](https://user-images.githubusercontent.com/16547949/53639288-bcf9ec80-3bf6-11e9-9d18-d97167168248.png)
+1. Pega la URL del repositorio en la nueva ventana y presiona <kbd>Enter</kbd>:
+      ```shell
+      {{ thePayload.repository.clone_url }}
+      ```
+1. Selecciona la ubicación en el que quieres guardar el repositorio y haz click en **Choose folder**. Después, abre la ubicación que seleccionaste.  
+1. El directorio del repositiorio debería estar ahora abierto en tu proyecto de VS Code. Haz click en `master` en la parte inferior de la ventana de VS Code. Esto abrirá Command Palette con todos los comandos relacionados a ramas de Git. 
+      ![una captura de pantalla de las ramas de Git en VS Code](https://user-images.githubusercontent.com/16547949/53639606-adc76e80-3bf7-11e9-98ac-bd41ae2b40db.png)
+1. Haz click en **Create new branch** e ingresa cualquier nombre que le quieras dar a tu rama como `mi-rama`. A continuación, presiona <kbd>Enter</kbd>.
+1. Cuando te hagan seleccionar la rama que servirá de referencia para tu nueva rama, selecciona `master`.
+1. Ve a la vista de Source Control, haz click en los punto suspensivos (...) y selecciona **Push**. En la caja de diálogo preguntándote si quieres publicar tu rama, confirma que sí.
+      ![una captura de pantalla de la vista de source control en VS Code](https://user-images.githubusercontent.com/16547949/53640015-ee73b780-3bf8-11e9-8c90-be9022b9555a.png)
+
+{% else %}
+
+1. Navega a la  [pestaña titulada Code]({{ thePayload.repository.html_url }})
+2. Haz click en **Branch: master** en el desplegable
+3. En el campo, ingresa un nombre para tu rama, como `mi-rama`
+4. Haz click en **Create branch: <nombre>** o presiona la tecla "Enter" para crear tu rama
+
+{% endif %}
+<hr>
+<h3 align="center">Responderé cuando haya detectado que una nueva rama ha sido creada en este repositorio.</h3>
diff --git a/responses/es/fix-base.md b/responses/es/fix-base.md
@@ -0,0 +1,10 @@
+Tu rama base debe llamarse `master` (principal). Vamos a abrir una nueva solicitud de extracción para arreglar esto.
+
+1. Haz click en el botón **Edit** que está localizado a la derecha del título de la solicitud de extracción.
+1. Debajo de la cajita del título del comentario, en el menú desplegable "base:", asegúrate que la rama “master” esté seleccionada.
+1. Una ventana pop-up va a aparecer para preguntar si quieres cambiar la "base". Haz click en el botón verde titulado **Change base**
+
+Si necesitas ayuda buscando una solución a tu problema, crea una publicación en [GitHub Community]({{ communityBoard }}). También puedes buscar otras publicaciones acerca de tu problema si otras personas lo han resuelto previamente.
+
+<hr>
+<h3 align="center">Responderé cuando detecte que la base de esta solicitud de extracción haya sido editada.</h3>
diff --git a/responses/es/fix-body.md b/responses/es/fix-body.md
@@ -0,0 +1,14 @@
+Buenas solicitudes de extracción tienen una descripción que les dice a otros colaboradores acerca del cambio que estás sugiriendo. Esto es para que comprendan mejor el contexto.
+
+Editemos esta solicitud de extracción para agregar una descripción.
+
+## :keyboard: Actividad: Arreglando tu solicitud de extracción
+
+1. El primer comentario que tu solicitud de extracción tendrá contendrá el texto predeterminado de **No description provided**. Haz click en el ícono **...** en la esquina superior derecha de la caja de comentario, después haz click en **Edit** para editar.
+1. Agrega una descripción de los cambios que has hecho en la caja de comentario. Si deseas puedes agregar una descripción de tus logros hasta ahora. Recuerda, has: creado una rama, creado un archivo y su confirmación de cambios correspondente, y abriste una solicitud de extracción.
+1. Cuando termines, haz click al botón verde **Update comment** que se encuentra en el lado inferior derecho de la caja de comentario.
+
+Si necesitas ayuda buscando una solución a tu problema, crea una publicación en [GitHub Community]({{ communityBoard }}) . También puedes buscar otras publicaciones acerca de tu problema si otras personas lo han resuelto previamente.
+
+<hr>
+<h3 align="center">Responderé cuando detecte que el cuerpo de esta solicitud de extracción ha sido editado.</h3>
diff --git a/responses/es/fix-filename.md b/responses/es/fix-filename.md
@@ -0,0 +1,39 @@
+Esperaba que tu archivo se llamara **{{ expected }}**.
+
+Editemos esta solicitud de extracción para arreglar ambos issues.
+
+## :keyboard: Actividad: Arregla tu solicitud de extracción
+
+{% if preferences.gitTool == 'cli' %}
+1. Revisa tu rama:
+    ```shell
+    git checkout {{ branch }}
+    ```
+1. Escribe `ls` para ver un listado del contenido de tu directorio de raíz.
+1. Confirma que tienes un directorio llamado `_posts`.
+1. Entra al directorio usando `cd _posts`.
+1. Escribe `ls` para ver un listado de el contenido de tu directorio `_posts`.
+1. Asegúrate que tienes un archivo llamado `{{ expected }}`
+1. Si encuentras que tienes que hacer cambios, entonces añade, confirma tus cambios, y sube esos cambios:
+    ```shell
+    git add .
+    git commit -m "<YOUR-MESSAGE>"
+    git push
+    ```
+{% else %}
+1. Haz click en la pestaña [Files Changed]({{ url }}) en esta solicitud de extracción
+1. Verifica que sólo el archivo que editaste se llame `{{ expected }}`.
+1. Si el archivo tiene el nombre incorrecto, o no esta en el lugar incorrecto, haz click en el ícono de lápiz que se encuentra al lado derecho de la pantalla para editar.
+1. Arriba del contenido del archivo, selecciona "all text" en el campo que contiene el nombre del archivo y bórralo.
+1. Continúa presionando la tecla backspace para también borrar cualquier directorio que exista.
+1. Escribe el nombre de archivo apropiado:
+    ```shell
+    {{ expected }}
+    ```
+1. Desplázate hasta el fondo de la página y escribe un mensaje de confirmación y haz una confirmación de cambios en la sección **Commit Changes** .
+{% endif %}
+
+Si necesitas ayuda buscando solución a tu problema, crea una publicación en [GitHub Community]({{ communityBoard }}) . También puedes buscar otras publicaciones acerca de tu issue si otras personas lo han resuelto previamente.
+
+<hr>
+<h3 align="center">Responderé abajo cuando detecte una confirmación de cambios en esta rama.</h3>
diff --git a/responses/es/head-to-branch.md b/responses/es/head-to-branch.md
@@ -0,0 +1,4 @@
+## ¡Considera esta propuesta terminada! :white_check_mark:
+
+<hr>
+<h3 align="center">Navega a <a href="{{ issueURL }}">la siguiente propuesta</a> ahora!</h3>