Archivo de la etiqueta: importar proyecto GitHub

Tutorial de Git – Aprende Git y GitHub/GitLab de manera fácil, rápida y sencilla – Parte 4

En el siguiente enlace tienes el indice para acceder al resto de entradas de este tutorial:

Hola a todos, hasta ahora hemos estado trabajando con un repositorio local, es decir todo el código de nuestro proyecto se encontraba en nuestro ordenador y solo nosotros accedemos a él.

Repositorios remotos

Lo normal en proyectos colaborativos o en los que trabajan más de una persona es tener un repositorio remoto alojado bien en algún servidor de la red interna, o directamente en internet.

Nosotros trabajaremos en nuestro repositorio local y después subiremos los cambios al repositorio remoto.

Aunque existen más, en este tutorial nos vamos a centrar en dos de las plataformas Git para alojar nuestro proyectos mas conocidas: GitHub y GitLab.

GitHub

GitHub es una plataforma de desarrollo colaborativo para alojar proyectos utilizando el sistema de control de versiones Git

En GitHub puedes almacenar tus proyectos de forma pública gratuitamente. Esto significa que tus proyectos están accesibles a cualquier persona. Por eso GitHub es muy utilizado en proyecto open source donde cualquiera puede tener acceso al código de un proyecto para poder hacer cambios o añadir funcionalidades.

Si necesitas tener  proyectos privados GitHub dispone de una opción de pago para almacenar proyectos de forma privada.

Microsoft acaba de comprar GitHub, habrá que estar atentos a la evolución que tenga la plataforma bajo la tutela de Microsoft.

Lo primero que necesitamos hacer es crear una cuenta en GitHub, para ello vamos a su página accediendo a la siguiente url:  https://github.com/

Creamos una cuenta rellenando los campos del formulario Username (nombre de usuario), Email y Password (contraseña).

Una vez registrados nos mostrará una pantalla similar a esta:

En este paso nos pide que seleccionemos el plan que queremos, por defecto marca repositorios públicos ilimitados gratis con la opción de seleccionar repositorios privados ilimitados con un coste en el momento de escribir estas líneas de 7 dólares.

Si seleccionamos la opción de pago nos pedirá los datos de facturación.

Si no tienes muy claro que plan necesitas no te preocupes, puedes empezar con la opción gratuita y más adelante si quieres puedes actualizar al plan de pago.

Una vez seleccionado el plan que queramos pulsamos en botón continuar .

En el último paso nos muestra una pequeña encuesta donde nos preguntan cual es nuestro nivel de experiencia como programadores, para qué tipo de proyectos vamos a utilizar GitHub, cual es tu perfil …

Este paso es opcional,  después de rellenar la encuesta  (o no) tras pulsar el botón continuar ya has completado la inscripción en GitHub.

Te enviarán un correo para verificar tu email, debes acceder al link que te indican en el correo para verificar la dirección de correo (Verify email address).

Al acceder al link se activará la cuenta y nos mostrará un formulario de login.

Accedes con el usuario y contraseña de la cuenta de GitHub que acabas de crear y listo.

En este punto ya podemos crear nuestro primer repositorio en GitHub:

Pulsamos el botón Start a project y accedemos al formulario para crear nuestro primer repositorio en GitHub:

Lo primero que tenemos que hacer es dar un nombre al repositorio, como no podía ser de otra manera para este primer ejemplo le vamos a  vamos a poner holamundo.

En la descripción ponemos la descripción de nuestro proyecto.

Después seleccionamos si nuestro proyecto va a ser público o privado,  recuerda que para poder tener repositorios privados debemos tener el plan de pago.

De momento no vamos a marcar la casilla Initialize this repository with a README, Este archivo lo crearemos más tarde y aprenderemos cómo se edita.

También nos da la opción de añadir un archivo .gitignore y una licencia, para este ejemplo lo dejamos en none.

Pulsamos en el botón Create repository y ya tenemos listo nuestro primer repositorio en GitHub.

Importar un proyecto desde un repositorio local – push

Lo primero que aparece al crear el repositorio es la url para acceder al mismo, tendrá el siguiente formato:

https://github.com/tu_usuario/tu_proyecto.git

Debajo nos muestra tres opciones, la primera es para crear un proyecto local desde cero, añadirle el archivo README.md y subirlo al repositorio que acabamos de crear.

La segunda opción es para subir un repositorio que ya tengamos creado en local.

Por último nos da la opción de importar un repositorio desde otro sistema de control de versiones como Subversion o Mercurial.

Como nosotros ya tenemos creado nuestro proyecto en local vamos a usar la segunda opción, entonces no tenemos más que seguir los pasos indicados:

Desde consola (Git bash o el terminal ) nos situamos en la carpeta de nuestro proyecto proyectoGit1 y añadimos el origen de nuestro repositorio remoto:

git remote add origin https://github.com/Reviblog/holamundo.git

Ahora para subir el contenido de nuestro proyecto utilizamos el siguiente comando:

git push -u origin master

Al ejecutar este comando nos pedirá que introduzcamos el usuario o el correo electrónico de nuestro usuario en GitHub y la contraseña:

Una vez logeado correctamente los archivos de nuestro repositorio local se subirán al repositorio remoto en GitHub.

Si refrescamos ahora la página en Github veremos que aparecen los archivos de nuestro repositorio local.

Ahora cada vez que hagamos cambios en nuestro repositorio local después de hacer el commit debemos utilizar el comando git push -u origin master para que los cambios se sincronicen con nuestro repositorio remoto en GitHub.

Vemos en que en la cabecera nos indica el número de commits que se han realizado, si pulsamos sobre  la palabra commits podemos ver los commits que se han realizado en nuestro proyecto, el decir, no solo se ha subido el código a nuestro repositorio si no que tenemos toda la información de los commits que tenemos en el repositorio local lo que nos permite hacer un seguimiento y volver a un punto anterior de nuestro proyecto en cualquier momento.

El archivo README.md

El archivo README.md  es un archivo de descripción de nuestro proyecto y suele contener una descripción del proyecto, modo de instalación, forma de utilización , tipo de licencia y cualquier otra información relevante sobre el proyecto.

Este archivo tiene un formato especial para representar su contenido, vamos a ver a continuación cómo se edita y como se da formato al texto contenido en el.

Si volvemos a la página inicial de nuestro proyecto  (podemos pinchar en el enlace holamundo en la parte superior de la pantalla) vemos que después del listado de los archivos  de nuestro proyecto hay un botón con el texto “Add a README“, si hacemos click sobre él nos abre un editor para editar el archivo README.md:

Tenemos dos pestañas,  “Edit files” y “Preview”.

README.md utiliza un formato Markdown.

Vamos a ver brevemente cómo utilizar el formato Markdown para nuestro archivo README.md:

Encabezados

Podemos observar que hola-mundo tiene el carácter  almohadilla “#” por delante, esto hace que se vea como un encabezado.

Una almohadilla antes del texto corresponde con un encabezado h1 de html, dos almohadillas sería igual a un h2, tres almohadillas sería igual a un h3 y así sucesivamente:

# Encabezado h1 
## Encabezado h2
### Encabezado h3
#### Encabezado h4

Citas

Para resaltar una cita usamos el símbolo  mayor que “>” antes del texto:

> "If it compiles, it is good, if it boots up it is perfect". - Linus Linus Torvalds

Cursiva y negrita

Agregamos un asterisco  “*” antes y después de la palabra o frase que queremos resaltar para cursiva y dos para negrita “**”:

*Cursiva* 

**Negrita**

Código

Se utiliza el acento grave para identificar código, y corchetes para identificar el lenguaje de programación:

 `Código`
 ``` [language]
 Código en 
 varias líneas
 ```

Listas

Para los elementos de listas no ordenadas utilizamos  el asterisco “*“:

* Primer elemento
* Segundo elemento
* Tercer elemento

Para las listar ordenadas indicamos el número del elemento con un punto:

1. Primer elemento de la lista
2. Segundo elemento de la lista
3. Tercer elemento de la lista

Enlaces

Para añadir un enlace a nuestro documento ponemos el texto del enlace entre corchetes y la url del enlace entre paréntesis:

 [Reviblog](www.reviblog.net)

Imágenes

Para incluir imágenes utilizamos el símbolo de exclamación “!” y entre corchetes el texto alternativo de la imagen seguido entre paréntesis de la url de la imagen:

![Un gato](https://reviblog.net/wp-content/uploads/2018/06/IMG_20180608_104752.jpg)

Vamos a ver como quedaría todo los que hemos visto, dejamos el archivo README.md de la siguiente manera:

# hola-mundo
Este es mi primer repositorio en GitHub

Encabezados:

# Encabezado h1
## Encabezado h2
### Encabezado h3
#### Encabezado h4

Citas:

> "If it compiles, it is good, if it boots up it is perfect". - Linus Linus Torvalds

Cursiva:

*Cursiva*

Negrita:

**Negrita**

Código:

``` [language]
Código en
varias líneas
```
Listas:

* Primer elemento
* Segundo elemento
* Tercer elemento

1. Primer elemento de la lista
2. Segundo elemento de la lista
3. Tercer elemento de la lista

Link:
[Reviblog](www.reviblog.net)

Imagen:

![Un gato](https://reviblog.net/wp-content/uploads/2018/06/IMG_20180608_104752.jpg)

Si seleccionamos la pestaña Preview changes obtendremos algo como esto:

 

Por último para que  los cambios en README.md  se hagan efectivos tenemos que hacer un commit,  podemos añadir una descripción al commit o dejar por defecto en cuyo caso la descripción del commit será “Create README.md” , después pulsamos en el Botón Commit  new File.

Por hoy lo dejamos aquí, ya hemos aprendido a crear un repositorio en GitHub y a importar nuestro proyecto local, también hemos aprendido a editar el archivo README.md.

En el siguiente enlace tienes el índice para acceder al resto de entradas de este tutorial:

En el siguiente post seguiremos aprendiendo un poco más sobre GitHub.