# Konfiguracja &kate;

## Przegląd

Program &kate; udostępnia kilka narzędzi dostosowania swojego zachowania do wymagań użytkownika. Do najważniejszych należą:

Okno konfiguracji

- Podstawowe narzędzie konfiguracji programu &kate;, komponentu edytora i zainstalowanych wtyczek.

Menu Ustawienia

- Pozwala na zmianę często używanych ustawień oraz wywołuje okna konfiguracji.

Menu Widok

- Pozwala użytkownikowi podzielić aktywną ramkę oraz włącza i wyłącza wyświetlenie paska ikon oraz numerów wierszy dla bieżącego dokumentu.

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

## Główne okno konfiguracji

Okno konfiguracji &kate; wyświetla listę dostępnych tematów konfiguracyjnych po lewej stronie, a karty konfiguracji odpowiadające wybranym tematom po prawej stronie.

Tematy konfiguracji dzielą się na dwie grupy

- Konfiguracja programu

- Konfiguracja edytora

## Konfiguracja programu &kate;

Ta grupa zawiera parametry konfiguracyjne dotyczące samego zachowania programu &kate;.

### Karta: Ustawienia ogólne

W karcie tej umieszczone są globalne ustawienia programu &kate;.

Wyświetl pełną ścieżkę w tytule

- 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).

Zachowanie

- Synchronizuj konsolę z aktywnym dokumentem

- Włączenie tej opcji spowoduje, iż wbudowany program &konsole; będzie automatycznie zmieniał katalog roboczy (poleceniem systemowym `cd`) 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.

Ostrzegaj o plikach zmienionych przez zewnętrzne procesy

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

  Jeżeli opcja jest wyłączona, to &kate; nie będzie pytać o reakcję w przypadku, gdy plik zostanie zmodyfikowany przez inny program.

Dodatkowe informacje

- Zachowaj dodatkowe informacje między sesjami

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

Usuń nieużywane dodatkowe informacje po

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

### Karta: Sesje

Poniższa sekcja zawiera informacje dotyczące korzystania z sesji.

Elementy sesji

- Dołącz konfigurację okien

- Jeżeli opcja jest włączona to &kate; zapisze wraz z informacją o sesji także bieżącą konfigurację okien.

Zachowanie przy starcie programu

- Pozwala na określenie zachowania programu &kate; po uruchomieniu. Ten parametr może zostać unieważniony poprzez uruchomienie &kate; z odpowiednimi parametrami w linii poleceń.

  Uruchom nową sesję

- Jeżeli ta opcja jest aktywna, to &kate; po uruchomieniu utworzy nową, nienazwaną sesję.

Wczytaj ostatnią sesję

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

Wybierz sesję ręcznie

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

Zachowanie przy wyjściu z programu lub przy zmianie sesji

- Nie zapisuj sesji

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

Zapisz sesję

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

Zapytaj użytkownika

- Zostanie wyświetlone pytanie o zapisanie sesji za każdym razem, gdy nazwana sesja będzie zamykana.

### Karta: Wybór plików

Pasek narzędzi

- 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ę Zaznaczone akcje, a następnie ustawić je we właściwej kolejności za pomocą przycisków strzałek.

Automatyczna synchronizacja

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

  - Przy zmianie aktywnego dokumentu.

  - Po wyświetleniu przeglądarki systemu plików.

  Jeżeli ta opcja nie zostanie włączona, to użytkownik może szybko przejść do katalogu bieżącego dokumentu za pomocą przycisku Bieżący katalog dokumentu, znajdującego się na pasku narzędzi.

Zapamiętane lokalizacje

- Pozwala określić liczbę pozycji w historii przeglądanych katalogów. Powtarzające się wpisy nie są zapamiętywane.

Zapamiętane filtry

- Pozwala określić liczbę pozycji w historii wykorzystywanych filtrów. Filtry powtarzające się nie są zapamiętywane.

Sesja

- Określa czy przeglądarka systemu plików ma zapamiętywać bieżący katalog i filtry plików podczas przełączania pomiędzy sesjami.

### Karta: Lista dokumentów

Cieniowanie tła

- 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 Lista dokumentów.

Sortuj wg

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

### Karta: Wtyczki

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.

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

### Narzędzia zewnętrzne

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

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.

### Właściwości narzędzi zewnętrznych

Etykieta

- Etykieta narzędzia, która wyświetli się w menu Narzędzia zewnętrzne.

Skrypt

- Skrypt powłoki uruchamiany przy wywoływaniu narzędzia. Podczas uruchamiania skryptu przekazywane są do niego następujące makra:

  %URL

- Pełna ścieżka dostępu dla bieżącego dokumentu lub pusty napis, jeżeli dokument nie został jeszcze zapisany.

%URLS

- Rozdzielana spacjami lista ścieżek dostępu do wszystkich otwartych dokumentów (z wyjątkiem dokumentów nie zapisanych).

%directory

- Katalog, w którym znajduje się bieżący dokument lub pusty napis, jeżeli nie został on jeszcze zapisany.

%filename

- Nazwa pliku bieżącego dokumentu (bez ścieżki dostępu do katalogu) lub pusty napis, jeżeli nie został on jeszcze zapisany.

%line

- Numer wiersza bieżącego dokumentu, w którym znajduje się kursor.

%column

- Numer kolumny bieżącego dokumentu, w której znajduje się kursor.

%selection

- Zaznaczony fragment tekstu z bieżącego dokumentu lub pusty napis, jeżeli nic nie zostało zaznaczone

%text

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

Program

- 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ą `PATH`.

Typy MIME

- Rozdzielana średnikami lista typów MIME, dla których dane polecenie może być wykonane. Aktualnie nie jest wykorzystywana.

Zapisz

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

Nazwa linii poleceń

- Wypełnienie tego pola powoduje, iż narzędzie staje się dostępne w linii poleceń edytora jako `exttool-`Nazwa linii poleceń`` (nazwa tu wprowadzona musi być poprzedzona napisem: exttool-) w wywołaniu linii poleceń.

## Konfiguracja edytora

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 definicje typu pliku, zmienne dokumentu lub przez ich zmianę w czasie edycji dokumentu.

### Wygląd

Zawijanie wyrazów

- Dynamiczne zawijanie wyrazów

- Powoduje, iż wiersze będą zawijane na krawędzi okna.

Znaczniki dynamicznego zawijania wyrazów

- Wybiera sposób wyświetlania znaczników dynamicznego zawijania wyrazów.

Wyrównaj pionowo dynamicznie zawijane wiersze do głębokości wcięć:

- Włącza automatyczne wyrównywanie dynamicznie zawiniętych wierszy do aktualnego poziomu wcięcia tekstu. Zwiększa to czytelność kodu.

  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.

Zwijanie kodu

- Pokaż znaczniki zwijania (jeśli dostępne)

- Włączenie tej opcji spowoduje pokazanie w aktualnie edytowanym dokumencie znaczników zwijania kodu (jeżeli opcja zwijania kodu jest włączona).

Paski boczne

- Pokaż pasek ikon

- Włącza wyświetlanie paska ikon po lewej stronie okna edytora. Na pasku ikon widoczne są np. znaczniki zakładek.

Pokaż numery wierszy

- Włącza pokazywanie numerów wierszy po lewej stronie okna edytora.

Pokaż znaki na pasku przewijania

- Zaznaczenie opcji powoduje wyświetlenie znaczników na pionowym pasku przewijania. Znaczniki te wskazują m.in. na miejsce wstawienia zakładki w tekście.

Sortuj menu zakładek

- Według położenia

- Zakładki zostaną posortowane w kolejności numerów wierszy, dla których zostały ustawione.

Według utworzenia

- Każda nowa zakładka zostanie dodana na końcu listy niezależnie od miejsca jej położenia w dokumencie.

Pokaż linie wcięć

- Zaznaczenie tej opcji spowoduje uwidocznienie w oknie edytora linii pomagających zidentyfikować poszczególne poziomy wcięcia tekstu.

### Czcionki i kolory

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.

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

#### Kolory

Tło tekstu

- Normalny tekst

- Kolor domyślny dla tła obszaru edycyjnego. Będzie to kolor wyraźnie dominujący w oknie edytora.

Zaznaczony tekst

- Tło dla zaznaczonego fragmentu tekstu. Wartości domyślne są pobierane z ustawień globalnych środowiska &kde;.

Bieżący wiersz

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

Zakładki

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

Dodatkowe elementy

- Tło lewej krawędzi

- Kolor wykorzystywany dla tła paska ikon, numerów wierszy i znaczników zwijania po lewej stronie edytora (jeżeli jest on widoczny).

Numery wierszy

- Kolor wykorzystywany dla wyświetlania numerów wierszy na pasku po lewej stronie okna edycyjnego (jeżeli są widoczne).

Podświetlanie nawiasów

- Kolor wykorzystywany do podświetlania tła par odpowiadających sobie wzajemnie nawiasów w kodzie programu.

Znaczniki zawijanego tekstu

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

Znaczniki tabulacji

- W kolorze tym wyświetlane są znaczniki tabulacji.

#### Czcionka

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.

#### Style normalnego tekstu

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.

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.

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.

#### Style podświetlania tekstu

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 Podświetlenie widocznej w górnej części okna.

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.

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.

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.

### Kursor i zaznaczanie

Ruch kursora tekstu

- Sprytny klawisz Home

- Wybranie pozycji powoduje, iż naciśnięcie klawisza "Home" przesuwa kursor na początek tekstu w wierszu, pomijając ewentualne znaki wcięcia.

Zawijaj kursor

- Podczas przesuwania kursora za pomocą lewego i prawego 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.

  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.

PageUp/PageDown przenosi kursor

- Opcja ta zmienia zachowanie kursora w przypadku naciśnięcia klawiszy Page Up lub Page Down. 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.

Automatycznie centruj kursor (wiersze):

- Określa liczbę wierszy, które program stara się pokazywać powyżej i poniżej aktualnej pozycji kursora.

Tryb zaznaczania

- Normalny

- Zaznaczony fragment zostanie zastąpiony przez wprowadzany tekst zaś przesunięcie kursora zlikwiduje zaznaczenie tekstu.

Trwałe zaznaczenia

- Zaznaczenie pozostanie aktywne nawet po przesunięciu kursora, czy też wprowadzeniu nowego tekstu.

### Edycja

Tabulatory

- Wstaw spacje zamiast tabulatorów

- Zaznaczenie tej opcji spowoduje, iż po naciśnięciu klawisza TAB edytor będzie wstawiał do tekstu określoną liczbę spacji, w zależności od pozycji oraz ustawienia parametru: `Szerokość tabulacji i wcięcia`.

Pokaż tabulatory

- Włączenie opcji spowoduje wyświetlanie przez &kate; małej kropki w miejscu występowania znaków tabulacji.

  Opcja powoduje również wyświetlanie kropki dla znaków spacji na końcu wiersza. Zachowanie to zostanie zmienione w przyszłych wersjach &kate;.

Szerokość tabulacji i wcięcia

- Jeśli włączona jest opcja Zamień tabulacje na spacje, wtedy to pole określa liczbę spacji, na które edytor automatycznie zamieni każdy znak tabulacji.

Statyczne zawijanie wyrazów

- 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: Zawijaj wyrazy na:.

  Włącz statyczne zawijanie wyrazów

- Opcja włącza lub wyłącza statyczne zawijanie wyrazów.

Pokaż znaczniki statycznego zawijania wyrazów

- Zaznaczenie tej opcji spowoduje wyświetlanie pionowej linii w miejscu określonym przez parametr "kolumna zawijania" w menu Ustawienia Konfiguracja &kate;... (w karcie: "Edycja"). Znacznik zawijania wyrazów jest wyświetlany tylko w przypadku stosowania czcionki o stałej szerokości.

Zawijaj wyrazy na:

- Jeśli opcja Zawijanie wyrazów jest wybrana, to w tym polu określa się liczbę znaków, przy której edytor automatycznie rozpocznie nowy wiersz.

Usuń spacje na końcu wiersza

- Włączenie tej opcji powoduje, że &kate; automatycznie usunie dodatkowe spacje na końcu wiersza tekstu.

Automatyczne nawiasy

- Włączenie tej opcji powoduje, że po wpisaniu lewego nawiasu ([, (, lub {) &kate; automatycznie doda prawy nawias (odpowiednio: }, ), lub ]) po prawej stronie kursora.

Liczba operacji cofnięć:

- 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 Cofnij.

Sprytne wyszukiwanie tekstu od:

- Pozwala na określenie źródła tekstu, który &kate; wstawi automatycznie w oknie dialogowym wyszukiwania. Dostępne są następujące opcje:

  - Nigdzie: Żaden tekst nie zostanie wstawiony.

  - Tylko zaznaczenie: Używa zaznaczonego fragmentu jako tekstu wyszukiwanego.

  - Zaznaczenie, potem bieżące słowo: Używa zaznaczonego fragmentu (jeżeli dostępny), w przeciwnym wypadku wprowadza bieżące słowo.

  - Tylko bieżące słowo: Używa słowa, na którym aktualnie znajduje się kursor.

  - Bieżące słowo, potem zaznaczenie: Używa bieżącego słowa, a jeśli brak słowa w pozycji kursora to zaznaczenia.

  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).

### Wcięcia

Automatyczne wcięcia

- Tryb wcięć:

- Pozwala na określenie domyślnie stosowanego trybu wcięć. Zalecane jest ustawienie tutaj `Brak` lub `Normalny` i ustawienie reguł wcięć w konfiguracji typów plików dla takich formatów jak kod programu w C/C++ czy &XML;.

Wstaw otwierający znak Doxygen "*" w czasie pisania

- Automatycznie wstawia otwierający znak Doxygen "*" w czasie pisania komentarzy w formacie Doxygena. Opcja jest aktywna tylko jeśli ma zastosowanie.

Wcięcia spacjami

- Używa znaków spacji zamiast znaków Tab do generowania wcięć

- Powoduje zamianę znaku tabulacji na zdefiniowaną poniżej Liczbę spacji:.

Tryb mieszany w stylu Emacsa

- Powoduje użycie zarówno znaków tabulacji, jak i spacji dla wcięć.

Liczba spacji:

- Pozwala na ustawienie liczby spacji używanych do generowania wcięć przy włączonej opcji Użyj spacji zamiast znaków Tab do wcięć.

Utrzymuj profil wcięć

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

Pozostaw dodatkowe spacje

- Wcięcie większe niż wybrana liczba spacji nie będzie zmniejszone.

Klawisze do użycia

- Wcięcie tabulatorami

- Pozwala na użycie klawisza Tab do wstawiania wcięć.

Wcięcia Backspace'm

- Pozwala na użycie klawisza Backspace do zmniejszania wcięć.

Tryb klawisza Tab jeżeli nic nie jest wybrane

- Wstaw znaki wcięcia

- Powoduje iż naciśnięcie klawisza Tab wprowadza znaki wcięcia.

Wstaw znak tabulacji

- Powoduje iż naciśnięcie klawisza Tab wprowadza znaki tabulacji.

Wysuń bieżący wiersz

- Powoduje iż naciśnięcie klawisza Tab wcina bieżący wiersz.

### Otwórz/Zapisz

Format pliku

- Kodowanie:

- Ustawia domyślne kodowanie znaków dla plików.

Koniec wiersza:

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

Automatyczne wykrywanie końca wiersza

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

Zużycie pamięci

- Najwięcej załadowanych bloków na plik:

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

  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.

  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.

Automatyczne czyszczenie przy zapisie/odczycie

- Usuń spacje na końcu wiersza

- &kate; automatycznie usunie dodatkowe spacje na końcu wierszy w całym tekście podczas operacji zapisu lub odczytu pliku.

Plik konfiguracyjny katalogu

- Głębokość szukania pliku konfiguracyjnego:

- Program będzie sprawdzał podaną liczbę katalogów nadrzędnych w celu znalezienia pliku konfiguracji &kate; i wczytania znajdujących się w nim ustawień.

Kopia zapasowa przy zapisie

- 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 ~.

  Pliki lokalne

- Włącza tworzenia kopii zapasowej dla plików lokalnych.

Zdalne pliki

- Włącza tworzenie kopii zapasowej dla plików zdalnych.

Przedrostek

- Tekst dodany przed nazwą pliku oryginalnego przy tworzeniu kopii zapasowej.

Przyrostek

- Tekst dodany do nazwy pliku oryginalnego przy tworzeniu kopii zapasowej.

### Podświetlenie

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.

Podświetlenie:

- Pole listy rozwijanej pozwalające wybrać rodzaj dokumentu/języka programowania,dla którego dokonywana jest zmiana ustawień.

Informacje

- Wyświetla informacje o wybranej regule podświetlania: nazwisko autora oraz rodzaj licencji.

Właściwości

- Rozszerzenia nazw pliku:

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

Typy MIME:

- Naciśnięcie przycisku po prawej stronie pola wyboru otwiera okno dialogowe asystenta, pozwalające wybrać typy MIME z listy dostępnych typów.

  Pole Rozszerzenia nazw plików będzie automatycznie uzupełnione zgodnie z wybranymi typami MIME.

Priorytet:

- Ustawia priorytet dla danej reguły podświetlania.

Pobierz...

- Naciśnięcie tego przycisku pozwala na pobranie nowych lub zaktualizowanych reguł podświetlania składni ze strony WWW programu &kate;.

### Typy plików

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.

Typ pliku:

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

  Nowy

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

Usuń

- Aby usunąć zdefiniowany wcześniej typ pliku należy wybrać go korzystając z listy rozwijanej, a następnie nacisnąć przycisk Usuń.

Właściwości wybranego typu pliku

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

  Nazwa:

- Nazwa typu pliku, która pojawia się jako pozycja w menu Narzędzia Typ pliku

Sekcja:

- Nazwa sekcji pozwala na właściwą organizację wyświetlania typów plików w menu. Jest wykorzystywana do wyświetlania menu Narzędzia Typy plików .

Zmienne:

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

  Pełna lista dostępnych zmiennych konfiguracyjnych dostępna jest w podręczniku.

Rozszerzenia nazw pliku:

- Maska filtra plików pozwala otwierać pliki z użyciem tylko nazwy. Typowa maska wykorzystuje gwiazdkę oraz rozszerzenie nazwy, przykładowo: `*.txt; *.text`. W polu tym wprowadza się listę masek rozdzieloną średnikami.

Typy MIME:

- Naciśnięcie przycisku asystenta po prawej stronie pola wyboru wyświetla okno dialogowe pozwalające na łatwy wybór typów MIME.

Priorytet:

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

### Skróty klawiszowe

Możliwa jest tutaj zmiana konfiguracji skrótów klawiszowych. Wybranie tego polecenia i zaznaczenie pola opcji: Własny powoduje otwarcie okna, w którym użytkownik definiuje własną kombinację klawiszy dla danego polecenia.

Pole wyszukiwania pozwala na szybkie odszukanie polecenia i sprawdzenie jego skrótu klawiszowego.

### Wtyczki

W tej karcie pojawi się lista wszystkich dostępnych wtyczek. Można je w tym oknie włączyć. Po włączeniu wtyczki przycisk Konfiguruj staje się aktywny dzięki czemu można skonfigurować wybraną wtyczkę.

## Konfiguracja programu za pomocą zmiennych

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ć: `kate: NAZWAZMIENNEJ WARTOŚĆ; [ NAZWAZMIENNEJ WARTOŚĆ; ... ]`. 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.

Poniżej znajduje się przykładowy wiersz zawierający zmienne konfiguracyjne zmieniający ustawienia wcięć dla pliku C++, Java lub Javascript:

    // kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;

Program sprawdza tylko pierwsze 10 lub ostatnie 10 wierszy dokumentu w poszukiwaniu zmiennych konfiguracyjnych.

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.

### Jak program &kate; wykorzystuje zmienne

Komponent edytora poszukuje parametrów konfiguracyjnych w następujących miejscach (i w podanej kolejności):

- Konfiguracja ogólna.

- Opcjonalne dane sesji.

- Konfiguracja typów pliku.

- Zmienne dokumentu znajdujące się w pliku.

- Zmiany konfiguracji z menu lub linii poleceń.

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ń.

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.

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:

- BOOL - przyjmuje wartości: on|off|true|false|1|0

- INTEGER - dowolna liczba całkowita

- STRING - wszystkie inne napisy

### Dostępne zmienne konfiguracyjne

    auto-bracketsBOOL

- Włącza lub wyłącza automatyczne wstawianie nawiasów.

    auto-center-linesINT

- Określa liczbę wierszy, które program stara się pokazywać powyżej i poniżej aktualnej pozycji kursora.

    auto-insert-doxygenBOOL

- 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ęć.

    background-colorSTRING

- Ustawia kolor tła. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".

    backspace-indentsBOOL

- Włącza lub wyłącza zmniejszanie wcięć klawiszem Backspace.

    block-selectionBOOL

- Włącza lub wyłącza tryb zaznaczania bloku.

    bracket-highlight-colorSTRING

- Ustawia kolor dla podświetlanych nawiasów. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000"

    current-line-colorSTRING

- Ustawia kolor wyświetlania bieżącego wiersza. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".

    dynamic-word-wrapBOOL

- Włącza lub wyłącza dynamiczne zawijanie wyrazów.

    eol | end-of-lineSTRING

- Ustawia tryb kodowania końca wiersza. Dostępne ustawienia to: unix, mac oraz dos

    encodingSTRING

- Ustawia kodowanie znaków w dokumencie. Wartość musi zawierać poprawną nazwę kodowania, np.: utf-8.

    font-sizeINT

- Określa rozmiar czcionki dla dokumentu w punktach.

    fontSTRING

- Ustawia rodzaj czcionki dla wyświetlania dokumentu. Wartość musi zawierać poprawną nazwę czcionki np.: courier.

    icon-bar-colorSTRING

- Ustawia kolor dla paska ikon. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".

    icon-borderBOOL

- Włącza lub wyłącza wyświetlanie paska ikon.

    folding-markersBOOL

- Włącza lub wyłącza wyświetlanie znaczników zwijania kodu.

    indent-modeSTRING

- Ustawia tryb automatycznych wcięć. Rozpoznawane tryby wcięć to: none, normal, cstyle, csands, python, xml Więcej informacji na temat automatycznych wcięć w sekcji kate-part-autoindent.

    indent-widthINT

- Ustawia szerokość wcięć.

    keep-extra-spacesBOOL

- Włącza lub wyłącza pozostawianie dodatkowych spacji podczas obliczania szerokości wcięcia.

    keep-indent-profileBOOL

- Zabezpiecza przez usunięciem wcięcia dla bloku jeżeli jest w nim nawet jeden wiersz bez wcięcia.

    line-numbersBOOL

- Włącza lub wyłącza wyświetlanie numerów wierszy.

    mixed-indentBOOL

- Włącza lub wyłącza mieszane wcięcia w stylu Emacsa.

    overwrite-modeBOOL

- Włącza lub wyłącza tryb zastępowania.

    persistent-selectionBOOL

- Włącza lub wyłącza funkcję trwałego zaznaczenia.

    remove-trailing-spaceBOOL

- Włącza lub wyłącza dynamiczne czyszczenia końca wiersza.

    replace-tabs-saveBOOL

- Włącza lub wyłącza konwersję znaków tabulacji na spacje przy zapisywaniu pliku.

    replace-tabsBOOL

- Włącza lub wyłącza dynamiczną konwersję tabulacji na spacje.

    replace-trailing-space-saveBOOL

- Włącza lub wyłącza funkcję czyszczenia końców wierszy przy zapisywaniu pliku.

    schemeSTRING

- Ustawia zestaw kolorów. Parametr musi określać istniejący zestaw kolorów, w przeciwnym wypadku nic się nie zmieni.

    selection-colorSTRING

- Ustawia kolor dla zaznaczenia. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".

    show-tabsBOOL

- Włącza lub wyłącza wyświetlanie znaku tabulacji.

    smart-homeBOOL

- Włącza lub wyłącza nawigację za pomocą sprytnego klawisza Home.

    space-indentBOOL

- Włącza lub wyłącza tworzenie wcięć za pomocą spacji.

    tab-indentsBOOL

- Włącza lub wyłącza tworzenie wcięć za pomocą klawisza tabulacji.

    tab-widthINT

- Ustawia szerokość wyświetlania znaku tabulacji.

    undo-stepsINT

- Ustawia liczbę zapamiętanych operacji dla polecenia "Cofnij".

    word-wrap-columnINT

- Ustawia liczbę znaków po której nastąpi statyczne zawinięcie wyrazów.

    word-wrap-marker-colorSTRING

- Ustawia kolor znacznika zawijania wyrazów. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".

    word-wrapBOOL

- Włącza lub wyłącza statyczne zawijanie wyrazów.

    wrap-cursorBOOL

- Włącza lub wyłącza zawijanie kursora.