#pragma section-numbers 2 # language fr # 2009-08-08 Frédéric Bouquet (youshe) - Première traduction en Français (Cette page est une traduction de la version originale en Anglais : [[QuickStart]] = Guide de démarrage rapide = ''(référez vous aussi à [[FrenchUnderstandingMercurial]], [[FrenchTutorial]])'' <> == Fixer un nom d'utilisateur == Par défaut, Mercurial utilise un nom d'utilisateur de la forme '{{{user@localhost}}}' pour les commits. Cela n'a souvent aucun sens. Il est conseillé de configurer votre propre adresse e-mail dans {{{~/.hgrc}}} (ou pour un système Windows dans {{{%USERPRIFILE%\Mercurial.ini}}}) en ajoutant les lignes suivantes en les adaptant : {{{ [ui] username = John Doe }}} == Travailler sur un projet Mercurial existant == Si vous avez une URL vers un [[Repository|dépôt]] consultable d'un projet (par exemple [[http://selenic.com/hg]]), vous pouvez en faire une copie ainsi : {{{ $ hg clone http://selenic.com/hg mercurial-repo real URL is http://www.selenic.com/hg/ requesting all changes adding changesets adding manifests adding file changes added 6908 changesets with 13429 changes to 976 files updating working directory 861 files updated, 0 files merged, 0 files removed, 0 files unresolved }}} Ceci va créer un nouveau répertoire appelé {{{mercurial-repo}}}, récupérer l'historique complet du projet et [[Update|mettre à jour]] le [[Tip|plus récent]] [[ChangeSet]]. Pour regarder quelle révision a été récupérée : {{{ $ cd mercurial-repo $ hg parents changeset: 6907:6dcbe191a9b5 tag: tip user: Matt Mackall date: Mon Aug 18 16:50:36 2008 -0500 summary: Fix up tests }}} == Mettre en place un nouveau projet Mercurial == Vous aller vouloir commencer par créer un dépôt : {{{ $ cd project/ $ hg init # crée .hg }}} Mercurial va chercher un fichier appelé [[.hgignore]] à la racine de votre dépôt qui contient un ensemble de patterns au format "glob" et d'expressions régulières à ignorer dans les chemins de fichiers. Voici un exemple de fichier .hgignore : {{{ syntax: glob *.orig *.rej *~ *.o tests/*.err syntax: regexp .*\#.*\#$ }}} Testez votre fichier .hgignore avec : {{{ $ hg status # Montre tous les fichiers non ignorés }}} Ceci va lister tous les fichiers qui ne sont pas ignorés avec un drapeau '?' (non suivi). Editez votre fichier .hgignore jusqu'à ce que seulement les fichier que vous voulez suivre soient listés par `status`. Vous voulez probablement suivre votre fichier .hgignore aussi, mais probablement pas les fichiers générés par le processus de construction. Une fois que vous être satisfaits, ordonnez vos fichiers à ajouter, ensuite [[Commit|commitez] : {{{ $ hg add # Ajouter ces fichiers 'inconnus' $ hg commit # Commiter tous les changements, éditer le ChangeSet $ hg parents # Regardez la révision actuellement suivie }}} == Clone, Commit, Merge == {{{ $ hg clone project project-work # cloner un dépôt $ cd project-work $ $ hg commit $ cd ../project $ $ hg commit $ hg pull ../project-work # récupérer les ChangeSet de project-work $ hg merge # fusionner le nouveau Tip de project-work dans notre répertoire de travail $ hg parents # voir les révisions qui ont été fusionnées dans notre répertoire de travail $ hg commit # commiter le résultat de la fusion }}} Reportez vous aussi à : [[Cmd:clone]], [[Cmd:ommit]], [[Cmd:pull]], [[Cmd:merge]], [[Cmd:parent]] == Exporter un patch == {{{ (make changes) $ hg commit $ hg export tip # exporter le commit le plus récent }}} Référez vous aussi à : [[Cmd:export]] == Support réseau == {{{ # clone depuis le dépôt Mercurial principal $ hg clone http://selenic.com/hg/ $ cd hg # Mettre à jour un dépôt existant $ hg pull http://selenic.com/hg/ # Exporter votre dépôt actuel via HTTP avec une interface consultable sur le port 8000 $ hg serve -n "My repo" # Envoyer les changements vers un dépôt en utilisant SSH $ hg push ssh://user@example.com/hg/ }}} Référez vous aussi à : [[Cmd:serve]], [[Cmd:push]], [[Cmd:pull]] ---- CategoryFrench