1
<chapter id="configuring-kate">
5
>&Anders.Lund; &Anders.Lund.mail;</author>
6
<othercredit role="translator"
18
>Polskie tłumaczenie</contrib
20
> <othercredit role="translator"
28
>wozniakk@ceti.pl</email
32
>Polskie tłumaczenie</contrib
38
>Konfiguracja &kate;</title>
40
<sect1 id="configuring-overview">
46
>konfiguracja</primary>
48
>ustawienia</secondary>
50
>właściwości</tertiary
52
<anchor id="find"/> <anchor id="find-again"/> <anchor id="replace"/> <anchor id="undo"/> <anchor id="redo"/> Program &kate; udostępnia kilka narzędzi dostosowania swojego zachowania do wymagań użytkownika. Do najważniejszych należą: </para>
57
>Okno konfiguracji</term>
60
>Podstawowe narzędzie konfiguracji programu &kate;, komponentu edytora i zainstalowanych wtyczek.</para
70
>Pozwala na zmianę często używanych ustawień oraz wywołuje okna konfiguracji.</para
80
>Pozwala użytkownikowi podzielić aktywną ramkę oraz włącza i wyłącza wyświetlenie paska ikon oraz numerów wierszy dla bieżącego dokumentu.</para
86
>Wbudowany terminal korzysta z parametrów konfiguracji ustawionych w &systemsettings;, ale można je zmienić w menu kontekstowym po naciśnięciu<mousebutton
88
> przycisku myszy.</para>
92
<sect1 id="configuring-kate-configdialog">
94
>Główne okno konfiguracji</title>
98
<imagedata format="PNG" fileref="configdialog01.png"/>
103
>Okno konfiguracji &kate; wyświetla listę dostępnych tematów konfiguracyjnych po lewej stronie, a karty konfiguracji odpowiadające wybranym tematom po prawej stronie.</para>
106
>Tematy konfiguracji dzielą się na dwie grupy <itemizedlist>
109
><link linkend="config-dialog"
110
>Konfiguracja programu</link>
115
><link linkend="config-dialog-editor"
116
>Konfiguracja edytora</link
126
<sect1 id="config-dialog">
128
>Konfiguracja programu &kate;</title>
130
>Ta grupa zawiera parametry konfiguracyjne dotyczące samego zachowania programu &kate;.</para>
132
<sect2 id="config-dialog-general">
134
>Karta: Ustawienia ogólne</title>
136
>W karcie tej umieszczone są globalne ustawienia programu &kate;.</para>
142
><anchor id="config-general-behavior"/>
144
>Zachowanie</guilabel
151
><anchor id="config-dialog-general-warn-mod"/>
153
>Ostrzegaj o plikach zmienionych przez zewnętrzne procesy</guilabel
157
>W przypadku włączenia tej opcji program &kate; poinformuje użytkownika w przypadku, gdy edytowany plik został zmieniony przez inny program. Sprawdzenie tego faktu odbywa się przy każdym aktywowaniu okna programu &kate;. Możliwe jest dokonywanie wybranych operacji na wielu zmodyfikowanych dokumentach: można je wczytać ponownie, zapisać lub porzucić zmiany.</para>
159
>Jeżeli opcja jest wyłączona, to &kate; nie będzie pytać o reakcję w przypadku, gdy plik zostanie zmodyfikowany przez inny program.</para>
166
><!-- /behavior group -->
170
><anchor id="config-general-meta-data"/>
172
>Informacje dodatkowe</guilabel
179
><anchor id="config-general-keep-meta-information"/>
181
>Zachowuj informacje dodatkowe między sesjami</guilabel
185
>Jeżeli opcja jest aktywna, to &kate; będzie zapisywać dane dodatkowe takie jak np. ustawione zakładki, dane konfiguracji sesji, itp., kiedy dokumenty są zamykane. Dane te będą wykorzystane przy ponownym otwarciu dokumentu.</para
191
><anchor id="config-general-delete-meta-information-after"/>
193
>Usuń nieużywane dodatkowe informacje po</guilabel
197
>Określa maksymalną liczbę dni, przez którą &kate; będzie przechowywać informacje dotyczące nieotwieranych plików. Pozwala to na utrzymywanie rozsądnych rozmiarów bazy informacji dodatkowych.</para
201
<!--Choose default text editing component-->
206
><!-- /meta data group -->
211
<sect2 id="config-dialog-sessions">
213
>Karta: Sesje</title>
216
>Poniższa sekcja zawiera informacje dotyczące <link linkend="fundamentals-using-sessions"
217
>korzystania z sesji</link
224
><anchor id="config-dialog-sessions-elements"/>
226
>Elementy sesji</guilabel
233
>Dołącz konfigurację okien</guilabel
237
>Jeżeli opcja jest włączona to &kate; zapisze wraz z informacją o sesji także bieżącą konfigurację okien.</para
243
><!-- /elements of sessions -->
247
><anchor id="config-dialog-sessions-startup-behavior"/>
249
>Zachowanie przy starcie programu</guilabel
253
>Pozwala na określenie zachowania programu &kate; po uruchomieniu. Ten parametr może zostać unieważniony poprzez uruchomienie &kate; z odpowiednimi parametrami <link linkend="command-line-options"
254
>w linii poleceń</link
260
>Uruchom nową sesję</guilabel
264
>Jeżeli ta opcja jest aktywna, to &kate; po uruchomieniu utworzy nową, nienazwaną sesję.</para
270
>Wczytaj ostatnią sesję</guilabel
274
>Program &kate; wczyta ostatnio wykorzystywaną sesję. Opcja ta jest bardzo przydatna, jeżeli użytkownik rzadko zmienia sesje i zwykle korzysta z jednego zestawu edytowanych plików.</para
280
>Wybierz sesję ręcznie</guilabel
284
>Program &kate; wyświetli okno dialogowe pozwalające wybrać pożądaną w danej chwili sesję. Jest to zachowanie domyślne, korzystne w przypadku, gdy użytkownik często korzysta z wielu różnych sesji.</para
290
><!-- /startup behavior -->
294
><anchor id="config-dialog-sessions-exit-behavior"/>
296
>Zachowanie przy wyjściu z programu lub przy zmianie sesji</guilabel
303
>Nie zapisuj sesji</guilabel
307
>Zmiana ustawień sesji (listy otwartych plików, konfiguracja okien) nie będzie zapisywana. Jednakże użytkownik będzie pytany o reakcję w przypadku niezapisanych plików. Dzięki tej opcji można raz skonfigurować sesję i później nie martwić się o zamykanie dodatkowych otwartych plików, których nie powinno być przy następnym otwarciu sesji.</para
313
>Zapisz sesję</guilabel
317
>Program &kate; zapisze dane dotyczące sesji, z wyjątkiem sytuacji, gdy sesja jest nienazwana. Jeżeli opcja ta jest włączona, to sesje zawsze będą przywracane do stanu z chwili ich zamknięcia. Jest to zachowanie domyślne. </para
323
>Zapytaj użytkownika</guilabel
327
>Zostanie wyświetlone pytanie o zapisanie sesji za każdym razem, gdy nazwana sesja będzie zamykana.</para
333
><!-- /exit/switch behavior -->
339
<sect2 id="config-dialog-documentlist">
342
>Lista dokumentów</guilabel
349
>Cieniowanie tła</guilabel
353
>Pozwala na włączenie lub wyłączenie funkcji cieniowania tła dla ostatnio używanych dokumentów oraz na określenie koloru cieniowania. Więcej informacji na ten temat znajduje się w sekcji <link linkend="kate-mdi-tools-file-list"
354
>Lista dokumentów</link
365
>Określa kolejność sortowania dla listy dokumentów. Zmiana porządku sortowania jest możliwa za pomocą menu kontekstowego dostępnego po naciśnięciu prawego przycisku myszy na liście dokumentów.</para
372
<sect2 id="config-dialog-plugins">
379
>Ta karta pokazuje listę zainstalowanych w programie &kate; wtyczek. Zawiera ona nazwę i krótki opis każdej dostępnej wtyczki oraz pole opcji pozwalające na włączenie lub wyłączenie wtyczki. </para>
382
>Jeżeli wtyczka posiada możliwość konfiguracji, to wyświetlone zostanie okno podrzędne z odpowiednimi polami do wypełnienia.</para>
386
<sect2 id="config-dialog-fileselector">
389
>Wybór pliku</guilabel
396
>Pasek narzędzi</guilabel
400
>Pozwala na skonfigurowanie przycisków widocznych na pasku narzędzi przeglądarki plików. Z listy dostępnych akcje należy przenieść odpowiednie ikony na listę <guilabel
401
>Zaznaczone akcje</guilabel
402
>, a następnie ustawić je we właściwej kolejności za pomocą przycisków strzałek.</para>
409
>Autosynchronizacja</guilabel
413
>Przeglądarka systemu plików będzie automatycznie zmieniać wyświetlany katalog na katalog bieżącego dokumentu. Dzieje się to w następujących sytuacjach: <itemizedlist
416
>Podczas aktywacji dokumentu.</para
420
>Gdy wybór pliku staje się widoczny.</para
423
> Jeżeli ta opcja nie zostanie włączona, to użytkownik może szybko przejść do katalogu bieżącego dokumentu za pomocą przycisku <guilabel
424
>Bieżący katalog dokumentu</guilabel
425
>, znajdującego się na pasku narzędzi. </para
432
>Zapamiętane lokalizacje</guilabel
436
>Pozwala określić liczbę pozycji w historii przeglądanych katalogów. Powtarzające się wpisy nie są zapamiętywane.</para
443
>Zapamiętane filtry</guilabel
447
>Pozwala określić liczbę pozycji w historii wykorzystywanych filtrów. Filtry powtarzające się nie są zapamiętywane.</para
458
>Określa czy przeglądarka systemu plików ma zapamiętywać bieżący katalog i filtry plików podczas przełączania pomiędzy sesjami.</para>
467
<sect2 id="config-dialog-general-sync-konsole">
477
>Automatycznie synchronizuj konsolę z bieżącym dokumentem, kiedy jest to możliwe</guilabel
481
>Włączenie tej opcji spowoduje, iż wbudowana konsola będzie automatycznie zmieniać katalog roboczy (poleceniem systemowym <command
483
>) na ten, w którym znajduje się aktywny dokument. Zmiana będzie następować zawsze przy wczytaniu nowego lub zmianie bieżącego dokumentu. Jeżeli opcja ta jest wyłączona, to zmiana katalogu będzie wymagała działania użytkownika. </para
490
<sect2 id="config-dialog-externaltools">
492
>Narzędzia zewnętrzne</title>
495
>Ta strona wyświetli się, gdy zostanie włączona wtyczka <guisubmenu
496
>Narzędzia zewnętrzne</guisubmenu
497
>.Wtyczka ta, powoduje wyświetlenie w menu <guimenu
499
> podmenu <guisubmenu
500
>Narzędzia zewnętrzne</guisubmenu
501
>. Są to programy operujące na danych związanych z bieżącym dokumentem, np: jego nazwą, katalogiem, tekstem lub zaznaczonym fragmentem. Ta karta pozwala na zarządzanie narzędziami zewnętrznymi: zmianę, usuwanie lub dodawanie nowych.</para>
504
>Każde narzędzie zewnętrzne to polecenie powłoki zawierające w wywołaniu makra reprezentujące dane dotyczące bieżącego dokumentu. Podczas uruchomiania narzędzia makra te są zamieniane na dane dotyczące dokumentu.</para>
508
>Właściwości narzędzi zewnętrznych</title>
514
>Etykieta narzędzia, która wyświetli się w menu Narzędzia zewnętrzne.</para
523
>Skrypt powłoki uruchamiany przy wywoływaniu narzędzia. Podczas uruchamiania skryptu przekazywane są do niego następujące makra: <variablelist>
529
>Pełna ścieżka dostępu dla bieżącego dokumentu lub pusty napis, jeżeli dokument nie został jeszcze zapisany.</para
538
>Rozdzielana spacjami lista ścieżek dostępu do wszystkich otwartych dokumentów (z wyjątkiem dokumentów nie zapisanych). </para
547
>Katalog, w którym znajduje się bieżący dokument lub pusty napis, jeżeli nie został on jeszcze zapisany.</para
556
>Pełna ścieżka dostępu dla bieżącego dokumentu lub pusty napis, jeżeli dokument nie został jeszcze zapisany.</para
565
>Numer wiersza bieżącego dokumentu, w którym znajduje się kursor.</para
574
>Numer kolumny bieżącego dokumentu, w której znajduje się kursor.</para
583
>Zaznaczony fragment tekstu z bieżącego dokumentu lub pusty napis, jeżeli nic nie zostało zaznaczone</para
592
>Pełny tekst bieżącego dokumentu. Należy korzystać uważnie z tego makra, gdyż tekst może przekroczyć maksymalną dopuszczalną długość wywołania polecenia w systemie.</para
607
>Program wykonywalny używany jako skrypt. Parametr ten jest wymagany i wykorzystywany podczas sprawdzania, czy dane polecenie jest dostępne w systemie. Dopuszczalne jest podanie pełnej ścieżki dostępu do programu, jeżeli nie znajduje się on w katalogu określonym przez zmienną środowiskową <envar
618
>Rozdzielana średnikami lista typów MIME, dla których dane polecenie może być wykonane. Aktualnie nie jest wykorzystywana.</para
627
>Powoduje, iż program &kate; zapisze bieżący lub wszystkie otwarte dokumenty przed uruchomieniem skryptu. Jest to przydatne w sytuacji gdy skrypt bezpośrednio przetwarza dane znajdujące się w edytowanym pliku.</para
633
>Wiersz poleceń</term>
636
>Wypełnienie tego pola powoduje, iż narzędzie staje się dostępne <link linkend="advanced-editing-tools-commandline"
637
>w linii poleceń edytora</link
639
>exttool-<replaceable
640
>Nazwa linii poleceń</replaceable
642
> (nazwa tu wprowadzona musi być poprzedzona napisem: <quote
644
>) w wywołaniu linii poleceń.</para
654
<sect1 id="config-dialog-editor">
656
>Konfiguracja edytora</title>
658
>Ta grupa ustawień zawiera karty dotyczące konfiguracji komponentu edytora &kate;. Większość parametrów w nich określonych ma wartość domyślną, która może zostać zmieniona poprzez <link linkend="pref-open-save-modes-filetypes"
659
>definicje typu pliku</link
660
>, <link linkend="config-variables"
661
>zmienne dokumentu</link
662
> lub przez ich zmianę w czasie edycji dokumentu.</para>
665
<sect2 id="appearance">
673
>Zawijanie wyrazów</guilabel
677
<varlistentry id="appearance-settings">
680
>Dynamiczne zawijanie wyrazów</guilabel
684
>Powoduje, iż wiersze będą zawijane na krawędzi okna.</para
690
>Znaczniki dynamicznego zawijania wyrazów (jeśli możliwe)</guilabel
694
>Wybiera sposób wyświetlania znaczników dynamicznego zawijania wyrazów. </para
700
>Wyrównaj pionowo dynamicznie zawijane linie do głębokości wcięć: </guilabel
704
>Włącza automatyczne wyrównywanie dynamicznie zawiniętych wierszy do aktualnego poziomu wcięcia tekstu. Zwiększa to czytelność kodu.</para
706
>Dodatkowo użytkownik może ustawić procent maksymalnej szerokości ekranu, przy której dynamicznie zawijane wiersze nie będą wyrównywane w pionie. Na przykład ustawienie parametru na 50% spowoduje że poziom wcięcia głębszy niż 50% szerokości ekranu nie będzie automatycznie wyrównywany w pionie dla dynamicznie zawijanych wierszy.</para
716
>Paski boczne</guilabel
723
>Pokaż znaczniki zwijania (jeśli dostępne) </guilabel
727
>Włączenie tej opcji spowoduje pokazanie w aktualnie edytowanym dokumencie znaczników zwijania kodu (jeżeli opcja zwijania kodu jest włączona).</para
733
>Pokaż pasek ikon </guilabel
737
>Włącza wyświetlanie paska ikon po lewej stronie okna edytora. Na pasku ikon widoczne są np. znaczniki zakładek.</para
743
>Pokaż numery wierszy </guilabel
747
>Włącza pokazywanie numerów wierszy po lewej stronie okna edytora.</para
753
>Pokaż znaki na pasku przewijania </guilabel
757
>Zaznaczenie opcji powoduje wyświetlenie znaczników na pionowym pasku przewijania. Znaczniki te wskazują m.in. na miejsce wstawienia zakładki w tekście.</para
767
>Sortuj menu zakładek </guilabel
775
>Według położenia </guilabel
779
>Zakładki zostaną posortowane w kolejności numerów wierszy, dla których zostały ustawione.</para
785
>Według utworzenia </guilabel
789
>Każda nowa zakładka zostanie dodana na końcu listy niezależnie od miejsca jej położenia w dokumencie.</para
800
>Zaawansowane </guilabel
808
>Włącz tryb zaawansowany (tryb KDE 3) </guilabel
818
>Pokaż linie wcięć </guilabel
822
>Zaznaczenie tej opcji spowoduje uwidocznienie w oknie edycyjnym linii pomagających zidentyfikować poszczególne poziomy wcięcia tekstu.</para
828
>Podświetl zakres między wybranymi nawiasami </guilabel
832
>Jeśli jest włączone, obszar między zaznaczonymi, odpowiadającymi sobie nawiasami będzie podświetlony.</para
843
<sect2 id="prefcolors">
845
>Czcionki i kolory</title>
848
>Ta karta pozwala na konfigurację ustawień czcionek i kolorów dla poszczególnych schematów wyświetlania oraz definiowanie nowych i usuwanie istniejących schematów. Każdy schemat zawiera ustawienia dotyczące kolorów i czcionek oraz style dla tekstu normalnego i dla podświetlania składni. </para>
851
>Program &kappname; pokaże w oknie aktywny w danym momencie schemat kolorów, jeżeli będzie potrzeba zmiany innego schematu, to można go wybrać za pomocą pola rozwijanej listy <guilabel
853
>. Przyciski <guibutton
857
> pozwalają utworzyć nowy schemat bądź usunąć już istniejący.</para>
859
>Na dole strony możesz wybrać <guilabel
860
>Domyślny schemat dla &kappname;</guilabel
863
<sect3 id="prefcolors-colors">
868
<varlistentry id="prefcolors-colors-text-background">
871
>Tło tekstu</guilabel
877
<varlistentry id="pref-colors-normal-text">
880
>Normalny tekst</guilabel
884
>Kolor domyślny dla tła obszaru edycyjnego. Będzie to kolor wyraźnie dominujący w oknie edytora.</para
888
<varlistentry id="pref-colors-selected-text">
891
>Zaznaczony tekst</guilabel
895
>Tło dla zaznaczonego fragmentu tekstu. Wartości domyślne są pobierane z ustawień globalnych środowiska &kde;. </para
899
<varlistentry id="pref-colors-current-line">
902
>Bieżąca linia</guilabel
906
>Kolor edytowanego wiersza. Jeżeli będzie on choć trochę inny od koloru tła, to pozwoli on skupić uwagę na aktualnie edytowanym wierszu tekstu. </para
910
<varlistentry id="pref-colors-marks">
917
>Rozwijana lista wyboru, pozwalająca określić kolory dla różnych rodzajów zakładek. Kolor jest mieszany z kolorem tła dla zaznaczonej linii, tak więc bieżąca linia, lub linia z kilkoma zakładkami, ma tło będące efektem zmieszania kilku kolorów. Kolor zakładek jest również wykorzystywany do pokazywania znaczników na bocznym pasku przewijania.</para
925
<varlistentry id="prefcolors-colors-other-elements">
928
>Dodatkowe elementy</guilabel
935
>Tło lewej krawędzi</guilabel
939
>Kolor wykorzystywany dla tła paska ikon, numerów wierszy i znaczników zwijania po lewej stronie edytora (jeżeli jest on widoczny). </para
945
>Numery linii</guilabel
949
>Kolor wykorzystywany dla wyświetlania numerów wierszy na pasku po lewej stronie okna edycyjnego (jeżeli są widoczne).</para
955
>Podświetlanie nawiasów</guilabel
959
>Kolor wykorzystywany do podświetlania tła par odpowiadających sobie wzajemnie nawiasów w kodzie programu. </para
965
>Znaczniki zawijanego tekstu</guilabel
969
>Kolor wyświetlania wzoru po lewej stronie dynamicznie zawiniętych wierszy, które zostały automatycznie wcięte i wyrównane pionowo jak również wyświetlania znacznika statycznego zawijania wyrazów.</para
975
>Znaczniki tabulacji i spacji</guilabel
979
>W kolorze tym wyświetlane są znaczniki tabulacji. </para
989
<sect3 id="prefcolors-fonts">
993
>Można tutaj ustawić czcionkę dla konfigurowanego schematu. Dostępna jest lista wszystkich czcionek zainstalowanych w systemie oraz możliwość ustawienia jej stylu oraz rozmiaru. W dolnej części wyświetlany jest przykładowy tekst z użyciem wybranej czcionki, aby pokazać efekt dokonanego wyboru. </para>
996
<sect3 id="prefcolors-normal-text-styles">
998
>Style normalnego tekstu</title>
1000
>Style normalnego tekstu stanowią domyślną wartość, wykorzystywaną dla określania kolorów dla innych stylów podświetlania, o ile nie definiują one własnych. Pozwala to na prezentację tekstu w zwarty i przejrzysty sposób, np. tekst komentarza, zawsze będzie miał ten sam kolor i wygląd w prawie wszystkich formatach tekstowych, które można wyświetlić w edytorze.</para>
1002
>Pozycja na liście stylów wyświetlania pokazana jest z użyciem skonfigurowanych kolorów i wyglądu czcionki, co pozwala na natychmiastowy podgląd stylu. </para>
1004
>Każdy styl pozwala na wybór wspólnych atrybutów dotyczących zarówno koloru tła, jak i koloru tekstu. Aby usunąć ustawienie dla koloru tła należy nacisnąć prawy przycisk myszki i skorzystać z menu kontekstowego.</para>
1007
<sect3 id="prefcolors-highlighting-text-styles">
1009
>Style podświetlania tekstu</title>
1011
>Ta karta pozwala na ustawienie stylów tekstu używanych przez określoną regułę podświetlania składni. Program automatycznie wybiera regułę związaną z aktualnie edytowanym dokumentem. Aby wybrać inną regułę, należy skorzystać z listy rozwijanej <guilabel
1012
>Podświetlenie</guilabel
1013
> widocznej w górnej części okna. </para>
1015
>Pozycja na liście stylów wyświetlania pokazana jest z użyciem skonfigurowanych kolorów i wyglądu czcionki, co pozwala na natychmiastowy podgląd stylu. </para>
1017
>Każdy styl pozwala na wybór wspólnych atrybutów dotyczących zarówno koloru tła jak i koloru tekstu. Aby usunąć ustawienie koloru tła należy nacisnąć prawy przycisk myszki i skorzystać z menu kontekstowego. Dodatkowo dostępna jest informacja o tym, czy aktualne ustawienie jest zgodne z ustawieniem domyślnym oraz możliwość ewentualnej zmiany tego ustawienia na wartości domyślne.</para>
1019
>Reguła podświetlania może zawierać w sobie inne reguły podświetlania, co jest reprezentowane jako grupa na liście stylów podświetlania. Na przykład większość reguł podświetlania składni dziedziczy pozycję "Alert", a reguły podświetlania dla kodu źródłowego programów dziedziczą ustawienia dla formatu Doxygen. Zmiana kolorów w tych grupach dotyczy tylko stylów używanych w konfigurowanej regule podświetlania składni. </para>
1024
<sect2 id="pref-edit">
1028
<sect3 id="pref-edit-general">
1036
>Tabulatory</guilabel
1043
>Wstaw spacje zamiast tabulatorów</guilabel
1047
>Zaznaczenie tej opcji powoduje, iż po naciśnięciu klawisza 	 edytor będzie wstawiał określoną liczbę spacji, w zależności od pozycji, oraz ustawienia <option
1048
>Szerokość tabulacji</option
1055
>Pokaż tabulatory</guilabel
1059
>Włączenie opcji, spowoduje wyświetlanie przez &kappname; małej kropki dla oznaczenia znaków tabulacji.</para>
1062
>Opcja powoduje również wyświetlanie kropki dla spacji poprzedzających w wierszu, zachowanie to zostanie poprawione w przyszłych wersjach &kappname;.</para
1067
<term id="pref-tab-width"
1069
>Szerokość tabulacji</guilabel
1073
>Jeśli opcja <link linkend="pref-word-wrap"
1074
>Wstaw spacje zamiast tabulatorów</link
1075
> jest włączona, to pole określa liczbę spacji, na które edytor automatycznie zmieni każdy znak tabulacji.</para
1083
<term id="pref-word-wrap"
1085
>Statyczne zawijanie wyrazów</guilabel
1089
>Zawijania wyrazów to funkcja, powodująca iż edytor automatycznie zaczyna nową linię tekstu i przenosi (zawija) kursor na jej początek. &kappname; automatycznie rozpocznie nową linię tekstu, jeżeli ilość znaków w bieżącej linii osiągnie wielkość zdefiniowaną w opcji <link linkend="pref-wrap-words-at"
1090
>Zawijaj wyrazy na:</link
1096
>Włącz statyczne zawijanie wyrazów</guilabel
1100
>Opcja włącza lub wyłącza statyczne zawijanie wyrazów.</para>
1106
>Pokaż znaczniki statycznego zawijania wyrazów</guilabel
1110
>Zaznaczenie tej opcji spowoduje wyświetlanie pionowej linii w miejscu określonym przez parametr "kolumna zawijania" w menu <menuchoice
1112
>Ustawienia</guimenu
1114
>Konfiguracja &kate;...</guimenuitem
1116
> (w karcie: "Edycja"). Znacznik zawijania wyrazów jest wyświetlany tylko w przypadku stosowania czcionki o stałej szerokości.</para>
1120
<term id="pref-wrap-words-at"
1122
>Zawijaj wyrazy na:</guilabel
1126
>Jeśli opcja <link linkend="pref-word-wrap"
1127
>Włącz statyczne zawijanie wyrazów</link
1128
> jest wybrana, to pole określa liczbę znaków w linii, przy której edytor automatycznie rozpocznie nową linię.</para>
1145
>Usuń spacje na końcu wiersza</guilabel
1149
>Włączenie tej opcji powoduje, że &kappname; automatycznie usunie dodatkowe spacje na końcu linii tekstu.</para
1156
>Podświetl spacje na końcu wiersza</guilabel
1160
>Włączenie tej opcji powoduje, że &kappname; podświetli dodatkowe spacje na końcu linii tekstu.</para
1167
>Automatyczne nawiasy</guilabel
1171
>Włączenie tej opcji powoduje, że po wpisaniu lewego nawiasu ([, (, lub {) &kappname; automatycznie doda prawy nawias (odpowiednio: }, ), lub ]) po prawej stronie kursora.</para
1181
<sect3 id="pref-edit-cursor-selection">
1183
>Kursor i zaznaczanie</title>
1190
>Ruch kursora tekstu</guilabel
1197
>Sprytny klawisz Home i End</guilabel
1201
>Wybranie pozycji powoduje, iż naciśnięcie klawisza "Home" przesuwa kursor na początek tekstu w wierszu, pomijając ewentualne znaki wcięcia.</para>
1207
>Zawijaj kursor</guilabel
1211
>Podczas przesuwania kursora za pomocą <emphasis role="bold"
1213
> i <emphasis role="bold"
1215
> klawisza strzałki będzie on przechodził na początek poprzedniego/następnego wiersza po osiągnięciu początku/końca wiersza, podobnie jak w innych edytorach tekstu.</para
1217
>Włączenie tej opcji spowoduje, iż przesuwanie kursora klawiszami strzałek poza koniec wiersza (po prawej stronie) przeniesie go w dół na początek następnego wiersza. Podobnie kiedy kursor jest przesuwany przed początek wiersza (po lewej stronie), to przeniesie się na koniec wiersza znajdującego się powyżej. Kiedy opcja ta nie jest wybrana to przesunięcie kursora w prawo spowoduje kontynuację pracy w tym samym wierszu, natomiast przesunięcie w lewo na początku wiersza jest niemożliwe. Ten tryb pracy może być użyteczny podczas pisania programów.</para>
1223
>PageUp/PageDown przenosi kursor</guilabel
1227
>Opcja ta zmienia zachowanie kursora w przypadku naciśnięcia klawiszy <keycap
1231
>. Gdy nie jest ona zaznaczona, to kursor zachowuje względną wizualnie pozycję w oknie dokumentu &kappname;. Jeżeli więc kursor znajduje się w środku okna, to po naciśnięciu tych klawiszy dalej będzie widoczny w środku okna (chyba że osiągnięty zostanie początek lub koniec dokumentu). Jeżeli opcja jest wybrana, to naciśnięcie klawiszy przesunie kursor na początek, bądź na koniec, nowo wyświetlonej w oknie strony dokumentu.</para>
1237
>Automatycznie centruj kursor (wiersze):</guilabel
1241
>Określa liczbę wierszy, które program stara się pokazywać powyżej i poniżej aktualnej pozycji kursora.</para>
1251
>Tryb zaznaczania tekstu</guilabel
1262
>Zaznaczony fragment zostanie zastąpiony przez wprowadzany tekst zaś przesunięcie kursora zlikwiduje zaznaczenie tekstu.</para>
1268
>Trwałe zaznaczenia</guilabel
1272
>Zaznaczenie pozostanie aktywne nawet po przesunięciu kursora, czy też wprowadzeniu nowego tekstu.</para>
1282
<sect3 id="pref-edit-indent">
1291
>Domyślny tryb wcięć:</guilabel
1295
>Pozwala na określenie domyślnie stosowanej reguły wcięć. Zalecane jest ustawienie tutaj <userinput
1298
>Normalny</userinput
1299
> i ustawienie reguł wcięć w konfiguracji typów plików, dla takich formatów jak kod w C/C++ czy &XML;.</para>
1306
>Właściwości wcięć</guilabel
1313
>Szerokość wcięć:</guilabel
1317
>Szerokość wcięć to liczba spacji, używana do wstawienia wcięcia w wierszu. Jeśli wyłączono opcję <guilabel
1318
>Wstaw spacje zamiast tabulatorów</guilabel
1319
> w karcie <guilabel
1323
>, wstawiany jest znak 	, gdy wcięcie jest podzielone na szerokość tabulacji.</para>
1329
>Pozostaw dodatkowe spacje</guilabel
1333
>Jeśli ta opcja jest wyłączona, zmiana poziomu wcięcia dopasuje wiersz do wielokrotności szerokości określonej w polu <guilabel
1334
>Szerokość wcięć</guilabel
1341
>Dopasuj wcięcie kodu wklejonego ze schowka</guilabel
1345
>Jeśli ta opcja jest wybrana, wklejony ze schowka kod zostanie wcięty. Wywołanie działania <guimenuitem
1346
>Cofnij</guimenuitem
1347
> usunie wcięcie.</para>
1357
>Akcje wcięć</guilabel
1364
>Backspace w początkowych białych znakach usuwa wcięcie</guilabel
1368
>Wybranie tej opcji spowoduje, że klawisz <keysym
1370
> zmniejszy poziom wcięcia, jeśli kursor umieszczony jest w początkowych białych znakach wiersza.</para>
1376
>Działanie klawisza Tab (jeśli nie ma zaznaczenia)</guilabel
1380
>Jeśli chcesz, aby klawisz 	 wyrównywał bieżący wiersz w bloku kodu (jak w emacs), stwórz powiązanie klawisza 	 z akcją <guimenuitem
1381
>Wcięcie</guimenuitem
1387
>Zawsze zwiększ do następnej pozycji tabulatora</guilabel
1391
>Jeśli ta opcja zostanie wybrana, klawisz 	 zawsze będzie wstawiał białe znaki do osiągnięcia następnej pozycji tabulacji. Jeśli włączona jest opcja <guilabel
1392
>Wstaw spacje zamiast tabulatorów</guilabel
1393
> w karcie <guilabel
1397
>, wstawiane będą spacje; w przeciwnym wypadku, wstawiany będzie pojedynczy tabulator.</para>
1403
>Zawsze zwiększaj poziom wcięć</guilabel
1407
>Wybranie tej opcji spowoduje, że klawisz 	 zawsze będzie dodawał wcięcie do bieżącego wiersza, mające określoną <guilabel
1408
>Szerokość wcięcia</guilabel
1416
>Zwiększ poziom wcięć jeśli w początkowych białych znakach</guilabel
1420
>Jeżeli opcja jest włączona, klawisz 	 wcina bieżącą linię lub przechodzi do kolejnej pozycji tabulatora. Jeżeli kursor znajduje się na lub przed pierwszym nie-białym znakiem w linii, lub jeżeli jest wybrany fragment tekstu, to do bieżącej linii dodawane jest wcięcie o szerokości ustawionej przez parametr<guilabel
1421
>Szerokość wcięć</guilabel
1422
>. Jeżeli kursor znajduje się za pierwszym nie-białym znakiem w linii i nie ma wybranego tekstu, dodawane są spacje w liczbie niezbędnej do osiągnięcia kolejnej pozycji tabulacji (jeżeli jest włączona opcja <guilabel
1423
>Wstaw spacje zamiast tabulatorów</guilabel
1424
> w karcie konfiguracji <guilabel
1428
>) lub pojedynczy znak tabulacji.</para>
1443
<sect3 id="pref-edit-autocompletion">
1445
>Uzupełnianie wyrazów</title>
1457
>Uzupełnianie wyrazów włączone</guilabel
1461
>Jeśli włączone, edytor obliczy liczbę spacji do następnej pozycji tabulacji określonej w szerokości tabulacji i umieści te spacje zamiast znaku 	.</para>
1473
<sect2 id="pref-open-save">
1475
>Otwórz/Zapisz</title>
1477
<sect3 id="pref-open-save-general">
1486
>Format pliku</guilabel
1493
>Kodowanie:</guilabel
1497
>Ustawia domyślne kodowanie znaków dla plików.</para>
1503
>Koniec wiersza:</guilabel
1507
>Konfiguruje sposób zapisywania znaków końca linii w aktywnym dokumencie. Dostępny jest wybór pomiędzy trybami: &UNIX;, DOS/&Windows; i Macintosh.</para>
1513
>Automatyczne wykrywanie końca wiersza</guilabel
1517
>Włączenie tej opcji powoduje, iż edytor będzie automatycznie wykrywał sposób kodowania końca wiersza. Pierwszy znaleziony w dokumencie znak końca wiersza będzie wykorzystany dla całego dokumentu.</para>
1527
>Automatyczne czyszczenie przy zapisie/odczycie</guilabel
1534
>Usuń spacje na końcu wiersza</guilabel
1538
>&kate; automatycznie usunie dodatkowe spacje na końcu wierszy w całym tekście podczas operacji zapisu lub odczytu pliku.</para>
1548
<sect3 id="pref-open-save-advanced">
1550
>Zaawansowane</title>
1556
>Plik konfiguracyjny katalogu</guilabel
1563
>Głębokość szukania pliku konfiguracyjnego:</guilabel
1567
>Program będzie przeszukiwał każdy katalog wgłąb na określoną liczbę poziomów, w poszukiwaniu pliku konfiguracji &kappname; i załadowania go.</para>
1577
>Kopia zapasowa przy zapisie</guilabel
1581
>Funkcja ta spowoduje, iż &kappname; skopiuje plik oryginalny przed zapisaniem zmian. Nazwa pliku skopiowanego będzie ustalona w sposób następujący: <przedrostek><nazwapliku><przyrostek>. Przedrostek domyślnie nie jest określony, zaś domyślny przyrostek to <emphasis role="bold"
1588
>Pliki lokalne</guilabel
1592
>Włącza tworzenia kopii zapasowej dla plików lokalnych.</para>
1598
>Zdalne pliki</guilabel
1602
>Włącza tworzenie kopii zapasowej dla plików zdalnych.</para>
1608
>Przedrostek</guilabel
1612
>Tekst dodany przed nazwą pliku oryginalnego przy tworzeniu kopii zapasowej.</para>
1618
>Przyrostek</guilabel
1622
>Tekst dodany do nazwy pliku oryginalnego przy tworzeniu kopii zapasowej.</para>
1633
<sect3 id="pref-open-save-modes-filetypes">
1635
>Tryby i typy plików</title>
1637
>Ta karta pozwala na modyfikację konfiguracji domyślnej dla dokumentu, w zależności od typu MIME pliku. Kiedy program wczyta dokument, to przeszuka maski filtra plików lub listę typów MIME w poszukiwaniu zdefiniowanego rodzaju pliku, a następnie zmieni konfigurację zgodnie z wprowadzonymi zmiennymi. Jeżeli dopasowane zostanie kilka typów, to wybierany jest ten o najwyższym priorytecie. </para>
1642
>Typ pliku:</guilabel
1646
>Typ pliku dla którego ustawiono najwyższy priorytet wyświetla się na pierwszym miejscu rozwijanej listy. Jeżeli istnieje więcej typów, to również są one wyświetlane.</para>
1655
>Pozwala na utworzenie nowego typu pliku. Po naciśnięciu przycisku wartości w polach znajdujących się poniżej zostają usunięte i można w nich wprowadzić ustawienia związane z nowo tworzonym typem pliku.</para
1665
>Aby usunąć zdefiniowany wcześniej typ pliku należy wybrać go korzystając z listy rozwijanej, a następnie nacisnąć przycisk Usuń.</para
1675
>Właściwości wybranego typu pliku</guilabel
1679
>Typ pliku dla którego ustawiono najwyższy priorytet wyświetla się na pierwszym miejscu rozwijanej listy. Jeżeli istnieje więcej typów, to również są one wyświetlane.</para>
1688
>Nazwa typu pliku, która pojawia się jako pozycja w menu <menuchoice
1692
>Typ pliku</guimenuitem
1704
>Nazwa sekcji pozwala na właściwą organizację wyświetlania typów plików w menu. Jest wykorzystywana do wyświetlania menu <menuchoice
1708
>Typy plików</guimenuitem
1720
>Pole pozwala na dostosowanie konfiguracji &kappname; do określonego typu mime. Możliwe jest określenie dowolnej opcji konfiguracyjnej, np. podświetlania, reguł wcięć, kodowania, itp.</para
1722
>Pełna lista dostępnych zmiennych konfiguracyjnych dostępna jest w podręczniku.</para
1728
>Podświetlenie:</guilabel
1732
>Jeśli chcesz utworzyć nowy typ pliku, ta lista rozwijana pomoże Ci wybrać typ pliku do podświetlania.</para
1738
>Rozszerzenia nazw pliku:</guilabel
1742
>Maska filtra plików pozwala otwierać pliki z użyciem tylko nazwy. Typowa maska wykorzystuje gwiazdkę oraz rozszerzenie nazwy, przykładowo: <filename
1743
>*.txt; *.text</filename
1744
>. W polu tym wprowadza się listę masek rozdzieloną średnikami.</para
1750
>Typy MIME:</guilabel
1754
>Naciśnięcie przycisku asystenta po prawej stronie pola wyboru wyświetla okno dialogowe pozwalające na łatwy wybór typów MIME.</para
1760
>Priorytet:</guilabel
1764
>Konfiguruje priorytet dla danego typu pliku. Jeżeli do danego pliku można dopasować kilka typów, to wybierany jest ten o najwyższym priorytecie.</para
1773
>Pobierz pliki podświetlania...</guibutton
1777
>Naciśnięcie tego przycisku pozwala na pobranie nowych lub zaktualizowanych reguł podświetlania składni ze strony WWW programu &kate;. </para>
1786
<sect2 id="pref-shortcuts">
1788
>Skróty klawiszowe</title
1789
> <!-- this is only in 4.1 in kate and kwrite, only cursor shortcuts, has been removed in 4.2 -->
1791
>Możliwa jest tutaj zmiana konfiguracji skrótów klawiszowych. Wybranie tego polecenia i zaznaczenie pola opcji: <guilabel
1793
> powoduje otwarcie okna, w którym użytkownik definiuje własną kombinację klawiszy dla danego polecenia.</para>
1795
>Pole wyszukiwania pozwala na szybkie odszukanie polecenia i sprawdzenie jego skrótu klawiszowego.</para>
1798
<sect2 id="pref-plugins">
1800
>Rozszerzenia</title>
1804
> zawiera listę wszystkich dostępnych wtyczek. Możesz wybrać te, których chcesz używać. Kliknij przycisk <guibutton
1805
>Informacja</guibutton
1806
>, aby otworzyć okno <guilabel
1807
>O programie</guilabel
1808
> danej wtyczki. Gdy wtyczka zostanie wybrana, aktywny stanie się przycisk <guibutton
1809
>Konfiguracja</guibutton
1810
>, który pozwala skonfigurować daną wtyczkę.</para>
1813
>Wybrane wtyczki są dostępne w menu <guimenu
1817
<!-- Scripts tab ??-->
1825
<sect1 id="config-variables">
1828
>Konfiguracja programu za pomocą zmiennych</title>
1831
>Mechanizm zmiennych dokumentu w &kate; oparty jest na mechanizmie wierszy konfiguracyjnych znanym z programów Emacs i vi. W &kate; format wiersza konfiguracyjnego ma postać: <userinput
1832
>kate: NAZWAZMIENNEJ WARTOŚĆ; [ NAZWAZMIENNEJ WARTOŚĆ; ... ]</userinput
1833
>. Ich treść może być oczywiście umieszczona w linii komentarza zgodnym z formatem edytowanego pliku. Nazwy zmiennych określane są jednym słowem (bez spacji) zaś cała treść do średnika stanowi wartość dla tej zmiennej. Średnik jest wymagany.</para>
1836
>Poniżej znajduje się przykładowy wiersz zawierający zmienne konfiguracyjne zmieniający ustawienia wcięć dla pliku C++, Java lub Javascript: <programlisting
1837
>// kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;</programlisting>
1842
>Program sprawdza tylko pierwsze 10 lub ostatnie 10 wierszy dokumentu w poszukiwaniu zmiennych konfiguracyjnych.</para
1846
>Zmienne dokumentu odnoszą się do niemal wszystkich parametrów konfiguracji komponentu edytora (katepart). Dodatkowe zmienne mogą wprowadzone przez wtyczki, i w takim wypadku informacje na ich temat powinny być dostępne w dokumentacji wtyczek.</para>
1848
<sect2 id="config-variables-howto">
1850
>Jak program &kate; wykorzystuje zmienne</title>
1853
>Komponent edytora poszukuje parametrów konfiguracyjnych w następujących miejscach (i w podanej kolejności): <itemizedlist
1856
>Konfiguracja ogólna.</para
1860
>Opcjonalne dane sesji.</para
1864
>Konfiguracja typów pliku.</para
1868
>Zmienne dokumentu znajdujące się w pliku.</para
1872
>Zmiany konfiguracji z menu lub linii poleceń.</para
1875
>Wynika z tego, iż zmienne dokumentu mają drugi z kolei poziom ważności. Kiedykolwiek dokument jest zapisywany to zmienne dokumentu są wczytywane ponownie i unieważniają zmiany ustawień dokonane w menu lub z linii poleceń.</para>
1878
>Wszystkie pozostałe, nie opisane poniżej, zmienne zapisane w dokumencie mogą być odczytywane przez wtyczki i wykorzystywane do ich celów. Na przykład tryby wcięć na podstawie zmiennych wykorzystuje zmienne dokumentu do konfiguracji.</para>
1881
>Poniżej opisane zmienne dotyczą programu &kate; w wersji 2.4. W przyszłości mogą zostać dodane kolejne zmienne. Wartości zapisywane do zmiennych mogą być następujące: <itemizedlist>
1884
>BOOL - przyjmuje wartości: on|off|true|false|1|0</para
1888
>INTEGER - dowolna liczba całkowita</para
1892
>STRING - wszystkie inne napisy</para
1899
>Dostępne zmienne konfiguracyjne</title>
1905
>auto-brackets</command
1912
>Włącza lub wyłącza automatyczne wstawianie nawiasów.</para
1920
>auto-center-lines</command
1927
>Określa liczbę wierszy, które program stara się pokazywać powyżej i poniżej aktualnej pozycji kursora.</para
1935
>auto-insert-doxygen</command
1942
>Automatycznie wstawia otwierający znak Doxygen "*" w czasie pisania komentarzy w formacie Doxygena. Opcja ta działa tylko w przypadku użycia trybu "cstyle" dla automatycznych wcięć. </para
1950
>background-color</command
1957
>Ustawia kolor tła. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para
1965
>backspace-indents</command
1972
>Włącza lub wyłącza zmniejszanie wcięć klawiszem Backspace.</para
1980
>block-selection</command
1987
>Włącza lub wyłącza tryb zaznaczania bloku.</para
1995
>bracket-highlight-color</command
2002
>Ustawia kolor dla podświetlanych nawiasów. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000" </para
2010
>current-line-color</command
2017
>Ustawia kolor wyświetlania bieżącego wiersza. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para
2025
>dynamic-word-wrap</command
2032
>Włącza lub wyłącza dynamiczne zawijanie wyrazów.</para
2040
>eol | end-of-line</command
2047
>Ustawia tryb kodowania końca wiersza. Dostępne ustawienia to: <quote
2068
>Ustawia kodowanie znaków w dokumencie. Wartość musi zawierać poprawną nazwę kodowania, np.: <quote
2085
>Określa rozmiar czcionki dla dokumentu w punktach.</para
2100
>Ustawia rodzaj czcionki dla wyświetlania dokumentu. Wartość musi zawierać poprawną nazwę czcionki np.: <quote
2110
>icon-bar-color</command
2117
>Ustawia kolor dla paska ikon. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para
2125
>icon-border</command
2132
>Włącza lub wyłącza wyświetlanie paska ikon.</para
2140
>folding-markers</command
2147
>Włącza lub wyłącza wyświetlanie znaczników zwijania kodu.</para
2155
>indent-mode</command
2162
>Ustawia tryb automatycznych wcięć. Rozpoznawane tryby wcięć to: <quote
2174
> Więcej informacji na temat automatycznych wcięć w sekcji <xref linkend="kate-part-autoindent"/>.</para
2182
>indent-width</command
2189
>Ustawia szerokość wcięć.</para
2197
>keep-extra-spaces</command
2204
>Włącza lub wyłącza pozostawianie dodatkowych spacji podczas obliczania szerokości wcięcia.</para
2212
>keep-indent-profile</command
2219
>Zabezpiecza przez usunięciem wcięcia dla bloku jeżeli jest w nim nawet jeden wiersz bez wcięcia.</para
2227
>line-numbers</command
2234
>Włącza lub wyłącza wyświetlanie numerów wierszy.</para
2242
>mixed-indent</command
2249
>Włącza lub wyłącza mieszane wcięcia w stylu Emacsa.</para
2257
>overwrite-mode</command
2264
>Włącza lub wyłącza tryb zastępowania.</para
2272
>persistent-selection</command
2279
>Włącza lub wyłącza funkcję trwałego zaznaczenia.</para
2287
>remove-trailing-space</command
2294
>Włącza lub wyłącza dynamiczne czyszczenia końca wiersza.</para
2302
>replace-tabs-save</command
2309
>Włącza lub wyłącza konwersję znaków tabulacji na spacje przy zapisywaniu pliku.</para
2317
>replace-tabs</command
2324
>Włącza lub wyłącza dynamiczną konwersję tabulacji na spacje.</para
2332
>replace-trailing-space-save</command
2339
>Włącza lub wyłącza funkcję czyszczenia końców wierszy przy zapisywaniu pliku.</para
2354
>Ustawia zestaw kolorów. Parametr musi określać istniejący zestaw kolorów, w przeciwnym wypadku nic się nie zmieni.</para
2362
>selection-color</command
2369
>Ustawia kolor dla zaznaczenia. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para
2384
>Włącza lub wyłącza wyświetlanie znaku tabulacji.</para
2392
>smart-home</command
2399
>Włącza lub wyłącza nawigację za pomocą sprytnego klawisza Home.</para
2407
>space-indent</command
2414
>Włącza lub wyłącza tworzenie wcięć za pomocą spacji.</para
2422
>tab-indents</command
2429
>Włącza lub wyłącza tworzenie wcięć za pomocą klawisza tabulacji.</para
2444
>Ustawia szerokość wyświetlania znaku tabulacji.</para
2452
>undo-steps</command
2459
>Ustawia liczbę zapamiętanych operacji dla polecenia "Cofnij".</para
2467
>word-wrap-column</command
2474
>Ustawia liczbę znaków po której nastąpi statyczne zawinięcie wyrazów.</para
2482
>word-wrap-marker-color</command
2489
>Ustawia kolor znacznika zawijania wyrazów. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para
2504
>Włącza lub wyłącza statyczne zawijanie wyrazów.</para
2512
>wrap-cursor</command
2519
>Włącza lub wyłącza zawijanie kursora.</para
added
removed
docs/kdesdk/kate/configuring.docbook
