Suivi de version (Git facile)

Git, GitHub et le cloud

Git est local. C'est un programme gratuit qui tourne sur votre ordinateur et garde l'historique des versions dans le dossier lui-même, dans le dossier caché .git. Activer le suivi de version n'envoie rien sur internet et ne demande aucun compte : les versions restent uniquement sur cette machine — et si le disque tombe en panne ou si l'ordinateur est perdu, elles partent avec lui.

GitHub, c'est autre chose : un service dans le cloud qui garde une copie du dépôt. C'est à GitHub, ou à un service similaire, que LightNote envoie les versions quand vous synchronisez. Avec cette copie ailleurs, vous obtenez une sauvegarde et pouvez utiliser les mêmes notes sur un autre ordinateur : vous envoyez depuis l'un et recevez sur l'autre. GitHub est gratuit pour un usage personnel, avec des dépôts privés illimités que vous seul voyez.

En résumé : Git, ce sont les versions, sur votre ordinateur ; le dépôt distant en est une copie ailleurs — GitHub, un autre service, un dossier OneDrive ou Google Drive, ou un serveur à vous. Tant que le dossier n'a pas de dépôt distant, le panneau de suivi de version affiche Versions sur cet ordinateur uniquement. et propose le lien Sauvegarder et synchroniser…, expliqué plus bas.

Cloner un dépôt

Pour travailler sur un dépôt qui existe déjà, utilisez Fichier → Cloner un dépôt Git... — l'élément se trouve aussi sur l'écran d'accueil et dans le panneau de suivi de version d'un dossier qui n'est pas encore un dépôt. Collez l'adresse HTTPS ou SSH affichée sur la page du dépôt ; l'URL de la page elle-même convient, et une commande git clone ... copiée entière aussi. Choisissez le dossier de base et le nom du dossier : l'assistant montre où il sera créé et prévient quand il y a déjà quelque chose. Les Options avancées contiennent la branche, le clone superficiel (seulement le dernier commit) et les sous-modules.

Quand le serveur demande une connexion, LightNote pose la question dans une fenêtre : utilisateur et jeton, la phrase de passe de la clé SSH, ou la confirmation de la clé d'un serveur que cet ordinateur n'a jamais vu — la fenêtre affiche alors l'empreinte et le lien vers la liste publiée par le service, et le choix par défaut est ne pas faire confiance. La réponse va directement à Git et LightNote ne la conserve pas ; c'est le gestionnaire d'identifiants de Git qui la conserve, lorsqu'il est installé (Git for Windows fournit le Git Credential Manager). Faire confiance à la clé l'écrit dans ~/.ssh/known_hosts, comme le ferait ssh lui-même.

Si le clonage échoue, l'écran dit ce qui s'est passé et propose la sortie : essayer en HTTPS quand la clé SSH a été refusée, utiliser les certificats de Windows quand le proxy de l'entreprise inspecte HTTPS, ne télécharger que le dernier commit quand la connexion tombe en route, ou utiliser les chemins longs quand Windows refuse de créer le fichier. Les Détails techniques contiennent le message de Git, et ce qui n'est pas reconnu peut partir vers l'IA. À la fin, l'assistant ouvre le dossier cloné dans cette fenêtre ou dans une nouvelle.

Versionner le dossier ouvert

Le suivi de version est facultatif par espace de travail. Activez-le dans Outils → Espace de travail → Configuration de l'espace de travail... : LightNote crée le dépôt Git (s'il n'en existe pas encore) et affiche la barre latérale de suivi de version (Ctrl+Shift+G).

En mode automatique, LightNote enregistre des versions (commits) tout seul aux moments choisis dans les Paramètres généraux (à l'enregistrement, à la fermeture de l'onglet ou à la fermeture de la fenêtre). Pendant la session, le commit ne prend que ce que LightNote a écrit — ce qu'une CLI d'IA ou un autre programme a changé reste en attente, pour que celui qui l'a changé fasse son propre commit ; Ctrl+S enregistre la version tout de suite, et ce que l'enregistrement automatique écrit entre dans un commit toutes les 10 minutes. À la fermeture de la fenêtre (activé par défaut), le commit prend tout ce qui a changé dans le dossier, y compris hors de LightNote : c'est le filet de sécurité de fin de session. En mode manuel, vous écrivez le message et enregistrez la version dans le panneau. L'indicateur de la barre d'état montre l'état (aucune modification, X modifiés…) et, lorsqu'on clique dessus, ouvre le menu Git (voir plus bas) ; dans un dossier pas encore versionné, il ouvre la configuration de l'espace de travail sur Intégrations. Vous pouvez voir le diff de chaque fichier et restaurer (annuler) les modifications non enregistrées.

L'automatisation a 3 niveaux par dossier (dans Configuration de l'espace de travail) : Manuel (rien d'automatique), Commit automatique (enregistre des versions tout seul, mais ne synchronise pas) et Tout automatique (commit et synchronisation — push après le commit + pull périodique ; nécessite des identifiants Git sans invite). Le panneau affiche une ligne d'état avec ↑ à envoyer / ↓ à recevoir par rapport au distant, et le bouton principal passe de commit à Synchroniser lorsqu'il y a des versions à envoyer — ainsi il est clair qu'après l'enregistrement, il reste à synchroniser.

Le panneau Git et le menu Git de l'arborescence proposent Ajouter (git add) et Restaurer (git restore) par fichier, ainsi qu'un unique Voir ce qui a changé, qui ouvre l'écran de comparaison. La liste du panneau suit l'ordre naturel des chemins, et le menu contextuel d'un fichier propose aussi Copier... et Afficher dans l'Explorateur (désactivé pour un fichier supprimé).

L'écran de comparaison montre les deux versions côte à côte, alignées : les passages identiques se font toujours face et chaque côté affiche le numéro de ligne de son fichier. Une ligne modifiée apparaît en ambre, avec la partie changée surlignée à l'intérieur. Le bouton Mode unifié bascule vers le format de correctif, Inverser les côtés change la base de la comparaison, et F8 / Shift+F8 sautent d'une modification à l'autre.

Le menu Git de la barre d'état. Dans un dossier versionné, l'indicateur montre la branche et, à côté, ce qui reste à synchroniser (↓ à recevoir, ↑ à envoyer) ; le point est vert quand tout est enregistré dans une version, ambre avec des modifications en attente et rouge avec des fichiers en conflit. Un clic ouvre un menu qui commence par l'état complet et propose Enregistrer une version de tout (commit)… — il prend toutes les modifications du dossier, y compris celles d'autres programmes ; avec un message vide, il est automatique —, Ouvrir le panneau Git et, avec un dépôt distant, Synchroniser (recevoir et envoyer), Recevoir (pull avec merge), Envoyer (push) et Vérifier le distant (fetch). Recevoir fusionne toujours (merge) et ne fait jamais de rebase, quelle que soit la configuration de Git sur la machine ; si le merge a des conflits, l'envoi n'a pas lieu et le menu propose Annuler le merge en conflit…. Dans Actions automatiques, vous changez le niveau d'automatisation du dossier sans ouvrir la configuration. Dans Avancé, Exécuter une commande git… lance n'importe quelle commande dans le dossier du dépôt et en montre la sortie — sans terminal : une commande qui demande une saisie (éditeur de message, mot de passe dans la console) abandonne au lieu d'attendre ; pour celles-là, utilisez le terminal. Si Git n'est pas installé, le clic ouvre le guide d'installation.

Déplacer et renommer. Quand vous déplacez ou renommez un fichier ou un dossier dans LightNote (glisser dans l’arborescence, couper et coller, renommer), la version emporte les deux moitiés ensemble et Git enregistre un renommage. Seul ce qui était déjà versionné y entre ; un nouveau fichier dans le dossier déplacé attend, comme les autres. La même règle que Ctrl+S s’applique : avec le commit à l’enregistrement désactivé, le déplacement attend le prochain commit. Les gros fichiers restent dehors — voir Gros fichiers et limites des services.

Historique et bande de modifications

La barre de l'éditeur de code et de la note a deux boutons pour les versions du fichier. Enregistrer la version écrit le fichier et garde cette version : dans un dossier versionné avec Git, il fait un commit de ce seul fichier — ce qu'un autre programme ou une session d'IA a changé dans les autres fichiers reste à l'écart —, et hors d'un dépôt il garde un point dans l'historique local. Il devient gris, avec la raison dans l'info-bulle, quand rien n'a changé depuis la dernière version.

Versions ouvre la liste des versions du fichier ouvert (la même section de la barre latérale), et sa flèche propose Enregistrer la version avec un message…, Voir ce qui a changé depuis la dernière version et Annuler les modifications depuis la dernière version…, qui ramène le fichier à la dernière version, avec ou sans Git — le texte annulé reste dans l'historique local, et Ctrl+Z le ramène aussi. La liste réunit les commits et les enregistrements locaux : LightNote en consigne un à chaque Ctrl+S et, avec l'enregistrement automatique, au plus un toutes les 10 minutes par fichier, plus le fichier tel qu'il était avant la première écriture : elle fonctionne donc aussi dans un dossier qui n'est pas un dépôt. Chaque ligne indique le sujet, l'auteur, la date et le nombre de lignes ajoutées et retirées ; la pastille distingue un commit à vous, un enregistrement de LightNote lui-même et un commit venu d'une session d'IA. S'il y a des modifications non validées, elles occupent la première ligne. Cliquer sur une version montre ce qui y a changé ; ouvrir la version entière, comparer avec l'actuelle et comparer deux versions sélectionnées sont dans le menu contextuel.

Une bande colorée dans la marge signale les lignes modifiées depuis la dernière version — dans l'éditeur de code et dans la note, et elle suit ce que vous tapez : elle disparaît dès que vous annulez jusqu'à l'original, sans attendre un enregistrement. La dernière version est le dernier commit au moment où vous avez ouvert le fichier — sans Git, le fichier tel qu'il était à l'ouverture. L'enregistrement et le commit automatique ne la déplacent pas : les marques restent jusqu'à ce que vous cliquiez sur Enregistrer la version ou fermiez l'onglet. Pour la désactiver, Affichage → Bande de modifications ; désactivée, elle n'est pas seulement masquée — plus rien n'est calculé. Cliquer sur la bande montre l'état antérieur du passage, avec Rétablir ce passage (Ctrl+Z annule), Copier l'original et Voir dans le diff, qui ouvre la comparaison complète déjà positionnée sur cette ligne. Quand le fichier ouvert change hors de LightNote — une CLI d'IA qui y écrit, par exemple —, l'onglet sans modification en attente est rechargé en silence et la bande montre ce qui a changé ; avec vos modifications ailleurs dans le fichier, les deux sont fusionnées (Ctrl+Z annule) ; et si les deux ont touché les mêmes lignes, une barre jaune en haut de l'onglet propose Comparer, Garder celle du disque et Garder la mienne — tant que vous n'avez pas choisi, l'enregistrement automatique n'écrit pas ce fichier, et la version écartée reste dans l'historique local. Une réserve sur l'historique local : il est conservé par chemin, donc renommer le fichier perd ses enregistrements locaux — pas les commits Git.

Auteur de la ligne et changement de branche

Qui a écrit cette ligne. Dans le menu Git de la barre d’état, Auteur de la ligne (blame) place à la fin de la ligne du curseur qui l’a écrite, quand, et le résumé de la version — par exemple Ana · il y a 3 jours · corrige le total. Seule la ligne du curseur est annotée, et l’annotation suit le curseur. Une ligne qui n’est encore entrée dans aucune version indique Non suivi ; avec des modifications non enregistrées, l’annotation demande Enregistrez pour voir l'auteur, car les lignes du fichier sur le disque ne correspondent plus à celles de l’écran.

Changer de branche. Le même menu contient le sous-menu Branche : main (avec le nom de la branche actuelle), qui liste les branches locales : l’actuelle est cochée, et un clic sur une autre y bascule (git checkout). Créer une branche… demande le nom, le vérifie avant d’appeler Git (pas d’espaces, pas de .., pas de - au début) et crée la branche à partir de l’actuelle, où vous travaillez aussitôt. Le changement est désactivé tant qu’un fichier est en conflit ou qu’une synchronisation est en cours.

Sauvegarde et synchronisation : GitHub pas à pas

Le lien Sauvegarder et synchroniser… du panneau — le même que Ajouter un dépôt distant…, dans le menu ⋯ du panneau et dans le menu Git de la barre d'état — ouvre l'écran Sauvegarde et synchronisation, avec trois voies : GitHub, la recommandée ; Autre service ; et un Dossier synchronisé (OneDrive, Google Drive, Dropbox, une clé USB ou un dossier réseau). Toutes fonctionnent ; GitHub est le plus simple pour utiliser vos notes sur plusieurs ordinateurs et la sauvegarde la plus sûre. Pour GitHub :

1. Créez le compte sur github.com/signup : e-mail, mot de passe et nom d'utilisateur ; GitHub envoie un code pour confirmer l'e-mail. L'offre Free suffit.
2. Créez un dépôt sur github.com/new : donnez-lui un nom (par exemple notes), choisissez Private et ne cochez pas Add a README, .gitignore ni de licence. Il doit naître vide : avec un README, le premier envoi est refusé, car GitHub aurait déjà un historique qui n'est pas le vôtre.
3. Copiez l'adresse HTTPS que la page affiche (du genre https://github.com/vous/notes.git) et collez-la dans Adresse du dépôt, sur l'écran de LightNote. Laissez Envoyer les versions maintenant coché et cliquez sur Connecter.
4. Connectez-vous : au premier envoi, Git ouvre une fenêtre GitHub pour que vous autorisiez dans le navigateur. Ensuite, Windows garde l'accès — c'est le Git Credential Manager, fourni avec Git pour Windows, qui le garde — et vous n'avez plus à vous reconnecter.
5. Sur l'autre ordinateur, installez Git et LightNote et utilisez Fichier → Cloner un dépôt Git... avec la même adresse. Dès lors, Synchroniser reçoit ce que l'autre ordinateur a envoyé et envoie ce que vous avez fait ici.

Pour ne pas avoir à penser à synchroniser, choisissez Tout automatique dans la configuration du dossier : LightNote envoie après chaque commit et reçoit de temps en temps. Deux limites à connaître : GitHub refuse les fichiers de plus de 100 Mo et recommande des dépôts d'environ 1 Go au maximum — gardez les vidéos et les gros fichiers hors du dossier versionné. Et privé signifie que vous seul (et les personnes que vous invitez) voyez le dépôt, mais le contenu se trouve sur les serveurs de GitHub : pour ce qui est confidentiel, utilisez le Markdown sécurisé, chiffré avant de quitter l'ordinateur.

Sur le téléphone. Avec le dépôt distant connecté, Ouvrir sur le téléphone… (dans le menu ⋯ du panneau et dans le menu Git de la barre d’état) affiche un code QR. Dans LightNote sur le téléphone, touchez le nom de l’espace de travail et choisissez Scanner le code QR de l’ordinateur : le dépôt devient un nouvel espace de travail sur le téléphone. Le QR ne contient que l’adresse, jamais le mot de passe — si le dépôt est privé, le téléphone utilise le compte Git qu’il a pour ce serveur, ou demande un jeton d’accès. Le téléphone clone en HTTPS : un dépôt distant qui est un dossier de cet ordinateur (OneDrive, ci-dessous) ne lui est pas accessible.

Gros fichiers et limites des services

Les limites. GitHub avertit à partir de 50 Mo par fichier et refuse les fichiers de plus de 100 Mo ; GitLab, Bitbucket et Azure Repos refusent aussi les fichiers de plus de 100 Mo. Pour le dépôt entier, GitHub recommande jusqu’à environ 1 Go (5 Go au maximum), et l’offre gratuite de Bitbucket donne 1 Go. Un dossier synchronisé (OneDrive, Google Drive) n’a pas ce plafond.

Pourquoi la précaution se prend au commit. La limite vaut pour chaque version de l’historique, pas seulement pour les fichiers d’aujourd’hui : dès qu’un fichier de 120 Mo entre dans une version, l’envoi est refusé — et le reste après que vous avez supprimé le fichier, car l’ancienne version le contient encore.

Ce que fait LightNote. Un fichier de plus de 100 Mo reste hors de toute version que l’application enregistre — le commit automatique, Ctrl+S, Enregistrer la version, le commit à la fermeture de la fenêtre, l’instantané et la synchronisation du téléphone. Il reste dans le dossier, et un avis propose Ignorer dans Git (.gitignore). Au-delà de 50 Mo le fichier entre, avec un avertissement dans la barre d’état. Un fichier marqué pour Git LFS (qui ne garde qu’un pointeur dans le dépôt) n’est pas retenu.

Si l’envoi a déjà été refusé (la version a été enregistrée hors de LightNote, dans un terminal), le panneau Git le dit. Supprimer le fichier ne règle rien. Si la version n’a pas encore été envoyée, exécutez reset @{u} dans Avancé → Exécuter une commande git… du menu Git de la barre d’état : les versions non envoyées sont annulées et les fichiers restent tels quels ; mettez le gros fichier dans .gitignore et enregistrez la version à nouveau. Pour garder le fichier dans le dépôt, utilisez Git LFS (git-lfs.com).

Autres services, OneDrive/Google Drive et serveur personnel

Autres services. Git fonctionne de la même façon avec n'importe quel service ; seul l'endroit où vous créez le dépôt change. Les plus connus : GitLab (gitlab.com, gratuit, avec des dépôts privés jusqu'à 10 Go chacun), Bitbucket (bitbucket.org, gratuit jusqu'à 5 utilisateurs, avec 1 Go au total), Azure DevOps (dev.azure.com, de Microsoft, gratuit jusqu'à 5 utilisateurs avec des dépôts privés illimités) et Codeberg (codeberg.org, à but non lucratif, mais réservé aux projets open source — pas pour des notes privées). Créez-y un dépôt vide et privé, copiez l'adresse et choisissez Autre service sur l'écran Sauvegarde et synchronisation. Les limites des offres changent avec le temps : vérifiez-les sur le site de chaque service.

OneDrive, Google Drive ou Dropbox, sans nouveau compte. Choisissez Dossier synchronisé et indiquez le dossier du service sur cet ordinateur (par exemple C:\Users\vous\OneDrive ou G:\Mon Drive). LightNote y crée un dépôt bare — un dossier Notes.git qui ne contient que les versions, sans les fichiers de travail — et l'utilise comme dépôt distant ; le service de cloud se charge de copier ce dossier. Sur l'autre ordinateur, attendez que le dossier apparaisse synchronisé et utilisez Fichier → Cloner un dépôt Git... en collant son chemin. La même option convient à une clé USB ou à un dossier réseau, comme sauvegarde.

• Pourquoi un dépôt bare, et pas tout le dossier de notes dans OneDrive ? Le dossier .git change sans arrêt pendant que vous travaillez, et deux ordinateurs qui le synchronisent par le cloud peuvent le corrompre. Dans le dépôt bare, seul l'envoi écrit, et ce qu'il écrit ne change plus ensuite.
• Un ordinateur à la fois. Avant de travailler sur l'autre ordinateur, attendez que OneDrive ou Drive ait fini de synchroniser ; envoyer des deux côtés avant cela peut créer des copies en conflit. Si cela arrive souvent, GitHub est la voie la plus sereine.
• Si le dossier de travail est déjà dans le cloud — Windows place souvent le dossier Documents dans OneDrive —, l'écran vous prévient. Sur un seul ordinateur, OneDrive joue le rôle de sauvegarde ; pour utiliser vos notes sur plusieurs, préférez GitHub, ou sortez le dossier de notes du cloud et n'y laissez que le dépôt bare.
• Sans Git, c'est possible aussi : synchronisez tout le dossier de notes par le service de cloud et laissez le suivi de version désactivé — l'historique local continue d'enregistrer les versions de chaque fichier. C'est la voie de Vos notes sur votre téléphone.

Un serveur à vous. Pour ne dépendre d'aucune entreprise, vous pouvez héberger votre propre serveur Git. Gitea et Forgejo sont légers, ont une interface web proche de celle de GitHub et tournent dans Docker — sur un ordinateur à la maison, un Raspberry Pi, un NAS ou un VPS loué. Le plus simple de tous est un serveur avec SSH et un dépôt créé avec git init --bare. Le prix à payer est l'entretien du serveur : l'installer, le mettre à jour et le sauvegarder ; les guides d'installation sont sur le site de chaque projet. Une fois le serveur prêt, l'adresse du dépôt va dans Autre service, comme n'importe quelle autre.