Crear un repositorio

Para subir tu proyecto a GitHub, deberás crear un repositorio donde alojarlo.

Crear un repositorio

Puedes almacenar distintos proyectos en los repositorios de GitHub, incluso proyectos de código abierto. Con proyectos de código abierto, puedes compartir el código para hacer que el software funcione mejor y sea más confiable. Puedes utilizar los repositorios para colaborar con otros y rastrear tu trabajo. Para obtener más información, consulta la sección "Acerca de los repositorios".

Nota: Puedes crear repositorios públicos para un proyecto de código abierto. Cuando crees un repositorio público, asegúrate de incluir un archivo de licencia que determine cómo deseas que se comparta tu proyecto con otros usuarios. Para obtener más información acerca del código abierto, específicamente sobre cómo crear y hacer crecer un proyecto de código abierto, hemos creado las Guías de Código Abierto que te ayudarán fomentar una comunidad saludable mediante la recomendación de mejores prácticas para crear y mantener repositorios para tus proyectos de código abierto.También puedes tomar un curso gratuito de Laboratorio de aprendizaje de GitHub sobre cómo mantener comunidades de código abierto.

  1. En la esquina superior derecha de cualquier página, utiliza el menú desplegable y selecciona Repositorio Nuevo. Menú desplegable con opción para crear un repositorio nuevo
  2. Escribe un nombre corto y fácil de recordar para tu repositorio. Por ejemplo: "hola-mundo". Campo para ingresar un nombre para el repositorio
  3. También puedes agregar una descripción de tu repositorio. Por ejemplo, "Mi primer repositorio en GitHub". Campo para ingresar una descripción para el repositorio
  4. Elige la visibilidad del repositorio. Para obtener más información, consulta la sección "Acerca de los repositorios". Botones radiales para seleccionar la visibilidad del repositorio
  5. Selecciona Inicializar este repositiro con un README. Inicializar este repositorio con una casilla de verificación README
  6. Haz clic en Crear repositorio. Botón para crear un repositorio

¡Felicitaciones! Has creado correctamente tu primer repositorio y lo has inicializado con un archivo README.

Para aprender más sobre el CLI de GitHub, consulta la sección "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 de tu proyecto, utiliza el subcomando gh repo create. Reemplaza a project-name con el nombre que deseas dar a tu repositorio. Si quieres que tu proyecto pertenezca a una organización en vez de a tu cuenta de usuario, especifica el nombre de la organización y del proyecto con organization-name/project-name.

    gh repo create 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. Como alternativa, puedes especificar los argumentos para omitir estos mensajes. Para obtener más información sobre los argumentos posibles, consulta el manual de CLI de GitHub.

Confirma tu primer cambio

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

Cuando creaste tu nuevo repositorio, lo inicializaste con un archivo README. Los archivos README son un lugar ideal para describir tu proyecto en más detalle o agregar documentación, como la forma en que se debe instalar o usar tu proyecto. El contenido de tu archivo README se mostrará automáticamente en la página inicial de tu repositorio.

Confirmemos un cambio en el archivo README.

  1. Es la lista de archivos de tu repositorio, haz clic en README.md. Archivo README en la lista de archivos
  2. En el contenido del archivo, haz clic en .
  3. En la pestaña Editar archivo, escribe alguna información sobre ti. Nuevo contenido en el archivo
  4. Arriba del contenido nuevo, da clic en Previsualizar cambios. Botón para previsualizar archivo
  5. Revisa los cambios que realizaste en el archivo. Verás el contenido nuevo en verde. Vista previa del archivo
  6. 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 obtener más información, consulta "Crear una confirmación con co-autores múltiples". Mensaje de confirmación de tu cambio
  7. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. 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 obtener más información, consulta "Crear una solicitud de extracción nueva". Confirmar opciones de rama
  8. Haz clic en Proponer cambio en el archivo. Botón para proponer cambio de archivo

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

Los archivos README son un lugar ideal para describir tu proyecto en más detalle o agregar documentación, como la forma en que se debe instalar o usar tu proyecto. El contenido de tu archivo README se mostrará automáticamente en la página inicial de tu repositorio. Sigue estos pasos para agregar un archivo README.

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

  2. Crea un archivo README con algo de información sobre el proyecto.

    echo "info about this project" >> README.md
  3. Ingresa git status. Verás que tienes un archivo README.md sin rastrear.

    $ 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

Celebrar

¡Felicitaciones! Has creado un repositorio, además de un archivo README, y has creado tu primera confirmación en GitHub.com.

Ahora puedes clonar un repositorio de GitHub para crear una copia local en tu computadora. Desde tu repositorio local, puedes confirmar y crear una solicitud de cambios para actualizar los cambios en el repositorio de nivel superior. Para obtener más información, consulta las secciones "Clonar un repositorio" y "Configurar Git".

Puedes encontrar proyectos y repositorios interesantes en GitHub y hacerles cambios creando una bifurcación del repositorio. Para obtener más información, consulta la sección "Bifurcar un repositorio".

Cada repositorio en GitHub 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 la sección "Sé sociable ".

GitHub tiene una excelente comunidad de soporte en donde puedes pedir ayuda y hablar con las personas de todo el mundo. Únete a la conversación en la Comunidad de soporte de GitHub.

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.