añade una branch, localmente, a tu repositorio bifurcado para trabajar en tus cambios.

Branches (ramas)

Los repositorios de Git usan ramas para separar el trabajo cuándo es necesario. Es una práctica común que cuándo se trabaja en un proyecto con otras personas crear una branch mantener tus cambios. De esta manera puedes hacer tu trabajo mientras que la rama principal, comunmente llamada 'master', mantiene estable. Cuándo el trabajo en tu rama es finalizado fusionas tu rama con la rama 'master'.

El siguiente diagrama muestra cómo puedes crear una rama a partir de 'master', hacer el trabajo y luego fusionar esos cambios de vuelta a 'master'. Incluso puedes crear una rama desde tu rama, la rama 'master' no necesariamente tiene que ser la base.

A diagram showing a horizontal line, representing the master branch, with another line branching off the top and later re-joining the original. Another line branches off the master branch line from below and yet another branch branches off of that. Both of these meet back up with the original master line, too.

Para una mejor entendimiento de cómo funcionan las ramas en un proyecto, revisa la guía de GitHub: guides.github.com/overviews/flow (en inglés)

Páginas de GitHub

GitHub automáticamente servirá y alojará sitio web de archivos estáticos en las ramas branches nombradas cómo 'gh-pages'. Este servicio gratuito es llamado GitHub Pages. Cómo el proyecto bifurcado crea un sitio web, su rama principal se llama 'gh-pages' en vez de 'master'. Todos los repositorios que tienen una rama 'gh-pages' con sitio web pueden ser encontradas, en línea, usando el siguiente patrón en la URL:

http://githubusername.github.io/repositoryname

Crea una rama

Cuándo creas una rama, Git copia todo lo que hay en la rama que estás actualmente y lo pone en la rama que acabas de crear.

Estando dentro de tu repositorio local 'patchwork', escribe git status para ver en cuál rama estás actualmente. Git podría decirte que estás en la rama 'gh-pages'.

Ahora crea una nueva rama y nombrala "add-<username>", donde 'username' es tu nombre de usuario de GitHub. Por ejemplo, "add-jlord". Las ramas son sensibles a mayúsculas así que nombra tu rama exactamente de la misma forma que aparece tu cuenta de usuario de GitHub.

git branch <BRANCHNAME>

Ahora tienes una rama con un nombre que es idéntica a la rama 'gh-pages'.

Para pasarte a esa rama debes hacer checkout a ella. Ve a la nueva rama:

git checkout <BRANCHNAME>

Paso: Crear un nuevo archivo

Vuelve a tu editor de texto:

  • Crea un archivo llamado "add-<USERNAME>.txt", dónde 'username' es tu nombre de usuario. Por ejemplo, "add-jlord.txt".
  • Entonces, sólo escribe tu nombre de usuario GitHub en él, eso es todo. Por ejemplo, Yo escribiría 'jlord'.
  • Guarda este archivo en la carpeta 'contributors' dentro de Patchwork: Patchwork/contributors/add-yourusername.txt
  • Siguiente paso, Verifica los cambios (mira abajo).

Check-in

Haz los siguientes pasos para guardar tus cambios:

git status

git add <contributors/FILENAME>

git commit -m "mensaje de commit"

Ahora haz push de tus cambios al fork, 'origin', en GitHub:

git push origin <BRANCHNAME>

Please select your repository directory.

Permission denied...error: 403

Estas empujando cambios a un repositorio en el cual no tienes permisos de escritura. En este caso, vas a queerer enviarlos a el original 'jlord/patchwork'. Asegurate que estás apuntando a 'origin' y que origin apunta a tu fork en GitHub. To check and see what your remotes are and where they point run git remote -v. Deberías tener a 'upstream' apuntando a 'jlord/patchwork' y 'origin' apuntando a 'yourusername/patchwork'.

Para arreglar un remoto que apunta a la dirección equivocada puedes cambiar su url: git remote set-url origin .

Authentication failed...error: 401

Tu identidad no pudo ser verificada. Pueden que tengas (Autenticación a dos pasos) activada en este caso tienes que usar un toke de acceso personal cómo tu contraseña. Puedes generar uno en siguiendo las instrucciones. Necesitarás mantenelo y usarlo en lugar de tu contraseña cuándo sea requerido. También puedes guardar este token de acceso en tu computadora para re usarlo.

El archivo no está en la carpeta contributors

El archivo creado debería estar en el interior de la carpeta 'contributors' en el repositorio Patchwork repository. Si lo pusiste en otro lugar, simplemente usa el Finder el explorador de windows para mover el archivo a la carpeta. Puedes verificar con git status otra vez y verás tus cambios. Añade y haz commit "all" (-A) de estos cambios (adiciones y borrados) con los siguientes comandos.

git add -A

git commit -m "mover archivo a la carpeta contributors"

Nombre de la rama esperado: _____

El nombre de la rama debería coincidir con tu nombre de usuario exactament. Para cambiar el nombre de la rama:

git branch -m <NEWBRANCHNAME>

Una vez hagas estos cambios, verifica nuevamente!

  • Crear y moverse a la rama en una sola línea
  • git checkout -b <BRANCHNAME>
  • Crear una rama nueva
  • git branch <BRANCHNAME>
  • Moverse a una rama
  • git checkout <BRANCHNAME>
  • Listado de las ramas
  • git branch
  • Renombrar la rama en la que estás situado
  • git branch -m <NEWBRANCHNAME>
  • Vericar la rama en la que estás y su estado
  • git status