✎ 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.

{{tag>bzr scripts programmation ubuntu-fr-scripts_aide brouillon}}

----

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

<code>sudo apt-get install bzr bzr-gtk</code>

===== 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 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. :-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 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 :
<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 ====
{{:application:bzr-gtk:bzr-gtk-checkout.png|Récupérer un projet existant}}

Merci de recopier le code ci-contre pour prouver que vous êtes humain : R T A O G 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