Wiki de l'ARHN

Axe de recherche en histoire numérique
LARHRA UMR5190

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
Allez vers la [[besson_sylvain:economiste_juriste_documentation|page précédente - Documentation]]
\\
====== Git et Github ======
\\
====Git====

[[https://git-scm.com/|Git]] est un logiciel de gestion de versions, crée en 2005, par Linus Torvalds,  qui permet de pouvoir faire des mises à jour sans impacter le travail des autres et pour voir une trace de toutes nos modifications (et d'éventuellement revenir à une version antérieure).

[[https://git-scm.com/doc|Documentation officielle]] de Git. 

[[https://fr.wikibooks.org/wiki/Git|Wikibooks fr]] très complet sur le fonctionnement de Git.

Installation sur les différents systèmes d'exploitation :

  * [[https://git-scm.com/download/win|Windows]]
  * [[https://git-scm.com/download/mac|Mac]]
  * [[https://git-scm.com/download/linux|Linux]]

----
\\
====Github====

Nous avons fait le choix d'utiliser qui [[https://github.com/|Github]], service web d'hébergement et de gestion de développement de logiciels qui repose sur Git. Ce choix est avant tout motivé, car c'est actuellement le plus utilisé et qu'il est simple d'utilisation.

Ce [[https://guides.github.com/|guide]] permet de comprendre les principales fonctions de Github.

Ce [[https://openclassrooms.com/fr/courses/5641721-utilisez-git-et-github-pour-vos-projets-de-developpement/6297041-tirez-le-maximum-de-ce-cours|tutoriel]], réalisé par Tiffany Lestroubac et Mila Paul sur OpenClassrooms, est aussi très bien fait pour savoir utiliser Git et Github.

----
\\
====Github desktop====

Nous avons eu aussi recours à [[https://desktop.github.com/|Github desktop]] (le site n'indique que les versions Windows et Mac, mais il est aussi disponible sur [[https://dev.to/rahedmir/is-github-desktop-available-for-gnu-linux-4a69|Linux]]) afin de transmettre les carnets de nos machines vers le dépôt Github. Cela a aussi permet surtout de passer par une interface graphique.

Vous pouvez suivre ce [[https://devstory.net/10283/utiliser-github-avec-github-desktop|tutoriel]] pour comprendre son fonctionnement.

----
\\
====Extension Jupyter====

Nous utilisons aussi une [[https://github.com/jupyterlab/jupyterlab-git|extension]] de Jupyterlab pour avoir Git, de même que nous utilisons une [[https://github.com/jupyterlab/jupyterlab-github|extension]] pour avoir Github. Ils sont notamment utiles pour cloner des dépôts Github dans Jupyterlab.

----
\\
====Clé SSH pour Github====
Afin de se connecter de façon sécurisée depuis une machine locale vers Github, il nous a semblé utile d'avoir recours à une [[https://help.gnome.org/users/seahorse/stable/about-ssh.html.fr|clef SSH]].

Cette clef est en deux parties :
  * Une clef publique disponible par tous
  * Une clef privée est secrète

Il faut pour cela créer une [[https://docs.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent|clef privée sur une machine locale]] puis ensuite reporter la clef publique sur [[https://docs.github.com/en/github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account|Github]]. Cela fonctionne à la fois sur Windows, Mac et Linux.

----
\\
Les différents carnets créés durant ce projet sont disponibles sur ce [[https://github.com/Semantic-Data-for-Humanities/Economists_Lawyers|dépôt Github]]. Ils permettent de prendre connaissance de la façon dont nous avons procédé pour extraire des informations sur les économistes et les juristes et comment nous les avons traités ensuite.
----
\\

====Site Web Github====

Il est possible de créer dans Github un site web hébergé par le site. La manière de procéder est légèrement différente si l'on souhaite faire un site pour un projet ou pour une organisation (ou une compte utilisateur). 
Pour un projet, vous pouvez le faire à partir d'un dépôt où il est préférable de créer une branche dédiée intitulée //[[https://github.com/Semantic-Data-for-Humanities/Economists_Jurists/tree/gh-pages|gh-pages]]// dans laquelle tous les fichiers liés au site web se trouveront. 
Alors que pour une organisation ou un compte utilisateur, il faut créer un dépôt dédié avec le nom exact de l'organisation ou de l'utilisateur (ex: semantic-data-for-humanities.github.io). Il est préférable d'utiliser la branche //master// car le dépôt est créer dans le seul but de faire le site web et non d'avoir du code en parallèle. 

Cette page explique très clairement la manière de procéder: [[https://www.freecodecamp.org/news/publishing-an-organization-homepage-on-github-pages-347dbd700f4e/|Publishing an organization homepage on GitHub Pages]]

C'est aussi expliquer ici: [[https://pages.github.com/| github pages]]

Ce tableau résume la façon de faire selon le type de site:

{{ :projets_individuels:github_pages_2021_05_20.png |}}

Il faut ensuite aller dans les paramètres du dépôt et cliquer sur "//Pages//". Il suffit ensuite indiquer la branche qui correspond au site. Il y a aussi la possibilité d'intégrer un thème Jekyll (soit ceux qui sont proposés ici soit en regardant sur le site). Pour notre part, nous avons fait le choix de créer notre site web en HTML. 

Enfin il est aussi possible d'avoir un nom de domaine personnaliser ainsi que de renforcer la sécurité en mettant le site avec une adresse "https" (il est mis par début pour un site avec un nom de domaine par défaut)

{{ :projets_individuels:github_pages_2021-05-19_1_.png |}}

Par la suite, il est possible d'indiquer l'adresse du site sur le dépôt dans le "à propos" en haut à droite de la page.

Le site du projet est disponible à cette [[https://semantic-data-for-humanities.github.io/Economists_Jurists/index.html|adresse]].
Wiki de l'ARHNAxe de recherche en histoire numériqueLARHRA UMR5190

Outils pour utilisateurs

Outils du site

Outils de la page

Wiki de l'ARHN

Axe de recherche en histoire numérique
LARHRA UMR5190
