Github 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 Everis Murcia.

Control de versiones

GIT ≠ Github

Git

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

Git

GIT

GIT

>git init

Pequeña chuleta

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

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

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 te permite utilizar Markdown para formatear la información del repo (readme), issues, pullrequest, wiki, etc...

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

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.

DEMO TIME

Muchas Gracias

Referencias

Github para principiantes

By zerasul

Github para principiantes

  • 76
Loading comments...

More from zerasul