Fonction Git dans ScribeUI (fr) - smercier/scribeui GitHub Wiki

Git dans ScribeUI

Une bonne pratique d'un projet cartographique est d'utiliser Git pour gérer les versions de votre projet. ScribeUI intègre les principales fonctionnalités git dans l'interface pour rapprocher le travail de cartographie Web de celui du programmeur. Ces fonctions permettent de conserver des versions de votre projet, de faire des copies de sécurité, ou encore de transférer d'une instance ScribeUI à une autre une Map Scribe. Les principales fonctions git sont disponibles via l'interface ScribeUI.

Git Manager

Dans le Manager Scribe, on a accès au quatre fonctionnalités liées à Git: Clone, Configure, Pull, Push

Git Clone Map

La fonction Clone permet de créer un projet Map dans votre Workspace à partir d'un repository Git existant. Par exemple, tester la fonction avec le repo suivant:

https://github.com/smercier/gitscribe.git

ScribeUI ajoute le "user/password" à l'URL au moment d'effectuer l'opération demandée. Pour ne pas laisser cette information en claire dans le fichier de config git, on supprime les références à l'URL après chaque opération. La séquence de lignes de commandes est la suivante:

git init
git remote add origin "mon_url"
git pull origin master
git remote rm origin  

Git Configure Map

La fonction Configure permet de définir le git(repository git existant) d'un projet Map existant sur votre instance ScribeUI (ScribeUI n'est pas un serveur Git). Ce panorama permet de définir l'URL git à utiliser et à ajouter/modifier la description de votre projet. Sur clic du bouton Configure, Scribe initialise un repo git à partir de votre répertoire de travail. L'URL du git est conservée dans la base de données de ScribeUI:

git init
Créer un fichier .gitignore

Enfin, un fichier .gitignore est créé pour ne conserver que les fichiers essentiels de votre projet Map. Prendre note que les répertoires de données ne sont pas synchronisés avec le repository git:

data/
pdata/
debugFile.log
map/*

Git Pull Map

La fonction Pull permet de synchroniser votre carte avec un repository distant. La fonctionnalité est utile pour travailler en équipe sur le même projet. Il faut au préalable avoir fait un Configure avant de faire un Pull.

Les lignes de commande pour les différentes options sont les suivantes:

Dans tous les cas (merge, overwrite, stash/apply)

git remote add origin "my_url"
git config http.sslVerify "false"

Pull (merge)

git pull origin master
git remote rm origin

Pull (overwrite)

git fetch origin master
git reset --hard FETCH_HEAD
git clean -df
git remote rm origin

Pull (stash/apply)

git stash
git pull origin master
git stash pop
git remote rm origin

Git Push Map

La fonction Push permet d'envoyer votre projet Map Scribe dans le repository git spécifié à l'aide de la fonction Configure.

La séquence de lignes de commandes est la suivante:

git remote add origin "my_url"
git config http.sslVerify "false"
git add .
git commit -m "message"  => caractères accentués non supportés
git pull origin master
git push origin master
git remote rm origin

NOTE: _my__url contient le "user/password". C'est pour cette raison que la référence au repo est supprimée à la fin de chaque opération.

Git Readme

Scribe supporte l'édition du fichier README.markdown de votre repository. Il est accessible à l'aide du sélecteur de fichier en édition secondaire: