Crear el primer repositorio mediante GitHub Desktop

Introducción

GitHub Desktopes una aplicación gratuita código abierto que le ayuda a trabajar con código hospedado en GitHub u otros servicios de hospedaje de Git. Con GitHub Desktop, puede realizar comandos de Git, como confirmar e insertar cambios, en una interfaz gráfica de usuario, en lugar de usar la línea de comandos. Para más información, consulta Acerca de GitHub Desktop.

Al final de esta guía, habrá usado GitHub Desktop para crear un repositorio, realizar cambios en el repositorio y publicar los cambios en GitHub.

Después de instalar GitHub Desktop e iniciar sesión en GitHub o GitHub Enterprise, puedes crear y clonar un repositorio de tutorial. El tutorial presentará los conceptos básicos para trabajar con Git y GitHub, incluida la instalación de un editor de texto, la creación de una rama, la realización de una confirmación de cambios, el envío de cambios a GitHub y la apertura de una solicitud de extracción. El tutorial está disponible si aún no tienes ningún repositorio en GitHub Desktop.

Se recomienda completar el tutorial, pero si desea explorar GitHub Desktop mediante la creación de un nuevo repositorio, esta guía le guiará a través del uso GitHub Desktop para trabajar en un repositorio de Git.

Parte 1: Instalación GitHub Desktop y autenticación de su cuenta

Puede instalar GitHub Desktop en cualquier sistema operativo compatible. Después de instalar la aplicación, deberá iniciar sesión y autenticar su cuenta en GitHub o GitHub Enterprise antes de poder crear y clonar un repositorio de tutoriales.

Para obtener más información sobre la instalación y autenticación, consulta Configurar GitHub Desktop.

Parte 2: Crear un repositorio nuevo

Si no tiene ningún repositorio asociado a GitHub Desktop, verá un mensaje "Vamos a empezar". donde puede elegir crear y clonar un repositorio de tutoriales, clonar un repositorio existente desde Internet, crear un repositorio, o bien agregar un repositorio existente desde el disco duro.

Crear y clonar un repositorio de tutorial

Se recomienda crear y clonar un repositorio de tutoriales como primer proyecto para practicar mediante GitHub Desktop.

1. Haz clic en Crear un repositorio de tutoriales... .
2. Siga las indicaciones del tutorial para instalar un editor de texto, crear una rama, editar un archivo, hacer un commit, publicar en GitHub y abrir una solicitud de extracción.

Crear un repositorio nuevo

Si no quieres crear y clonar un repositorio de tutorial, puedes crear un repositorio nuevo.

1. Haz clic en Crear un nuevo repositorio en tu disco duro... .
2. En la ventana "Crear un nuevo repositorio", rellena los campos y selecciona tus opciones preferidas.
   • "Name" define el nombre del repositorio tanto localmente como en GitHub.
   • "Description" (Descripción) es un campo opcional que puedes usar para brindar más información sobre el objetivo de tu repositorio.
   • "Local path" (Ruta local) establece la ubicación de tu repositorio en tu computadora. De forma predeterminada, GitHub Desktop crea una carpeta GitHub dentro de la carpeta Documentos para almacenar los repositorios, pero puede elegir cualquier ubicación en el equipo. Tu nuevo repositorio será una carpeta dentro de la ubicación elegida. Por ejemplo, si asigna el nombre Tutorial al repositorio, se crea una carpeta denominada Tutorial dentro de la carpeta seleccionada para la ruta de acceso local. GitHub Desktop recuerda la ubicación elegida la próxima vez que cree o clone un nuevo repositorio.
   • Inicializar este repositorio con un README crea un commit inicial con un archivo README.md. README ayuda a las personas a comprender el objetivo de tu proyecto, por lo que recomendamos seleccionarlo y completarlo con información útil. Cuando alguien visite tu repositorio en GitHub, el README será lo primero que vea cuando empiece a informarse sobre tu proyecto. Para más información, consulta Acerca del archivo LÉAME del repositorio.
   • El menú desplegable Ignorar Git permite agregar un archivo personalizado para ignorar archivos concretos del repositorio local que no quiera almacenar en el control de versiones. Si hay un lenguaje o marco de trabajo que estarás utilizando, puedes seleccionar una opción de la lista disponible. Si recién estás comenzando, puedes omitir esta selección. Para más información, consulta Ignorar archivos.
   • El menú desplegable Licencia permite agregar una licencia de código abierto a un archivo LICENSE en el repositorio. No tienes que preocuparte por agregar una licencia de inmediato. Para más información sobre las licencias de código abierto disponibles y cómo agregarlas al repositorio, consulta Generar licencia para un repositorio.
3. Haga clic en Create repository (Crear repositorio).

Parte 3: Exploración GitHub Desktop

En el menú Archivo, en la parte superior de la pantalla, puedes acceder a los ajustes y las acciones que puedes realizar en GitHub Desktop. La mayoría de las acciones tienen atajos del teclado para ayudarte a trabajar con más eficacia. Para obtener una lista completa de los métodos abreviados de teclado, consulta Métodos abreviados de teclado de GitHub Desktop.

Barra de repositorio GitHub Desktop

En la parte superior de la GitHub Desktop aplicación, verá una barra que muestra el estado actual del repositorio.

• En Repositorio actual se muestra el nombre del repositorio en el que trabaja. Puede hacer clic en Repositorio actual para cambiar a otro repositorio en GitHub Desktop.
• La rama actual muestra el nombre de la rama en la que estás trabajando. Puede hacer clic en Rama actual para ver todas las ramas del repositorio, cambiar a otra rama o crear una. Una vez que haya creado solicitudes de incorporación de cambios en el repositorio, también puede verlas si hace Rama actual.
• Publicar repositorio aparece porque aún no ha publicado su repositorio en GitHub, algo que hará más adelante, en el siguiente paso. Esta sección de la barra cambiará con base en el estado de tu repositorio y rama actuales. Varias acciones dependientes del contexto estarán disponibles, las cuales te permitirán intercambiar datos entre tus repositorios locales y remotos.

Cambios e Historial

En la barra lateral de la izquierda, encontrará las vistas Cambios e Historial.

• En la vista Cambios se muestran los cambios que ha realizado en los archivos de la rama actual, pero que todavía no ha confirmado en el repositorio local. En la parte inferior, hay un cuadro con los cuadros de texto "Resumen" y "Descripción", y un botón Confirmar en RAMA. Aquí es donde confirmarás los campos nuevos. El botón Confirmar en RAMA es dinámico y mostrará la rama en la que se van a confirmar los cambios.
• En la vista Historial se muestran las confirmaciones anteriores en la rama actual del repositorio. Debería ver una "Confirmación inicial" creada por GitHub Desktop al crear el repositorio. A la derecha del commit, en función de las opciones que hayas seleccionado al crear el repositorio, puedes ver archivos .gitattributes, .gitignore, LICENSE o README. Puedes hacer clic en cada archivo para ver una diferencia para ese archivo, que son los cambios realizados en el archivo en esa confirmación. La diferencia solo muestra las partes del archivo que han cambiado, no el contenido completo del archivo

Parte 4: Publicación del repositorio en GitHub

Cuando creas un repositorio nuevo, éste solo existirá en tu computadora y serás el único que pueda acceder a él. Puede publicar su repositorio en GitHub para mantenerlo sincronizado en múltiples equipos y permitir que otras personas accedan a él. Para publicar el repositorio, inserte los cambios locales en GitHub.

1. En la barra del repositorio, haz clic en Publicar repositorio.

1. En la ventana "Publicar repositorio", escribe los detalles del nuevo repositorio.
   • GitHub Desktop rellena automáticamente los campos "Nombre" y "Descripción" con la información que escribió al crear el repositorio.
   • Mantener este código privado le permite controlar quién puede ver el proyecto. Si deja esta opción sin seleccionar, otros usuarios GitHub podrán ver el código. Si seleccionas esta opción, tu código no estará disponible al público en general.
   • El menú desplegable Organización , si está presente, le permite publicar el repositorio en una organización específica a la que pertenece en GitHub.
   1. Haz clic en Publicar repositorio.
   2. Puede acceder al repositorio en GitHub desde dentro de GitHub Desktop. En el menú Archivo, haga clic en Repositorio y después en Ver en GitHub. Esto te llevará directamente hasta el repositorio en tu navegador predeterminado.

Parte 5: Hacer, confirmar y empujar cambios

Ahora que creaste y publicaste tu repositorio, estás listo para hacer cambios en tu proyecto y comenzar a crear tu primera confirmación para este repositorio.

1. Para iniciar el editor externo desde GitHub Desktop, en la barra de menús "GitHub Desktop", seleccione Repositorio y, a continuación, haga clic en Abrir en el EDITOR. Para más información, consulta Configuración de un editor predeterminado en GitHub Desktop.

1. Realice algunos cambios en el archivo README.md que ha creado antes. Puedes agregar información que describa tu proyecto, como por ejemplo, que es lo que hace y por qué es útil. Cuando estés satisfecho con los cambios, guárdalos en tu editor de texto.
2. En GitHub Desktop, vaya a la vista Cambios. En la lista de archivos, debería ver el archivo README.md. La casilla a la izquierda del archivo README.md indica que los cambios que has realizado en el archivo formarán parte de la confirmación que hagas. En el futuro, es posible que realices cambios a múltiples archivos pero solo quieras confirmar los cambios que realizaste en alguno de los archivos. Si haces clic en la casilla junto a un archivo, este no se incluirá en la confirmación.

1. En la parte inferior de la lista Cambios, escriba un mensaje de confirmación. A la derecha de tu imagen de perfil, escribe una descripción breve de la confirmación. Como se va a cambiar el archivo README.md, "Agregar información sobre el objetivo del proyecto" sería un buen resumen de la confirmación. Debajo del resumen, verás un campo de texto de "Descripción" en donde podrás teclear una descripción más amplia de los cambios en la confirmación, lo cual es de gran ayuda cuando regresas a ver el historial de un proyecto y entiendes por qué se realizaron los cambios. Como va a realizar una actualización básica de un archivo README.md, puede omitir la descripción.

1. Debajo del mensaje de confirmación, haz clic en Confirmar en NOMBRE DE RAMA. El botón de confirmación muestra tu rama actual, así que puedes estar seguro de confirmar a la rama que quieras.
2. Para insertar los cambios en el repositorio remoto en GitHub, haga clic en Insertar origen.

• El botón Enviar al origen es el mismo que pulsó para publicar su repositorio en GitHub. Este botón cambia contextualmente con base en el punto en el que estés en el flujo de trabajo de Git. Ahora debería mostrar Push origin con un 1 al lado, indicando que hay una confirmación de cambios que no se ha subido a GitHub.
• El "origin" de Push origin significa que estás enviando cambios al remoto llamado origin, que en este caso es el repositorio de tu proyecto en GitHub. Hasta que no envíes nuevos commits a GitHub, habrá diferencias entre el repositorio de tu proyecto en tu ordenador y el repositorio de tu proyecto en GitHub. Esto le permite trabajar localmente y solo insertar los cambios en GitHub cuando esté listo.

1. En la ventana situada a la derecha de la vista Cambios, verá sugerencias para las acciones que puede realizar a continuación. Para abrir el repositorio en GitHub en el explorador, haga clic en Ver en GitHub.

1. En el navegador, haga clic en 2 commits. Verá una lista de las confirmaciones de este repositorio en GitHub. La primera confirmación debe ser la confirmación que acaba de realizar en GitHub Desktop.

Conclusión

Ahora has creado un repositorio, has publicado el repositorio en GitHub, has hecho una confirmación y has subido tus cambios a GitHub. Puedes seguir este flujo de trabajo cuando colabores con otros proyectos que crees o en los cuales colabores.

Información adicional

• Aspectos básicos de Git
• Obtener información sobre GitHub
• Introducción a la documentación de GitHub