Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Crear el primer repositorio mediante GitHub Desktop

Puedes usar GitHub Desktop para comenzar a trabajar rápidamente con un repositorio Git sin necesidad de usar la línea de comando.

En este artículo

Introducción

Esta guía te orientará a través del proceso de uso de GitHub Desktop para trabajar en un repositorio Git. GitHub Desktop se extiende y simplifica tu flujo de trabajo GitHub.com, usando una interfaz visual en lugar de comandos de texto en la línea de comandos. Al final de esta guía, habrás usado GitHub Desktop para crear un repositorio, realizar cambios al repositorio, y publicar los cambios en GitHub.com o GitHub Enterprise Server.

Después de descargar GitHub Desktop e iniciar sesión en GitHub o GitHub Enterprise puedes crear y clonar un repositorio de tutorial. El tutorial introducirá los aspectos básicos del trabajo con Git y GitHub, que incluye la instalación de un editor, la creación de una rama, la generación de una confirmación, la extracción de GitHub.com, y la creación de una solicitud de extracción. El tutorial está disponible mientras no tengas ningún repositorio en GitHub Desktop.

Paso 1. Instalar e iniciar sesión en GitHub Desktop

  1. Descarga GitHub Desktop de https://desktop.github.com/. GitHub Desktop soporta las versiones recientes de Windows y macOS. Para conocer las instrucciones de instalación específicas para tu sistema operativo, consulta Instalar GitHub Desktop."

  2. Abre GitHub Desktop y sigue el flujo de bienvenida inicial para iniciar sesión en tu cuenta de GitHub. Verás un paso "Configure Git" (Configurar Git), donde puedes configurar tu nombre y dirección de correo electrónico. Para asegurarte de que tus confirmaciones se atribuyan correctamente a tu cuenta de GitHub, usa la dirección de correo electrónico asociada a tu cuenta de GitHub. Para obtener más información, consulta "Establecer tu dirección de correo electrónico de confirmación."

Paso 2. Crear un repositorio nuevo

Verás una vista "Let's get started!" (¡Comencemos"), donde puedes elegir si deseas crear y clonar un repositorio de tutorial, crear un repositorio nuevo o agregar un repositorio existente.

Crear y clonar un repositorio de tutorial

  1. Haz clic en Create a tutorial repository and clone it (Crear un repositorio de tutorial y clonarlo).
    Crear y clonar un botón de repositorio de tutorial
  2. Sigue las instrucciones en el tutorial.

Crear un repositorio nuevo

  1. Haz clic en Crear un nuevo repositorio en tu disco duro...
    Crear un repositorio nuevo
  2. Para crear un repositorio nuevo, completa los campos:
    Crear un repositorio de opciones
    • "Name" (Nombre) define el nombre de tu repositorio a nivel local y 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 manera predeterminada, GitHub Desktop crea una carpeta GitHub en tu carpeta Documents (Documentos) para almacenar tus repositorios, pero puedes elegir cualquier ubicación en tu computadora. Tu nuevo repositorio será una carpeta dentro de la ubicación elegida. Por ejemplo, si colocas el nombre Tutorial a tu repositorio, se creará la carpeta Tutorial dentro de la carpeta que seleccionaste en tu ruta local. GitHub Desktop recuerda tu ubicación elegida la próxima vez que crees o clones un repositorio nuevo.
    • Si inicializas este repositorio con un README (Léeme), se crea una confirmación 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 visita tu repositorio en GitHub, el archivo README es lo primero que verán a medida que aprenden sobre tu proyecto. Para obtener más información, consulta "Acerca de los archivos README".
    • El menú desplegable Git ignore (Ignorar Git) te permite agregar un archivo personalizado para ignorar los archivos específicos en tu repositorio local que no deseas almacenar en el control de la versión. Si existe un idioma o encuadre específico que estarás usando, puedes seleccionar una opción desde la lista disponible. Si recién estás comenzando, puedes omitir esta selección. Para obtener más información, consulta "Ignorar archivos".
    • El menú desplegable License (Licencia) te permite agregar una licencia de código abierto para un archivo LICENSE (Licencia) en tu repositorio. No tienes que preocuparte por aprender cómo agregar una licencia inmediatamente. Para obtener más información sobre las licencias de código abierto disponibles y cómo agregarlas a tu repositorio, consulta "Licenciar un repositorio".
  3. Haz clic en Crear repositorio.

Paso 3. Explorar GitHub Desktop

Ahora que has creado un repositorio, verás un menú de archivo en la parte superior de la pantalla. Allí es donde puedes acceder a la configuración 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 encontrar un listado completo de atajos de teclado, consulta la sección "Atajos de teclado".

  1. Debajo del menú se encuentra una barra que muestra el estado actual del repositorio en GitHub Desktop:

    • Current repository (Repositorio actual) muestra el nombre del repositorio en el que estás trabajando. Puedes hacer clic en Current repository (Repositorio actual) para alternar a un repositorio diferente en GitHub Desktop.
    • Current branch (Rama actual) muestra el nombre de la rama en la que estás trabajando. Puedes hacer clic en Current branch (Rama actual) para ver todas las ramas en tu repositorio, alternar a una rama diferente o crear una rama nueva. Una vez que creaste solicitud de extracción en tu repositorio, también puedes verlas haciendo clic en Current branch (Rama actual).
    • Publish repository (Publicar repositorio) aparece porque todavía no has publicado tu repositorio en GitHub. que harás a continuación en el próximo paso.

    Explorar el escritorio de GitHub

  2. En la barra lateral a la izquierda, encontrarás la vista Changes (Cambios) y la vistaHistory (Historial).

    • La vista Changes (Cambios) muestra los cambios que realizaste a los archivos en tu rama actual pero aún no confirmaste en tu repositorio local. En la parte inferior, advertirás un cuadro con los cuadros de texto "Summary" (Resumen) y "Description" (Descripción) y un botón Commit to master (Confirmar en principal). Aquí es donde confirmarás los campos nuevos. El botón Commit (Confirmar) te permite saber en qué rama estás confirmando los cambios.

      Área de confirmación de cambios

    • La vista History (Historial) muestra las confirmaciones previas en la rama actual de tu repositorio. Deberías ver una "Initial commit" (Confirmación inicial) que fue creada por GitHub Desktop cuando creaste tu repositorio. A la derecha de la confirmación, según las opciones que seleccionaste al crear tu repositorio, es posible que veas los 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 slo los contenidos completos del archivo.

      Vista de historial

Paso 4. Subir tu repositorio a GitHub

Actualmente, tu repositorio solo existe en tu computadora, y eres el único que puede acceder al repositorio. Al publicar tu repositorio en GitHub se mantiene actualizado con múltiples computadoras y miembros del equipo en el mismo proyecto. Para publicar el repositorio, lo "subirás" a GitHub, lo que permite que también esté disponible en GitHub.com.

  1. Haz clic en Publish repository (Publicar repositorio).
    Publicar repositorio
    • Verás algunos campos familiares. "Name" (Nombre) y "Description" (Descripción) coinciden con los campos completados cuando creaste el repositorio.
    • Verás la opción Keep this code private (Mantener la privacidad de este código). Selecciona esta opción si no deseas compartir tu código públicamente con otros usuarios en GitHub.
    • El desplegable Organization (Organización), si está presente, te permite publicar tu repositorio a una organización específica a la que perteneces en GitHub. No hay problemas si todavía no eres miembro de una organización.
      Publicar pasos del repositorio
  2. Haz clic en Publish repository (Publicar repositorio).
  3. Puedes acceder al repositorio en GitHub.com desde el interior de GitHub Desktop. En el menú del archivo, haz clic en Repository (Repositorio), luego haz clic en View on GitHub (Ver en GitHub). Esto te llevará directamente hasta el repositorio en tu navegador predeterminado.

Ahora que el repositorio está publicado, volvamos a GitHub Desktop y realicemos más cambios a tu repositorio local. En primer lugar, repasaremos la configuración de un editor de texto predeterminado.

Paso 5. Configurar un editor de texto

Para reducir la cantidad de tiempo dedicada a la configuración de tu entorno de desarrollo, lanzaremos un número de editores de texto y entornos de desarrollo integrados (IDE, por sus siglas en inglés) directamente desde GitHub Desktop. Desde un repositorio en GitHub Desktop, puedes abrir perfectamente la carpeta del proyecto en tu editor de texto favorito.

  1. Haz clic en File (Archivo), luego haz clic en Options (Opciones) y luego haz clic en Advanced (Avanzado).
  2. Usa el menú desplegable External editor (Editor externo) y selecciona un editor de la lista. Deberías ver los editores que has instalado en la lista. Si no ves ningún editor, instala un editor compatible como Atom. Para ver la lista de editores compatibles, consulta la integración "Open External Editor" (Abrir editor externo) en el repositorio GitHub Desktop.
    Editor externo
  3. Si instalaste un editor nuevo, reinicia GitHub Desktop para que el editor esté disponible en el menú desplegable External editor (Editor externo).

Paso 6. Realizar, confirmar y subir cambios

Ahora que has configurado un editor predeterminado, estás listo para hacer cambios en tu proyecto y para comenzar a crear tu primera confirmación en tu repositorio.

  1. Para iniciar tu editor externo desde el interior GitHub Desktop, haz clic en Repository (Repositorio) y luego haz clic en Open in EDITOR (Abrir en EDITOR).

    Abrir en editor

  2. Comienza por realizar algunos cambios en el archivo README.md que creaste previamente. Agrega la información que describe el proyecto, como qué hace y por qué resulta útil. Recuerda que esta es la primera interacción que tendrán las personas con tu proyecto. Ahora estás listo para hacer tu primera confirmación.

  3. Cambia desde el editor de texto hasta GitHub Desktop y desplázate hasta la pestaña Changes (Cambios). En la lista de archivos, deberías ver tu README.md. La marca de verificación junto al archivo README.md indica que los cambios que realizaste en el archivo formarán parte de la confirmación que realizaste. 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. GitHub Desktop te permite seleccionar los cambios específicos que deseas confirmar.

    Ver cambios

  4. En la parte inferior de la lista Changes (Cambios), escribe un mensaje de confirmación. A la derecha de tu imagen de perfil, escribe una descripción breve de la confirmación. Dado que estamos cambiando 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 "Description" (Descripción), donde puedes escribir una descripción más extensa de los cambios en la confirmación, que resulta útil al volver a mirar el historial de un proyecto y comprender por qué se hicieron los cambios. Dado que estás realizando una actualización básica de un archivo README.md, puedes omitir la descripción.

    Mensaje de confirmación

  5. Haz clic en Committ to master (Confirmar en principal). El botón de confirmación muestra tu rama actual, que en este caso es master (principal), por lo que debes asegurarte de confirmar la rama que deseas.

    Confirmar al principal

  6. Para subir los cambios al repositorio remoto en GitHub, haz clic en Push origin (Subir origen).

    Subir origen

    • ¿Recuerdas el botón Publish (Publicar) que usaste para publicar tu repositorio en GitHub? Ahora debería decir Push origin (Subir origen), con un código 1, junto al nombre, indicando que existe una confirmación que no ha sido subida a GitHub.
    • El "origen" en Push origin (Subir origen) significa que estamos subiendo los cambios al remoto llamado origin (origen), que en este caso es tu repositorio del proyecto en GitHub.com. Hasta que hayas subido alguna de las nuevas confirmaciones GitHub, habrá diferencias entre el repositorio de tu proyecto en tu computadora y el repositorio del proyecto en GitHub.com. Esto te permite trabajar localmente y solo subir tu trabajo a GitHub.com cuando estés listo.
  7. En el área abierta junto a la pestaña Changes (Cambios), verás sugerencias sobre lo que puedes hacer a continuación. Para abrir el repositorio en GitHub en tu navegador, haz clic en View on GitHub (Ver en GitHub).

    Ver en GitHub

  8. En tu navegador, haz clic en 2 commits (2 confirmaciones). Verás una lista de las confirmaciones en este repositorio en GitHub. La primera confirmación deberá ser la confirmación que acabas de realizar en GitHub Desktop.

    Hacer clic en dos confirmaciones

Conclusión

¡Felicitaciones! Has creado un repositorio, publicado el repositorio en GitHub, realizado una confirmación y subido tus cambios. Esta es solo una muestra de todas las cosas que puedes hacer con GitHub y GitHub Desktop. Esperamos que este ejercicio te estimule para explorar un poco más.

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos