Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Creación de un repositorio

Para hospedar el proyecto en GitHub, deberás crear un repositorio donde resida.

Creación de un repositorio

Puede almacenar distintos proyectos en repositorios de GitHub, incluidos proyectos de código abierto. Con los proyectos de código abierto, puedes compartir el código para mejorar el software y hacerlo más fiable. Puedes utilizar los repositorios para colaborar con otros y rastrear tu trabajo. Para más información, vea "Acerca de los repositorios". Para obtener más información acerca de los proyectos de código abierto, visita OpenSource.org.

Notas:

  • Puedes crear repositorios públicos para un proyecto de código abierto. A la hora de crear el repositorio público, asegúrese de incluir un archivo de licencia que determine cómo quiere que se comparta el proyecto con otros usuarios. Para más información sobre el código abierto, en concreto cómo crear e incrementar un proyecto de código abierto, hemos creado Guías de código abierto que le ayudarán a desarrollar una comunidad de código abierto con la recomendación de procedimientos recomendados para crear y mantener repositorios para un proyecto de código abierto.
  • También puede tomar un curso gratuito de GitHub Skills sobre el mantenimiento de comunidades de código abierto.
  • También puedes agregar archivos de estado de la comunidad a los repositorios para establecer instrucciones sobre cómo contribuir, velar por la seguridad de los repositorios y mucho más. Para más información, vea "Creación de un archivo de estado de la comunidad predeterminado".
  1. En la esquina superior derecha de cualquier página, utiliza el menú desplegable y selecciona New repository (Nuevo repositorio). Menú desplegable con opción para crear un repositorio
  2. Escriba un nombre corto y fácil de recordar para el repositorio. Por ejemplo: "hola-mundo". Campo para proporcionar un nombre para el repositorio
  3. Opcionalmente, puede agregar una descripción del repositorio. Por ejemplo, "Mi primer repositorio en GitHub". Campo para escribir una descripción del repositorio 1. Elige la visibilidad del repositorio. Para más información, vea "Acerca de los repositorios". Botones de radio para seleccionar la visibilidad del repositorio 1. Seleccione Initialize this repository with a README (Inicializar este repositorio con un archivo Léame). Inicializar este repositorio con una casilla archivo Léame 1. Haga clic en Create repository (Crear repositorio). Botón para crear un repositorio

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

Para obtener más información sobre GitHub CLI, vea "Acerca de GitHub CLI".

  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, haga clic en README.md. Archivo Léame en la lista de archivos
  2. Encima del contenido del archivo, haga clic en .
  3. En la pestaña Edit file (Editar archivo), escriba información sobre usted mismo. Nuevo contenido en el archivo 1. Encima del nuevo contenido, haga clic en Vista previa de los cambios. Botón de vista previa del archivo
  4. Revisa los cambios que realizaste en el archivo. Verás el contenido nuevo en verde. Vista previa del archivo 1. En la parte inferior de la página, teclea un mensaje de confirmación corto y significativo que describa el cambio que realizaste al archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para más información, vea "Creación de una confirmación con varios coautores". Mensaje de confirmación para el cambio 1. 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, vea "Creación de una solicitud de incorporación de cambios". Opciones de confirmación de rama 1. Haga clic en Propose file change (Proponer cambio de archivo). Botón para proponer cambio de archivo

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

Has creado un repositorio, incluido un archivo Léame, y tu primera confirmación en GitHub.com.

  • 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, vea "Clonación de un repositorio" y "Configuración de Git".
  • 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 obtener más información, vea "Bifurcación de 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 obtener más información, consulta "Ser social".

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