Le projet Domogik utilise le gestionnaire de sources décentralisé Mercurial.

Contrairement à un gestionnaire centralisé comme CVS/SVN, pour Mercurial, chaque copie locale est un dépot "maître".

Utiliser Mercurial pour le projet Domogik reste assez simple :

Installer Mercurial

• Sur Ubuntu/Debian :

  apt-get install mercurial
  

il est ensuite nécessaire de le configurer, pour celà, vous pouvez utiliser le script configure-hgrc ou lire le man, au choix :

hg clone http://bitbucket.org/boredzo/configure-hgrc/
cd configure-hgrc
./configure-hgrc.py

Initialiser un répertoire avec le projet

• Accès développeur (par ssh) :

  hg clone ssh://domogik@rennes1.dunnewind.net/domogik
  

• Accès public (lecture seule) :

  hg clone http://hg.domogik.dunnewind.net/domogik/
  

Travailler sur la copie locale

Une fois votre copie locale obtenue, vous pouvez travailler dessus à votre guise.

Lorsque vous souhaitez garder une trace de votre évolution, vous pouvez committer votre travail :

hg commit -m "changement de XXX"

Celà effectuera un commit sur le dépot local (vous pouvez donc le faire sans connexion aucune à internet :)

Pour ajouter un nouveau fichier / répertoire au dépot :

hg add nomfichier

Attention : Mercurial ne prend pas en compte les répertoires vides

De même, pour supprimer :

hg remove xxxx

Synchronisation de / vers la copie centrale

Les opérations push et pull vous permettront de synchroniser votre travail avec la copie centrale.

• local -> central :

  hg push
  

• central -> local:

  hg pull