Ceci est une ancienne révision du document !
Page d'aide à l'utilisation de l'interface bzr-gtk
bzr-gtk est une interface "facilitant l'usage de bazaar", cependant avant d'utiliser cette interface il est préférable de se familiariser à la gestion de projet et plus particulièrement à l'usage de la commande bzr.
L'interface actuellement est encore en phase beta, quelques bugs peuvent exister.
Installation
Vous devrez installer certains outils pour pouvoir travailler sur un projet
sudo apt-get install bzr bzr-gtk
Aide commande bzr
Pour plus d'informations sur la commande bzr veuillez consulter la documentation Bazaar User Guide (en)
bzr help bzr help commands # Liste des commandes bzr help xxx # Aide sur la commande xxx
Configuration de votre bazaar
Définissez votre identité
bzr whoami "Votre Nom <email@exemple.com>"
La configuration de votre bazaar se trouve dans $HOME/.bazaar
- bazaar.conf options de configuration
- locations.conf options de configuration des branches
- authentication.conf configuration des serveurs distants
Utilisation de bzr-gtk
Présentation
Bien qu'il soit bien plus rapide et fiable d'utiliser la ligne de commande, il existe une interface pour gérer votre bazaar.
L'interface bzr-gtk se présente comme suit :
- Liste à puce
- Une barre de menu regroupant les actions possibles en fonction du contexte.
- Une barre d'outils des actions coutantes.
- 1 → L'emplacement dans votre arborescence, permet également de changer d'emplacement.
- 2 → Le contenu du répertoire courant.
- 3 → La fenêtre des marques pages, correspondant à des emplacements définis dans votre arborescence.
La première action consistera à aller dans le menu Fichiers/File et d'ajouter un marque page du répertoire courant (~/Projets)/Bookmark current directory
Création d'un projet
Sélectionner dans le menu Branch/Initialize, une boite de dialogue apparaît, entrez les informations comme ci-dessous.
Revient au même que :
mkdir MonProjet && cd MonProjet && bzr init
Vous pouvez voir votre dossier MonProjet dans la partie de droite de bzr-gtk, Vous pouvez entrer dedans en double-cliquant sur l'icône du dossier. Afin de pouvoir accéder plus rapidement à votre projet, vous pouvez ajouter un marque page comme expliqué plus haut.
Ajout et validation du projet
L'interface bzr-gtk, n'étant pas vraiment un gestionnaire de fichiers, nous allons créer 3 fichiers en ligne de commande.
cd ~/Projets/MonProjet && touch fichier1 fichier2 fichier3
Pour marquer les nouveaux fichiers à ajouter menu File/Add
Pour valider l'ajout et/ou la modification de fichiers cliquez sur le Bouton Commit ou menu Branche/Commit.
Consulter l'historique
Consulter les différences
Pour consulter les différences entre la version encours non "commitée" et la dernière de version du fichier. Cliquez sur le bouton Diff ou menu Statistics/Diff.
- Le - devant la ligne indique que la ligne à été supprimée
- Le + devant la ligne indique que la ligne a été ajoutée
Créer un répertoire
Pour créer un sous dossier dans votre projet menu File/Make directory. Indiquer un nom de répertoire et cliquez sur Versioned directory. Ceci revient au même que :
mkdir SousDossier && bzr add SousDossier
Renommer un fichier ou un répertoire
Supprimer un fichier
Les bons réflexes
Si vous êtes seul à travailler sur votre projet, vous n'avez pas à vous soucier des mises à jours effectués pas d'autres personnes.
Cependant en équipe vous devez avant d'effectuer des modifications vérifier que des modifications n'ont pas été effectuées par d'autres. Première chose vous devez faire un pull du serveur launchpad vers votre répertoire projet. Cliquez sur le bouton Pull
Néanmoins si vous aviez fait des modifications avant de faire le pull et que quelqu'un d'autre avait modifié les même fichiers, dans de cas vous devrez faire un merge.
Récupérer un projet existant
Vous pouvez charger sur votre machine un projet existant et depuis n'importe quelle version (ou révision) Par exemple vous souhaitez apporter une correction à la version 30 alors que le projet en est à la 63, ce qui donnera la nouvelle version 30.1 Cliquez sur Jump-to et entrez le numéro de version désirée.