Cómo crear su primer repositorio en Github

El popular sitio de Github junto con la herramienta git lo convierte en un excelente recurso no solo para distribuir y exhibir su trabajo, sino también para facilitar un control de versiones eficiente y profesional.

En este tutorial, exploraremos cómo crear un repositorio de Github, enviar confirmaciones, lanzamientos de etiquetas y más.

Crear un repositorio

Para crear un nuevo repositorio, primero inicie sesión en Github o regístrese para obtener una nueva cuenta. Una vez que haya iniciado sesión, haga clic en el botón Crear nuevo en la esquina superior derecha de la pantalla, seguido del enlace Repositorio en la lista desplegable que aparece.

Verá la pantalla de creación de repositorio:

El nombre y la descripción del repositorio pueden ser los que desee, y para este ejemplo se utilizó "muo_demo" como nombre. Deje el resto de los campos como están / en blanco y presione el botón Crear nuevo repositorio . Se le llevará a una página que muestra su nuevo repositorio en blanco.

Iniciar repositorio local

Ahora que se ha creado un repositorio en Github, debe inicializar el repositorio en su PC local. Ejecute los siguientes comandos en la terminal para crear un directorio en blanco y agregue un archivo Readme.md.

 mkdir myrepo

 cd myrepo

 echo "# My Test Repository" > Readme.md

 echo "A temporary file" > temp.txt

Al visualizar un repositorio en Github, el contenido del archivo Readme.md siempre se muestra para describir el repositorio o como la primera página del manual. La extensión de archivo .md significa formato Markdown, y si no está familiarizado con Markdown, consulte nuestra excelente hoja de trucos sobre el formato Markdown .

Ahora puede iniciar el repositorio dentro de la terminal con los comandos.

 git init

 git remote add origin https://github.com/mdizak/muo_demo.git

En el segundo comando, debes cambiar "mdizak" por tu nombre de usuario de Github, y la parte "muo_demo" por el nombre de tu repositorio. Por ejemplo, si su nombre de usuario de Github es "johndoe" y el nombre de su repositorio es "test_repo", el comando sería:

 git remote add origin https://github.com/johndoe/test_repo.git

Primer compromiso

Ahora puede sincronizar los repositorios local y Github, y agregar los dos archivos a Github, con los siguientes comandos en la terminal.

 git add Readme.md temp.txt

 git commit -m "My first commit"

 git push -u origin master

Se le pedirá su nombre de usuario y contraseña de Github, y una vez que ingrese correctamente, los dos archivos se cargarán en su repositorio de Github. Si vuelve a cargar su repositorio de Github en su navegador, ahora verá los dos archivos junto con el encabezado "Mi repositorio de prueba" dentro del archivo Readme.md.

Grandes mensajes de confirmación

En lugar de especificar solo un pequeño mensaje de confirmación de una sola línea, también es posible incluir un mensaje de texto más grande. En su editor de texto favorito, ingrese el contenido del mensaje de confirmación, que puede ser tan grande y con tantas líneas como desee. Cuando confirme los últimos cambios, use el comando.

 git commit --file=/path/to/commit.txt

Asegúrese de que el comando apunte al archivo de texto de su mensaje de confirmación, y su contenido se utilizará en lugar del mensaje de una sola línea definido mediante la opción -m.

Eliminar archivos

La eliminación de archivos se realiza de la misma manera, excepto para usar el comando git add anterior, usamos el comando git rm . Para eliminar el archivo temp.txt que agregó anteriormente, ejecute los siguientes comandos en la terminal.

 git rm temp.txt

 git commit -m "Deleting temp file"

 git push -u origin master

Se le pedirá su nombre de usuario y contraseña nuevamente, y una vez hecho esto, el archivo temp.txt se eliminará de su repositorio de Github. ¡Eso es todo al respecto!

Etiquetado de lanzamientos

De vez en cuando, una vez que esté perfectamente satisfecho con su proyecto probado, es posible que desee etiquetar el estado actual como una versión. Esto les informa a otros que el proyecto en su estado está completo y listo para su distribución al público.

Para marcar su repositorio como una versión, agregue una etiqueta con el número de versión. Por ejemplo, para lanzar nuestro repositorio actual como v1.0.0 dentro de la terminal, ejecute los comandos.

 git tag 1.0.0

 git push --tags

Después de ingresar su nombre de usuario y contraseña de Github, vuelva a cargar la página del repositorio en su navegador web. Notará que ahora hay una versión para su repositorio. Al hacer clic para ver todas las versiones, se proporcionará un enlace al archivo TAR.GZ para ver el repositorio completo en el estado en que se etiquetó la versión.

Repositorio de clonación

En ocasiones, deberá clonar y reinicializar su repositorio desde cero. Esto se hace fácilmente con los siguientes comandos en la terminal.

 git clone https://github.com/mdizak/muo_demo.git myrepo

 cd myrepo

 git init

Al igual que cuando inicializamos el repositorio, dentro de la primera línea debe cambiar el nombre de usuario de Github y el nombre del repositorio dentro de la URL.

Esto descargará el contenido del repositorio de Github al directorio / myrepo /, y luego lo reinicializará con el comando git init . Desde allí, puede continuar agregando y eliminando archivos de la misma manera que se indicó anteriormente.

Ver historial de confirmaciones

Puede volver atrás y ver sus confirmaciones anteriores con el registro de git , como:

 git log - 3

El comando anterior mostrará las últimas tres confirmaciones realizadas en el repositorio. Esto puede resultar útil si alguna vez necesita modificar o eliminar una confirmación por cualquier motivo.

Modificar un mensaje de confirmación

Si ya ha enviado una confirmación a Github, luego se dio cuenta de que cometió un error en el mensaje de confirmación, hay una manera de corregirlo. Para modificar el último mensaje de confirmación, dentro de la terminal ejecute el comando.

 git commit --amend

Esto abrirá su editor de texto predeterminado con el mensaje de confirmación anterior. Realice los cambios necesarios y cierre el editor. Si usa nano como editor de texto, puede cerrarlo presionando Ctrl + X , seguido de las teclas Y y Enter .

Una vez que haya guardado el nuevo mensaje de confirmación, envíelo a Github con el comando:

 git push --force origin

¡Listo para mostrar tu trabajo!

Felicitaciones, ahora ha aprendido los conceptos básicos del uso del popular sitio web de Github junto con la herramienta de línea de comandos git. Ha creado correctamente un repositorio y ahora puede agregar / eliminar archivos, enviar confirmaciones, publicar etiquetas y clonar repositorios.

Si desea aprender comandos de git más avanzados, consulte el sitio de comandos de git avanzados .