Introducción/Git.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<img src=\"https://git-scm.com/images/logos/downloads/Git-Logo-2Color.png\" width=\"200\">\n",
    "\n",
    "---\n",
    "`Nota: Si crees que este notebook necesita algún cambio no dudes en contribuir a su desarrollo.`\n",
    "\n",
    "---\n",
    "\n",
    "## ¿Qué es Git?\n",
    "\n",
    "[Git](https://git-scm.com/) es una herramienta de [control de versiones](https://git-scm.com/book/es/v1/Empezando-Acerca-del-control-de-versiones). Originalmente fue concebida para el desarrollo de software. Más especificamente, fue creada por Linus Torvalds para gestionar el desarrollo de los kernels (nucleos del sistema) de Linux. Pero hoy en dia Git se ha convertido en un popular protocolo para el desarrollo de cualquier proyecto que conlleve la participación de varias personas, que necesite un registro de qué cambios hizo quién, cúando y con qué propósito se hicieron los cambios. Git nos permite fácilmente cosas como: ir hacia atrás en la historia del desarrollo del proyecto, implementar nuevos cambios de manera tentativa, crear copias del proyecto en las que hacer pruebas para posteriormente fusionar la copia con el proyecto original, etc.\n",
    "\n",
    "En la comunidad científica, especialmente la que desarrolla trabajo computacional, Git se ha convertido en una cómoda manera de gestionar cualquier tarea en grupo: desde escribir un documento en colaboración hasta desarrollar unos scripts de análisis o crear una figura. Por este motivo Git es una plataforma de trabajo que se encuentra detrás de muchas de las tareas que realizamos individualmente y en grupo en la UIBCDF.\n",
    "\n",
    "## ¿Cómo se instala?\n",
    "\n",
    "### Linux\n",
    "\n",
    "Git suele estar por defecto instalado en cualquier distribución de Linux. En caso de que no sea así puedes recurrir a [su repositorio oficial](https://git-scm.com/downloads).\n",
    "\n",
    "#### Ubuntu\n",
    "\n",
    "En caso de Ubuntu, Git se encuentra en el repositorio principal y puede ser instalado con el comando:\n",
    "\n",
    "```bash\n",
    "sudo apt install git\n",
    "```\n",
    "\n",
    "### Mac\n",
    "\n",
    "Para instalar Git en Mac recomendamos acudir a [su repositorio oficial](https://git-scm.com/downloads).\n",
    "\n",
    "### Windows\n",
    "\n",
    "Para instalar Git en Windows recomendamos acudir a [su repositorio oficial](https://git-scm.com/downloads).\n",
    "\n",
    "## ¿Cómo se usa?\n",
    "\n",
    "<img src=\"https://imgs.xkcd.com/comics/git.png\" width=\"250\">\n",
    "\n",
    "### Como controlador de versiones local y personal\n",
    "\n",
    "#### ¿Quieres generar un proyecto y llevar tu propio control de versiones?\n",
    "\n",
    "Cómo crear un proyecto/repositorio:\n",
    "\n",
    "```bash\n",
    "git init\n",
    "```\n",
    "\n",
    "Cómo clonar un proyecto existente en tu máquina:\n",
    "\n",
    "```bash\n",
    "git clone /path/to/repository\n",
    "```\n",
    "\n",
    "Cómo añadir un nuevo fichero al listado de ficheros del proyecto que controla Git:\n",
    "\n",
    "```bash\n",
    "git add <filename>\n",
    "```\n",
    "\n",
    "Cómo añadir todos los ficheros presentes en el directorio al listado que controlado Git:\n",
    "\n",
    "```bash\n",
    "git add *\n",
    "```\n",
    "\n",
    "Cómo registrar los cambios de todos los ficheros seguidos por el controlador de versiones. A esta acción se la denomina \"comprometer\" (*commit* en inglés) los cambios, y se realiza para registrar en el histórico el estado actual del proyecto junto con un mensaje de texto explicando las modificaciones:\n",
    "\n",
    "```bash\n",
    "git commit -m \"Commit message\"\n",
    "```\n",
    "\n",
    "\n",
    "<img src=\"https://imgs.xkcd.com/comics/git_commit.png\" width=\"400\">\n",
    "\n",
    "Cómo consultar el estatus de todos los ficheros cambiados del proyecto:\n",
    "\n",
    "```bash\n",
    "git status\n",
    "```\n",
    "\n",
    "Cómo crear crear una rama del proyecto (una réplica o copia local) en la que realizar cambios al margen de la copia principal o maestra:\n",
    "\n",
    "```bash\n",
    "git checkout -b nombre_de_la_rama # para crear la rama\n",
    "git checkout master # para volver a la copia maestro\n",
    "git branch -d nombre_de_la_rama # para borrar la rama\n",
    "git merge nombre_de_la_rama # para fusionar los cambios de una rama en la copia maestra\n",
    "```\n",
    "\n",
    "Encuentra un breve listado de otros comandos útiles [aquí](http://rogerdudler.github.io/git-guide/index.es.html)\n",
    "\n",
    "#### ¿Quieres clonar un proyecto público existente en otra máquina?\n",
    "\n",
    "Puedes clonar un proyecto que se encuentra en una máquina remota.\n",
    "\n",
    "```bash\n",
    "git clone username@host:/path/to/repository\n",
    "```\n",
    "\n",
    "Si cuentas con los permisos adecuados, despues de haber hecho el correspondiente `commit`, puedes \"empujar\" tus cambios al repositorio remoto.\n",
    "\n",
    "```bash\n",
    "git push\n",
    "```\n",
    "\n",
    "O en el caso de que haya cambios en el repositorio remoto, puedes \"tirar\" de ellos e implementarlos en tu clon.\n",
    "\n",
    "```bash\n",
    "git pull\n",
    "```\n",
    "\n",
    "Encuentra un breve listado de otros comandos útiles [aquí](http://rogerdudler.github.io/git-guide/index.es.html)\n",
    "\n",
    "### Como cliente para un servidor remoto central de git\n",
    "\n",
    "#### En un servidor nuestro\n",
    "\n",
    "La UIBCDF no tiene todavía su servidor de Git central configurado y la información e instrucciones para configurar uno escapan al propósito de este documento.\n",
    "\n",
    "#### En la nube\n",
    "\n",
    "En la UIBCDF hacemos uso de un servidor remoto en la nube como GitHub. Conocemos que existen otras posibilidades, por ejemplo GitLab, pero por motivos históricos y porque muchas de las librerías y herramientas que usamos se encuentran como proyectos públicos en GitHub, [puedes encontrarnos ahí](https://github.com/uibcdf).\n",
    "\n",
    "Para hacer uso de GitHub, o interaccionar desde tu máquina con un repositorio de GitHub, te sugerimos acudas al [siguiente notebook](Academia.ipynb) en este repositorio.\n",
    "\n",
    "---\n",
    "\n",
    "## Dudas de uso, problemas técnicos y soluciones.\n",
    "\n",
    "Para centralizar esas dudas, sugerencias o soluciones técnicas sobre el tema de este notebook, haz uso del siguiente canal:\n",
    "\n",
    "[Foro Técnico: Git](https://github.com/uibcdf/Academia/issues/1)\n",
    "\n",
    "## Documentación, tutoriales y recursos útiles\n",
    "\n",
    "El propósito de este notebook es ser un documento únicamente introductorio. Puedes encontrar -o contribuir añadiendo- más información útil en el siguiente listado:\n",
    "\n",
    "### Español:\n",
    "https://git-scm.com/book/es  \n",
    "http://rogerdudler.github.io/git-guide/index.es.html  \n",
    "https://codigofacilito.com/articulos/que-es-git  \n",
    "https://swcarpentry.github.io/git-novice-es/\n",
    "\n",
    "### Inglés:\n",
    "https://git-scm.com/book/en  \n",
    "https://git-scm.com/docs  \n",
    "http://swcarpentry.github.io/git-novice/\n",
    "http://rogerdudler.github.io/git-guide/  \n",
    "https://www.atlassian.com/git/tutorials/what-is-git  \n",
    "https://jahya.net/blog/git-vs-github/  \n",
    "https://www.atlassian.com/git/tutorials\n"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.6.7"
  },
  "latex_envs": {
   "LaTeX_envs_menu_present": true,
   "autoclose": false,
   "autocomplete": true,
   "bibliofile": "biblio.bib",
   "cite_by": "apalike",
   "current_citInitial": 1,
   "eqLabelWithNumbers": true,
   "eqNumInitial": 1,
   "hotkeys": {
    "equation": "Ctrl-E",
    "itemize": "Ctrl-I"
   },
   "labels_anchors": false,
   "latex_user_defs": false,
   "report_style_numbering": false,
   "user_envs_cfg": false
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}