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 utilizar GitHub Desktop para crear y administrar un repositorio de Git sin utilizar la línea de comandos.

En este artículo

¿Te ayudó este documento?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.

Introducción

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 utilizado GitHub Desktop para crear un repositorio, hacer cambios en éste y publicarlos en GitHub.

Después de instalar GitHub Desktop y de iniciar sesión en GitHub o en GitHub Enterprise, deberás crear y clonar un repositorio de tutorial. El tutorial te presentará lo básico de trabajar con Git y con GitHub, incluyendo el instalar un editor de texto, crear una rama, hacer una confirmación, cargarla a GitHub.com y abrir una solicitud de extracción. El tutorial está disponible si aún no tienes ningún repositorio en GitHub Desktop.

Te recomendamos completar el tutorial, pero si quieres explorar GitHub Desktop creando un nuevo repositorio, esta guía te describirá cómo utilizar GitHub Desktop para trabajar en un repositorio de Git.

Parte 1: Instalar GitHub Desktop y autenticar tu cuenta

Puedes instalar GitHub Desktop o cualquier sistema operativo compatible. Después de instalar la app, necesitarás iniciar sesión y autenticarte en tu cuenta de GitHub o de GitHub Enterprise antes de que puedas crear y clonar un repositorio de tutorial.

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

Parte 2: Crear un repositorio nuevo

Si no tienes ningún repositorio asociado con GitHub Desktop, tendrás una vista de "Let's get started!", en donde podrás elegir crear y clonar un repositorio de tutorial, clonar un repositorio existente desde internet, crear un repositorio nuevo, o agregar un repositorio existente desde tu disco duro. ¡Comencemos! screen

Crear y clonar un repositorio de tutorial

Te recomendamos que tu primer poyecto sea crear y clonar un repositorio de tutorial para practicar cómo utilizar GitHub Desktop.

  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 para instalar un editor de texto, crear una rama, editar un archivo, hacer una confirmación, 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...
    Crear un repositorio nuevo
  2. Llena los campos y selecciona tus opciones preferidas.
    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 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 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.

Parte 3: Explorar GitHub Desktop

En el menú del archivo en la parte superior de la pantalla, puedes acceder a la configuración y a 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".

La barra de menú de GitHub Desktop

En la parte superior de la app de GitHub Desktop, verás una barra que muestra el estado actual de tu repositorio.

  • 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. 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.

    Explorar el escritorio de GitHub

Cambios e Historial

En la barra lateral a la izquierda, encontrarás la vista Changes (Cambios) y la vistaHistory (Historial). Las pestañas de cambios y de 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, encontrarás un recuadro con cajas de texto para "Resumen" y "Descripción", y un botón de Confirmar a RAMA. Aquí es donde confirmarás los campos nuevos. El botón de Confirmar a RAMA es dinámico y mostrará a qué rama estás confirmando tus 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

Parte 4: Publicar tu repositorio en GitHub

Cuando creas un repositorio nuevo, éste solo existirá en tu computadora y serás el único que pueda acceder a él. Puedes publicar tu repositorio en GitHub para mantenerlo sincronizado a través de varias computadoras y permitir que otras personas accedan a él. Para publicar tu repositorio, sube tus cambios locales a GitHub.

  1. Da clic en Publicar repositorio en la barra de menú.

    Publicar repositorio

    • GitHub Desktop llenará los campos de "Nombre" y "Descripción" automáticamente con la información que ingresaste cuando creaste el repositorio.
    • La opción de Mantener este código como privado te permite controlar quién puede ver tu proyecto. Si no seleccionas esta opción, otros usuarios en GitHub podrán ver tu código. Si seleccionas esta opción, tu código no estará disponible al público en general.
    • El menú desplegable de Organización, si es que lo hay, te permite publicar tu repositorio en una organización específica en GitHub a la cual pertenezcas.

    Publicar pasos del repositorio

  2. Haz clic en el botón 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.

Parte 5: Hacer, confirmar y subir 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 lanzar tu editor externo desde dentro de GitHub Desktop, da clic en Repositorio, luego da clic en Abrir en EDITOR. Para obtener más información, consulta la sección "Configurar un editor predeterminado".

    Abrir en editor

  2. Haz algunos cambios al archivo README.md que hayas creado previamente. 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.

  3. En GitHub Desktop, navega a la vista de Cambios. En la lista de archivos, deberías ver tu README.md. La marca de verificación a la izquierda del archivo README.md indica que los cambios que has hecho al archivo serán parte de la confirmación que haces. 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 das clic en la marca de verificación contigua a un archivo, este archivo no se incluirá en la confirmación.

    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 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. Dado que estás realizando una actualización básica de un archivo README.md, puedes omitir la descripción.

    Commit message
    <<<<<<< HEAD

  5. Da clic en Confirmar al 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.

    Confirmar a una rama

  6. Haz clic en Committ to master (Confirmar en principal). El botón de confirmación te muestra tu rama actual, que en este caso es master, para que sepas hacia qué rama estás haciendo la confirmación.

    Confirmar al principal

    principal

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

    Subir origen

  • El botón de Subir el origen es el mismo en el que diste clic para publicar tu 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 decir Subir el origen con un 1 en un costado, indicando que hay una confirmación que no se ha subido a GitHub.
  • El "origen" en Subir el origen significa que estás subiendo los cambios al repositorio remoto llamado origin, que en este caso es el repositorio de tu 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 tus cambios a GitHub.com cuando estés listo.
  1. En la ventana, a la derecha de la vista de Cambios, verás las sugerencias para las acciones que puedes hacer después. Para abrir el repositorio en GitHub en tu buscador, da clic en Ver en GitHub.
    Acciones disponibles
  2. 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 aquella que acabas de realizar en GitHub Desktop.
    Hacer clic en dos confirmaciones

Conclusión

Ya creaste un repositorio, lo publicaste en GitHub, hiciste una confirmación y subiste tus cambios a GitHub. Puedes seguir este flujo de trabajo cuando colabores con otros proyectos que crees o en los cuales colabores.

Leer más

¿Te ayudó este documento?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.