&Anders.Lund; &Anders.Lund.mail;
Suse
Polska

    suse@suse.pl

Polskie tłumaczenie
Krzysztof
Woźniak

    wozniakk@ceti.pl

Polskie tłumaczenie

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

    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.