Notebook et programmation lettrée
  • Code source
  • Ouvrir une issue
  1. Pratique individuelle
  2. Forge logicielle
  3. .gitignore
  • Pratique individuelle
    • Introduction
      • Présentation
      • Environnement
      • Données
    • Notebook
      • Opt1 - Quarto + R
      • Opt2 - Jupyter + Python
    • Forge logicielle
      • Création dépôt
      • CI/CD
      • .gitignore
  • Pratique collective
    • Présentation
    • Environnement
    • Exercice
  • Pour aller plus loin…
    • CI/CD avancé
    • Environnements virtuels
  1. Pratique individuelle
  2. Forge logicielle
  3. .gitignore

Exclusion de fichiers du versionnage

Compilation local d’un notebook et versionnement

Lorsque que l’on fait (re)compiler son notebook par une forge GitLab grâce à une pipeline renseignée dans le fichier .gitlab-ci.yml, les fichiers de sortie seront recrées par la forge. Il est alors inutile de prendre en compte les fichiers générés (.html par exemple) en local dans le versionnage des fichiers.

Cela surcharge inutilement les commits et le travail de versionnage réalisé par Git, car a chaque compilation en local, les fichiers de sortie sont modifiés…

Il est donc fortement conseillé de ne pas prendre en compte les fichiers générés par la compilation en local du notebook dans le système de versionnage.


Le fichier .gitignore

Pour exclure des fichiers du processus de versionnement, vous pouvez utiliser une fichier nommé .gitignore et placé à la racine du répertoire (exemple). Pour exclure un fichier ou un dossier, il suffit tout simplement d’ajouter son nom dans ce fichier.

Ainsi, vous pouvez compléter le fichier .gitignore de la manière suivante :

.Rproj.user
.Rhistory
.RData
.Ruserdata
index_files
index.html

Dans le cas ci-dessus, le fichier “index.html” ne sera plus pris en compte, tout comme le répertoire “index_files” qui contient des librairies utilisées par la page web créée.

 

Produit par le GT Notebook avec Quarto - 2025