Github/GITLAB Para principantes

Víctor Suárez García - HacktoberFestEst

Víctor Suárez

Ingeniero informático por la UAL, miembro de HackLab Almería (y python almeria) y actualmente trabaja en Plexus.

Control de versiones

GIT ≠ Github/GITLAB

Git

Git es un sistema de control de versiones distribuido pensado en la eficiencia y confiabilidad de proyectos de "software"

https://git-scm.com/

Git

GIT

GIT

>git init

Pequeño repaso

Inicializar un repositorio

>git add mifichero.txt

Añadir un archivo

>git commit -m "mi super commit esta listo"

Realizar un "commit" (registrar los cambios)

En ocasiones hay que configurar usuario y email:

> git config [--global] user.name victor
> git config [--global] user.mail mimail@gmail.com

Github

GITHUB

Github es una plataforma de desarrollo colaborativo para alojar proyectos utilizando el control de versiones git.

Funcionalidades de Github:

  • Control de versiones
  • Issues
  • Pull Request
  • Wiki
  • Páginas web (github pages)
  • etc...

https://github.com

GITHUB

GITHUB

ISSUES

Issues

Una issue es una petición que puede hacerse a un repositorio; puede ser informar de un error, pedir una mejora e incluso puede ser un punto de discusion de distintos temas. Con esto ya estas contribuyendo al proyecto y sin codigo!!!

OJO: Las peticiones de Hacktoberfest se identifican por una etiqueta con el mismo nombre

Gitlab

Gitlab es una plataforma que nos va a permitir tener también repositorios tanto publicos como privados y además integración continua.

https://gitlab.com

REpositorios Gitlab

Gitlab también nos permite crear repositorios de forma sencilla. Podemos hasta usar plantillas para crearlos.

ISSUES

Con Gitlab, también podremos crear nuevas peticiones y seran importantes a la hora de trabajar en hacktoberfest (estarán etiquetadas para el evento)

ISSUES

Merge REquest

También podremos crear merge request que serán las que se aceptaran para puntuar en hacktoberfest.

MARKDOWN

MARKDOWN

Markdown es un lenguaje de marcado que te permite hacer textos enriquecidos de forma sencilla utilizando simbolos de puntuación para formatear el texto.

# Esto es una cabecera

esto es un texto libre. **Con negrita** y _cursiva_

![imagen](miimagen.png)

[enlace a github](https://github.com)

Github/Gitlab te permite utilizar Markdown para formatear la información del repo (readme), issues, pullrequest, wiki, etc...

https://guides.github.com/features/mastering-markdown/

MARKDOWN

README.md

MARKDOWN

README.md

Para añadir información sobre el proyecto es importante añadir un fichero llamado "readme.md", para poder usar markdown y que muestre información cuando se entre a nuestro repositorio.

CONtribuir a Proyectos

Contribuir a Proyectos

Contributing.md

Antes de contribuir a un proyecto es importante leer el fichero contributing.md que encontraras en cada uno para seguir las normas de cada proyecto.

Contribuir a Proyectos

FORK

Un Fork, es una copia del repositorio al que queremos contribuir que se realizará para que podamos realizar los cambios.

Simplemente pulsamos en el boton de la parte superior derecha

Github

Gitlab

También pulsaremos el boton en la parte superior derecha de la información del proyecto.

Contribuir a Proyectos

CLONE

Una vez tenemos la copia del repositorio, usaremos la orden clone, para descargar el repositorio a nuestro equipo y empezar a trabajar

OJO: debemos usar la URL de nuestra copia, no del repo original.

git clone <url-repo>

Contribuir a Proyectos

Push

Tras hacer nuestros cambios ya en local, vamos a subir al repositorio de Github. usando la orden de git push.

OJO: Recuerda que debes haber hecho commit antes de hacer push.

git add .
git commit -m "mi primera contribucion"
git push origin
git remote add origin <url-repo>

RECUERDA: Si no has hecho clone, deberás añadir el repositorio remoto con la orden remote.

Contribuir a Proyectos

Pull Request

Por último, accedemos a nuestro repositorio en github y crearemos un nuevo Pull Request

Si todo va bien, aceptaran nuestro cambio y enhorabuena!! acabas de hacer tu primera contribución.

Contribuir a Proyectos

MERGE REQUEST

Por último, accedemos a nuestro repositorio en gitlab y crearemos un nuevo merge Request

Una vez rellenados los datos y creado el merge request solo queda esperar a que acepten el cambio y tendras tu primera contribucion!!

DEMO TIME

Muchas Gracias

Twitter: https://twitter.com/zerasul

Blog: https://zerasul.me

Referencias

  • https://git-scm.com/
  • https://github.com/
  • https://opensource.org/licenses
  • https://pages.github.io

  • https://travis-ci.com/

  • https://jenkins.io/

  • https://github.com/zerasul/hacktobertest

  • https://github.com/zerasul/blask

  • https://slides.com/zerasul/git

Made with Slides.com