瀏覽代碼

Update README.md

MASSOT Olivier 9 年之前
父節點
當前提交
6a7734efe5
共有 1 個文件被更改,包括 72 次插入91 次删除
  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)  
 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):  
 Pour l'installer (Access 2010):  
 - Télécharger le fichier [vcs.accda.zip](http://codebox/dev/VCS/blob/master/vcs.accda.zip)
 - 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
 - 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'
 - Menu 'Outils de la base de données' > 'Compléments' > 'Gestionnaire de complément'
 - Cliquer sur 'Ajouter un nouveau'
 - Cliquer sur 'Ajouter un nouveau'
 - Trouver le fichier 'vcs.accda' téléchargé, et le sélectionner; valider.
 - 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.  
 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.  
 Une boite de dialogue s'affiche et demande de taper la commande désirée.  
 
 
 Liste des commandes VCS:  
 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éé: 
 [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