&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 terminal korzysta z parametrów konfiguracji ustawionych w &systemsettings;, ale można je zmienić w menu kontekstowym po naciśnięciuprawego przycisku myszy.

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

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

Informacje dodatkowe
  Zachowuj informacje dodatkowe 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: 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.

### Karta: Wybór pliku

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.

Autosynchronizacja

  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:

  - Podczas aktywacji dokumentu.

  - Gdy wybór pliku staje się widoczny.

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

Automatycznie synchronizuj konsolę z bieżącym dokumentem, kiedy jest to możliwe

  Włączenie tej opcji spowoduje, iż wbudowana konsola będzie automatycznie zmieniać katalog roboczy (poleceniem systemowym `cd`) na ten, w którym znajduje się aktywny dokument. Zmiana będzie następować zawsze przy wczytaniu nowego lub zmianie bieżącego dokumentu. Jeżeli opcja ta jest wyłączona, to zmiana katalogu będzie wymagała działania użytkownika.

### Narzędzia zewnętrzne

Ta strona wyświetli się, gdy zostanie włączona wtyczka Narzędzia zewnętrzne.Wtyczka ta, powoduje wyświetlenie w menu Narzędzia 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: zmianę, usuwanie lub dodawanie nowych.

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

    Pełna ścieżka dostępu dla bieżącego dokumentu lub pusty napis, jeżeli dokument nie został 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.

Wiersz 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 (jeśli możliwe)

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

  Wyrównaj pionowo dynamicznie zawijane linie 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.

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

  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.

Zaawansowane

  Włącz tryb zaawansowany (tryb KDE 3)

    Bez efektów

  Pokaż linie wcięć

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

  Podświetl zakres między wybranymi nawiasami

    Jeśli jest włączone, obszar między zaznaczonymi, odpowiadającymi sobie nawiasami będzie podświetlony.

### 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 &kappname; pokaże w oknie aktywny w danym momencie schemat kolorów, jeżeli będzie potrzeba zmiany innego schematu, to można go wybrać za pomocą pola rozwijanej listy Schemat. Przyciski Nowy i Usuń pozwalają utworzyć nowy schemat bądź usunąć już istniejący.

Na dole strony możesz wybrać Domyślny schemat dla &kappname;.

#### 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żąca linia

    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 zaznaczonej linii, tak więc bieżąca linia, lub linia z kilkoma zakładkami, ma tło będące efektem zmieszania kilku kolorów. Kolor zakładek jest również wykorzystywany do pokazywania znaczników na bocznym pasku przewijania.

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 linii

    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 i spacji

    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

Style normalnego tekstu stanowią domyślną wartość, wykorzystywaną dla określania kolorów dla innych stylów podświetlania, o ile nie definiują one własnych. Pozwala to na prezentację tekstu w zwarty i przejrzysty sposób, np. tekst komentarza, zawsze będzie miał ten sam kolor i wygląd w prawie wszystkich formatach tekstowych, które można wyświetlić w edytorze.

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.

### Edycja

#### Ogólne

Tabulatory
  Wstaw spacje zamiast tabulatorów

    Zaznaczenie tej opcji powoduje, iż po naciśnięciu klawisza &Tab; edytor będzie wstawiał określoną liczbę spacji, w zależności od pozycji, oraz ustawienia `Szerokość tabulacji`.

  Pokaż tabulatory

    Włączenie opcji, spowoduje wyświetlanie przez &kappname; małej kropki dla oznaczenia znaków tabulacji.

    Opcja powoduje również wyświetlanie kropki dla spacji poprzedzających w wierszu, zachowanie to zostanie poprawione w przyszłych wersjach &kappname;.

  Szerokość tabulacji

    Jeśli opcja Wstaw spacje zamiast tabulatorów jest włączona, to pole określa liczbę spacji, na które edytor automatycznie zmieni każdy znak tabulacji.

Statyczne zawijanie wyrazów

  Zawijania wyrazów to funkcja, powodująca iż edytor automatycznie zaczyna nową linię tekstu i przenosi (zawija) kursor na jej początek. &kappname; automatycznie rozpocznie nową linię tekstu, jeżeli ilość znaków w bieżącej linii osiągnie wielkość zdefiniowaną w opcji 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 Włącz statyczne zawijanie wyrazów jest wybrana, to pole określa liczbę znaków w linii, przy której edytor automatycznie rozpocznie nową linię.

Różne
  Usuń spacje na końcu wiersza

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

  Podświetl spacje na końcu wiersza

    Włączenie tej opcji powoduje, że &kappname; podświetli dodatkowe spacje na końcu linii tekstu.

  Automatyczne nawiasy

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

#### Kursor i zaznaczanie

Ruch kursora tekstu
  Sprytny klawisz Home i End

    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 &kappname;. Jeżeli więc kursor znajduje się w środku okna, to po naciśnięciu tych klawiszy dalej będzie widoczny w środku okna (chyba że osiągnięty zostanie początek lub koniec dokumentu). Jeżeli opcja jest wybrana, to naciśnięcie klawiszy przesunie kursor na początek, bądź na koniec, nowo wyświetlonej w oknie strony dokumentu.

  Automatycznie centruj kursor (wiersze):

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

Tryb zaznaczania tekstu
  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.

#### Wcięcia

Domyślny tryb wcięć:

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

Właściwości wcięć
  Szerokość wcięć:

    Szerokość wcięć to liczba spacji, używana do wstawienia wcięcia w wierszu. Jeśli wyłączono opcję Wstaw spacje zamiast tabulatorów w karcie Ogólne strony Edycja, wstawiany jest znak &Tab;, gdy wcięcie jest podzielone na szerokość tabulacji.

  Pozostaw dodatkowe spacje

    Jeśli ta opcja jest wyłączona, zmiana poziomu wcięcia dopasuje wiersz do wielokrotności szerokości określonej w polu Szerokość wcięć.

  Dopasuj wcięcie kodu wklejonego ze schowka

    Jeśli ta opcja jest wybrana, wklejony ze schowka kod zostanie wcięty. Wywołanie działania Cofnij usunie wcięcie.

Akcje wcięć
  Backspace w początkowych białych znakach usuwa wcięcie

    Wybranie tej opcji spowoduje, że klawisz Backspace zmniejszy poziom wcięcia, jeśli kursor umieszczony jest w początkowych białych znakach wiersza.

  Działanie klawisza Tab (jeśli nie ma zaznaczenia)

    Jeśli chcesz, aby klawisz &Tab; wyrównywał bieżący wiersz w bloku kodu (jak w emacs), stwórz powiązanie klawisza &Tab; z akcją Wcięcie.

    Zawsze zwiększ do następnej pozycji tabulatora

      Jeśli ta opcja zostanie wybrana, klawisz &Tab; zawsze będzie wstawiał białe znaki do osiągnięcia następnej pozycji tabulacji. Jeśli włączona jest opcja Wstaw spacje zamiast tabulatorów w karcie Ogólne strony Edycja, wstawiane będą spacje; w przeciwnym wypadku, wstawiany będzie pojedynczy tabulator.

    Zawsze zwiększaj poziom wcięć

      Wybranie tej opcji spowoduje, że klawisz &Tab; zawsze będzie dodawał wcięcie do bieżącego wiersza, mające określoną Szerokość wcięcia.

    Zwiększ poziom wcięć jeśli w początkowych białych znakach

      Jeżeli opcja jest włączona, klawisz &Tab; wcina bieżącą linię lub przechodzi do kolejnej pozycji tabulatora. Jeżeli kursor znajduje się na lub przed pierwszym nie-białym znakiem w linii, lub jeżeli jest wybrany fragment tekstu, to do bieżącej linii dodawane jest wcięcie o szerokości ustawionej przez parametrSzerokość wcięć. Jeżeli kursor znajduje się za pierwszym nie-białym znakiem w linii i nie ma wybranego tekstu, dodawane są spacje w liczbie niezbędnej do osiągnięcia kolejnej pozycji tabulacji (jeżeli jest włączona opcja Wstaw spacje zamiast tabulatorów w karcie konfiguracji Ogólne - Edycja) lub pojedynczy znak tabulacji.

#### Uzupełnianie wyrazów

Ogólne
  Uzupełnianie wyrazów włączone

    Jeśli włączone, edytor obliczy liczbę spacji do następnej pozycji tabulacji określonej w szerokości tabulacji i umieści te spacje zamiast znaku &Tab;.

### Otwórz/Zapisz

#### Ogólne

Format pliku
  Kodowanie:

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

  Koniec wiersza:

    Konfiguruje sposób zapisywania znaków końca linii w aktywnym dokumencie. Dostępny jest wybór pomiędzy trybami: &UNIX;, DOS/&Windows; i Macintosh.

  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.

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.

#### Zaawansowane

Plik konfiguracyjny katalogu
  Głębokość szukania pliku konfiguracyjnego:

    Program będzie przeszukiwał każdy katalog wgłąb na określoną liczbę poziomów, w poszukiwaniu pliku konfiguracji &kappname; i załadowania go.

Kopia zapasowa przy zapisie

  Funkcja ta spowoduje, iż &kappname; skopiuje plik oryginalny przed zapisaniem zmian. Nazwa pliku skopiowanego będzie ustalona w sposób następujący: <przedrostek><nazwapliku><przyrostek>. Przedrostek domyślnie nie jest określony, zaś domyślny przyrostek to ~.

  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.

#### Tryby i 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 &kappname; do określonego typu mime. Możliwe jest określenie dowolnej opcji konfiguracyjnej, np. podświetlania, reguł wcięć, kodowania, itp.

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

  Podświetlenie:

    Jeśli chcesz utworzyć nowy typ pliku, ta lista rozwijana pomoże Ci wybrać typ pliku do podświetlania.

  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.

Pobierz pliki podświetlania...

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

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

### Rozszerzenia

Karta Wtyczki zawiera listę wszystkich dostępnych wtyczek. Możesz wybrać te, których chcesz używać. Kliknij przycisk Informacja, aby otworzyć okno O programie danej wtyczki. Gdy wtyczka zostanie wybrana, aktywny stanie się przycisk Konfiguracja, który pozwala skonfigurować daną wtyczkę.

Wybrane wtyczki są dostępne w menu Narzędzia.

## 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 (katepart). Dodatkowe zmienne mogą wprowadzone przez wtyczki, i 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.