Kiln » TortoiseHg » TortoiseHg
Clone URL:  
settings.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
******************* 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:`Grafický (textový) 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:`Rozvětvit 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 komentáře:` 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:`Provést push po komitu:` Aplikace se pokusí vyslat (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 Changelog --------- :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:`Kopírovat hash:` V okně Repozitory Explorer lze kopírovat ID (hash) changesetů do schránky. Zastaralé, v dalších verzích programu bude vypuštěno. Implicitní nastavení je False. :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:`Zabarvení 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 .. 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:`Jméno:` Jméno 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ý má být naslouchán. :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:`TLS SMTP:` 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:`Místní 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 aa 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é se jednotlivá změna nachází. Implicitně je False. :guilabel:`Ignorovat prázdné znaky:` Ignorovat prázdné znaky 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. 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