====== Guía de instalación de Git y Visual Studio Code en Raspberry Pi ======

===== Git en Raspberry Pi =====

==== 1.Instalar Git. ====

Lo que aprenderá en esta guía, es a instalar y utilizar el software de control de versiones de Git para trabajar en tus propios proyectos dentro de Raspberry.

Lo que vas a aprender:

  * Instalar Git en Raspberry
  * Crear un Repositorio y subirlo a Github

Vamos a utilizar los conocimientos de [[https://github.com/fullmakeralchemist/raspberrysetupes|SSH Raspberry]] en esta guía utilizando el Shell de Raspberry desde Putty y vamos a ingresar el siguiente comando:
<code>

sudo apt install git

</code>

{{  :guias:guias:gitvisual:installgitmedium.png  }}

{{ guias:guias:gitvisual:gitintaled.png }}

==== 2.Configurando Git. ====

Lo primero que debemos hacer es ingresar a Git nuestra información. Esto es importante, ya que muchas personas pueden usar Git de forma colaborativa, por lo que es necesario saber quién realizó cambios en qué archivos. Puede usar su propio nombre de usuario y dirección de correo electrónico.

Así que ingresaremos los siguientes comandos:

<code>
git config --global user.name "usuariogit"

</code>
<code>
git config --global user.email "emailusuariogit@mail.com"

</code>

{{ guias:guias:gitvisual:usergitmedium.png }}

{{ guias:guias:gitvisual:emailgitmedium.png }}

A continuación, debes decirle a Git qué editor de texto desea usar. Si no tienes un editor favorito, simplemente puedes escribir:

<code>
git config --global core.editor nano

</code>

{{ guias:guias:gitvisual:editormedium.png }}

==== 3.Creando nuestro primer proyecto ====

¿Quieres empezar un nuevo proyecto? Tal vez sea un bot como Jarvis que te cuide en todo momento. Necesitará de un directorio en su computadora para todos sus archivos, así que lo primero que debe hacer es crear ese directorio.

En la terminal, puedes usar el comando ls (en lista el contenido del directorio actual) para revisar las carpetas y archivos.

En la terminal, puedes usar el comando cd (cambio de directorio) para cambiar un nuevo directorio.

En la terminal, puedes usar el comando mkdir (crear directorio) para crear un nuevo directorio.

<code>
ls

</code>
<code>
cd Desktop

</code>
<code>
mkdir snitch-sniffer

</code>
<code>
cd snitch-sniffer

</code>

{{ guias:guias:gitvisual:cddirecotymeidun.png }}

A continuación, puedes crear un archivo que le dirá a las personas de qué se trata el proyecto. Puede utilizar cualquier editor de texto para hacer esto, como el Bloc de notas o mas adelante cuando tengamos el Visual Studio Code puedes hacer un segundo archivo para practicar. Crea un archivo llamado README.md, La extensión .md significa Markdown, que es un lenguaje de marcado. Puede obtener más información sobre Markdown [[https://daringfireball.net/projects/markdown/|aquí]]. Para crear un archivo desde el Shell de Raspberry utilizaremos el comando:
<code>

nano README.md

</code>

Ahora podremos ingresar texto en nuestro archivo, para guardar el archivo "Ctrl+O" y finalmente para salir del editor "Ctrl+X".

Una segunda opción es utilizar los conocimientos anteriores de [[https://github.com/fullmakeralchemist/raspberrysetupes|Wireless Setup]], para ingresar por VNC y crear el archivo. Como en cualquier ordenador usaremos clic derecho, opción nuevo y le damos un nombre y extensión al archivo.

Yo ingrese el siguiente texto en el archivo README.md
<code>

# The Golden Snitch Sniffer

   This is a project that uses multiple long-range ultrasonic sensors to find and track an object flying in three-dimensional space. It displays the object's coordinates, speed, and trajectory through a VR headset.

</code>

{{ guias:guias:gitvisual:readme.png }}

{{ guias:guias:gitvisual:textreadmemedium.png }}

Su archivo debería haber sido creado y ahora estará ubicado en su directorio. Puede escribir en la terminal para ver una lista de archivos el siguiente comando.

<code>
ls

</code>

Por el momento, el directorio es como cualquier otro de su sistema. Ahora necesitas hacer la parte de el control de versiones. Esto se conoce como repositorio de Git y toma la forma de un directorio oculto que realiza un seguimiento de todos los cambios en el directorio de trabajo. Escriba lo siguiente para crear el repositorio, que de ahora en adelante solo se llamará repositorio:

<code>
git init

</code>

{{ guias:guias:gitvisual:gitinitraspberry.png }}

Si vuelve a escribir ls, no parecerá que haya cambiado nada. Sin embargo, puede usar `ls -a` para ver todos los archivos y directorios ocultos.

Ahora debería ver algo como esto en la ventana de su terminal:

<code>
. .. .git README.md

</code>

Ese directorio .git es el esqueleto del repositorio. Puede echar un vistazo al interior escribiendo lo siguiente.

<code>
ls -a .git

</code>

Así que ahora tienes la parte de la mochila mágica, pero aún no le has agregado nada. Ese archivo README.md aún no se ha colocado en la bolsa. Debe decirle a Git que desea agregar el archivo README.md al repositorio. Para hacer esto, simplemente escriba:

<code>
git add README.md

</code>

Sin embargo, a veces es más fácil agregar todo al repositorio, en lugar de agregar archivos individuales. Para hacer esto, puede escribir:

<code>
git add --all

</code>

Ahora Git sabe que necesita realizar un seguimiento de todos los cambios que suceden en el archivo README.md. Puede ver el estado de su repositorio en cualquier momento escribiendo lo siguiente:

<code>
git status

</code>

La respuesta anterior le indica que el archivo README.md aún no se ha confirmado. Esto significa que, aunque Git conoce el archivo, todavía no tiene almacenado ninguno de sus contenidos. La forma más sencilla de realizar una confirmación es escribiendo:

<code>
git commit -am "add README.md"

</code>

Esto confirma todos los cambios que ha realizado en el directorio en el repositorio de Git y agrega un mensaje que dice lo que hizo. El mensaje puede ser cualquier cosa en realidad, pero es mejor que sea bastante breve pero descriptivo de lo que ha cambiado.

{{ guias:guias:gitvisual:gitcomitt1medium.png }}

==== 4.Trabajando con un Github ====

Ahora que sabe cómo hacer lo básico en Git, es hora de aprender a usarlo en todo su potencial: úselo para compartir su trabajo y colaborar con otros.

Hay muchos servicios que alojarán su repositorio de Git de forma gratuita. GitLab es uno de esos servicios y BitBucket es otro. En este recurso, utilizará GitHub, que es uno de los servicios más populares.

Lo primero que debe hacer es registrarse para obtener una cuenta en [[https://github.com/join?source=header-home|GitHub]] y simplemente elegir el plan gratuito.

Ahora que tiene una cuenta, puede crear un repositorio de snitch-sniffer en GitHub. Busque el botón Nuevo repositorio y haga clic en él.

{{ guias:guias:gitvisual:new-repo.png }}

Asigne un nombre y una descripción al repositorio y haga clic en el botón Crear repositorio.

{{ guias:guias:gitvisual:new-repo2.png }}

A continuación, debería aparecer una página de instrucciones.

{{ guias:guias:gitvisual:instructions.png }}

Como ya tiene un repositorio listo para enviar a GitHub, entonces todo lo que necesita hacer es asegurarse de estar en el directorio de su proyecto y escribir:
<code>

git remote add origin git@github.com:HarryPotter/snitch-sniffer.git

</code>

y luego:

<code>
git push -u origin master

</code>

Si busca en GitHub, ahora debería poder ver su repositorio, junto con el archivo README.md que se muestra y que escribió.

{{ guias:guias:gitvisual:gh-repo.png }}

Cada vez que realiza cambios en su proyecto y desea enviarlos a GitHub, puede escribir:

<code>
git push origin master

</code>

Si está trabajando en una rama diferente, escribiría:

<code>
git push origin <branch-name>

</code>

Para saber mas acerca de Git en Raspberry te recomiendo ir a [[https://projects.raspberrypi.org/en/projects/getting-started-with-git|Getting started with Git]].

===== Instalar Visual Studio Code en Raspberry. =====

==== 1.Instalación. ====

Thonny IDE (entorno de desarrollo integrado) incluido con la última versión del sistema operativo Raspberry Pi OS. Thonny viene con Python 3.7 integrado, por lo que no es necesario instalar nada.

Como preferencia personal mi IDE favorito es VS CODE, para algunos proyectos como Apps en Flask, Bots y Tensorflow, me siento mas cómodo trabajando en la interfaz de VS. La gran noticia es que VS Code ahora está disponible como parte de los paquetes apt de Raspberry Pi OS. Inicie la terminal Raspberry Pi y ejecute los siguientes comandos:
<code>

sudo apt update

</code>
<code>
sudo apt full-upgrade

</code>
<code>
sudo apt install code -y

</code>

Tardara un poco la instalación, después de terminar, puedes acceder por VNC y revisar que la instalación fue exitosa.

{{ guias:guias:gitvisual:visualraspberrymedium.png }}

Listo con esto, podemos empezar a trabajar con VS CODE y Git, trata de utilizar lo aprendió en esta guía, para crear un segundo repositorio con VS.

También puedes revisar el repositorio de este post en mi Github.