Revenir à l'[[intro_histoire_numerique:accueil|accueil]]



====== Documentation concernant GIT ======



  * Un [[https://openclassrooms.com/fr/courses/5641721-utilisez-git-et-github-pour-vos-projets-de-developpement/6297041-tirez-le-maximum-de-ce-cours|excellent tutoriel]] réalisé par Tiffany Lestroubac et Mila Paul sur OpenClassrooms
    * pour les débutants suivre seulement la Partie 1 - Faites vos premiers pas avec Git
    * [[https://openclassrooms.com/fr/courses/1233741-gerez-vos-codes-source-avec-git|ce tutoriel]] est plus compact mais présuppose quelques connaissances
    * [[https://blog.reviewnb.com/github-jupyter-notebook/|How to use Git / GitHub with Jupyter Notebook]] : explications utiles, Git utilisé en ligne de commande



====== Travailler avec GitHub en utilisant GitHub Desktop ======


  * Installer [[https://desktop.github.com/|GitHub Desktop]]
  * Toutes les explications indispensables se trouvent dans **[[https://devstory.net/10283/utiliser-github-avec-github-desktop|ce tutoriel]]**
  * Pour des explications plus développées, voir [[https://riptutorial.com/github|ce tutoriel]]



===== Télécharger des carnets Jupyter =====


  * Lancer GitHub Desktop
  * Choisir le dépot de code (repository) à télécharger, par ex. les [[https://github.com/pyshs/exemples-manuel | exemples du manuel 'Python pour les SHS]]
  * Appuyer sur le bouton vert 'Code' et choisir: //Open with gitHub desktop//
  * Dans la boîte de dialogue choisir un dossier sur votre disque dans lequel ajouter le dépôt
    * Dans le cas de l'exemple, ajouter le dépôt dans un dossier 'Tutoriels' de votre dossier racine (sur votre disque dur) dans lequel vous allez créer et gérer les carnets Jupyter 
    * Ce dossier racine sera aussi le dossier de lancement de JupyterLab (depuis la ligne de commande, s'y rendre avec la commande CD [adresse complète du dossier]
  * Exécuter: les carnets seront copies depuis GitHub vers votre dossier
  * Ouvrir JupyterLab et explorer – exécuter les carnets



===== Mettre des carnets Jupyter en ligne avec GitHub Desktop =====


  * Créer un compte sur GitHub (cf. tutoriels OpenClassrooms et GitHub Desktop ci-dessus)
  * Créer un nouveau dépôt de code pour vos carnets publics (par ex. intitulé "cours histoire numérique" ou semblable
  * Cloner le nouveau dépôt dans le dossier racine Jupyterlab de votre disque dur (avec GitHub Desktop ou en ligne de commande)
  * Y déposer les carnets préparés dans votre projet local (c'est la démarche simplifiée, normalement on travaille avec des branches puis on fusionne avec la branche master et on envoit en ligne sur GitHub