diff --git a/config.yml b/config.yml index 5048324..71cc766 100644 --- 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 new file mode 100644 index 0000000..2dbd752 --- /dev/null +++ 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). + +
+

Responderé cuando haya detectado que te hayas asignado esta propuesta.

+ +> _¡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 new file mode 100644 index 0000000..1e3b7d6 --- /dev/null +++ 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 + +
+

Responderé cuando hayas cerrado esta propuesta.

\ No newline at end of file diff --git a/responses/es/commit-something.md b/responses/es/commit-something.md new file mode 100644 index 0000000..f27b408 --- /dev/null +++ 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! + +
Commits 101 + +## 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. + +
+
+ +### :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 "" + ``` +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 presionandoCtrl+Enter en Windows o Command ⌘+Enter 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 %} +
+

Responderé cuando haya detectado una nueva confirmación de cambio en esta rama.

diff --git a/responses/es/create-a-branch.md b/responses/es/create-a-branch.md new file mode 100644 index 0000000..89554dc --- /dev/null +++ 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 [:book:](https://help.github.com/articles/github-glossary/#branch). + +
Creando una rama + +## 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 [:book:](https://help.github.com/articles/github-glossary/#merge) con la rama principal o `master`. + +
+
+ +### :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 + ``` + +{% 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 Ctrl+Shift+P en Windows, o Command ⌘+Shift+P 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 Enter + ![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 Enter: + ```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 Enter. +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: ** o presiona la tecla "Enter" para crear tu rama + +{% endif %} +
+

Responderé cuando haya detectado que una nueva rama ha sido creada en este repositorio.

\ No newline at end of file diff --git a/responses/es/fix-base.md b/responses/es/fix-base.md new file mode 100644 index 0000000..214ed52 --- /dev/null +++ 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. + +
+

Responderé cuando detecte que la base de esta solicitud de extracción haya sido editada.

diff --git a/responses/es/fix-body.md b/responses/es/fix-body.md new file mode 100644 index 0000000..21dc0fb --- /dev/null +++ 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. + +
+

Responderé cuando detecte que el cuerpo de esta solicitud de extracción ha sido editado.

diff --git a/responses/es/fix-filename.md b/responses/es/fix-filename.md new file mode 100644 index 0000000..dcf1eca --- /dev/null +++ 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 "" + 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. + +
+

Responderé abajo cuando detecte una confirmación de cambios en esta rama.

diff --git a/responses/es/head-to-branch.md b/responses/es/head-to-branch.md new file mode 100644 index 0000000..cefbcca --- /dev/null +++ b/responses/es/head-to-branch.md @@ -0,0 +1,4 @@ +## ¡Considera esta propuesta terminada! :white_check_mark: + +
+

Navega a la siguiente propuesta ahora!

diff --git a/responses/es/introduction.md b/responses/es/introduction.md new file mode 100644 index 0000000..e496973 --- /dev/null +++ b/responses/es/introduction.md @@ -0,0 +1,117 @@ +# :wave: Bienvenido a "Introducción a GitHub" de GitHub Learning Lab + +Para empezar, te guiaré a través de unos primeros pasos que son importantes para programar y colaborar en GitHub. + +:point_down: _Esta flecha indica que puedes expandir la ventana! Haz click en ellas durante el curso para más información._ +
¿Qué es GitHub? +
+ +## ¿Qué es GitHub? + +¡Me alegra que lo hayas preguntado! Muchas personas usan GitHub porque quieren contribuir a proyectos de código abierto [:book:](https://help.github.com/articles/github-glossary/#open-source), o porque son invitados por compañeros de trabajo o de clase que usan GitHub en sus proyectos. ¿Por qué la gente usa GitHub en sus proyectos? + +**En esencia, GitHub es una plataforma de colaboración.** + +Desde software hasta documentos legales, puedes contar con GitHub para ayudarte a hacer tu mejor trabajo con las herramientas de colaboración y seguridad que tu equipo necesita. Con GitHub, puedes mantener proyectos completamente privados, invitar al mundo a colaborar y optimizar cada paso de tu proyecto. + +**GitHub también es una poderosa herramienta de versión de control.** + +GitHub usa Git [:book:](https://help.github.com/articles/github-glossary/#git), el software de control de versión más popular para rastrear cada contribución y colaborador [:book:](https://help.github.com/articles/github-glossary/#contributor) de tu proyecto--de esta manera sabrás exactamente de dónde vino cada línea de código de tu proyecto. + +**GitHub ayuda a las personas a hacer mucho más.** + +La gente usa GitHub para construir varias de las tecnologías más avanzadas del mundo. Ya sea que estes visualizando datos o construyendo un nuevo juego, hay una comunidad entera y un set de herramientas en GitHub que te puedan llevar al siguiente nivel. Este curso empieza con lo básico pero ¡profundizaremos el resto después! + +:tv: [Video: ¿Qué es GitHub?](https://www.youtube.com/watch?v=w3jLJU7DT5E) +
+

+ +
Explorando un repositorio de GitHub +
+ +## Explorando un repositorio de GitHub + +:tv: [Video: Explorando un repositorio](https://www.youtube.com/watch?v=R8OAwrcMlRw) + +### Más características + +El video cubre algunas de las características usadas con mayor frequencia. Aquí hay otras cosas que puedes encontrar en los repositorios de GitHub: + +- Tableros para el proyecto: Crear un tablero estilo Kanban para seguir tus tareas dentro de GitHub +- Wiki: Crea y guarda documetación relevante acerca de tu proyecto. +- Estadísticas: Ve un menú desplegable que contiene enlaces a herramientas de análisis para tu repositorio, que incluyen: + - Pulso: Encuentra información sobre el trabajo que ha sido completado y el trabajo que está en progreso en este panel del proyecto. + - Gráficas: Las gráficas proporcionan una vista más granular de la actividad del repositorio, incluyendo quién contribuyó al repositorio, quién lo bifurcó y cuándo completaron el trabajo. + +### Archivos especiales + +En el video aprendiste sobre un archivo especial llamado README.md. Aquí hay una lista de algunos otros archivos especiales que puedes añadir a tus repositorios: + +- CONTRIBUTING.md: El archivo `CONTRIBUTING.md` es usado para describir el proceso para contribuir al repositorio. Un link al archivo `CONTRIBUTING.md` es mostrado cada vez que alguien crea una nueva propuesta o una solicitud de extracción. +- ISSUE_TEMPLATE.md: El archivo `ISSUE_TEMPLATE.md` lo puedes usar para prellenar el cuerpo de una propuesta. Por ejemplo, si siempres necesitas el mismo tipo de información para reportar errores puedes incluirlo en la plantilla de tu propuesta y cada nueva propuesta será abierta con el texto que has recomendado para empezar. + +
+
+ +### Usando las propuestas +Esto es una propuesta [:book:](https://help.github.com/articles/github-glossary/#issue): un lugar en el que puedes tener conversaciones sobre los errores en tu código, revisiones de código y casi cualquier otra cosas que te puedas imaginar. + +Los títulos de tus propuestas son como la línea de sujeto de un email. Avisan de un vistazo a tus colaboradores de que trata tu propuesta. Por ejemplo, el título de esta propuesta es Getting Started with GitHub. + +
Usando GitHub Issues (propuestas) + +## Usando propuestas de GitHub + +Las propuestas se usan para discutir ideas, mejoras, tareas y errores. Facilitan la colaboración al: + +- Proveer a todos (incluso miembros futuros) con la historia completa en un solo lugar +- Permitirte entrelazar tu propuesta con otras propuestas o una solicitud de extracción [:book:](https://help.github.com/articles/github-glossary/#pull-request) +- Crear un registro único y completo de cómo y por qué tomaste ciertas decisiones +- Permitirte atraer fácilmente a las personas y los equipos adecuados a una conversación con @mención +:tv: [Video: Usando propuestas](https://www.youtube.com/watch?v=Zhj46r5D0nQ) + +
+
+ +
Administrando notificaciones +
+ +## Administrando notificaciones + +:tv: [Video: Observando, notificaciones, estrellas y explorar](https://www.youtube.com/watch?v=ocQldxF7fMY) + +Una vez que hayas comentado en una propuesta o solicitud de extracción, empezarás a recibir notificaciones por email cada vez que haya actividad en tu hilo. + +## Cómo silenciar o dejar de silenciar conversaciones en específico. + +1. Ve a la propuesta o solicitud de extracción +2. Bajo _"Notifications"_, haz click en el botón de **Unsubscribe** a la derecha para silenciar notificaciones o **Subscribe** para dejar de silenciarlas. + +Verás una descripción corta que explica tu estado actual de notificaciones. + +### Cómo personalizar notificaciones en Settings + +1. Haz click en el ícono de tu perfil +2. Haz click en **Settings** +3. Haz click en **Notifications** desde el menú a tu izquierda y [ajusta tus preferencias de notificaciones](https://help.github.com/articles/managing-notification-delivery-methods/) + +### Opciones de notificación de un repositorio + +* **Watch**: Recibirás una notificación cuando una nueva propuesta, solicitud de extracción o comentario ha sido publicado y también cuando una propuesta ha sido cerrado o una solicitud de extracción ha sido fusionada. +* **Not watching**: No vas a recibir notificaciones al menos que te hayan mencionado usando @ +* **Ignore**: No vas a recibir ningún tipo de notificación sobre este respoitorio + +## Cómo revisar las notificaciones de los repositorios que estás observando + +1. Haz click en tu ícono de perfil +2. Haz click en **Settings** +3. Haz click en **Notification** desde el menú a tu izquierda +4. Haz click en el link de [repositorios que estás observando](https://github.com/watching) +5. Selecciona la pestaña **Watching** +6. Haz click en el botón de **Unwatch** para inhabilitar las notificaciones o en **Watch** para habilitarlas. + +
+
+ +
+

Sigue leyendo a continuación para encontrar tu primera tarea

diff --git a/responses/es/open-a-pr.md b/responses/es/open-a-pr.md new file mode 100644 index 0000000..6847202 --- /dev/null +++ b/responses/es/open-a-pr.md @@ -0,0 +1,30 @@ +## Paso 6: Abre una solicitud de extracción + +Buen trabajo haciendo esa confirmación de cambios :sparkles: + +Ahora que has creado una confirmación de cambios, ¡es hora de compartir los cambios que propones por medio de una solicitud de extracción! Mientras que las propuestas fomentan la discusión con otros colaboradores de un proyecto, las solicitudes de extracción te ayudan a compartir tus cambios, recibir notas acerca de tus cambios y sguir trabajando en tus cambios hasta que estén perfectos! + +
¿Qué es una solicitud de extracción? + +## Solicitudes de extracción + +Pensemos de nuevo en el flujo de GitHub. Has creado una rama, agregaste un archivo, e hiciste una confirmación de cambios de ese archivo en tu rama. Ahora es hora de colaborar en tu archivo con otros estudiantes que toman esta clase. Esta colaboración sucede dentro de una solicitud de extracción. Ve este video para aprender más: + +:tv: [Video: Introducción a las solicitudes de extracción](https://youtu.be/kJr-PIfLDl4) +
+
+ +Esta solicitud de extracción mantendrá los cambios que hiciste dentro de tu rama y propondrá aplicarlos a la rama `master`. + +### :keyboard: Actividad: Crea una solicitud de extracción + +1. Abre una solicitud de extracción usando [este atajo]({{ url }}) o manualmente así: + - Desde la pestaña "Pull requests", haz click en **New pull request** + - En la lista desplegable llamada "base:", asegúrate que la rama "master" esté seleccionada + - En la lista desplegable llamada "compare:", selecciona "{{ branch | remove: 'refs/heads/' }}" +1. Cuando hayas seleccionado tu rama, escribe un título para tu solicitud de extracción. Por ejemplo `Add {{ user.username }}'s file` +1. El siguiente campo te ayuda a agregar una descripción de los cambios que has hecho. Agrega una descripción de los cambios que has hecho hasta ahora. Recordatorio, has: creado una rama, creado un archivo e iniciado la confirmación de cambios correspondiente y por último has abierto una solicitud de extracción +1. Dale click a **Create pull request** + +
+

Responderé dentro de tu nueva solicitud de extracción.

diff --git a/responses/es/pr-succeeds.md b/responses/es/pr-succeeds.md new file mode 100644 index 0000000..996175d --- /dev/null +++ b/responses/es/pr-succeeds.md @@ -0,0 +1,33 @@ +## Paso 8: Fusiona tu solicitud de extracción + +Bien hecho @{{ user.username }}! :sparkles: + +Has creado una solicitud de extracción satisfactoriamente, y ha pasado todas las pruebas. Ahora puedes fusionar tu solicitud de extracción. + +### :keyboard: Actividad: Fusiona tu solicitud de extracción + +{% if preferences.gitTool == 'cli' %} +1. Usa el checkout para cambiarte a la rama `master`: + ```shell + git checkout master + ``` +2. Fusiona tu rama: + ```shell + git merge {{ branch }} + ``` +3. Sube tu historial de fusión a GitHub: + ```shell + git push + ``` +4. Elimina tu rama localmente: + ```shell + git branch -d {{ branch }} + ``` +{% else %} +1. Haz click en **Merge pull request** +1. Haz click en **Confirm merge** +{% endif %} +1. Cuando tu rama se haya fusionado, ya no la vas a necesitar. Haz click en **Delete branch**. + +
+

Responderé cuando esta solicitud de extracción se haya fusionado.

diff --git a/responses/es/reminder-delete.md b/responses/es/reminder-delete.md new file mode 100644 index 0000000..192b27f --- /dev/null +++ b/responses/es/reminder-delete.md @@ -0,0 +1,35 @@ +## Buen trabajo + +![celebra](https://octodex.github.com/images/collabocats.jpg) + +Felicidades @{{ user.username }}, ¡has completedo este curso! + +## Qué fue lo que funcionó + +Ahora que has acabado el curso has implementado tu conjunto de diapositivas [aquí](https://{{ user.username }}.github.io/{{ repo }}) y has pasado por el flujo de GitHub. + +Antes de decir adiós, aquí te mostramos un resumen de todas las tareas que completaste en tu repositorio: + +- Aprendiste sobre las propuestas, las solicitudes de extracción, y la estructura de un repositorio en GitHub +- Aprendiste sobre qué son las ramas en GitHub +- Creaste una confirmación de cambios +- Viste y respondiste a revisiones de solicitudes de extracción +- Editaste un archivo ya existente +- Habilitaste GitHub Pages +- ¡Hiciste tu primera contribución! :tada: + +## ¿Qué sigue? + +Esperamos que este curso te haya ayudado a sentirte más a gusto usando GitHub. Recuerda: Siempre eres bienvenido(a) a repetir los temas del curso si necesitas más práctica. Si estás listo para aprender más, aquí te presentamos algunas ideas. + +### Contribuye an un proyecto + +Para encontrar proyectos en los que puedes contribuir por medio de temas actuales y colecciones comisariadas, revisa [GitHub Explore](https://github.com/explore). + +### Sigue aprendiendo + +Encuentra aquí abajo sugerencias sobre los cursos que puedes tomar en el futuro: +- [GitHub Pages]({{ host }}/githubtraining/github-pages): Continúa aprendiendo acerca de GitHub Pages. Este fue un tema que tocamos brevemente en este curso. +- [Comunicación usando Markdown]({{ host }}/githubtraining/communicating-using-markdown): Usamos un poco del formato Markdown en este curso, pero si quieres aprender todo acerca sobre su sintaxis :sparkles:, toma el curso! + +[¿Qué más aprenderás]({{ host }}/courses)? diff --git a/responses/es/reopen.md b/responses/es/reopen.md new file mode 100644 index 0000000..104823c --- /dev/null +++ b/responses/es/reopen.md @@ -0,0 +1,9 @@ +### :keyboard: Actividad: Vuelve a abrir tu solicitud de extracción + +Oooops! Parece que has cerrado tu solicitud de extracción accidentalmente. + +1. Haz click en **Reopen pull request**. Si este botón esta inactivo, primero tendrás que hacer click en **Restore branch** . +1. Fusiona tu pull request. + +
+

Responderé cuando esta solicitud de extracción haya sido fusionada.

diff --git a/responses/es/request-changes.md b/responses/es/request-changes.md new file mode 100644 index 0000000..b56260a --- /dev/null +++ b/responses/es/request-changes.md @@ -0,0 +1,44 @@ +## Paso 7: Responde a una revisión + +¡Tu solicitud de extracción se ve súper bien! + +Agreguemos contenido a tu archivo. Reemplaza la línea 5 de tu archivo con una cita textual o con un meme y una leyenda chistosa. Recuerda: Usar el formato [Markdown](https://guides.github.com/features/mastering-markdown/) es aceptado. + +### :keyboard: Actividad: Actualiza tu archivo + +{% if preferences.gitTool == 'cli' %} +1. Usa el comando checkout para cambiar de rama: + ```shell + git checkout {{ branch }} + ``` +1. Abre el archivo `_posts/0000-01-02-{{ user.username }}.md`. +1. Reemplaza la línea 5 de tu archivo con algo nuevo. +1. Añade tus nuevos cambios: + ```shell + git add _posts/0000-01-02-{{ user.username }}.md + ``` +1. Haz una confirmación de cambios para las modificaciones que acabas de hacer: + ```shell + git commit -m "" + ``` +1. Sube tus cambios a GitHub: + ```shell + git push + ``` + +{% elsif preferences.gitTool == 'vscode' %} +1. Abre el archivo `_posts/0000-01-02-{{ user.username }}.md`. +1. Reemplaza la línea 5 de tu archivo con algo nuevo. +1. Añade tus nuevos cambios. Recuerda: puedes hacer esto desde la vista de Source Control, haz click en el símbolo **+** al lado del archivo. +1. Haz una confirmación de cambios. Puedes hacer esto desde la vista de Source Control, incluyendo un mensaje de confirmación en el recuadro de texto y después presionando Ctrl+Enter en Windows o Command ⌘+Enter en macOS. +1. Sube tus cambios a GitHub. En la vista de Source Control, haz click en los puntos suspensivos (...), y selecciona **Push**. + +{% else %} +1. Haz click en [Files Changed tab]({{ url }}) en esta solicitud de extracción +1. Haz click en el ícono de lápiz que puedes encontrar al lado derecho de tu pantalla para editar el archivo que acabas de agregar. +1. Reemplaza la línea 5 con algo nuevo. +1. Navega hacia abajo y haz click en **Commit Changes** +{% endif %} + +
+

Responderé cuando detecte una confirmación de cambios en esta rama

diff --git a/responses/es/turn-on-gh-pages.md b/responses/es/turn-on-gh-pages.md new file mode 100644 index 0000000..6014112 --- /dev/null +++ b/responses/es/turn-on-gh-pages.md @@ -0,0 +1,20 @@ +## Paso 2: Activa GitHub Pages + +:tada: ¡Ahora eres el supervisor de esta propuesta! Ahora que te has autodesignado, las personas que vean tu propuesta sabrán que su participación es bienvenida, pero tú estás encargado(a) de llevar esta propuesta hasta el punto final :sunglasses:. + +### Usemos GitHub Pages + +¡Ahora a lo que venimos! GitHub Pages te permite servir un sitio estático basado en un repositorio. Hemos llenado este repositorio con contenido de sitio, pero el sitio aún no es visible. Cambiemos eso. + +### :keyboard: Actividad: Habilita GitHub Pages + +1. Haz click en la pestaña [**Settings**]({{ repoUrl }}/settings) de este repositorio +1. Navega a la sección de GitHub Pages +1. En la lista llamada "Source" selecciona **master branch** + +> Nota: Aunque puedes ver una opción para escoger un tema, no apliques ningún tema en este momento. Hemos protegido el código para que no puedas hacer cambios involuntarios. Tendrás oportunidad de usar un tema cuando terminemos el curso. + +
+

Responderé en esta propuesta cuando detecte que GitHub Pages haya implementado tu página .

+ +> Activar GitHub Pages crea una implementación de tu repositorio. Me podré tomar hasta un minuto para responder mientras espero que la implementación termine. diff --git a/responses/es/your-first-contribution.md b/responses/es/your-first-contribution.md new file mode 100644 index 0000000..7fd7446 --- /dev/null +++ b/responses/es/your-first-contribution.md @@ -0,0 +1,10 @@ +### Introducción al flujo de GitHub + +Ahora que te has familiarizado con issues, usemos esta propuesta para seguir el camino a tu primera contribución. + +Diferentes personas usan diferentes flujos de trabajo para contribuir a proyectos de software, pero la forma más simple y efectiva de contribuir en GitHub es con el flujo de GitHub. + +:tv: [Video: Entendiendo el flujo de GitHub](https://www.youtube.com/watch?v=PBI2Rz-ZOxU) + +
+

Sigue leyendo para ver los siguientes pasos

diff --git a/responses/ja/assign-yourself.md b/responses/ja/assign-yourself.md new file mode 100755 index 0000000..639315b --- /dev/null +++ b/responses/ja/assign-yourself.md @@ -0,0 +1,14 @@ +## ステップ1:担当者になろう + +イシューに担当者が設定されていない状態では、誰がオーナーかがわかりません。イシューやプルリクエストの担当になることで、リポジトリを見に来る人やコントリビュートしようとしている人たちにそのタスクの議論をリードするのはあなたであると示すことが出来ます :muscle:。 + +### :keyboard: やってみよう + +1. スクリーンの右側の「Assignees」セクションで、ギアアイコンをクリックし自分を選択しましょう。 + +このコースのステップを印刷したい場合は、[Quick Reference Guide]({{ host }}/public/{{ course.slug }}.pdf)を参照ください。 + +
+

このイシューにあなたが担当になったのを検知したら、このイシューに追加のコメントを書き込みます。

+ +> _時々、追加のコメントが書き込まれないことがあります!正しい操作をしたにも関わらず何のコメントも書き込まれない場合は、数秒待ってからこのページを再読込してください。_ diff --git a/responses/ja/close-issue.md b/responses/ja/close-issue.md new file mode 100755 index 0000000..1164fb8 --- /dev/null +++ b/responses/ja/close-issue.md @@ -0,0 +1,14 @@ +## ステップ3:イシューをクローズしよう + +GitHub Pagesの有効化に成功しました! + +サイトはパブリックに見えるようになっています。こちらから確認してみましょう {{ pagesUrl }} 。 + +このイシューでのタスクは完了ですので、クローズしましょう!イシューを閉じることによって、他のコントリビューターにこのタスクについての議論は終了したと知らせることが出来ます。 + +### :keyboard: やってみよう + +1. 下の**Close issue**ボタンをクリックしましょう + +
+

このイシューがクローズされたらコメントを書き込みます。

diff --git a/responses/ja/commit-something.md b/responses/ja/commit-something.md new file mode 100755 index 0000000..7c97bf5 --- /dev/null +++ b/responses/ja/commit-something.md @@ -0,0 +1,93 @@ +## ステップ5:ファイルをコミットしよう + +:tada: ブランチを作成できました! + +ブランチを作成することで、`master`ブランチに変更を加えることなくプロジェクトへの修正を行うことができるようになります。さて、ブランチの作成が完了したので、次はファイルを作成し、初めてのコミットを行いましょう! + +
コミットの基礎 + +## コミットの基礎 + +GitHub上で新しいファイルを作成したり、ファイルの修正をし終えたら、ページの下にスクロースしましょう。"Commit new file"セクションが見つかるはずです。 + +最初のフィールドにはコミットメッセージを入力します。コミットメッセージでは、このファイルに対して行った変更を他の人に完結に伝える必要があります。 + +### コミットメッセージを書く際の決まり: + +- コミットメッセージの終わりにピリオドは付けない +- コミットメッセージは50文字以内とする。必要であれば、詳細な情報は追加の詳細フィールドに記載する。これはタイトルのラインのすぐ下にあるフィールドです +- 現在形を使う。例えば、「追加した」の代わりに「追加する」を書いたり、「マージした」の代わりに「マージする」と書く +- ファイルを変更する上での意図を書く + +
+
+ +### :keyboard: やってみよう:初めてのコミット + +下記の手順に従うことによって、GitHub上に変更をコミットすることが出来ます。 + +{% if preferences.gitTool == 'cli' %} +1. ブランチをチェックアウトしましょう: + ```shell + git checkout {{ thePayload.ref }} + ``` +1. `_posts/0000-01-02-{{ user.username }}.md`という名前の新しいファイルを作成しましょう。 +1. ファイルに下記の内容を追記しましょう: + ```yaml + --- + layout: slide + title: "2枚目のスライドにようこそ!" + --- + 何かを書く。 + 戻るには戻るボタンを使いましょう! + ``` +1. 新しいファイルをステージに追加しましょう: + ```shell + git add _posts/0000-01-02-{{ user.username }}.md + ``` +1. テキストを追加し、変更とコミットメッセージをコミットしたら、手順のすぐ上にある**コミットの基礎**ドロップダウンを開き内容を確認しましょう: + ```shell + git commit -m "" + ``` +1. Push your new commit to GitHub: + ```shell + git push + ``` + +{% elsif preferences.gitTool == 'vscode' %} +1. `_posts`フォルダに`0000-01-02-{{ user.username }}.md`という名前の新しいファイルを作成しましょう。ファイルのパスは`_posts/0000-01-02-{{ user.username }}.md`となるはずです。 +1. ファイルに以下の内容を追加し、保存しましょう: + ```yaml + --- + layout: slide + title: "2枚目のスライドにようこそ!" + --- + 何かを書く。 + 戻るには戻るボタンを使いましょう! + ``` +1. 新しいファイルをステージに追加するには:Source Controlビューに移動し、ファイルの横にある**+**ボタンをクリックしましょう。[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. テキストフィールドにコミットメッセージを入力し、Windowsの場合はCtrl+Enter、macOSの場合はCommand ⌘+Enterを押すことで変更をコミットしましょう。 + ![a screenshot of the commit message on VS Code](https://user-images.githubusercontent.com/16547949/53641276-698a9d00-3bfc-11e9-9b3d-01680fd01d7c.png) +1. ...をクリックし、**Push**を選択しましょう。 + +{% else %} +1. このブランチに新しいファイルを作成しましょう。`_posts`フォルダーに`0000-01-02-{{ user.username }}.md`という名前のファイルを作成します。[このリンクをクリックする]({{ thePayload.repository.html_url }}/new/{{ thePayload.ref }}?filename=_posts/0000-01-02-{{ user.username }}.md)か、以下の手順でファイルを作成することが出来ます: + - "Code"タブに戻る + - ブランチドロップダウンにて、"{{ thePayload.ref }}"を選択 + - **Create new file**をクリック + - "file name"フィールドに`_posts/0000-01-02-{{ user.username }}.md`と入力する。ファイル名の中に`/`を入れることで自動的にそのファイルを`_posts`ディレクトリに保存することが出来ます。 +1. ファイルの名前を入力したら、以下の内容をファイルに追加する: + ```yaml + --- + layout: slide + title: "2枚目のスライドにようこそ!" + --- + 何かを書く。 + 戻るには戻るボタンを使いましょう! + ``` +1. テキストを追加後、ファイル編集ビューのすぐ下にあるテキスト入力フィールドにコミットメッセージを入れることで、この変更をコミットすることが出来ます。コミットメッセージのガイドラインとしては、手順のすぐ上にある**コミットの基礎**を参照してください。 +1. コミットメッセージを入力したら、**Commit new file**をクリック +{% endif %} +
+

このブランチに新しいコミットが行われたら、追加のコメントを書き込みます。

diff --git a/responses/ja/create-a-branch.md b/responses/ja/create-a-branch.md new file mode 100755 index 0000000..eb36deb --- /dev/null +++ b/responses/ja/create-a-branch.md @@ -0,0 +1,71 @@ +## ステップ4:ブランチを作ろう + +GitHubフローの最初のステップに取り掛かりましょう:つまりブランチの作成です[:book:](https://help.github.com/articles/github-glossary/#branch)。 + +
ブランチの作成 + +## ブランチの作成 + +:tv: [Video: Branches](https://www.youtube.com/watch?v=xgQmu81G1yY) + +さて、GitHubフローの最初のステップとしてブランチの作成方法を学びました。 + +ブランチを作ることによって`master`ブランチからあなたの作業を分離することができるため、ブランチはGitHubフローにおいて重要な役割を果たします。言い換えれば、誰もが安全な場所でコントリビュートを始めることができるのです。 + +### ブランチを使う際のコツ + +1つのプロジェクトの中にブランチは何百と作成され、それぞれが`master`ブランチへの変更の提案となります。 + +これらのブランチをチーム全体で管理可能な状態を保つには一つ一つのブランチを完結で短命に保つことが必要です。言い換えると、1つの新しい機能か1つのバグフィックスごとに1つのブランチを作成するべきです。こうすることで、ブランチが`master`ブランチにマージ [:book:](https://help.github.com/articles/github-glossary/#merge) されるまでのアクティブな期間を数日に保つことができ、他のコントリビューターが混乱する可能性を減らすことが出来ます。 + +
+
+ +### :keyboard: やってみよう:初めてのブランチ + +{% if preferences.gitTool == 'cli' %} +1. お好みのコマンドラインインターフェースを開きましょう。ここからはそのコマンドラインインターフェースのことをシェルと呼びます。 +1. このリポジトリをクローンしましょう: + ```shell + git clone {{ thePayload.repository.clone_url }} + ``` +1. シェル上でリポジトリに移動しましょう: + ```shell + cd {{ thePayload.repository.name }} + ``` +1. ブランチを作成しましょう。ブランチ名は好きな名前で大丈夫です。下記の名前をそのまま使っても構いません: + ```shell + git branch my-slide + ``` +1. ブランチをGitHubにプッシュしましょう: + ``` + git push --set-upstream origin + ``` + +{% elsif preferences.gitTool == 'vscode' %} +1. もちまだインストールしていないのであれば[Visual Studio Code](https://code.visualstudio.com/Download) (VS Codeと呼ばれます)をダウンロードし、起動しましょう。 +1. VS Codeの中で、コマンドパレットを開きましょう。コマンドパレットを開くには、WindowsではCtrl+Shift+P、macOSではCommand ⌘+Shift+Pを押します。クローンの際には[VS Codeの公式ドキュメント](https://code.visualstudio.com/docs/editor/versioncontrol#_cloning-a-repository)にも手順が記載されています。 +1. `git clone`と入力し、Enterを押します。 + ![a screenshot of vs code with the command palette open](https://user-images.githubusercontent.com/16547949/53639288-bcf9ec80-3bf6-11e9-9d18-d97167168248.png) +1. 新しいウィンドウにリポジトリのURLを貼り付け、Enterを押します: + ```shell + {{ thePayload.repository.clone_url }} + ``` +1. リポジトリを保存する場所を選択し、**Choose folder** をクリックします。その後、選択したフォルダーを開きましょう。 +1. リポジトリのフォルダーがVS Codeのプロジェクトに開かれているはずです。VS Codeのウィンドウの左下にある`master`をクリックしましょう。Gitブランチに関連するコマンドが表示されたコマンドパレットが表示されるはずです。 + ![a screenshot of the Git branches in VS Code](https://user-images.githubusercontent.com/16547949/53639606-adc76e80-3bf7-11e9-98ac-bd41ae2b40db.png) +1. **Create new branch** をクリックし、好きなブランチ名を入力しましょう。例えば`my-slide`といったものです。その後、Enterを押します。 +1. どのrefからブランチを作成するか尋ねられた場合、`master`を選択しましょう。 +1. Source Controlビューに移動し、...をクリックし **Push** を選択します。ブランチを公開するか尋ねるダイアログボックスを確認しましょう。 + ![a screenshot of the source control view in VS Code](https://user-images.githubusercontent.com/16547949/53640015-ee73b780-3bf8-11e9-8c90-be9022b9555a.png) + +{% else %} + +1. [Codeタブ]({{ thePayload.repository.html_url }})に移動しましょう +2. **Branch: master** ドロップダウンをクリックしましょう +3. 入力フィールドに、例えば`my-slide`のように、作成するブランチの名前を入力しましょう +4. **Create branch: ** をクリックするか、"Enter"キーを押し、ブランチを作成しましょう + +{% endif %} +
+

このリポジトリで新しいブランチが作成されたら、新しいコメントを書き込みます。

diff --git a/responses/ja/fix-base.md b/responses/ja/fix-base.md new file mode 100755 index 0000000..025aac0 --- /dev/null +++ b/responses/ja/fix-base.md @@ -0,0 +1,12 @@ +ベースブランチは`master`である必要があります。新しいプルリクエストを作成し、これを修正しましょう。 + +### :keyboard: やってみよう:プルリクエストのマージ先の修正 + +1. プルリクエストのタイトルの右側にある**Edit**ボタンをクリックしましょう +1. タイトルのコメントボックスの下の"base:"ドロップダウンメニューで"master"が選択されている事を確認しましょう +1. "base"を変更してよいかどうかを確認するポップアップウィンドウが表示されます。緑の**Change base**ボタンをクリックしましょう + +もしなにか問題に遭遇し、解決するのに助けが必要であれば、[GitHub Community]({{ communityBoard }})に書き込んでください。他の人が過去に解決した問題を検索することも出来ます。 + +
+

このプルリクエストのベースが修正されたら、新しいコメントを書き込みます。

diff --git a/responses/ja/fix-body.md b/responses/ja/fix-body.md new file mode 100755 index 0000000..17efd4f --- /dev/null +++ b/responses/ja/fix-body.md @@ -0,0 +1,15 @@ +良いプルリクエストというものは、他のメンバーが見た時にどいうった変更をしようとしているのかを理解できるよう、本文に説明が書かれているものです。 + +このプルリクエストに本文の説明を追加してみましょう。 + +## :keyboard: やってみよう:プルリクエストの修正 + +1. プルリクエストの最初のコメントはデフォルトのテキストである**No description provided**と書かれているでしょう。コメントボックスの右上にある **...** アイコンをクリックし、次に **Edit** をクリックして修正をしましょう +1. コメントボックスに変更についての説明を記載しましょう。ここまでに行ってきたことについて、自由に記載しましょう。ちなみに、ここまででこれらの事をやってきています:ブランチの作成、新規ファイルの作成、コミットの追加、プルリクエストの作成 +1. コメントボックスの下の緑の **Update comment** ボタンをクリックしましょう + + +もしなにか問題に遭遇し、解決するのに助けが必要であれば、[GitHub Community]({{ communityBoard }})に書き込んでください。他の人が過去に解決した問題を検索することも出来ます。 + +
+

プルリクエストの本文が修正されたら、新しいコメントを書き込みます

diff --git a/responses/ja/fix-filename.md b/responses/ja/fix-filename.md new file mode 100755 index 0000000..0392f16 --- /dev/null +++ b/responses/ja/fix-filename.md @@ -0,0 +1,39 @@ +ファイルは **{{ expected }}** という名前で作成する必要があります。 + +これを解決するためにプルリクエストを編集してみましょう。 + +## :keyboard: やってみよう:プルリクエストの修正 + +{% if preferences.gitTool == 'cli' %} +1. ブランチをチェックアウトします: + ```shell + git checkout {{ branch }} + ``` +1. `ls` と入力し、ルートディレクトリの中を表示します。 +1. `_posts` という名前のフォルダがある事を確認します。 +1. `cd _posts` と実行してフォルダの中に移動します。 +1. `_posts` フォルダの中を確かめるために `ls` と入力します。 +1. `{{ expected }}` という名前のファイルがあることを確認します。 +1. なにか修正が必要なものがあれば、その変更を行いステージ、コミット、プッシュを実行します: + ```shell + git add . + git commit -m "" + git push + ``` +{% else %} +1. プルリクエストの中の[Files Changedタブ]({{ url }})をクリックします。 +1. 変更が行われたファイルが `{{ expected }}` というファイルであることを確認します。 +1. もしそのファイル名が間違っていたり、正しい場所に無い場合は、画面右側の鉛筆アイコンをクリックし、ファイルを編集します。 +1. ファイルの中身が表示されている部分の上のファイル名が含まれているテキストフィールドの内容を選択し削除します。 +1. バックスペースキーを押し続け、ディレクトリ名も削除します。 +1. 正しいファイル名を入力します: + ```shell + {{ expected }} + ``` +1. 画面を下までスクロールし、**Commit Changes**にてコミットメッセージを入力してコミットします。 +{% endif %} + +もしなにか問題に遭遇し、解決するのに助けが必要であれば、[GitHub Community]({{ communityBoard }})に書き込んでください。他の人が過去に解決した問題を検索することも出来ます。 + +
+

このブランチにコミットが行われたら、新しいコメントを書き込みます。

diff --git a/responses/ja/head-to-branch.md b/responses/ja/head-to-branch.md new file mode 100755 index 0000000..010065b --- /dev/null +++ b/responses/ja/head-to-branch.md @@ -0,0 +1,4 @@ +## このイシューは完了です! :white_check_mark: + +
+

さあ次のイシューに進みましょう!

diff --git a/responses/ja/introduction.md b/responses/ja/introduction.md new file mode 100755 index 0000000..f66bd61 --- /dev/null +++ b/responses/ja/introduction.md @@ -0,0 +1,119 @@ +# :wave: GitHubラーニングラボの"Introduction to GitHub"コースへようこそ + +まずはじめに、GitHubを使ってコーディングをしたりコラボレーションするのに大事ないくつかのポイントを紹介しましょう。 + +:point_down: _この矢印は中身を展開することが出来ます!より詳細な情報が必要なときにはコース中のこの矢印をクリックしましょう_ +
GitHubとはなにか? +
+ +## GitHubとはなにか? + +よくぞ聞いてくれました!多くの人がGitHubにアクセスするのは、オープンソース [:book:](https://help.github.com/articles/github-glossary/#open-source) プロジェクトにコントリビュートするためであったり、チームメイトやクラスメイトが彼らのプロジェクトでGitHubを使っていてそこに招待されたからです。では、なぜ人々はプロジェクトにGitHubを使うのでしょうか? + +**GitHubはコラボレーションプラットフォームです。** + +ソフトウェアから法的文書まで、GitHub上でのコラボレーションとチームが必要とするセキュリティツールによって、最善の仕事をすることができるのです。GitHubを使えば、プロジェクトを完全にプライベートにする事もできますし、世界中のメンバーとコラボレーションすることも出来ますし、プロジェクトのプロセスを円滑にすることも出来ます。 + +**GitHubは強力なバージョン管理ツールでもあります。** + +GitHubではGit [:book:](https://help.github.com/articles/github-glossary/#git) という、最も有名なオープンソースのバージョン管理ソフトウェアを使っており、プロジェクトの全てのコントリビュートとコントリビューター [:book:](https://help.github.com/articles/github-glossary/#contributor) を追跡出来ます。これによって、ソースコードのあらゆる行が誰がいつかいたのかを把握することが出来ます。 + +**GitHubは人々がより多くの事を成し遂げる助けとなります** + +GitHubは世界で最も先進的な技術を構築することに使われています。データの可視化であろうと、新しいゲームの作成だろうと、GitHub上には皆さんが次のレベルに到達するためのコミュニティとツールが揃っています。このコースは基本からスタートしますが、後半は徐々に深掘りしていきます! + +:tv: [ビデオ:GitHubとはなにか?](https://www.youtube.com/watch?v=w3jLJU7DT5E) +
+

+ +
GitHubリポジトリ概観 +
+ +## GitHubリポジトリ概観 + +:tv: [ビデオ:GitHubリポジトリ概観](https://www.youtube.com/watch?v=R8OAwrcMlRw) + +### さらなる機能 + +ビデオではGitHubで最も使われる機能のうちの一部を紹介しました。GitHubリポジトリでお使いいただける他の機能もいくつかここでご紹介します: + +- プロジェクトボード:GitHub上でカンバンスタイルのタスク管理ボードを作成することが出来ます +- Wiki:プロジェクトのドキュメントを書くことが出来ます +- Insights:以下のようなリポジトリの解析ツールへのリンクが表示されます: + - Pulse:このプロジェクトダッシュボードでは完了した作業や実施中の作業についての情報を見つけることが出来ます + - Graphs:誰がリポジトリにコントリビュートしているのか、誰がフォークしているのか、いつ作業を完成させたのかといったリポジトリに関するより詳細な情報を提供します + +### 特別なファイル + +ビデオの中で、README.mdという名前の特別なファイルについて学びました。以下はリポジトリに追加できる他の特別なファイルです: + +- CONTRIBUTING.md: `CONTRIBUTING.md`はリポジトリに対してコントリビュートするためのプロセスを記載するのに使います。新しいイシューやプルリクエストを作成する際に、`CONTRIBUTING.md`ファイルへのリンクが表示されます。 +- ISSUE_TEMPLATE.md: `ISSUE_TEMPLATE.md`はイシューの本文に事前に含めておくことができる内容を記載するファイルです。例えば、バグ報告には常に同じ種類の情報が必要な場合、イシューテンプレートにその内容を含ることで、新しくイシューを作成する際に常にテンプレートの内容が入力された状態で表示されます。 + +
+
+ +### イシューを使ってみよう + +今皆さんが見ているのはイシュー [:book:](https://help.github.com/articles/github-glossary/#issue) です:ここではあなたのコードのバグやコードレビューについて議論したり、他のあらゆる事を議論する事ができる場所です。 + +イシュータイトルはメールの件名のようなものです。そのイシューがどういったものなのかをひと目で分かるようにするためのものです。例えば、このイシューのタイトルは「GitHubを始めよう」です。 + +
GitHubイシューを使ってみよう + +## GitHubイシューを使ってみよう + +イシューはアイデアや機能追加、タスク、バグについて議論するにの使われます。イシューを使うことによって以下のような理由でコラボレーションをやりやすくします: + +- 全員(将来のチームメンバーに対しても)に完全な話の流れを1つの場所で提供する +- 他のイシューやプルリクエスト [:book:](https://help.github.com/articles/github-glossary/#pull-request) へのクロスリンクを貼ることができる +- どのようにして、なぜある意思決定をしたのかについて1つの場所に網羅的な記録を残すことができる +- @メンションを使うことで、議論に参加することが必要なメンバーやチームを簡単に呼ぶことができる + +:tv: [ビデオ;イシューを使ってみよう](https://www.youtube.com/watch?v=Zhj46r5D0nQ) + +
+
+ +
通知の管理 +
+ +## 通知の管理 + +:tv: [ビデオ:ウォッチ、通知、スター、探索](https://www.youtube.com/watch?v=ocQldxF7fMY) + +一度イシューやプルリクエストにコメントを書くと、そのスレッドについてのメール通知を受け取るようになります。 + +### 特定の会話の通知のオン/オフのやり方 + +1. イシューやプルリクエストに移動 +2. 画面右側の _"Notifications"_ セクションにて、通知をオフにするには**Unsubscribe**ボタン、通知をオンにするには **Subscribe** ボタンを押す。 + +ここでは現在の通知設定がどうなっているかが記載されています。 + +### Settings での通知のカスタマイズ方法 + +1. プロフィールアイコンをクリック +2. **Settings** をクリック +3. 画面左側のメニューにある **Notifications** をクリックし、 [通知の設定を行う](https://help.github.com/articles/managing-notification-delivery-methods/) + +### リポジトリの通知設定 + +* **Watch**: 新しいイシューやプルリクエスト、コメントが作られた時や、イシューがクローズされた時、プルリクエストがマージされた時に通知が送られる +* **Not watching**: @メンションされた時以外は通知が送られる +* **Ignore**: リポジトリからの通知は全く送られない + +### ウォッチしているリポジトリの通知の設定方法 + +1. プロフィールアイコンをクリック +2. **Settings** をクリック +3. 画面左側のメニューにある **Notification** をクリック +4. [repositories you’re watching](https://github.com/watching) リンクをクリック +5. **Watching** タブを選択 +6. 通知を無効化するには **Unwatch** ボタン、有効化する **Watch** ボタンをクリック + +
+
+ +
+

次に最初のタスクが書き込まれます

diff --git a/responses/ja/open-a-pr.md b/responses/ja/open-a-pr.md new file mode 100755 index 0000000..778768a --- /dev/null +++ b/responses/ja/open-a-pr.md @@ -0,0 +1,31 @@ +## ステップ6:プルリクエストを作ろう + +コミットの作成に成功しました :sparkles: + +コミットの作成が完了したので、次にプルリクエストによって変更を提案してみましょう!イシューでは他のメンバーと議論をすることが行われますが、プルリクエストではあなたが行った変更を共有し、その変更についてのフィードバックをもらい、完璧になるまでそれを繰り返すのです! + +
プルリクエストとはなにか? + +## プルリクエスト + +GitHubフローを思い返してみましょう。ブランチの作成をし、ファイルを追加し、ブランチにそのファイルをコミットしました。次にこのファイルについて他のメンバーとコラボレートしましょう。プルリクエスト上でコラボレーションを行います。詳細はこのビデオを御覧ください: + +:tv: [ビデオ:プルリクエストの紹介](https://youtu.be/kJr-PIfLDl4) +
+
+ +このプルリクエストは、ブランチに対して行った変更を保持し、`master`ブランチへ取り込むためのものです。 + +### :keyboard: やってみよう:プルリクエストの作成 + +1. [このリンク]({{ url }})をクリックするか、下記手順によってプルリクエストを作成しましょう: + - "Pull requests"タブから、**New pull request**をクリックしましょう + - "base:"ドロップダウンメニューでは、"master"が選択されている事を確認しましょう + - "compare:"ドロップダウンメニューでは、"{{ branch | remove: 'refs/heads/' }}"を選択しましょう + - "Create pull request"ボタンを押しましょう +1. ブランチを選択したら、プルリクエストのタイトルを入力しましょう。例えば`{{ user.username }}のファイルを追加`などです。 +1. 次のフィールドには、行った変更の説明を記載します。ここまでに行ってきたことについて、自由に記載しましょう。ちなみに、ここまででこれらの事をやってきています:ブランチの作成、新規ファイルの作成、コミットの追加、プルリクエストの作成 +1. **Create pull request**をクリックしましょう + +
+

新しいプルリクエストが作成されたら、そこにコメントを書き込みます

diff --git a/responses/ja/pr-succeeds.md b/responses/ja/pr-succeeds.md new file mode 100755 index 0000000..7c9dab0 --- /dev/null +++ b/responses/ja/pr-succeeds.md @@ -0,0 +1,33 @@ +## ステップ8:プルリクエストをマージしよう + +よく出来ました、@{{ user.username }}! :sparkles: + +無事にプルリクエストを作成し、全部のテストが成功しました。プルリクエストをマージする準備が出来ました。 + +### :keyboard: やってみよう:プルリクエストのマージ + +{% if preferences.gitTool == 'cli' %} +1. `master`ブランチをチェックアウトする: + ```shell + git checkout master + ``` +2. ブランチをマージする: + ```shell + git merge {{ branch }} + ``` +3. マージされた履歴をGitHubにプッシュする: + ```shell + git push + ``` +4. ローカルブランチを削除する: + ```shell + git branch -d {{ branch }} + ``` +{% else %} +1. **Merge pull request**をクリックする +1. **Confirm merge**をクリックする +{% endif %} +1. 一度ブランチがマージされたら、もはやそのブランチは必要ありません。**Delete branch**をクリックしましょう。 + +
+

このプルリクエストがマージされたら、新しいコメントを書き込みます。

diff --git a/responses/ja/reminder-delete.md b/responses/ja/reminder-delete.md new file mode 100755 index 0000000..0a425c1 --- /dev/null +++ b/responses/ja/reminder-delete.md @@ -0,0 +1,35 @@ +## よく出来ました + +![celebrate](https://octodex.github.com/images/collabocats.jpg) + +おめでとう、@{{ user.username }}。このコースは完了です! + +## このコースでやったこと + +ここまでで、[ここ](https://{{ user.username }}.github.io/{{ repo }})にサイトをデプロイし、GitHub Flowを体験してきました。 + +コースを完了する前に、このリポジトリで達成したタスクを振り返ってみましょう: + +- イシュー、プルリクエスト、GitHubリポジトリの構成について学びました。 +- ブランチについて学びました。 +- コミットを作成しました。 +- プルリクエストのレビューやレビューに対する返答をしました。 +- 既存のファイルを変更しました。 +- GitHub Pagesを有効化しました。 +- はじめてのコントリビュートを行いました! :tada: + +## 次のステップ + +このコースでGitHubに慣れてもらえると嬉しいです。忘れないでください、更に練習が必要だと思うのであれば、このコースを何度も繰り返し実行することができるのです。もっと新しいスキルを身に着けたいのであれば、いくつかおすすめがあります。 + +### プロジェクトにコントリビュートする + +コントリビュートする対象として、トレンドのトピックや厳選されたプロジェクトのコレクションを見つけたいのであれば、[GitHub Explore](https://github.com/explore)をチェックしてみましょう。 + +### 学び続けましょう + +次に学ぶのにおすすめのコース: +- [GitHub Pages]({{ host }}/githubtraining/github-pages):このコースでも触れたGitHub Pagesについて更に学習することができます。 +- [Communicating using Markdown]({{ host }}/githubtraining/communicating-using-markdown):このコースではMarkdownはほんの少しだけ使いましたが、Markdownの :sparkles: 記法を学びたいのであればこのコースを受講しましょう! + +[次は何を学びましょう]({{ host }}/courses)? diff --git a/responses/ja/reopen.md b/responses/ja/reopen.md new file mode 100755 index 0000000..8e9473d --- /dev/null +++ b/responses/ja/reopen.md @@ -0,0 +1,9 @@ +### :keyboard: やってみよう:プルリクエストのリオープン + +おおっっと!どうやら間違えてプルリクエストをクローズしてしまったようです。 + +1. **Reopen pull request**をクリックしましょう。もしこのボタンが押せないのであれば、先に**Restore branch**をクリックする必要があります。 +1. プルリクエストをマージしましょう。 + +
+

このプルリクエストがマージされたら、新しいコメントを書き込みます。

diff --git a/responses/ja/request-changes.md b/responses/ja/request-changes.md new file mode 100755 index 0000000..4fadb28 --- /dev/null +++ b/responses/ja/request-changes.md @@ -0,0 +1,44 @@ +## ステップ7:レビュー対応をしよう + +正しくプルリクエストが作成できました! + +ファイルになにか追加してみましょう。ファイルの5行目をなにか新しい内容で置き換えてみましょう。忘れないでください:[Markdown](https://guides.github.com/features/mastering-markdown/)が使えます。 + +### :keyboard: やってみよう:ファイルの変更 + +{% if preferences.gitTool == 'cli' %} +1. ブランチをチェックアウトします: + ```shell + git checkout {{ branch }} + ``` +1. `_posts/0000-01-02-{{ user.username }}.md` を開きます。 +1. ファイルの5行目をなにか新しい内容で置き換えます。 +1. 新しい変更をステージします: + ```shell + git add _posts/0000-01-02-{{ user.username }}.md + ``` +1. 変更をコミットします: + ```shell + git commit -m "" + ``` +1. 変更をGitHubにプッシュします: + ```shell + git push + ``` + +{% elsif preferences.gitTool == 'vscode' %} +1. `_posts/0000-01-02-{{ user.username }}.md`を開きます。 +1. ファイルの5行目をなにか新しい内容で置き換えます。 +1. 新しい変更をステージします。もう一度言いますが、Source Controlビューでファイルの横の **+** をクリックすることでステージすることができます。 +1. 変更をコミットします。Source Controlビューでテキストフィールドにコミットメッセージを入力し、Windowsの場合はCtrl+Enter、macOSの場合はCommand ⌘+Enterと入力することでコミットすることができます。 +1. 変更をGitHubにプッシュします。Source Controlビューで、...をクリックし、 **Push** を選択しましょう。 + +{% else %} +1. このプルリクエストの[Files Changedタブ]({{ url }})をクリックします。 +1. 画面右側の ... アイコンの中の "Edit file" をクリックし、新しく追加されたファイルを編集します。 +1. ファイルの5行目をなにか新しい内容で置き換えます。 +1. 画面の下にスクロールし、**Commit Changes** をクリックします。 +{% endif %} + +
+

このブランチへのコミットが行われたら、新しいコメントを書き込みます。

diff --git a/responses/ja/turn-on-gh-pages.md b/responses/ja/turn-on-gh-pages.md new file mode 100755 index 0000000..4fc043e --- /dev/null +++ b/responses/ja/turn-on-gh-pages.md @@ -0,0 +1,20 @@ +## ステップ2:GitHub Pagesを有効化しよう + +:tada: おめでとうございます、無事にこのイシューの担当者になりました!担当者に設定することで、このイシューを見かけた人が参加しやすくなりますが、今回は自分でタスク自体もやってしまいましょう。 :sunglasses: + +### GitHub Pagesを使ってみよう + +GitHub Pagesはリポジトリから静的サイトを作る機能です。いくつかサイトのコンテンツをこのリポジトリに用意しておいたのですが、まだそのコンテンツのサイトは見えるようになっていません。設定を変更してみましょう。 + +### :keyboard: やってみよう:GitHub Pagesの有効化 + +1. このリポジトリの[**Settings**]({{ repoUrl }}/settings)タブをクリックしましょう +1. "GitHub Pages"のセクションまでスクロールダウンしましょう +1. "Source"ドロップダウンから、**master branch** を選択しましょう + +> 注意:テーマを選択できる設定が目に入ったとしても、現時点ではテーマの適用はしないでおきましょう。意図しない変更が入らないよう、コードは保護されています。コースが完了したら、テーマを設定できるようになります。 + +
+

GitHub Pagesのサイトがデプロイされたら、このイシューにコメントを書き込みます。

+ +> GitHub Pagesを有効化すると、リポジトリのデプロイ処理が実行されます。デプロイを検知するまでに1分ほどかかることがあります。 diff --git a/responses/ja/your-first-contribution.md b/responses/ja/your-first-contribution.md new file mode 100755 index 0000000..e26d050 --- /dev/null +++ b/responses/ja/your-first-contribution.md @@ -0,0 +1,10 @@ +### GitHubフローの紹介 + +さてイシューに慣れてきたところで、このイシューを使ってあなたの初めてのコントリビュートの道筋をたどってみましょう。 + +プロジェクトによってコントリビュートのフローは異なりますが、GitHub上で最もシンプルで最も効率的なコントリビュートのやり方はGitHubフローです。 + +:tv: [ビデオ:GitHubフローを理解する](https://www.youtube.com/watch?v=PBI2Rz-ZOxU) + +
+

以下を読み進めて、次のステップに移りましょう