Ver Fonte

Update README.md

MASSOT Olivier há 9 anos atrás
pai
commit
6a7734efe5
1 ficheiros alterados com 72 adições e 91 exclusões
  1. 72 91
      README.md

+ 72 - 91
README.md

@@ -7,7 +7,8 @@ INSTALLATION
 ---------
 
 VCS est un add-in (ou complément) pour Access, qui utilise le code fourni par msaccess-vcs-integration (opensource)  
-  
+   
+   
 Pour l'installer (Access 2010):  
 - Télécharger le fichier [vcs.accda.zip](http://codebox/dev/VCS/blob/master/vcs.accda.zip)
 - Extraire le fichier 'vcs.accda' de l'archive
@@ -15,8 +16,8 @@ Pour l'installer (Access 2010):
 - Menu 'Outils de la base de données' > 'Compléments' > 'Gestionnaire de complément'
 - Cliquer sur 'Ajouter un nouveau'
 - Trouver le fichier 'vcs.accda' téléchargé, et le sélectionner; valider.
-- Fermer le gestionnaire
-
+- Fermer le gestionnaire  
+  
 VCS est maintenant accessible depuis la liste des compléments pour tous les projets Access ouverts avec cette session Windows.  
   
 
@@ -30,134 +31,114 @@ Pour utiliser les commandes VCS (Access 2010):
 Une boite de dialogue s'affiche et demande de taper la commande désirée.  
 
 Liste des commandes VCS:  
-* makesources: met à jour le code source
-* * zippe le fichier de l'application
-* * met à jour le code source
+* `makesources`
+> met à jour le code source
+  * zippe le fichier de l'application
+  * met à jour le code source  
 
-* update: met à jour l'application à partir du code source
-* * Créé une sauvegarde de l'application: [nom_app].accdb.old
-* * met à jour l'application à partir du code source
+* `update`
+> met à jour l'application à partir du code source
+  * Créé une sauvegarde de l'application: [nom_app].accdb.old
+  * met à jour l'application à partir du code source  
 
-* init: configure le dépot GIT pour VCS
-* * complète le fichier .gitignore
+* `init`
+> configure le dépot GIT pour VCS
+  * complète le fichier .gitignore  
 
 
 
 
 
-
-
-Configurer le dépot GIT d'une application Access pour utiliser VCS
+Configurer le dépot GIT d'une application Access pour utiliser VCS  
 -------
 
 [Si le dépot GIT n'est pas encore créé: 
-Créer le projet dans Codebox
-> git init
-> git remote add origin ...
-]
-
-
-Créer le fichier .gitignore s'il n'existe pas
-Dans .gitignore, ajouter:
-*.accdb
-*.laccdb
-*.mdb
-*.ldb
-
-[Si un dépot Git existait déjà, il faut retirer ces derniers fichiers de l'index:
-> git rm --cached FILENAME
-]
-
-
-Ouvrir l'application Access
-
-Créer une table "ztbl_vcs_tables", avec un seul champ texte: [tablename] (CP)
-Ajouter à ce champs le nom de chacune des tables qui doivent être incluses dans le système de versionnage.
-Exemple: 'tbl_parametres', 'Communes'...Etc
-
-
-*********
-*option 1*
-Installer le complément VCS
-
-Enregistrer
-
-Compacter l'application
-
-Lancer le complément VCS
-
-Choisir make-sources
-
-
-*option2*
+Créer le projet dans Codebox  
+`git init`
+`git remote add origin ...`  
+]   
+  
 
-Ouvrir VBA (Alt+F11)
+Créer le fichier .gitignore s'il n'existe pas  
+Dans .gitignore, ajouter:  
+*.accdb  
+*.laccdb  
+*.mdb  
+*.ldb  
 
-Outils > Références
+[Si un dépot Git existait déjà, il faut retirer ces derniers fichiers de l'index:  
+`git rm --cached FILENAME`
+]  
 
-Parcourir
 
-Ajouter c:\...\vcs.accdb
+Ouvrir l'application Access  
+  
+Créer une table "ztbl_vcs", avec un deux champs texte: [key] (CP), [val]  
+Ajouter une entrée avec pour clé `include_tables`  
+Dans le champs [val], lister les tables de paramètre qui doivent être incluses dans le suivi de version  
+ex: "tbl_parametres", "tbl_communes"...  
 
-Enregistrer
 
-Afficher la fenetre d'éxécution (Ctrl+G)
+Installer le complément VCS  
 
-Taper make-sources
+Enregistrer  
 
-*********
+Compacter l'application  
 
-(les sources doivent maintenant avoir été créées)
+Lancer le complément VCS  
 
-Zippez votre application: application.accdb -> application.zip
+Taper `makesources`  
 
-> git add *
-> git add .gitignore
-> git commit -m "Mise en place de VCS"
+(les sources doivent maintenant avoir été créées)  
 
-> git push origin master
+Lancer Git:  
+`git add *`  
+`git add .gitignore`  
+`git commit -m "Mise en place de VCS"`  
 
-!!! 
-Il est possible qu'il faille à ce niveau effectuer un force push: 
-> git push -f origin master
-Il faut pour cela que la branche master cible soit non protégée.
-!!!
+`git push origin master`  
 
-Envoyer une nouvelle version de l'application sur Codebox
+!!!   
+Il est possible qu'il faille à ce niveau effectuer un force push:  
+`git push -f origin master`
+Il faut pour cela que la branche master cible soit non protégée.  
+!!!  
+  
+  
+Pour envoyer une nouvelle version de l'application sur Codebox  
 -------
 
-Aprés avoir modifié l'application, et de manière générale à chaque fois qu'il faut utiliser Git sur les sources de l'appli:
-
-Ouvrir l'application Access (si elle n'est pas déjà ouverte)
+Aprés avoir modifié l'application, et de manière générale à chaque fois qu'il faut utiliser Git sur les sources de l'appli:  
 
-Compacter l'application
+Ouvrir l'application Access (si elle n'est pas déjà ouverte)  
 
-Vérifier le contenu de 'ztbl_vcs'
+Compacter l'application  
 
+Vérifier le contenu de 'ztbl_vcs'  
 
-Lancer le complément VCS
 
-Taper 'makesources'
+Lancer le complément VCS  
 
-Une fois l'opération terminée, lancez git, puis:
+Taper 'makesources'  
 
-> git add *
-> git commit -m [votre message]
+Une fois l'opération terminée, lancez git, puis:  
 
-Récupérer d'éventuelles modifications effectuées par d'autres
-> git pull origin master
-(résoudre les éventuels conflits)
+`git add *`  
+`git commit -m [votre message]`  
 
-> git push origin master
+Récupérer d'éventuelles modifications effectuées par d'autres  
+`git pull origin master`  
+(résoudre les éventuels conflits)  
 
-Si le pull a effectué des modifications:
+`git push origin master`  
 
-Ouvrir l'application Access (si elle n'est pas déjà ouverte)
+Si le pull a effectué des modifications:  
 
+Ouvrir l'application Access (si elle n'est pas déjà ouverte)  
 
-Lancer le complément VCS
+Lancer le complément VCS  
 
-Taper update
+Taper update