*******************
Nastavení parametrů
*******************

.. module:: settings.dialog
		:synopsis: Dialog used to set preferences

.. figure:: figures/settings.png
		:alt: Settings dialog

		Okno Konfigurace uživatele

Dialog nastavení se používá pro konfiguraci jak TortoiseHg, tak DVCS Mercurialu, protože TortoiseHg je vlastně uživatelská obálka programu Mercurial.

Konfigurace Mercurialu ve Windows má tři úrovně.

1) Nastavení pro počítač v souboru
   :file:`C:\\Program Files\\TortoiseHg\\Mercurial.ini`
   Tento soubor je čten jako první a má nejnižší prioritu.
2) Nastavení pro uživatele v souboru
   :file:`C:\\Documents and Settings\\username\\mercurial.ini`
   Tento soubor je čten jako druhý a může přepsat parametry nastavení pro počítač.
3) Nastavení pro repozitář v souboru   :file:`repo-root\\.hg\\hgrc`. Tento soubor je čten jako poslední a má tudíž nejvyšší prioritu.

Nastavení pro počítač může být přepsáno při aktualizaci, takže se doporučuje provádět změny jen v souborech :file:`..username\\mercurial.ini` a/nebo :file:`.hg\\hgrc`.  
V TortoiseHg je toto doporučení vynuceno tím, že se používají jen dvě úrovně nastavení:

Globální nastavení uživatele
	edituje nastavení pro uživatele :file:`..username\\mercurial.ini`
Nastavení repozitáře
	edituje nastavení pro repozitář :file:`.hg/hgrc`

Mezi těmito režimy lze přepínat ve výběrovém tlačítku vlevo nahoře. Vlastní nastavení lze provést buď ve vybraném dialogovém okně nebo editací uvedených souborů.

Většina uživatelů TortoiseHg si všechny nastavitelné parametry uloží v globálním nastavení a soubor hgrc v repozitáři použije pro uložení cest (aliasy pro vzdálené repozitáře). Vězme, že soubory pro tato nastavení neexistují dříve, než poprvé použijeme dialog Nastavení.


Záložky
=======

Nástroj pro konfiguraci programu se skládá ze záložek.

Každá záložka přibližně odpovídá jedné sekci v konfiguračním souboru. Některé sekce však byly kvůli přehlednosti rozdělený do více záložek. 

Všechny záložky kromě :guilabel:`Sync` mají stejný formát - sloupec nastavitelných parametrů s rozbalovacími seznamy možných hodnot. Názvy parametrů jsou doplněny skrytými popisy parametru a jeho možných hodnot.
Popis aktuálně editovaného parametru se rovněž objeví v textovém rámečku dole.

Podrobnější informaci o nastavitelných parametrech nalezneme na stránkách wiki pro Mercurial, kromě těch záložek, které jsou specifické pro TortoiseHg:
:guilabel:`TortoiseHg`, :guilabel:`Commit`, :guilabel:`Changelog`.

.. module:: TortoiseHg.settings
	:synopsis: Dialog used to set general TortoiseHg preferences

TortoiseHg
----------

:guilabel:`Nástroj pro slučování:`
	Grafický program pro řešení konfliktů při slučování. Pokud není určen, vybere Mercurial první použitelný nástroj, který nalezne v našem systému, nebo použije vlastní nástroj, který konflikty jenom označí. Tuto poslední možnost lze přikázat výběrem :guilabel:`internal:merge`. Volba :guilabel:`internal:prompt` vždy vybere lokální nástroj a volba :guilabel:`internal:dump` ponechá soubory v pracovním adresáři pro ruční sloučení. 

:guilabel:`Nástroj Visual Diff:`
	Určit externí program pro porovnávání diffů (příkaz extdiff)

:guilabel:`Přeskočit úvodní okno VDiff:`
	Vypustit úvodní okno se seznamem souborů a přímo použít prvky našeho 'VDiff' programu. Tuto volbu povolíme jen tehdy, pokud víme, že náš nástroj má platnou konfiguraci příkazu extdiff. Implicitní nastavení je False.

:guilabel:`Vizuální editor:`
	Editor pro zobrazování souborů, atp.

:guilabel:`Editor CLI:`
	Editor pro komunikaci z příkazového řádku.

:guilabel:`Šířka záložky:`
	Určit počet míst na která se roztáhnou záložky v různých oknech TortoiseHg. Implicitně je 'neurčeno'.

:guilabel:`Max velikost diffu:`
	Maximální velikost souboru (v KB) pro zobrazení změn v oknech pro changelog, status a commit. Nulová hodnota je pro nastavení bez limitu. Implicitně je 1024 (1MB).

:guilabel:`Diff panel dole:`
	Umístit diffový panel pod seznamem souborů v oknech pro status, shelve a commit. Implicitně je False (panel je vpravo vedle seznamu souborů).

:guilabel:`Zachytit stderr:`
	Přesměrovat stderr do bufferu, který je na konci procesu analyzován pro chyby za běhu. Implicitně je True.

:guilabel:`Dělit hgtk:`
	Při zadání hgtk z přikazového řádku rozdělit proces na pozadí tak, aby spouštěl grafické dialogy. Implicitně je True.

:guilabel:`Úplný název cesty:`
	Zobrazit celou cestu k adresáři repozitáře v záhlaví okna místo pouhého jména adresáře. Implicitně je False.

:guilabel:`Kontrola pravopisu:`
	Implicitní jazyk pro kontrolu pravopisu. Není-li specifikováno, použije se jazyk systému. Příklady: en, en_GB, en_US. Kontrola pravopisu vyžaduje aplikaci gtkspell, která je přístupná jen na počítačích 'Gnome'.

.. module:: commit.settings
	:synopsis: Dialog used to set commit specific preferences

Commit
------

:guilabel:`Jméno uživatele:`
	Jméno spojené s komity.
:guilabel:`Délka souhrnného řádku:`
	Maximální délka souhrnného řádku průvodní zprávy komitu.
	Aplikace vydá varování při překročení zadané délky, nebo není-li souhrnný řádek oddělen od případného dalšího textu prázdným řádkem. Implicitní nastavení je 0 (nevynuceno). 
:guilabel:`Délka řádku zprávy:`
	Délka zalomení řádku průvodní zprávy komitu. Je-li délka zadána, lze použít vyskakovací menu pro formátování zprávy a objeví se varování při překročení zadané délky. Implicitní nastavení je 0 (nevynuceno).
:guilabel:`Push po komitu:`
	Aplikace se pokusí poslat (push) revizi k nastavenému repozitáři po každém úspěšném komitu. Implicitně je False.
:guilabel:`Seznam auto-include:`
	Čárkami rozdělený seznam souborů, které jsou automaticky vloženy do každého komitu. Zamýšleno pouze jako nastavení repozitáře. Implicitní nastavení je None.
:guilabel:`Seznam auto-exclude:`
	Čárkami rozdělený seznam souborů, které jsou automaticky vypuštěny z výběru při otevření dialogů status, commit a shelve. Implicitní nastavení je None.


.. module:: changelog.settings
	:synopsis: Dialog used to set changelog specific preferences

Průzkumník repozitáře
---------------------

:guilabel:`Zabarvení podle autora:`
	Zabarvení changesetů podle jména autora. Není-li umožněno, jsou změny zabarveny zeleně pro sloučení, červeně pro netriviální rodiče a černě pro běžné případy. Implicitně je False.

:guilabel:`Dlouhý souhrn:`
	Zadáno-li true, spojují se řádky zpráv až do délky 80 znaků. Implicitně je False

:guilabel:`Velikost dávky logu:`
	Počet revizí načtených a zobrazených v jedné dávce. Implicitně je 500.

:guilabel:`Mrtvé větve:`
	Seznam čárkami oddělených jmen větví, které mají být ignorovány při sestavování seznamu jmen větví pro repozitář. Implicitní nastavení je None.

:guilabel:`Barvy větví:`
	Seznam mezerami oddělených jmen větví a barev ve formě 'branch:#XXXXXX'. Mezery a dvojtečky ve jménu větve musí být předznamenány zpětnými lomítky (\\). Podobně mohou být předznamenány i některé další znaky, např. \\u0040 bude dekódováno na znak @ a \\n na 'linefeed'. Implicitní nastavení je None.

:guilabel:`Skrýt tagy:`
	Seznam mezerami oddělených tagů, které se nebudou zobrazovat. Užitečný příklad: zadejte 'qbase qparent qtip' pro skrytí standardních tagů, vkládaných extenzí MQ. Implicitní nastavení je None.
	
:guilabel:`Použít expandér:`
	Zobrazit detaily changesetu pomocí rozbalovací ikony

:guilabel:`Styl nástrojové lišty`
	Jsou nabízeny čtyři možnosti: neurčeno (implicitní), small, large a theme.

.. module:: synchronize.settings
	:synopsis: Dialog used to set synchronize specific preferences

Sync
----

Na záložce :guilabel:`Sync` můžeme ukládat adresy URL (cesty) přidružených repozitářů. Tato informace se většinou ukládá do konfiguračního souboru repozitáře. Mercurial má dvě speciální jména cest, které lze pro některé operace nastavit jako implicitní cíle.

* *default* - implicitní URL ze kterého lze stahovat (pull), obvykle je to zdroj našeho klonu
* *default-push* - implicitní cíl pro operaci 'push' při použití příkazového řádku

:guilabel:`Operace po akci pull:`
	Nastavená operace se provede bezprostředně po úspěšné akci 'pull'. Volba :guilabel:`update` se rovná :command:`pull --update`, volba :guilabel:`fetch`
	se rovná extenzi fetch, volba :guilabel:`rebase` se rovná pořadí
	:command:`pull --rebase`.  Implicitní nastavení je none.

:guilabel:`Cesty ke vzdáleným repozitářům`
	V tomto panelu lze nastavit náhradní označení pro repizitáře, se kterými se často synchronizujeme. Mercurial přidá automaticky označení *default* ke zdroji klonu. Všechna označení nastavených cest se objeví v rozbalovacím seznamu dialogu Synchronizovat a lze je použít jako zkratku na příkazovém řádku.
 

.. module:: web.settings
	:synopsis: Dialog used to set web server specific preferences

Web
---

:guilabel:`Název:`
	Název repozitáře pro použití ve webovém rozhraní. Implicitní hodnota je název pracovního adresáře.

:guilabel:`Popis:`
	Popis účelu nebo obsahu repozitáře.

:guilabel:`Kontakt:`
	Jméno nebo mailová adresa osoby zodpovědné za repozitář.

:guilabel:`Styl:`
	Výběr šablony stylů

:guilabel:`Formáty pro archivaci:`
	Seznam (CSV) archivovacích formátů pro načítání

:guilabel:`Port:`
	Port, kterému má být nasloucháno.

:guilabel:`Push vyžaduje SSL:`
	Zda požadovat přenos příchozího 'push' přes SSL, aby se zabránilo 'čmuchání po heslu'. 

:guilabel:`Pruhy:`
	Kolik řádků májí zabírat "pruhy zebry" ve víceřádkovém výstupu. Implicitní nastavení je 1; hodnota 0 volbu znemožní.

:guilabel:`Souborů maximálně:`
	Maximální počet souborů uváděných v jednom changesetu.

:guilabel:`Změn maximálně:`
	Maximální počet změn uváděných v changelogu.

:guilabel:`Povolit push:`
	Zda povolit vyslání do repozitáře. Není-li nic zadáno, 'push' není dovolen. Je-li zadána hodnota "*", může push provést libovolný i neověřený uživatel. Vzdálení uživatelé musí jinak být ověřeni a jejich ověřená jména musí být přítomna v tomto seznamu (oddělená mezerou nebo ","). Obsah seznamu allow_push je zkoumán po seznamu deny_push.

:guilabel:`Odmítnout push:`
	Zda odmítnout vyslání do repozitáře. Není-li nic zadáno, 'push' není odmítnuto. Je-li zadána hodnota "*", mají  'push' zamítnut všichni uživatelé, ověření či neověření. Případný seznam deny_push je zkoumán před seznamem allow_push.

:guilabel:`Kódování:`
	Název kódování znaků.


.. module:: proxy.settings
	:synopsis: Dialog used to set proxy specific preferences

Proxy
-----

:guilabel:`Hostitel:`
	Jméno hostitele a (nepovinné) port proxy serveru, například ``myproxy:8000``.

:guilabel:`Seznam pro bypass:`
	Nepovinné. CSV seznam jmen hostitelů, kteří mají obejít proxy server.

:guilabel:`Uživatel:`
	Nepovinné. Jméno uživatele pro ověření u proxy serveru.

:guilabel:`Heslo:`
	Nepovinné. Heslo pro ověření u proxy serveru.


.. module:: email.settings
	:synopsis: Dialog used to set email specific preferences

Email
-----

:guilabel:`From:`
	Emailová adresa pro použití v záhlaví "From" a pro obálku SMTP.

:guilabel:`To:`
	CSV seznam adres příjemců emailu.

:guilabel:`Cc:`
	CSV seznam adres příjemců kopie emailu.

:guilabel:`Bcc:`
	CSV seznam skrytých adres příjemců kopie emailu.

:guilabel:`Metoda:`
	Nepovinné. Použitá metoda při posílání emailových zpráv. Je-li hodnota "smtp" (implicitní hodnota), použije se SMTP (konfigurace viz níže). 
Jinak se zadaná hodnota použije jako jméno programu, který působí jako 'sendmail' (příjímá volbu :command:`-f` pro odesílatele, seznam příjemců na příkazovém řádku, zprávu v stdin). Normálně pro posílání zpráv postačí nastavení ``sendmail`` nebo ``/usr/sbin/sendmail``.

:guilabel:`Hostitel SMTP:`
	Jméno hostitele mailového serveru.

:guilabel:`Port SMTP:`
	Port pro připojení na mailovém serveru. Implicitní nastavení je 25.

:guilabel:`SMTP TLS:`
	Připojení k mailovému serveru s použitím TLS. Implicitní nastavení je False.

:guilabel:`Uživatel SMTP:`
	Uživatelské jméno pro ověření u mailového serveru.

	:guilabel:`Heslo pro SMTP:`
	Heslo pro ověření u mailového serveru.

:guilabel:`Lokální jméno hostitele:`
	Hostitelské jméno, které může odesílatel použít pro ověření u mailového serveru.


.. module:: diff.settings
	:synopsis: Dialog used to set diff specific preferences

Diff
----

:guilabel:`Oprávka EOL:`
	Normalizovat ukončení řádků v souboru na lf nebo crlf během a po akci patch. Implicitní nastavení 'strict' normalizaci neprovádí. 

:guilabel:`Formát Git:`
	Použít rozšířený git formát záhlaví diffu. Implicitně je False.

:guilabel:`Bez datumu:`
	Do záhlaví diffů nezahrnovat data modifikací. Implicitně je False.

:guilabel:`Zobrazit funkci:`
	Ukázat funkci ve které je jednotlivá změna obsažena. Implicitně je False.

:guilabel:`Ignorovat prázdné znaky:`
	Ignorovat prázdné znaky (WS) při porovnávání řádků. Implicitně je False.

:guilabel:`Ignorovat množství WS:`
	Ignorovat změny v počtu prázdných znaků. Implicitně je False.

:guilabel:`Ignorovat prázdné řádky:`
	Ignorovat změny, jejichž řádky jsou všechny prázdné. Implicitně je False.
	
:guilabel:`Styl zabarvení:`
	Úprava stylu zabarvení diffových řádků v prohlížeči changesetů. Implicitně: foreground.


Font
====

:guilabel:`Implicitní fonty motivu`
	Použít výchozí fonty založené na aktuálním motivu GTK
	
:guilabel:`Nastavené fonty:`
	Vybrat nastavené fonty z rozbalovací nabídky. Tyto sady fontů vyjadřuji odlišnosti různých jazyků či prostředí.
	
:guilabel:`Uživatelské fonty:`
	Určit jména fontů a velikostí individuálně pro jednotlivá místa použití.
	:guilabel:`Komentář komitu:`
		Font je používán v prohlížeči changesetů a při zápisu komitu. Implicitně: monospace 10.
	:guilabel:`Text diffu:`
		Font je používán pro zápis diffů v nástrojích status a commit. Implicitně: monospace 10.
	:guilabel:`Seznam souborů:`
		Font je používán v seznamu souborů v nástrojích status a commit. Implicitně: sans 9.
	:guilabel:`Výstup příkazu:`
		Font je používán v oknech s výstupem příkazů. Implicitně: monospace 10.

	
Klávesová navigace
===================

:kbd:`Ctrl-Enter`
	Uplatnit změny a ukončit dialog; ekvivalent stisknutí tlačítka 'OK'.


Spuštění z příkazového řádku
============================

::

	hgtk repoconfig

pro nastavení repozitáře (:file:`.hg/hgrc` file) nebo ::

	hgtk userconfig

pro uživatelskou konfiguraci (:file:`Mercurial.ini` file).

Příkazy se zadávájí bez parametrů, kromě globálních voleb.

.. vim: noet ts=4