Skip to content

Commit

Permalink
Merge pull request #45 from minhducnguyen26/update-README
Browse files Browse the repository at this point in the history
Separate markdown files for different languages
  • Loading branch information
hturner authored Oct 18, 2022
2 parents fae274f + d580277 commit 61f7d84
Show file tree
Hide file tree
Showing 5 changed files with 237 additions and 132 deletions.
5 changes: 3 additions & 2 deletions Contributors.md
Original file line number Diff line number Diff line change
Expand Up @@ -752,6 +752,7 @@
- [Rafael Molina](https://github.com/RafaGrey)
- [billyderringer](https://github.com/billyderringer)
- [Grom](https://github.com/gromms)
- [Minh Nguyen](https://github.com/minhducnguyen26)
- [matt011](https://github.com/matt011)
- [lakshan](https://github.com/Lakshangit)
- [shivanshu1086](https://github.com/shivanshu1086)
Expand Down Expand Up @@ -5240,7 +5241,7 @@
- [Hari Kuduva](https://github.com/sriharikuduva)
- [Kinsey Favre](https://github.com/kinstalinist)
- [Taylor Prescott](https://github.com/taycott3)
Rohan Das
- Rohan Das
- [Brandon Meeks](https://github.com/brandon-meeks)
- [Lee](https://github.com/lnsykalski)
- [Jacob Brown](https://github.com/Gamerick)
Expand Down Expand Up @@ -10223,4 +10224,4 @@
- [Sean Cassiere](https://github.com/SeanCassiere)
- [Evelyn Greeves](https://github.com/evelyngreeves)
- [Sophie Breitbart](https://github.com/sbreitbart)
- [Woodspock](https://github.com/woodspock)
- [Woodspock](https://github.com/woodspock)
38 changes: 36 additions & 2 deletions Languages/German.md → README-translations/README_de.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@

# Erste Beiträge

| <img alt="RStudio" src="../assets/rstudio-logo.png" width="300"> | RStudio Edition |
| ---------------------------------------------------------------- | --------------- |

Dieses Repo ist eine zerstückelte, abgespeckte und für RStudio angepasste Version des Erstaunlichen [Erste Beiträge](https://github.com/firstcontributions/first-contributions) Repository (und ist nicht offiziell mit RStudio verbunden). Sehen Sie sich das Original-Repo an, um Anweisungen zur Verwendung anderer Tools und Sprachübersetzungen zu erhalten.

## Einleitung
Expand Down Expand Up @@ -34,10 +36,15 @@ Beim Schreiben dieses Leitfadens habe ich eine Reihe von Annahmen getroffen:

Forken Sie dieses Repo, indem Sie auf die Fork-Schaltfläche oben auf dieser Seite klicken.

<img width="300" src="../assets/fork.png" alt="fork this repository" style = "display: inline;" />
<br/>

Dadurch wird eine Kopie dieses Repositorys in Ihrem Konto erstellt und Sie werden zu dieser Version des Repositorys weitergeleitet.

Sie müssen jetzt die URL für Ihr Repo abrufen. Klicken Sie auf „ Klonen oder herunterladen“ und kopieren Sie die URL in das Feld.

<img width="300" src="../assets/rstudio-gh-clone.png" alt="clone the repo" style = "display: inline;" />
<br/>

## Erstellen Sie ein neues Projekt

Expand All @@ -53,15 +60,25 @@ Wählen Sie abschließend aus, wo das geklonte Repo gespeichert werden soll, ind

Wenn Sie fertig sind, klicken Sie auf „Create Project“, um das Repo zu klonen und das Projekt einzurichten.

Das Repo wird nun in den von Ihnen angegebenen Ordner geklont.
<img width="300" src="../assets/rstudio-clone.png" alt="Git" style = "display: inline;" />
<br/>

Das Repo wird nun in den von Ihnen angegebenen Ordner geklont.

## Erstellen Sie einen Zweig

Klicken Sie auf der Registerkarte „Git“ oben rechts auf die Schaltfläche „Neuer Zweig“.

<img width="500" src="../assets/git-tab-location.jpg" alt="Git tab" style = "display: inline;" />
<br/>
<img width="300" src="../assets/rstudio-new-branch-button.png" alt="Create a new branch" style = "display: inline;" />
<br/>

Benennen Sie Ihren Branch "add-your-name", zum Beispiel: "add-nic-crane".

<img width="300" src="../assets/rstudio-new-branch-button2.png" alt="name your branch" style = "display: inline;" />
<br/>

Stellen Sie sicher, dass „Zweig mit Remote synchronisieren“ aktiviert ist und klicken Sie auf „Erstellen“. Möglicherweise werden Sie aufgefordert, Ihren GitHub-Benutzernamen und Ihr Passwort einzugeben.


Expand All @@ -71,22 +88,39 @@ Stellen Sie sicher, dass „Zweig mit Remote synchronisieren“ aktiviert ist un

Sie werden sehen, dass neben der Datei ein „M“ steht. Aktivieren Sie das Kontrollkästchen daneben und klicken Sie dann auf „Commit“.

<img width="300" src="../assets/rstudio-add.png" alt="commit button" style = "display: inline;" />
<br/>

Sie sehen eine Diff-Datei mit den Änderungen, die Sie an der Datei vorgenommen haben. Fügen Sie eine Commit-Nachricht hinzu – eine Zusammenfassung der von Ihnen vorgenommenen Änderungen – und klicken Sie dann auf „Commit“. Ein Kästchen erscheint, um die Übergabe zu bestätigen; klicken Sie auf "Schließen".

<img width="400" src="assets/rstudio-commit-message.png" alt="commit dialog" style = "display: inline;" />
<br/>

## Pushen Sie Änderungen an GitHub

Herzlichen Glückwunsch, Sie haben alle Änderungen an Ihrer lokalen Kopie Ihres Zweigs Ihres Fork of first-contributions festgeschrieben. Klicken Sie nun auf „Push“, um Ihren Commit mit dem Remote-Repo zu synchronisieren.

<img width="500" src="assets/rstudio-push1.png" alt="push button" style = "display: inline;" />
<br/>

Sie sehen ein Kästchen wie dieses, wenn Ihre Änderungen erfolgreich übertragen wurden. Klicken Sie auf „Schließen“.

<img width="400" src="../assets/rstudio-push2.png" alt="git output log" style = "display: inline;" />
<br/>


## Reichen Sie Ihre Änderungen zur Überprüfung ein

Wenn Sie auf Github zu Ihrem Repository gehen, sehen Sie die Schaltfläche „Compare & Pull Request“. Klicken Sie auf diese Schaltfläche.

<img width="500" style = "display: inline;" src="../assets/compare-and-pull.png" alt="create a pull request" />
<br/>

Stellen Sie sicher, dass Sie Gabeln vergleichen. Links sollte der Master-Branch des ursprünglichen Repos sein, und rechts sollte der neue Branch sein, den Sie in Ihrem Repo erstellt haben. Nachdem Sie die richtigen Optionen ausgewählt und eine kurze Zusammenfassung der vorgenommenen Änderungen geschrieben haben, senden Sie die Pull-Anforderung, indem Sie auf „Pull-Anforderung erstellen“ klicken.

<img width="500" style = "display: inline;" src="../assets/submit-pull-request.png" alt="submit pull request" />
<br/>

Bald werde ich alle Ihre Änderungen in den Master-Zweig dieses Projekts zusammenführen. Sie erhalten eine Benachrichtigungs-E-Mail, sobald die Änderungen zusammengeführt wurden!

Glückwunsch! Sie haben gerade den Standard-Workflow _fork -> clone -> edit -> PR_ abgeschlossen, dem Sie als Mitwirkender oft begegnen werden!
Expand Down
145 changes: 145 additions & 0 deletions README-translations/README_es.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,145 @@
## Primera contribución

| <img alt="RStudio" src="../assets/rstudio-logo.png" width="300"> | RStudio Edition |
| ---------------------------------------------------------------- | --------------- |

Este repositorio es una versión cortada, recortada y personalizada para RStudio del increíble repositorio [primeras contribuciones](https://github.com/firstcontributions/first-contributions) (y no está afiliado oficialmente con RStudio). Consulte el repositorio original para obtener instrucciones sobre el uso de otras herramientas y traducciones de idiomas.

---

## Introducción

Es dificil. Siempre es difícil cuando haces algo por primera vez. Especialmente cuando estás colaborando, cometer errores no es algo cómodo. Pero el código abierto tiene que ver con la colaboración y el trabajo conjunto. Queríamos simplificar la forma en que los nuevos colaboradores de código abierto aprenden y contribuyen por primera vez.

Leer artículos y ver tutoriales puede ayudar, pero ¿qué es mejor que hacer las cosas sin estropear nada? Este proyecto tiene como objetivo proporcionar orientación y simplificar la forma en que los novatos hacen su primera contribución. Recuerde que cuanto más relajado esté, mejor aprenderá. Si está buscando hacer su primera contribución, simplemente siga los sencillos pasos a continuación. Te lo prometemos, será divertido.

---

## Lo que esto te enseñará

- Cómo bifurcar un repositorio
- Cómo hacer una rama
- Cómo enviar una solicitud de extracción al repositorio original

---

## Lo que esto no te enseñará

- Cómo construir paquetes R
- Etiqueta de código abierto

---

## Supuestos

He hecho una serie de suposiciones al escribir esta guía:

- Tienes una cuenta de GitHub
- Tiene [RStudio](https://www.rstudio.com/products/rstudio/download/#download) instalado.
- Tiene [git](https://git-scm.com/downloads) instalado y su [identidad configurada](http://happygitwithr.com/hello-git.html). Si puede enviar a GitHub, ya lo ha hecho :)
- Te sientes cómodo usando git con RStudio. Si desea mejorar su conocimiento, le recomiendo trabajar primero con 'Happy Git y GitHub para el usuario'.

¡Bien, empecemos!

---

## Bifurcar este repositorio

Bifurque este repositorio haciendo clic en el botón de bifurcación en la parte superior de esta página.

<img width="300" src="../assets/fork.png" alt="fork this repository" style = "display: inline;" />
<br/>

Esto creará una copia de este repositorio en su cuenta y será redirigido a esta versión del repositorio.

Ahora necesita obtener la URL de su repositorio. Haga clic en "Clonar o descargar" y copie la URL en el cuadro.

<img width="300" src="../assets/rstudio-gh-clone.png" alt="clone the repo" style = "display: inline;" />
<br/>

---

## Crea un nuevo proyecto

En RStudio, vaya a Archivo -> Nuevo proyecto

Seleccione "Control de versiones" y luego "Git".

En el cuadro de diálogo Nuevo proyecto, pega la URL que copiaste de GitHub en el cuadro "URL del repositorio".

Elija el nombre que desea que se llame al directorio de su computadora y colóquelo en el cuadro "Nombre del directorio del proyecto". De forma predeterminada, este es el nombre del repositorio.

Finalmente, elija dónde desea que se almacene el repositorio clonado haciendo clic en el botón "Examinar".

Una vez que haya terminado, haga clic en "Crear proyecto" para clonar el repositorio y configurar el proyecto.

<img width="300" src="../assets/rstudio-clone.png" alt="Git" style = "display: inline;" />
<br/>

El repositorio ahora se clonará en la carpeta que especificó.

---

## Crea una sucursal

En la pestaña "Git" del panel superior derecho, haz clic en el botón "nueva rama".

<img width="500" src="../assets/git-tab-location.jpg" alt="Git tab" style = "display: inline;" />
<br/>
<img width="300" src="../assets/rstudio-new-branch-button.png" alt="Create a new branch" style = "display: inline;" />
<br/>

Nombre su rama "agregue-su-nombre", por ejemplo: "agregar-nombre-mariposa"

<img width="300" src="../assets/rstudio-new-branch-button2.png" alt="name your branch" style = "display: inline;" />
<br/>

Asegúrese de que "Sincronizar rama con remoto" esté marcado y haga clic en "Crear". Es posible que se le solicite que ingrese su nombre de usuario y contraseña de GitHub.

---

## Realice los cambios necesarios y confirme esos cambios

Ahora abra el archivo `Contributors.md` en RStudio y agregue su nombre, luego guarde el archivo.

Verá que el archivo tiene una 'M' al lado. Marque la casilla junto a él y luego haga clic en "Confirmar".

<img width="300" src="../assets/rstudio-add.png" alt="commit button" style = "display: inline;" />
<br/>

Verá un archivo de diferencias que muestra los cambios que ha realizado en el archivo. Agregue un mensaje de confirmación, un resumen de los cambios que ha realizado, y luego haga clic en "Confirmar". Aparecerá un cuadro para confirmar la confirmación; haga clic en "cerrar".

<img width="400" src="../assets/rstudio-commit-message.png" alt="commit dialog" style = "display: inline;" />
<br/>

---

## Enviar cambios a GitHub

Felicitaciones, ha comprometido todos los cambios en su copia local de su rama de su bifurcación de primeras contribuciones. Ahora haga clic en "Push" para sincronizar su confirmación con el repositorio remoto.

<img width="500" src="../assets/rstudio-push1.png" alt="push button" style = "display: inline;" />
<br/>

Verá un cuadro como este si sus cambios se han realizado correctamente. Haga clic en "Cerrar".

<img width="400" src="../assets/rstudio-push2.png" alt="git output log" style = "display: inline;" />
<br/>

---

## Envíe sus cambios para su revisión

Si va a su repositorio en github, verá un botón "Comparar y solicitar extracción". Haga clic en ese botón.

<img width="500" style = "display: inline;" src="../assets/compare-and-pull.png" alt="create a pull request" />
<br/>

Asegúrese de comparar bifurcaciones. A la izquierda debería estar la rama maestra del repositorio original, y a la derecha debería estar la nueva rama que ha creado en su repositorio. Una vez que haya seleccionado las opciones correctas y haya escrito un resumen rápido de los cambios realizados, envíe la solicitud de extracción haciendo clic en "Crear solicitud de extracción".

<img width="500" style = "display: inline;" src="../assets/submit-pull-request.png" alt="submit pull request" />
<br/>

Pronto fusionaré todos sus cambios en la rama principal de este proyecto. ¡Recibirá un correo electrónico de notificación una vez que se hayan combinado los cambios!

¡Felicitaciones! ¡Acaba de completar la bifurcación estándar -> clonar -> editar -> flujo de trabajo de relaciones públicas que encontrará a menudo como colaborador!
23 changes: 10 additions & 13 deletions Languages/Italian.md → README-translations/README_it.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@


# Primo Contributo

Questo repository è una versione ridotta, ridotta e personalizzata per
Expand Down Expand Up @@ -77,16 +75,15 @@ configurare il progetto.
Nella scheda "Git" nel pannello in alto a destra, fai clic sul pulsante
"nuovo ramo".


<img src="assets/git-tab-location.jpg" alt="Git tab" width="500" style="display: inline;"/>
<img src="../assets/git-tab-location.jpg" alt="Git tab" width="500" style="display: inline;"/>
<br/>

<img src="assets/rstudio-new-branch-button.png" alt="Create a new branch" width="300" style="display: inline;"/>
<img src="../assets/rstudio-new-branch-button.png" alt="Create a new branch" width="300" style="display: inline;"/>
<br/>

Assegna un nome al tuo ramo "aggiungi il tuo nome"

<img src="./assets/rstudio-new-branch-button2.png" alt="name your branch" width="300" style="display: inline;"/>
<img src="../assets/rstudio-new-branch-button2.png" alt="name your branch" width="300" style="display: inline;"/>
<br/>

Assicurati che "Sincronizza ramo con telecomando" sia selezionato e fai
Expand All @@ -101,15 +98,15 @@ quindi salva il file.
Vedrai che il file ha una "M" accanto ad esso. Seleziona la casella
accanto ad essa e quindi fai clic su "Commit".

<img src="./assets/rstudio-add.png" alt="name your branch" width="300" style="display: inline;"/>
<img src="../assets/rstudio-add.png" alt="commit button" width="300" style="display: inline;"/>
<br/>

Vedrai un file diff che mostra le modifiche che hai apportato al file.
Aggiungi un messaggio di commit: un riepilogo delle modifiche che hai
apportato, quindi fai clic su "Commit". Apparirà una finestra per
confermare il commit; clicca su "chiudi".

<img src="./assets/rstudio-commit-message.png" alt="name your branch" width="400" style="display: inline;"/>
<img src="../assets/rstudio-commit-message.png" alt="commit dialog" width="400" style="display: inline;"/>
<br/>

## Invia le modifiche a GitHub
Expand All @@ -118,21 +115,21 @@ Congratulazioni, hai eseguito il commit di tutte le modifiche alla tua
copia locale del tuo ramo del tuo fork dei primi contributi. Ora fai
clic su "Push" per sincronizzare il tuo commit con il repository remoto.

<img src="./assets/rstudio-push1.png" alt="name your branch" width="500" style="display: inline;"/>
<img src="../assets/rstudio-push1.png" alt="push button" width="500" style="display: inline;"/>
<br/>

Vedrai una casella come questa se le modifiche sono state inviate
correttamente. Fare clic su "Chiudi".

<img src="./assets/rstudio-push2.png" alt="name your branch" width="400" style="display: inline;"/>
<img src="./assets/rstudio-push2.png" alt="git output log" width="400" style="display: inline;"/>
<br/>

## Invia le modifiche per la revisione

Se vai al tuo repository su github, vedrai un pulsante "Confronta ed
esegui richiesta". Fare clic su quel pulsante.

<img src="./assets/compare-and-pull.png" alt="create a pull request" width="500" style="display: inline;"/>
<img src="../assets/compare-and-pull.png" alt="create a pull request" width="500" style="display: inline;"/>
<br/>

Assicurati di confrontare i fork. A sinistra dovrebbe esserci il ramo
Expand All @@ -141,12 +138,12 @@ ramo che hai creato nel tuo repository. Dopo aver selezionato le opzioni
corrette e aver scritto un rapido riepilogo delle modifiche apportate,
invia la richiesta pull facendo clic su "Crea richiesta pull".

<img src="./assets/submit-pull-request.png" alt="submit pull request" width="500" style="display: inline;"/>
<img src="../assets/submit-pull-request.png" alt="submit pull request" width="500" style="display: inline;"/>
<br/>

Presto unirò tutte le tue modifiche nel ramo principale di questo
progetto. Riceverai un'e-mail di notifica una volta unite le modifiche!

Congratulazioni! Hai appena completato il flusso di lavoro standard
*fork -\> clone -\> modifica -\> PR* che incontrerai spesso come
_fork -\> clone -\> modifica -\> PR_ che incontrerai spesso come
collaboratore!
Loading

0 comments on commit 61f7d84

Please sign in to comment.