Inicio rápido para repositorios

Obtenga información sobre cómo crear un nuevo repositorio y confirmar el primer cambio en 5 minutos.

Tool navigation

En este artículo

Creación de un repositorio

Los repositorios de GitHub almacenan una variedad de proyectos. En esta guía, creará un repositorio y confirmará el primer cambio.

  1. En la esquina superior derecha de cualquier página, selecciona y luego haz clic en Nuevo repositorio.

    Captura de pantalla del menú desplegable GitHub que muestra las opciones para crear nuevos elementos. El elemento de menú "New repository" está resaltado en naranja oscuro.

  2. Escriba un nombre corto y fácil de recordar para el repositorio. Por ejemplo: "hola-mundo".

    Recorte de pantalla del primer paso para crear un repositorio. El campo "Repository name" contiene el texto "hello-world" y aparece en naranja oscuro.

  3. Opcionalmente, puede agregar una descripción del repositorio. Por ejemplo, "Mi primer repositorio en GitHub".

  4. Elige la visibilidad del repositorio. Para más información, consulta Acerca de los repositorios.

  5. Seleccione Initialize this repository with a README (Inicializar este repositorio con un archivo Léame).

  6. Haga clic en Create repository (Crear repositorio).

Felicidades. Ha creado correctamente su primer repositorio y lo has inicializado con un archivo Léame.

Note

Para más información sobre GitHub CLI, consulta Acerca del CLI de GitHub.

  1. En la línea de comandos, navega al directorio en donde te gustaría crear un clon local de tu proyecto nuevo.
  2. Para crear un repositorio para el proyecto, use el subcomando gh repo create. Cuando se le solicite, seleccione Create a new repository on GitHub from scratch (Crear un nuevo repositorio en GitHub desde cero) y escriba el nombre del nuevo proyecto. Si quieres que tu proyecto pertenezca a una organización en lugar de a tu cuenta personal, especifica el nombre de la organización y del proyecto con organization-name/project-name.
  3. Sigue los mensajes interactivos. Para clonar el repositorio localmente, confirma que sí cuando se te pregunte si quisieras clonar el directorio remoto del proyecto.
  4. Como alternativa, para omitir los mensajes interactivos, proporcione el nombre del repositorio y una marca de visibilidad (--public, --private o --internal). Por ejemplo: gh repo create project-name --public. Para clonar el repositorio localmente, pase la marca --clone. Para obtener más información acerca de los posibles argumentos, vea el manual de la CLI de GitHub.

Confirma tu primer cambio

Una confirmación es como una instantánea de todos los archivos del proyecto en un momento dado.

Una vez creado el repositorio, se inicializa con un archivo Léame. Los archivos Léame son un buen lugar para describir el proyecto con más detalle o bien agregar documentación, como instrucciones de instalación o uso del proyecto. El contenido del archivo Léame se muestra automáticamente en la página principal del repositorio.

Vamos a confirmar un cambio en el archivo Léame.

  1. En la lista de archivos del repositorio, seleccione README.md.

    Captura de pantalla de una lista de archivos en un repositorio. Un nombre de archivo, "README.md", aparece resaltado con un contorno naranja.

  2. En la esquina superior derecha de la vista de archivos, haz clic en para abrir el editor de archivos.

Captura de pantalla de un archivo. En el encabezado, un botón (etiquetado con un icono de lápiz) está resaltado en naranja oscuro.

  1. En el cuadro de texto, escriba alguna información personal.

  2. Encima del nuevo contenido, haz clic en Vista previa.

    Captura de pantalla de un archivo en modo de edición. Encima del contenido del archivo, una pestaña etiquetada "Vista previa" está resaltada en naranja oscuro.

  3. Revisa los cambios que realizaste en el archivo. Si seleccionas Mostrar diferencia, verás el contenido nuevo en verde.

    Recorte de pantalla de la vista previa de un archivo. La casilla "Mostrar diferencias" está habilitada y las adiciones al archivo se muestran con una línea verde. Ambas opciones se muestran resaltadas con un contorno naranja.

  4. Haz clic en Confirmar cambios... .

  5. En el campo de "Mensaje de confirmación", escriba un mensaje de confirmación corto y significativo que describa la modificación que hizo en el archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para más información, consulta Crear una confirmación con distintos autores.

  6. Debajo de los campos para el mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una nueva rama. Si tu rama actual es la rama predeterminada, debes elegir crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para más información, consulta Crear una solicitud de incorporación de cambios.

    Captura de pantalla de una solicitud de cambios de GitHub en la que se muestra un botón de radio para confirmar directamente en la rama principal o para crear una rama. Aparece seleccionada la opción de rama nueva.

  7. Haz clic en Confirmar cambios o Proponer cambios.

Ahora que creaste un proyecto, puedes comenzar a confirmar cambios.

Los archivos Léame son un buen lugar para describir el proyecto con más detalle o bien agregar documentación, como instrucciones de instalación o uso del proyecto. El contenido del archivo Léame se muestra automáticamente en la página principal del repositorio. Siga estos pasos para agregar un archivo Léame.

  1. En la línea de comandos, navega al directorio raíz de tu proyecto nuevo. (Este directorio se ha creado cuando ha ejecutado el comando gh repo create).

  2. Cree un archivo Léame con cierta información sobre el proyecto.

    echo "info about this project" >> README.md

  3. Escriba git status. Verá que tiene un archivo README.md sin seguimiento.

    $ git status

Untracked files:
  (use "git add <file>..." to include in what will be committed)
  README.md

nothing added to commit but untracked files present (use "git add" to track)

  4. Prueba y confirma el archivo.

    git add README.md && git commit -m "Add README"

  5. Sube los cambios a tu rama.

    git push --set-upstream origin HEAD

Pasos siguientes

Ha creado un repositorio, incluido un archivo Léame, y la primera confirmación en GitHub.

  • Ahora puede clonar un repositorio de GitHub para crear una copia local en su equipo. Desde tu repositorio local, puedes confirmar y crear una solicitud de cambios para actualizar los cambios en el repositorio de nivel superior. Para más información, consulta Clonar un repositorio y Configuración de Git.

  • Protege el repositorio con las características de seguridad disponibles de GitHub. Para más información, consulta Inicio rápido para proteger el repositorio.

  • Puede encontrar proyectos y repositorios interesantes en GitHub y realizar cambios en ellos mediante la creación de una bifurcación del repositorio. La bifurcación de un repositorio te permitirá realizar cambios en otro repositorio sin afectar al original. Para más información, consulta Bifurcar un repositorio.

  • Cada repositorio de GitHub le pertenece a una persona u organización. Puedes interactuar con las personas, repositorios y organizaciones conectándote y siguiéndolos en GitHub. Para más información, consulta Búsqueda de inspiración en GitHub.

  • GitHub tiene una excelente comunidad de soporte técnico en la que puede pedir ayuda y hablar con usuarios de todo el mundo. Únete a la conversación en GitHub Community.