✎ bzr-gtk [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== Bazaar GUI ======

<note important>
TODO (pour enlever le tag BROUILLON)
  * déplacer certaines section vers la page [[bazaar]]
  * refaire les captures d'écran avec le thème par defaut
</note>

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 [[bazaar|bzr]].

L'interface actuellement est encore en phase beta, quelques bugs peuvent exister.

===== Installation =====
Le paquet **bzr-gtk** fait partie du [[:depots#universe_et_multiverse|dépôt Universe]].
[[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt://bzr-gtk|bzr-gtk]]**

===== Aide commande bzr =====
Pour plus d'informations sur la commande bzr veuillez consulter la documentation [[http://doc.bazaar-vcs.org/bzr.dev/en/user-guide/|Bazaar User Guide (en)]]
<code>bzr help
bzr help commands # Liste des commandes
bzr help xxx # Aide sur la commande xxx</code>

===== Configuration de votre bazaar =====
Définissez votre identité
<code>bzr whoami "Votre Nom <email@exemple.com>"</code>
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=====
==== 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. :-D
<note important>Veillez à être bien familiarisé avec l'usage de la commande bzr, avant de vous lancer dans l'utilisation de bzr-gtk.</note>
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 courantes.
  * 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 :
<code>mkdir MonProjet && cd MonProjet && bzr init</code>

{{:application:bzr-gtk:bzr-gtk-initialize.png|bzr-gtk initialisation du projet}}

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.
<code>cd ~/Projets/MonProjet && touch fichier1 fichier2 fichier3</code>

Pour marquer les nouveaux fichiers à ajouter menu File/Add

{{:application:bzr-gtk:bzr-gtk-add.png|bzr-gtk marquer les fichiers à ajouter}}

Pour valider l'ajout et/ou la modification de fichiers cliquez sur le Bouton Commit ou menu Branche/Commit.

{{:application:bzr-gtk:bzr-gtk-commit.png|bzr-gtk Valider l'ajout des trois fichiers}}

==== Consulter l'historique ====
Pour consulter l'historique de votre projet. Cliquez sur le bouton Log ou menu Statistics/Log

{{:application:bzr-gtk:bzr-gtk-revision-history.png|bzr-gtk Consulter l'historique de votre projet}}

==== 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

{{:application:bzr-gtk:bzr-gtk-diff1.png|Consulter les différences entre la version encours non "commitée" et la dernière de version}}

==== 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 :
<code>mkdir SousDossier && bzr add SousDossier</code>

{{:application:bzr-gtk:bzr-gtk-mkdir.png|Ajouter un répertoire et le valider}}

==== Renommer un fichier ou un répertoire ====
Sélectionner le fichier ou le dossier à renommer et menu File/Rename

==== Supprimer un fichier ====
Sélectionner le ou les fichiers que vous souhaitez supprimer et menu File/Remove

{{:application:bzr-gtk:bzr-gtk-remove1.png|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

{{:application:bzr-gtk:bzr-gtk.png| Mettre à jour sont projet sur sa machine}}

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.

{{:application:bzr-gtk:bzr-gtk-checkout.png|Récupérer un projet existant}}

===== Liens =====
  * **(en)** [[http://bazaar-vcs.org/bzr-gtk|Site officiel]]

==== Les plus de bzr-gtk ====

Pour obtenir les différents modules de l'interface de façon inviduelle, vous pouvez lancer depuis le répertoire de votre projet/branche la commande bzr suivi de
<code>
gannotate
gcheckout
gconflicts
ginit
gmissing
gpush
gselftest
gstatus
gbranch
gcommit
gdiff
gmerge
gpreferences
graph-ancestry
gsend
gtags
</code>

----
//Contributeurs principaux : [[utilisateurs:fidji]], [[utilisateurs:jahwork]].//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : M E H K O Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported