(Cette page est une traduction de la version originale en Anglais : QuickStart

Guide de démarrage rapide

(référez vous aussi à FrenchUnderstandingMercurial, FrenchTutorial)

1. 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 <john@example.com>

2. Travailler sur un projet Mercurial existant

Si vous avez une URL vers un 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 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 <mpm@selenic.com>
date:        Mon Aug 18 16:50:36 2008 -0500
summary:     Fix up tests

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

4. Clone, Commit, Merge

$ hg clone project project-work    # cloner un dépôt
$ cd project-work
$ <faire des changements>
$ hg commit
$ cd ../project
$ <faire d'autres changements>
$ 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 à : clone, ommit, pull, merge, parent

5. Exporter un patch

(make changes)
$ hg commit
$ hg export tip    # exporter le commit le plus récent

Référez vous aussi à : export

6. 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 à : serve, push, pull


CategoryFrench

FrenchQuickStart (last edited 2012-11-11 13:51:14 by abuehl)