Añade una branch, localmente, a tu repositorio bifurcado para realizar tus cambios.

Branches (ramas)

Los repositorios de Git usan ramas para separar el trabajo cuando es necesario. Es una práctica común cuando se trabaja en un proyecto con otras personas, crear una branch sobre la que realizar tus cambios. De esta manera puedes hacer tu trabajo mientras que la rama principal, comúnmente llamada 'master', se mantiene estable. Cuando terminas el trabajo en tu rama, 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.

Un diagrama que muestra una línea horizontal, representando la branch master, con otra línea separándose de la parte superior y después volviéndose a unir con la original. Otra línea se separa de la branch master desde abajo y una más de esta última. Estas dos branches vuelven a encontrarse también con la línea principal master.

Para entender mejor 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á un sitio web de archivos estáticos en las ramas o branches nombradas 'gh-pages'. Este servicio gratuito se llama GitHub Pages. Como 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 se encuentran disponibles online, usando el siguiente patrón en la URL:

http://usuariogithub.github.io/nombredelrepositorio

Crea una rama

Cuando creas una rama, Git copia todo lo que hay en la rama en la 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 qué 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 <NOMBREDELABRANCH>

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

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

git checkout <NOMBREDELABRANCH>

Paso: Crear un nuevo archivo

Vuelve a tu editor de texto:

  • Crea un archivo llamado "add-<USERNAME>.txt", donde 'username' es tu nombre de usuario. Por ejemplo, "add-jlord.txt".
  • Ahora sólo escribe tu nombre de usuario GitHub, 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/NOMBREDELARCHIVO>

git commit -m "mensaje de commit"

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

git push origin <NOMBREDELABRANCH>

Por favor, selecciona la carpeta en la que está tu repositorio.

Permission denied...error: 403

Estás empujando cambios a un repositorio en el cual no tienes permisos de escritura. En este caso, seguramente estás queriendo enviarlos al original 'jlord/patchwork'. Asegúrate de que estás apuntando a 'origin' y que origin apunta a tu fork en tu cuenta personal de GitHub. Para comprobar cuáles son tus remotos y a donde apuntan, ejecuta git remote -v. Deberías tener 'upstream' apuntando a 'jlord/patchwork' y 'origin' apuntando a 'tunombredeusuario/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 la autenticación en dos pasos activada; en este caso tienes que usar un token de acceso personal como contraseña. Puedes generar uno siguiendo las instrucciones. Necesitarás mantenerlo y usarlo en lugar de tu contraseña cuando sea requerido. También puedes guardar este token de acceso en tu ordenador para volverlo a utilizar.

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. Si lo pusiste en otro lugar, simplemente usa el explorador de archivos 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 exactamente. Para cambiar el nombre de la rama:

git branch -m <NUEVONOMBREDELABRANCH>

Una vez hagas estos cambios, ¡verifica nuevamente!

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