path: root/tde-i18n-pl/docs/tdebase/kate/configuring.docbook

<chapter id="configuring-kate">
<chapterinfo>
<authorgroup>
<author>&Anders.Lund; &Anders.Lund.mail;</author>
<othercredit role="translator"><firstname>Suse</firstname><surname>Polska</surname><affiliation><address><email>[email protected]</email></address> </affiliation><contrib>Polskie tłumaczenie</contrib></othercredit> <othercredit role="translator"><firstname>Krzysztof</firstname><surname>Woźniak</surname><affiliation><address><email>[email protected]</email></address></affiliation><contrib>Polskie tłumaczenie</contrib></othercredit> 
</authorgroup>
</chapterinfo>
<title>Konfiguracja &kate;</title>

<sect1 id="configuring-overview">
<title>Przegląd</title>
<para>
<indexterm>
<primary>konfiguracja</primary>
<secondary>ustawienia</secondary>
<tertiary>właściwości</tertiary></indexterm>
<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>

<variablelist>
<varlistentry>
<term id="configure">Okno konfiguracji</term>
<listitem><para>Podstawowe narzędzie konfiguracji programu &kate;, komponentu edytora i zainstalowanych wtyczek.</para></listitem>
</varlistentry>
<varlistentry>
<term id="settings">Menu <guimenu>Ustawienia</guimenu></term>
<listitem><para>Pozwala na zmianę często używanych ustawień oraz wywołuje okna konfiguracji.</para></listitem>
</varlistentry>
<varlistentry>
<term>Menu <guimenu>Widok</guimenu></term>
<listitem><para>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></listitem>
</varlistentry>
</variablelist>

<para>Wbudowany program &konsole; korzysta z parametrów konfiguracji ustawionych w &kcontrolcenter-miejscownik;, ale można je zmienić naciskając <mousebutton>prawy</mousebutton> przycisk myszy i wybierając <guimenuitem>Ustawienia</guimenuitem> z menu kontekstowego.</para>

</sect1>

<sect1 id="configuring-kate-configdialog">
<title>Główne okno konfiguracji</title>

<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="configdialog01.png"/>
</imageobject>
</mediaobject>

<para>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>

<para>Tematy konfiguracji dzielą się na dwie grupy <itemizedlist>
<listitem><para><link linkend="config-dialog">Konfiguracja programu</link>
</para></listitem>
<listitem><para><link linkend="config-dialog-editor">Konfiguracja edytora</link></para></listitem>

</itemizedlist>

</para>

</sect1>

<sect1 id="config-dialog">
<title>Konfiguracja programu &kate;</title>
<para>Ta grupa zawiera parametry konfiguracyjne dotyczące samego zachowania programu &kate;.</para>

<sect2 id="config-dialog-general">
<title>Karta: Ustawienia ogólne</title>
<para>W karcie tej umieszczone są globalne ustawienia programu &kate;.</para>

<variablelist>

<varlistentry>
<term><anchor id="config-dialog-general-show-full-path"/>
<guilabel>Wyświetl pełną ścieżkę w tytule</guilabel></term>
<listitem><para>Jeżeli opcja jest włączona, to &kate; wyświetli pełną ścieżkę dostępu do bieżącego dokumentu w pasku tytułowym okna (w przeciwnym wypadku wyświetlona zostanie tylko nazwa pliku).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="config-general-behavior"/>
<guilabel>Zachowanie</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term>
<anchor id="config-dialog-general-sync-konsole"/>
<guibutton>Synchronizuj konsolę z aktywnym dokumentem</guibutton></term>
<listitem><para>Włączenie tej opcji spowoduje, iż wbudowany program &konsole; będzie automatycznie zmieniał katalog roboczy (poleceniem systemowym <command>cd</command>) na ten, w którym znajduje się edytowany 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></listitem>
</varlistentry>

<varlistentry>
<term><anchor id="config-dialog-general-warn-mod"/>
<guilabel>Ostrzegaj o plikach zmienionych przez zewnętrzne procesy</guilabel></term>
<listitem><para>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>
<para>Jeżeli opcja jest wyłączona, to &kate; nie będzie pytać o reakcję w przypadku, gdy plik zostanie zmodyfikowany przez inny program.</para>
</listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry><!-- /behavior group -->

<varlistentry>
<term><anchor id="config-general-meta-data"/>
<guilabel>Dodatkowe informacje</guilabel></term>
<listitem>

<variablelist>
<varlistentry>
<term><anchor id="config-general-keep-meta-information"/>
<guilabel>Zachowaj dodatkowe informacje między sesjami</guilabel></term>
<listitem><para>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></listitem>
</varlistentry>

<varlistentry>
<term><anchor id="config-general-delete-meta-information-after"/>
<guilabel>Usuń nieużywane dodatkowe informacje po</guilabel></term>
<listitem><para>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></listitem>
</varlistentry>

</variablelist>

</listitem>
</varlistentry><!-- /meta data group -->

</variablelist>
</sect2>

<sect2 id="config-dialog-sessions">
<title>Karta: Sesje</title>

<para>Poniższa sekcja zawiera informacje dotyczące <link linkend="fundamentals-using-sessions">korzystania z sesji</link>.</para>

<variablelist>

<varlistentry>
<term><anchor id="config-dialog-sessions-elements"/>
<guilabel>Elementy sesji</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Dołącz konfigurację okien</guilabel></term>
<listitem><para>Jeżeli opcja jest włączona to &kate; zapisze wraz z informacją o sesji także bieżącą konfigurację okien.</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry><!-- /elements of sessions -->

<varlistentry>
<term><anchor id="config-dialog-sessions-startup-behavior"/>
<guilabel>Zachowanie przy starcie programu</guilabel></term>
<listitem>
<para>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">w linii poleceń</link>.</para>
<variablelist>
<varlistentry>
<term><guilabel>Uruchom nową sesję</guilabel></term>
<listitem><para>Jeżeli ta opcja jest aktywna, to &kate; po uruchomieniu utworzy nową, nienazwaną sesję.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Wczytaj ostatnią sesję</guilabel></term>
<listitem><para>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></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Wybierz sesję ręcznie</guilabel></term>
<listitem><para>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></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry><!-- /startup behavior -->

<varlistentry>
<term><anchor id="config-dialog-sessions-exit-behavior"/>
<guilabel>Zachowanie przy wyjściu z programu lub przy zmianie sesji</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Nie zapisuj sesji</guilabel></term>
<listitem><para>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></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Zapisz sesję</guilabel></term>
<listitem><para>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></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Zapytaj użytkownika</guilabel></term>
<listitem><para>Zostanie wyświetlone pytanie o zapisanie sesji za każdym razem, gdy nazwana sesja będzie zamykana.</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry><!-- /exit/switch behavior -->

</variablelist>

</sect2>

<sect2 id="config-dialog-fileselector">
<title>Karta: <guilabel>Wybór plików</guilabel></title>

<variablelist>
<varlistentry>
<term><guilabel>Pasek narzędzi</guilabel></term>
<listitem><para>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>Zaznaczone akcje</guilabel>, a następnie ustawić je we właściwej kolejności za pomocą przycisków strzałek.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Automatyczna synchronizacja</guilabel></term>
<listitem><para>Włączenie tej opcji powoduje, iż 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> <listitem><para>Przy zmianie aktywnego dokumentu.</para></listitem> <listitem><para>Po wyświetleniu przeglądarki systemu plików.</para></listitem> </itemizedlist> Jeżeli ta opcja nie zostanie włączona, to użytkownik może szybko przejść do katalogu bieżącego dokumentu za pomocą przycisku <guilabel>Bieżący katalog dokumentu</guilabel>, znajdującego się na pasku narzędzi. </para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Zapamiętane lokalizacje</guilabel></term>
<listitem><para>Pozwala określić liczbę pozycji w historii przeglądanych katalogów. Powtarzające się wpisy nie są zapamiętywane.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Zapamiętane filtry</guilabel></term>
<listitem><para>Pozwala określić liczbę pozycji w historii wykorzystywanych filtrów. Filtry powtarzające się nie są zapamiętywane.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Sesja</guilabel></term>
<listitem>
<para>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>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="config-dialog-documentlist">
<title>Karta: <guilabel>Lista dokumentów</guilabel></title>

<variablelist>
<varlistentry>
<term><guilabel>Cieniowanie tła</guilabel></term>
<listitem><para>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">Lista dokumentów</link>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Sortuj wg</guilabel></term>
<listitem><para>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></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="config-dialog-plugins">
<title>Karta: <guilabel>Wtyczki</guilabel></title>

<para>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>

<para>Jeżeli wtyczka posiada możliwość konfiguracji, to wyświetlone zostanie okno podrzędne z odpowiednimi polami do wypełnienia.</para>

</sect2>


<sect2 id="config-dialog-externaltools">
<title>Narzędzia zewnętrzne</title>

<para>W menu <guimenu>Narzędzia</guimenu> dostępne jest podmenu <guisubmenu>Narzędzia zewnętrzne</guisubmenu>. 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.</para>

<para>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>

<variablelist>
<title>Właściwości narzędzi zewnętrznych</title>
<varlistentry>
<term>Etykieta</term>
<listitem><para>Etykieta narzędzia, która wyświetli się w menu Narzędzia zewnętrzne.</para></listitem>
</varlistentry>

<varlistentry>
<term>Skrypt</term>
<listitem><para>Skrypt powłoki uruchamiany przy wywoływaniu narzędzia. Podczas uruchamiania skryptu przekazywane są do niego następujące makra: <variablelist>
<varlistentry>
<term>%URL</term>
<listitem><para>Pełna ścieżka dostępu dla bieżącego dokumentu lub pusty napis, jeżeli dokument nie został jeszcze zapisany.</para></listitem>
</varlistentry>

<varlistentry>
<term>%URLS</term>
<listitem><para>Rozdzielana spacjami lista ścieżek dostępu do wszystkich otwartych dokumentów (z wyjątkiem dokumentów nie zapisanych).</para></listitem>
</varlistentry>

<varlistentry>
<term>%directory</term>
<listitem><para>Katalog, w którym znajduje się bieżący dokument lub pusty napis, jeżeli nie został on jeszcze zapisany.</para></listitem>
</varlistentry>

<varlistentry>
<term>%filename</term>
<listitem><para>Nazwa pliku bieżącego dokumentu (bez ścieżki dostępu do katalogu) lub pusty napis, jeżeli nie został on jeszcze zapisany.</para></listitem>
</varlistentry>

<varlistentry>
<term>%line</term>
<listitem><para>Numer wiersza bieżącego dokumentu, w którym znajduje się kursor.</para></listitem>
</varlistentry>

<varlistentry>
<term>%column</term>
<listitem><para>Numer kolumny bieżącego dokumentu, w której znajduje się kursor.</para></listitem>
</varlistentry>

<varlistentry>
<term>%selection</term>
<listitem><para>Zaznaczony fragment tekstu z bieżącego dokumentu lub pusty napis, jeżeli nic nie zostało zaznaczone</para></listitem>
</varlistentry>

<varlistentry>
<term>%text</term>
<listitem><para>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></listitem>
</varlistentry>

</variablelist>

</para></listitem>
</varlistentry>

<varlistentry>
<term>Program</term>
<listitem><para>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>PATH</envar>.</para></listitem>
</varlistentry>

<varlistentry>
<term>Typy MIME</term>
<listitem><para>Rozdzielana średnikami lista typów MIME, dla których dane polecenie może być wykonane. Aktualnie nie jest wykorzystywana.</para></listitem>
</varlistentry>

<varlistentry>
<term>Zapisz</term>
<listitem><para>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></listitem>
</varlistentry>

<varlistentry>
<term>Nazwa linii poleceń</term>
<listitem><para>Wypełnienie tego pola powoduje, iż narzędzie staje się dostępne <link linkend="advanced-editing-tools-commandline">w linii poleceń edytora</link> jako <command>exttool-<replaceable>Nazwa linii poleceń</replaceable></command> (nazwa tu wprowadzona musi być poprzedzona napisem: <quote>exttool-</quote>) w wywołaniu linii poleceń.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="config-dialog-editor">
<title>Konfiguracja edytora</title>
<para>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="config-dialog-editor-filetypes">definicje typu pliku</link>, <link linkend="config-variables">zmienne dokumentu</link> lub przez ich zmianę w czasie edycji dokumentu.</para>


<sect2 id="config-dialog-editor-appearance">
<title>Wygląd</title>

<variablelist>
<varlistentry>
<term><guilabel>Zawijanie wyrazów</guilabel></term>
<listitem>
<variablelist>
<varlistentry id="appearance-settings">
<term><guilabel>Dynamiczne zawijanie wyrazów</guilabel></term>
<listitem><para>Powoduje, iż wiersze będą zawijane na krawędzi okna.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Znaczniki dynamicznego zawijania wyrazów</guilabel></term>
<listitem><para>Wybiera sposób wyświetlania znaczników dynamicznego zawijania wyrazów. </para></listitem></varlistentry>
<varlistentry>
<term><guilabel>Wyrównaj pionowo dynamicznie zawijane wiersze do głębokości wcięć: </guilabel></term>
<listitem><para>Włącza automatyczne wyrównywanie dynamicznie zawiniętych wierszy do aktualnego poziomu wcięcia tekstu. Zwiększa to czytelność kodu.</para><para>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></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Zwijanie kodu</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Pokaż znaczniki zwijania (jeśli dostępne) </guilabel></term>
<listitem><para>Włączenie tej opcji spowoduje pokazanie w aktualnie edytowanym dokumencie znaczników zwijania kodu (jeżeli opcja zwijania kodu jest włączona).</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Paski boczne</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Pokaż pasek ikon </guilabel></term>
<listitem><para>Włącza wyświetlanie paska ikon po lewej stronie okna edytora. Na pasku ikon widoczne są np. znaczniki zakładek.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Pokaż numery wierszy </guilabel></term>
<listitem><para>Włącza pokazywanie numerów wierszy po lewej stronie okna edytora.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Pokaż znaki na pasku przewijania </guilabel></term>
<listitem><para>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></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Sortuj menu zakładek </guilabel></term>
<listitem><para>
<variablelist>
<varlistentry>
<term><guilabel>Według położenia </guilabel></term>
<listitem><para>Zakładki zostaną posortowane w kolejności numerów wierszy, dla których zostały ustawione.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Według utworzenia </guilabel></term>
<listitem><para>Każda nowa zakładka zostanie dodana na końcu listy niezależnie od miejsca jej położenia w dokumencie.</para></listitem>
</varlistentry>
</variablelist>
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Pokaż linie wcięć </guilabel></term>
<listitem><para>Zaznaczenie tej opcji spowoduje uwidocznienie w oknie edytora linii pomagających zidentyfikować poszczególne poziomy wcięcia tekstu.</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="config-dialog-editor-colors">
<title>Czcionki i kolory</title>

<para>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>

<para>Program &kate; pokaże w karcie aktywny w danym momencie schemat wyświetlania. Zmiana schematu na inny możliwa jest za pomocą rozwijanej listy <guilabel>Schemat</guilabel>.</para>

<sect3 id="config-dialog-editor-colors-colors">
<title>Kolory</title>

<variablelist>
<varlistentry id="config-dialog-editor-colors-colors-text-background">
<term><guilabel>Tło tekstu</guilabel></term>
<listitem>

<variablelist>

<varlistentry id="config-dialog-editor-colors-normal-text">
<term><guilabel>Normalny tekst</guilabel></term>
<listitem><para>Kolor domyślny dla tła obszaru edycyjnego. Będzie to kolor wyraźnie dominujący w oknie edytora.</para></listitem>
</varlistentry>

<varlistentry id="config-dialog-editor-colors-selected-text">
<term><guilabel>Zaznaczony tekst</guilabel></term>
<listitem><para>Tło dla zaznaczonego fragmentu tekstu. Wartości domyślne są pobierane z ustawień globalnych środowiska &kde;. </para></listitem>
</varlistentry>

<varlistentry id="config-dialog-editor-colors-current-line">
<term><guilabel>Bieżący wiersz</guilabel></term>
<listitem><para>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></listitem>
</varlistentry>

<varlistentry id="config-dialog-editor-colors-marks">
<term><guilabel>Zakładki</guilabel></term>
<listitem><para>Rozwijana lista wyboru pozwalająca określić kolory dla różnych rodzajów zakładek. Kolor jest mieszany z kolorem tła dla zaznaczonego wiersza, tak więc bieżący wiersz, lub wiersz z kilkoma zakładkami, ma tło będące efektem zmieszania kilku kolorów. Kolor zakładek jest również wykorzystywany dla znaczników, wyświetlanych na bocznym pasku przewijania.</para></listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry id="config-dialog-editor-colors-colors-other-elements">
<term><guilabel>Dodatkowe elementy</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Tło lewej krawędzi</guilabel></term>
<listitem><para>Kolor wykorzystywany dla tła paska ikon, numerów wierszy i znaczników zwijania po lewej stronie edytora (jeżeli jest on widoczny). </para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Numery wierszy</guilabel></term>
<listitem><para>Kolor wykorzystywany dla wyświetlania numerów wierszy na pasku po lewej stronie okna edycyjnego (jeżeli są widoczne).</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Podświetlanie nawiasów</guilabel></term>
<listitem><para>Kolor wykorzystywany do podświetlania tła par odpowiadających sobie wzajemnie nawiasów w kodzie programu. </para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Znaczniki zawijanego tekstu</guilabel></term>
<listitem><para>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></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Znaczniki tabulacji</guilabel></term>
<listitem><para>W kolorze tym wyświetlane są znaczniki tabulacji. </para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="config-dialog-editor-colors-fonts">
<title>Czcionka</title>
<para>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>
</sect3>

<sect3 id="config-dialog-editor-colors-normal-text-styles">
<title>Style normalnego tekstu</title>
<para>Parametry stylu normalnego tekstu są dziedziczone przez style podświetlania składni. Pozwala to na prezentację tekstu w zwarty i przejrzysty sposób. Przykładowo tekst komentarza zawsze będzie miał ten sam kolor i wygląd we wszystkich formatach tekstowych, które można wybrać dla podświetlania składni w edytorze.</para>
<para>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>
<para>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>
</sect3>

<sect3 id="config-dialog-editor-colors-highlighting-text-styles">
<title>Style podświetlania tekstu</title>
<para>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>Podświetlenie</guilabel> widocznej w górnej części okna. </para>
<para>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>
<para>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>
<para>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>
</sect3>

</sect2>

<sect2 id="config-dialog-editor-cursor-selection">
<title>Kursor i zaznaczanie</title>

<variablelist>

<varlistentry>
<term><guilabel>Ruch kursora tekstu</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Sprytny klawisz Home</guilabel></term>
<listitem>
<para>Wybranie pozycji powoduje, iż naciśnięcie klawisza "Home" przesuwa kursor na początek tekstu w wierszu, pomijając ewentualne znaki wcięcia.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Zawijaj kursor</guilabel></term>
<listitem>
<para>Podczas przesuwania kursora za pomocą <emphasis role="bold">lewego</emphasis> i <emphasis role="bold">prawego</emphasis> 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><para>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>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>PageUp/PageDown przenosi kursor</guilabel></term>
<listitem>
<para>Opcja ta zmienia zachowanie kursora w przypadku naciśnięcia klawiszy <keycap>Page Up</keycap> lub <keycap>Page Down</keycap>. Gdy nie jest ona zaznaczona, to kursor zachowuje względną wizualnie pozycję w oknie dokumentu &kate;. 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>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Automatycznie centruj kursor (wiersze):</guilabel></term>
<listitem>
<para>Określa liczbę wierszy, które program stara się pokazywać powyżej i poniżej aktualnej pozycji kursora.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Tryb zaznaczania</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Normalny</guilabel></term>
<listitem>
<para>Zaznaczony fragment zostanie zastąpiony przez wprowadzany tekst zaś przesunięcie kursora zlikwiduje zaznaczenie tekstu.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Trwałe zaznaczenia</guilabel></term>
<listitem>
<para>Zaznaczenie pozostanie aktywne nawet po przesunięciu kursora, czy też wprowadzeniu nowego tekstu.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="config-dialog-editor-edit">
<title>Edycja</title>
<variablelist>

<varlistentry>
<term><guilabel>Tabulatory</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Wstaw spacje zamiast tabulatorów</guilabel></term>
<listitem>
<para>Zaznaczenie tej opcji spowoduje, iż po naciśnięciu klawisza <keycap>TAB</keycap> edytor będzie wstawiał do tekstu określoną liczbę spacji, w zależności od pozycji oraz ustawienia parametru: <option>Szerokość tabulacji i wcięcia</option>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Pokaż tabulatory</guilabel></term>
<listitem>
<para>Włączenie opcji spowoduje wyświetlanie przez &kate; małej kropki w miejscu występowania znaków tabulacji.</para>
<note><para>Opcja powoduje również wyświetlanie kropki dla znaków spacji na końcu wiersza. Zachowanie to zostanie zmienione w przyszłych wersjach &kate;.</para></note>
</listitem>
</varlistentry>
<varlistentry>
<term id="config-dialog-editor-tab-width">Szerokość tabulacji i wcięcia</term> <listitem><para>Jeśli włączona jest opcja <link linkend="config-dialog-editor-word-wrap"><guilabel>Zamień tabulacje na spacje</guilabel></link>, wtedy to pole określa liczbę spacji, na które edytor automatycznie zamieni każdy znak tabulacji.</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term id="config-dialog-editor-word-wrap"><guilabel>Statyczne zawijanie wyrazów</guilabel></term>
<listitem><para>Zawijania wyrazów to funkcja powodująca, iż edytor automatycznie rozpoczyna nowy wiersz tekstu i przenosi (zawija) kursor na jego początek. Program &kate; automatycznie rozpocznie nowy wiersz tekstu, jeżeli liczba znaków w bieżącym wierszu osiągnie wielkość zdefiniowaną w polu: <link linkend="config-dialog-editor-wrap-words-at">Zawijaj wyrazy na:</link>.</para>
<variablelist>
<varlistentry>
<term><guilabel>Włącz statyczne zawijanie wyrazów</guilabel></term>
<listitem>
<para>Opcja włącza lub wyłącza statyczne zawijanie wyrazów.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Pokaż znaczniki statycznego zawijania wyrazów</guilabel></term>
<listitem>
<para>Zaznaczenie tej opcji spowoduje wyświetlanie pionowej linii w miejscu określonym przez parametr "kolumna zawijania" w menu <menuchoice> <guimenu>Ustawienia</guimenu> <guimenuitem>Konfiguracja &kate;...</guimenuitem></menuchoice> (w karcie: "Edycja"). Znacznik zawijania wyrazów jest wyświetlany tylko w przypadku stosowania czcionki o stałej szerokości.</para>
</listitem>
</varlistentry>
<varlistentry id="config-dialog-editor-wrap-words-at">
<term><guilabel>Zawijaj wyrazy na:</guilabel></term>
<listitem>
<para>Jeśli opcja <link linkend="config-dialog-editor-word-wrap">Zawijanie wyrazów</link> jest wybrana, to w tym polu określa się liczbę znaków, przy której edytor automatycznie rozpocznie nowy wiersz.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Usuń spacje na końcu wiersza</guilabel></term>
<listitem><para>Włączenie tej opcji powoduje, że &kate; automatycznie usunie dodatkowe spacje na końcu wiersza tekstu.</para></listitem> </varlistentry>

<varlistentry>
<term><guilabel>Automatyczne nawiasy</guilabel></term> <listitem><para>Włączenie tej opcji powoduje, że po wpisaniu lewego nawiasu ([, (, lub {) &kate; automatycznie doda prawy nawias (odpowiednio: }, ), lub ]) po prawej stronie kursora.</para></listitem>
</varlistentry>

<varlistentry> <term>Liczba operacji <link linkend="undo">cofnięć</link>:</term>
<listitem><para>Ta opcja określa liczbę możliwych w programie &kate; operacji wycofania pisania tekstu lub innych działań. Im większa liczba, tym więcej pamięci program przeznaczy na przechowywanie historii operacji. Ustawienie opcji na 10 spowoduje, iż użytkownik będzie mógł wycofać 10 poprzednich operacji naciskając dziesięciokrotnie przycisk <guibutton>Cofnij</guibutton>.</para></listitem> </varlistentry>

<varlistentry> <term>Sprytne wyszukiwanie tekstu od:</term>
<listitem><para>Pozwala na określenie źródła tekstu, który &kate; wstawi automatycznie w oknie dialogowym wyszukiwania. Dostępne są następujące opcje:<itemizedlist> <listitem><para><emphasis role="bold">Nigdzie:</emphasis> Żaden tekst nie zostanie wstawiony.</para></listitem> <listitem><para><emphasis role="bold">Tylko zaznaczenie:</emphasis> Używa zaznaczonego fragmentu jako tekstu wyszukiwanego. </para></listitem> <listitem><para><emphasis role="bold">Zaznaczenie, potem bieżące słowo:</emphasis> Używa zaznaczonego fragmentu (jeżeli dostępny), w przeciwnym wypadku wprowadza bieżące słowo. </para></listitem> <listitem><para><emphasis role="bold">Tylko bieżące słowo:</emphasis> Używa słowa, na którym aktualnie znajduje się kursor. </para></listitem> <listitem><para><emphasis role="bold">Bieżące słowo, potem zaznaczenie:</emphasis> Używa bieżącego słowa, a jeśli brak słowa w pozycji kursora to zaznaczenia. </para></listitem> </itemizedlist> Dla wszystkich powyższych trybów, jeżeli program nie może ustalić poszukiwanego tekstu, to w oknie dialogowym wyszukiwania pojawi się poprzednio wyszukiwany tekst (zachowanie domyślne). </para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="config-dialog-editor-indent">
<title>Wcięcia</title>
<variablelist>
<varlistentry>
<term><guilabel>Automatyczne wcięcia</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Tryb wcięć:</guilabel></term>
<listitem>
<para>Pozwala na określenie domyślnie stosowanego trybu wcięć. Zalecane jest ustawienie tutaj <userinput>Brak</userinput> lub <userinput>Normalny</userinput> i ustawienie reguł wcięć w konfiguracji typów plików dla takich formatów jak kod programu w C/C++ czy &XML;.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Wstaw otwierający znak Doxygen "*" w czasie pisania</guilabel></term>
<listitem>
<para>Automatycznie wstawia otwierający znak Doxygen "*" w czasie pisania komentarzy w formacie Doxygena. Opcja jest aktywna tylko jeśli ma zastosowanie.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Wcięcia spacjami</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Używa znaków spacji zamiast znaków Tab do generowania wcięć</guilabel></term>
<listitem>
<para>Powoduje zamianę znaku tabulacji na zdefiniowaną poniżej <guilabel>Liczbę spacji:</guilabel>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Tryb mieszany w stylu Emacsa</guilabel></term>
<listitem>
<para>Powoduje użycie zarówno znaków tabulacji, jak i spacji dla wcięć.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Liczba spacji:</guilabel></term>
<listitem>
<para>Pozwala na ustawienie liczby spacji używanych do generowania wcięć przy włączonej opcji <guilabel>Użyj spacji zamiast znaków Tab do wcięć</guilabel>.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Utrzymuj profil wcięć</guilabel></term>
<listitem><para>Zaznaczenie tej opcji powoduje, że program nie będzie usuwał wcięć w zaznaczonym fragmencie tekstu, jeżeli najmniej wcięty wiersz znajdzie się na początku wiersza (bez wcięcia). Może to być przydatne w przypadku usuwania wcięć w dużych fragmentach kodu programu. </para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Pozostaw dodatkowe spacje</guilabel></term>
<listitem><para>Wcięcie większe niż wybrana liczba spacji nie będzie zmniejszone.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Klawisze do użycia</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Wcięcie tabulatorami</guilabel></term>
<listitem>
<para>Pozwala na użycie klawisza <keycombo action="simul"><keycap>Tab</keycap></keycombo> do wstawiania wcięć.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Wcięcia Backspace'm</guilabel></term>
<listitem>
<para>Pozwala na użycie klawisza <keycombo action="simul"><keycap>Backspace</keycap></keycombo> do zmniejszania wcięć.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Tryb klawisza Tab jeżeli nic nie jest wybrane</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Wstaw znaki wcięcia</guilabel></term>
<listitem>
<para>Powoduje iż naciśnięcie klawisza <keycombo action="simul"><keycap>Tab</keycap></keycombo> wprowadza znaki wcięcia.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Wstaw znak tabulacji</guilabel></term>
<listitem>
<para>Powoduje iż naciśnięcie klawisza <keycombo action="simul"><keycap>Tab</keycap></keycombo> wprowadza znaki tabulacji.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Wysuń bieżący wiersz</guilabel></term>
<listitem>
<para>Powoduje iż naciśnięcie klawisza <keycombo action="simul"><keycap>Tab</keycap></keycombo> wcina bieżący wiersz.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="config-dialog-editor-open-save">
<title>Otwórz/Zapisz</title>

<variablelist>

<varlistentry>
<term><guilabel>Format pliku</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Kodowanie:</guilabel></term>
<listitem>
<para>Ustawia domyślne kodowanie znaków dla plików.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Koniec wiersza:</guilabel></term>
<listitem>
<para>Konfiguruje sposób zapisywania znaków końca wiersza w aktywnym dokumencie. Dostępny jest wybór pomiędzy trybami: &UNIX;, DOS/&Windows; i Macintosh.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Automatyczne wykrywanie końca wiersza</guilabel></term>
<listitem>
<para>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>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Zużycie pamięci</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Najwięcej załadowanych bloków na plik:</guilabel></term>
<listitem>
<para>Program załaduje określoną przez ten parametr liczbę bloków (po około 2048 wierszy każdy) tekstu do pamięci. Jeżeli rozmiar pliku jest większy od ustawionej tu wartości, to pozostałe bloki zostaną zapisane na dysk i załadowane później w razie potrzeby.</para>
<para>Może to powodować opóźnienia w trakcie poruszania się po dokumencie. Większa liczba bloków zwiększa szybkość kosztem zużycia pamięci. </para><para>W większości przypadków wybranie największej możliwej wartości jest ustawieniem optymalnym. Należy ją zmniejszyć w przypadku problemów z brakiem pamięci.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Automatyczne czyszczenie przy zapisie/odczycie</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Usuń spacje na końcu wiersza</guilabel></term>
<listitem>
<para>&kate; automatycznie usunie dodatkowe spacje na końcu wierszy w całym tekście podczas operacji zapisu lub odczytu pliku.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Plik konfiguracyjny katalogu</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Głębokość szukania pliku konfiguracyjnego:</guilabel></term>
<listitem>
<para>Program będzie sprawdzał podaną liczbę katalogów nadrzędnych w celu znalezienia pliku konfiguracji &kate; i wczytania znajdujących się w nim ustawień.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Kopia zapasowa przy zapisie</guilabel></term>
<listitem><para>Funkcja ta spowoduje, iż &kate; skopiuje plik oryginalny przed zapisaniem dokonanych zmian w tekście. Nazwa pliku kopii będzie ustalona w sposób następujący: '&lt;przedrostek&gt;&lt;nazwapliku&gt;&lt;przyrostek&gt;'. Przedrostek domyślnie nie jest określony, zaś domyślny przyrostek to <emphasis role="bold">~</emphasis>. </para>
<variablelist>
<varlistentry>
<term><guilabel>Pliki lokalne</guilabel></term>
<listitem>
<para>Włącza tworzenia kopii zapasowej dla plików lokalnych.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Zdalne pliki</guilabel></term>
<listitem>
<para>Włącza tworzenie kopii zapasowej dla plików zdalnych.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Przedrostek</guilabel></term>
<listitem>
<para>Tekst dodany przed nazwą pliku oryginalnego przy tworzeniu kopii zapasowej.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Przyrostek</guilabel></term>
<listitem>
<para>Tekst dodany do nazwy pliku oryginalnego przy tworzeniu kopii zapasowej.</para>
</listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="config-dialog-editor-highlighting">
<title>Podświetlenie</title>
<para>Poniższe ustawienia stosowane są do konfiguracji reguł podświetlania składni dla różnych rodzajów dokumentu. Zmiany dokonane w tej karcie dotyczą jedynie jednego wybranego typu dokumentu.</para>

<variablelist>
<varlistentry>
<term><guilabel>Podświetlenie:</guilabel></term>
<listitem><para>Pole listy rozwijanej pozwalające wybrać rodzaj dokumentu/języka programowania,dla którego dokonywana jest zmiana ustawień.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Informacje</guilabel></term>
<listitem>
<para>Wyświetla informacje o wybranej regule podświetlania: nazwisko autora oraz rodzaj licencji. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Właściwości</guilabel></term>
<listitem>
<variablelist>
<varlistentry>
<term><guilabel>Rozszerzenia nazw pliku:</guilabel></term>
<listitem><para>Pozwala na określenie rozszerzeń nazw plików związanych z daną regułą podświetlania składni, co pozwala na automatyczny wybór reguły w momencie otwierania pliku.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Typy MIME:</guilabel></term>
<listitem><para>Naciśnięcie przycisku po prawej stronie pola wyboru otwiera okno dialogowe asystenta, pozwalające wybrać typy MIME z listy dostępnych typów.</para><para>Pole <emphasis role="bold">Rozszerzenia nazw plików</emphasis> będzie automatycznie uzupełnione zgodnie z wybranymi typami MIME.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Priorytet:</guilabel></term>
<listitem><para>Ustawia priorytet dla danej reguły podświetlania.</para></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Pobierz...</guibutton></term>
<listitem>
<para>Naciśnięcie tego przycisku pozwala na pobranie nowych lub zaktualizowanych reguł podświetlania składni ze strony WWW programu &kate;. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="config-dialog-editor-filetypes">
<title>Typy plików</title>
<para>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>
<variablelist>
<varlistentry>
<term><guilabel>Typ pliku:</guilabel></term>
<listitem><para>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>
<variablelist>
<varlistentry>
<term><guilabel>Nowy</guilabel></term>
<listitem><para>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></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Usuń</guilabel></term>
<listitem><para>Aby usunąć zdefiniowany wcześniej typ pliku należy wybrać go korzystając z listy rozwijanej, a następnie nacisnąć przycisk Usuń.</para></listitem>
</varlistentry>
</variablelist>
</listitem> </varlistentry>

<varlistentry>
<term><guilabel>Właściwości wybranego typu pliku</guilabel></term>
<listitem><para>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>
<variablelist>
<varlistentry>
<term><guilabel>Nazwa:</guilabel></term>
<listitem><para>Nazwa typu pliku, która pojawia się jako pozycja w menu <menuchoice><guimenu>Narzędzia</guimenu><guimenuitem>Typ pliku</guimenuitem> </menuchoice></para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Sekcja:</guilabel></term>
<listitem><para>Nazwa sekcji pozwala na właściwą organizację wyświetlania typów plików w menu. Jest wykorzystywana do wyświetlania menu <menuchoice> <guimenu>Narzędzia</guimenu> <guimenuitem>Typy plików</guimenuitem> </menuchoice>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Zmienne:</guilabel></term>
<listitem><para>Pole pozwala na dostosowanie konfiguracji &kate; do określonego typu MIME. Możliwe jest określenie dowolnej opcji konfiguracyjnej takiej jak np. podświetlanie, reguły wcięć, kodowanie, itp.</para><para>Pełna lista dostępnych zmiennych konfiguracyjnych dostępna jest w podręczniku.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Rozszerzenia nazw pliku:</guilabel></term>
<listitem><para>Maska filtra plików pozwala otwierać pliki z użyciem tylko nazwy. Typowa maska wykorzystuje gwiazdkę oraz rozszerzenie nazwy, przykładowo: <filename>*.txt; *.text</filename>. W polu tym wprowadza się listę masek rozdzieloną średnikami.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Typy MIME:</guilabel></term>
<listitem><para>Naciśnięcie przycisku asystenta po prawej stronie pola wyboru wyświetla okno dialogowe pozwalające na łatwy wybór typów MIME.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Priorytet:</guilabel></term>
<listitem><para>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></listitem>
</varlistentry>
</variablelist>
</listitem> </varlistentry>

</variablelist>
</sect2>

<sect2 id="config-dialog-editor-shortcuts">
<title>Skróty klawiszowe</title>
<para>Możliwa jest tutaj zmiana konfiguracji skrótów klawiszowych. Wybranie tego polecenia i zaznaczenie pola opcji: <guilabel>Własny</guilabel> powoduje otwarcie okna, w którym użytkownik definiuje własną kombinację klawiszy dla danego polecenia.</para>
<para>Pole wyszukiwania pozwala na szybkie odszukanie polecenia i sprawdzenie jego skrótu klawiszowego.</para>
</sect2>

<sect2 id="config-dialog-editor-plugins">
<title>Wtyczki</title>
<para>W tej karcie pojawi się lista wszystkich dostępnych wtyczek. Można je w tym oknie włączyć. Po włączeniu wtyczki przycisk <guibutton>Konfiguruj</guibutton> staje się aktywny dzięki czemu można skonfigurować wybraną wtyczkę.</para>
</sect2>

</sect1>



<sect1 id="config-variables">

<title>Konfiguracja programu za pomocą zmiennych</title>

<para>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>kate: NAZWAZMIENNEJ WARTOŚĆ; [ NAZWAZMIENNEJ WARTOŚĆ; ... ]</userinput>. 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>

<para>Poniżej znajduje się przykładowy wiersz zawierający zmienne konfiguracyjne zmieniający ustawienia wcięć dla pliku C++, Java lub Javascript: <programlisting>// kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;</programlisting>
</para>

<note><para>Program sprawdza tylko pierwsze 10 lub ostatnie 10 wierszy dokumentu w poszukiwaniu zmiennych konfiguracyjnych.</para></note>

<para>Zmienne dokumentu odnoszą się do niemal wszystkich parametrów konfiguracji komponentu edytora. Dodatkowe zmienne mogą być wykorzystywane przez wtyczki, jednak w takim wypadku informacje na ich temat powinny być dostępne w dokumentacji wtyczek.</para>

<sect2 id="config-variables-howto">
<title>Jak program &kate; wykorzystuje zmienne</title>

<para>Komponent edytora poszukuje parametrów konfiguracyjnych w następujących miejscach (i w podanej kolejności): <itemizedlist> <listitem><para>Konfiguracja ogólna.</para></listitem> <listitem><para>Opcjonalne dane sesji.</para></listitem> <listitem><para>Konfiguracja typów pliku.</para></listitem> <listitem><para>Zmienne dokumentu znajdujące się w pliku.</para></listitem> <listitem><para>Zmiany konfiguracji z menu lub linii poleceń.</para></listitem> </itemizedlist>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>

<para>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>

<para>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>
<listitem><para>BOOL - przyjmuje wartości: on|off|true|false|1|0</para></listitem>
<listitem><para>INTEGER - dowolna liczba całkowita</para></listitem>
<listitem><para>STRING - wszystkie inne napisy</para></listitem>
</itemizedlist>
</para>

<variablelist>
<title>Dostępne zmienne konfiguracyjne</title>

<varlistentry>
<term><cmdsynopsis><command>auto-brackets</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza automatyczne wstawianie nawiasów.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>auto-center-lines</command><arg>INT</arg></cmdsynopsis></term>
<listitem><para>Określa liczbę wierszy, które program stara się pokazywać powyżej i poniżej aktualnej pozycji kursora.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>auto-insert-doxygen</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>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></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>background-color</command><arg>STRING</arg></cmdsynopsis></term>
<listitem><para>Ustawia kolor tła. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>backspace-indents</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza zmniejszanie wcięć klawiszem Backspace.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>block-selection</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza tryb zaznaczania bloku.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>bracket-highlight-color</command><arg>STRING</arg></cmdsynopsis></term>
<listitem><para>Ustawia kolor dla podświetlanych nawiasów. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000" </para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>current-line-color</command><arg>STRING</arg></cmdsynopsis></term>
<listitem><para>Ustawia kolor wyświetlania bieżącego wiersza. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>dynamic-word-wrap</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza dynamiczne zawijanie wyrazów.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>eol | end-of-line</command><arg>STRING</arg></cmdsynopsis></term>
<listitem><para>Ustawia tryb kodowania końca wiersza. Dostępne ustawienia to: <quote>unix</quote>, <quote>mac</quote> oraz <quote>dos</quote></para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>encoding</command><arg>STRING</arg></cmdsynopsis></term>
<listitem><para>Ustawia kodowanie znaków w dokumencie. Wartość musi zawierać poprawną nazwę kodowania, np.: <quote>utf-8</quote>.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>font-size</command><arg>INT</arg></cmdsynopsis></term>
<listitem><para>Określa rozmiar czcionki dla dokumentu w punktach.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>font</command><arg>STRING</arg></cmdsynopsis></term>
<listitem><para>Ustawia rodzaj czcionki dla wyświetlania dokumentu. Wartość musi zawierać poprawną nazwę czcionki np.: <quote>courier</quote>.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>icon-bar-color</command><arg>STRING</arg></cmdsynopsis></term>
<listitem><para>Ustawia kolor dla paska ikon. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>icon-border</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza wyświetlanie paska ikon.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>folding-markers</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza wyświetlanie znaczników zwijania kodu.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>indent-mode</command><arg>STRING</arg></cmdsynopsis></term>
<listitem><para>Ustawia tryb automatycznych wcięć. Rozpoznawane tryby wcięć to: <quote>none</quote>, <quote>normal</quote>, <quote>cstyle</quote>, <quote>csands</quote>, <quote>python</quote>, <quote>xml</quote> Więcej informacji na temat automatycznych wcięć w sekcji <xref linkend="kate-part-autoindent"/>.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>indent-width</command><arg>INT</arg></cmdsynopsis></term>
<listitem><para>Ustawia szerokość wcięć.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>keep-extra-spaces</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza pozostawianie dodatkowych spacji podczas obliczania szerokości wcięcia.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>keep-indent-profile</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Zabezpiecza przez usunięciem wcięcia dla bloku jeżeli jest w nim nawet jeden wiersz bez wcięcia.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>line-numbers</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza wyświetlanie numerów wierszy.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>mixed-indent</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza mieszane wcięcia w stylu Emacsa.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>overwrite-mode</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza tryb zastępowania.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>persistent-selection</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza funkcję trwałego zaznaczenia.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>remove-trailing-space</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza dynamiczne czyszczenia końca wiersza.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>replace-tabs-save</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza konwersję znaków tabulacji na spacje przy zapisywaniu pliku.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>replace-tabs</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza dynamiczną konwersję tabulacji na spacje.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>replace-trailing-space-save</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza funkcję czyszczenia końców wierszy przy zapisywaniu pliku.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>scheme</command><arg>STRING</arg></cmdsynopsis></term>
<listitem><para>Ustawia zestaw kolorów. Parametr musi określać istniejący zestaw kolorów, w przeciwnym wypadku nic się nie zmieni.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>selection-color</command><arg>STRING</arg></cmdsynopsis></term>
<listitem><para>Ustawia kolor dla zaznaczenia. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>show-tabs</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza wyświetlanie znaku tabulacji.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>smart-home</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza nawigację za pomocą sprytnego klawisza Home.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>space-indent</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza tworzenie wcięć za pomocą spacji.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>tab-indents</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza tworzenie wcięć za pomocą klawisza tabulacji.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>tab-width</command><arg>INT</arg></cmdsynopsis></term>
<listitem><para>Ustawia szerokość wyświetlania znaku tabulacji.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>undo-steps</command><arg>INT</arg></cmdsynopsis></term>
<listitem><para>Ustawia liczbę zapamiętanych operacji dla polecenia "Cofnij".</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>word-wrap-column</command><arg>INT</arg></cmdsynopsis></term>
<listitem><para>Ustawia liczbę znaków po której nastąpi statyczne zawinięcie wyrazów.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>word-wrap-marker-color</command><arg>STRING</arg></cmdsynopsis></term>
<listitem><para>Ustawia kolor znacznika zawijania wyrazów. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>word-wrap</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza statyczne zawijanie wyrazów.</para></listitem>
</varlistentry>

<varlistentry>
<term><cmdsynopsis><command>wrap-cursor</command><arg>BOOL</arg></cmdsynopsis></term>
<listitem><para>Włącza lub wyłącza zawijanie kursora.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

</chapter>