== Tutoriál 1 - Začínáme instalací programu ==

''Toto je první kapitola [[CzechTutorial|Tutoriálu]]. Pokračováním je [[CzechTutorialInit|Vytvoření repozitáře]]''

Instalace Mercurialu je jednoduchá.

 * Pro Linux, Mac``OS X, a jiné Unixové varianty, proveďte instalaci podle pokynů v  UnixInstall.
 * Instalaci ve Windows, lze provést dle instrukcí ve WindowsInstall.

Po ukončení instalace se vraťe zpět. Nutno poznamenat, že ve Windows se Mercurial instaluje a používá převážně jako součást instalace TortoiseHg. Pro oba programy existují instalační pakety "~.msi".

Program Mercurialu se jmenuje {{{hg}}}.  Tímto označením začíná každý příkaz; následuje jméno příkazu a za ním případné možnosti či argumenty.

Teď, když máme Mercurial nainstalován, stačí když na příkazovém řádku v okně našeho terminálu zapíšeme {{{hg}}}, aby nám program potvrdil, že je připraven:

{{{
$ hg
Mercurial Distributed SCM

základní příkazy:

 add        přidat označené soubory pro následný commit
 annotate   zobrazit změny (v souboru) řádek po řádce
 clone      provést kopii existujícího repozitáře
 commit     zapsat určené soubory a nevyřízené změny do changesetu v repozitáři

 (...)

použijte "hg help" pro získání úplného seznamu příkazů nebo "hg -v" pro zobrazení detailů
}}}

Nainstalovanou verzi svého Mercurialu zjistíme:

{{{
$ hg version
Mercurial Distributed SCM (version 1.4)

Copyright (C) 2005-2009 Matt Mackall <mpm@selenic.com> and others
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
}}}

Mercurial bude při zápisu komitů potřebovat uživatelské jméno. Nejlepší je uvést vlastní emailovou adresu v konfiguračním souboru `~/.hgrc`<<FootNote(http://www.selenic.com/mercurial/hgrc.5.html)>>
( `%USERPROFILE%\Mercurial.ini` ve Windows) přidáním obdoby následujících řádků:
{{{
[ui]
username = John Doe <john@example.com>
}}}

Máme-li hotovo, můžeme pokračovat v kapitole [[CzechTutorialInit|Vytvoření repozitáře]].

----
CategoryCzech