<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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><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>
<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>
<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>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>
<listitem><para>Skrypt powłoki uruchamiany przy wywoływaniu narzędzia. Podczas uruchamiania skryptu przekazywane są do niego następujące makra: <variablelist>
<listitem><para>Rozdzielana spacjami lista ścieżek dostępu do wszystkich otwartych dokumentów (z wyjątkiem dokumentów nie zapisanych).</para></listitem>
<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>
<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>
<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>
<listitem><para>Rozdzielana średnikami lista typów MIME, dla których dane polecenie może być wykonane. Aktualnie nie jest wykorzystywana.</para></listitem>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<para>Automatycznie wstawia otwierający znak Doxygen "*" w czasie pisania komentarzy w formacie Doxygena. Opcja jest aktywna tylko jeśli ma zastosowanie.</para>
<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><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>
<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>
<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>
<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>
<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>
<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: '<przedrostek><nazwapliku><przyrostek>'. Przedrostek domyślnie nie jest określony, zaś domyślny przyrostek to <emphasis role="bold">~</emphasis>. </para>
<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>
<listitem><para>Pole listy rozwijanej pozwalające wybrać rodzaj dokumentu/języka programowania,dla którego dokonywana jest zmiana ustawień.</para></listitem>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>
<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>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>
<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>
<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>
<listitem><para>Ustawia tryb kodowania końca wiersza. Dostępne ustawienia to: <quote>unix</quote>, <quote>mac</quote> oraz <quote>dos</quote></para></listitem>
<listitem><para>Ustawia rodzaj czcionki dla wyświetlania dokumentu. Wartość musi zawierać poprawną nazwę czcionki np.: <quote>courier</quote>.</para></listitem>
<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>
