README.md

Présentation

Ce document a pour objectif d'expliquer le fonctionnement de Git pour les ateliers du CREPP.
Un répertoire Git a été créé pour centraliser les supports des ateliers ainsi que les codes et projets produits depuis la création du CREPP en 2012.
Il est donc en perpétuelle amélioration.

Localisation

Le répertoire est disponible à l'adresse suivante : https://github.com/CREPP-PLOEMEUR ou bien en passant sur le site du CREPP, dans la section Ressources GIT

Menu principal

Une fois le lien cliqué, vous tombez directement sur cette interface

Les répertoires facilement accessibles sont :

• Le répertoire Supports PDF regroupe les supports PDf utilisés pour les Ateliers Arduino et Microcontrôleurs.
• Le répertoire Codes Arduino est une compilation des codes Arduino utilisés lors des ateliers.
• Le répertoire Codes ESP12 est une compilation des codes ESP12 des ateliers.

Sous ces trois répertoires, vous avez accès à l'ensemble des répertoires du CREPP. Pour afficher tous les répertoires, vous pouvez cliquer
sur View all repositories en bas de la page.

Il est possible de classer les répertoires en cliquant sur Sort et de les classer en fonction de :

• Les dates de modifications
  
• Les noms
  

Actuellement, voici les répertoires :

• codes Arduino
  
• Codes ESP12
  
• Codes Pico
  
• Projets Ateliers Jeunes
  
• Projet Capteur pollution atmospherique
  
• Projet Cocci-Bot
  
• Projet Crepp-Rap
  
• Projet Fauteuil roulant
  
• Projet MySensors
  
• Projet Pot Qui pense
  
• Projet Raspi-Bot
  
• Projet SimpleCDBot
  
• Projet Ventilateur
  
• Supports PDF
  

Exploration d'un répertoire

L'arborescence

En cliquant sur un répertoire, l'arborescence de ce dernier apparaît avec le premier rang des dossiers et les fichiers sur le même niveau.
En cliquant sur les noms des dossiers, on peut parcourir l'arborescence du répertoire complet.

Une description du répertoire est disponible avec un fichier README.md. (ici le répertoire Codes Arduino)

Les principaux langages utilisés dans le répertoires sont indiqués à droite de la section README.

Récupération d'un fichier

Un fichier contenant du code

Pour récupérer le contenu d'un fichier particulier, il faut parcourir l'arborescence pour le trouver.
Une fois le fichier localisé, il faut cliquer sur le fichier afin de voir son contenu :

Enfin, il ne reste plus qu'à cliquer sur Copy raw contents pour copier tout le texte du fichier dans le presse-papier.

Un fichier PDF

Pour récupérer le fichier PDF, après l'avoir localisé, il suffit de cliquer sur le bouton Download.

Remarque

Cette méthode est contraignante quand nous sommes ammenés à manipuler plusieurs fichiers au sein d'un même répertoire. La méthode suivante va vous expliquer comment télécharger directement tout un répertoire pour travailler par la suite en local.

Téléchargement d'un répertoire

Pour télécharger un répertoire dans son intégralité, il faut tout d'abord se placer à la racine de celui-ci en cliquant sur le
nom du répertoire (Codes Arduino):

Ensuite, il faut cliquer sur le bouton vert Code pour dérouler un petit menu puis cliquer sur Download ZIP

Le répertoire va se télécharger au format ZIP dans vos téléchargements avec le suffixe -master. Par exemple, le répertoire Codes Arduino sera téléchargé sous le nom Codes Arduino-master.zip. Il ne vous reste plus qu'à extraire le fichier pour explorer le répertoire.