<para>&kwrite; to coś więcej niż tylko edytor tekstu dla &kde;. Może być z powodzeniem używany jako edytor programisty, może też być rozważany przynajmniej jako częściowa alternatywa dla bardziej rozbudowanych edytorów. Najlepsze efekty można osiągnąć używając go wraz z przeglądarką &konqueror; w odniesieniu do plików źródłowych w różnych językach programowania. &kwrite; pracuje także bardzo dobrze jako prosty edytor tekstu. Jedną z funkcji &kwrite; jest kolorowanie składni dostosowane do różnych języków programowania, takich jak C/C++, &Java;, Python, Perl, Bash, Modula 2, <acronym>HTML</acronym> i Ada. </para>
<para>&kwrite; jest bardzo łatwy w użyciu. Każdy kto używał kiedykolwiek innego edytora tekstu, nie będzie miał kłopotów z obsługą tego programu. </para>
<para>&kwrite; używa mechanizmu przeciągnij-i-upuść środowiska &kde;. Pliki mogą być przeciągnięte i upuszczone w okno &kwrite; z pulpitu, z przeglądarki &konqueror; lub niektórych zdalnych serwerów &FTP;, otwartych w oknie &konqueror-dopelniacz;. </para>
<para>Pomimo że &kwrite; najczęściej otwierany jest za pomocą menu programów &kde; lub ikony pulpitu, może być także otwierany z linii poleceń w oknie terminala. W tym trybie dostępnych jest kilka użytecznych opcji. </para>
<para>Poprzez określenie ścieżki i nazwy wybranego pliku, użytkownik może spowodować, że program &kwrite; otworzy plik lub utworzy automatycznie plik podczas uruchamiania. Wywołanie takie może wyglądać tak:</para>
<para>Powyżej wspomniana metoda może być także używana przy otwieraniu plików w Internecie (jeśli użytkownik ma dostęp do sieci). Przykład wywołania znajduje się poniżej:</para>
<listitem><para>Wyświetla informacje o wersji &Qt;, &kde;, oraz &kwrite;. Również dostępna przez <userinput><command>kwrite</command> <option>-v</option></userinput>. </para></listitem>
<listitem><para>Opcja powoduje, że &kwrite; odczytuje dokument ze standardowego wejścia. Opcja ta jest podobna do opcji <option>-</option> wykorzystywanej przez wiele programów, i pozwala przekierowywać wyjście dowolnego programu do &kwrite;.</para></listitem>
<para>Wiele skrótów klawiszowych może być skonfigurowanych poprzez opcję Konfiguracja skrótów w menu <link linkend="settings">Ustawienia</link>. Domyślnie &kwrite; obsługuje nastepujące klawisze:</para>
<entry><para>Klawisz przełączania pomiędzy trybem wstawiania i zastępowania (nadpisywania). W trybie wstawiania, edytor doda kolejny znak do tekstu na prawo od kursora. Tryb zastępowania powoduje, że każdy znak na prawo od kursora zostaje zastąpiony znakiem nowo wprowadzonym.</para></entry>
<para>Wyświetla standardowe okno dialogowe <guilabel>Otwórz plik</guilabel>. Pojawi się lista plików, spośród których możesz wybrać plik do otworzenia. Następnie kliknij przycisk <guibutton>Otwórz</guibutton>, aby go otworzyć. Więcej informacji na temat okna dialogowego <guilabel>Otwórz plik</guilabel> znajduje się w Podręczniku użytkownika środowiska &kde;.</para>
<para>Pozycja ta zawiera listę ostatnio zapisywanych dokumentów. Kliknięcie spowoduje otworzenie podmenu z kilkoma ostatnio zapisywanymi plikami. Wybranie któregoś z nich otworzy go w &kwrite; - o ile znajduje się on jeszcze w tym samym miejscu. </para>
<para>Zapisuje bieżący dokument. Jeśli zmiany w tym dokumencie były już wcześniej zapisywane, to program zastąpi plik bez pytania. Jeśli zaś dokument jest zapisywany po raz pierwszy, to pokaże się okno dialogowe <guimenuitem>Zapisz jako ...</guimenuitem> (opisane poniżej). </para>
<para>Zapisuje dokument pozwalając na nadanie mu nowej nazwy. Po wybraniu tej pozycji otwiera się okno dialogowe analogiczne jak opisane wcześniej okno <link linkend="open">Otwórz</link>. </para>
<para>Powoduje ponowne wczytanie zawartości aktualnie edytowanego dokumentu z dysku. Funkcja ta przydaje się, jeżeli inny program lub proces zmienił plik po tym jak użytkownik otworzył go w &kwrite;. </para>
<para>Zamyka aktualnie edytowany dokument. Jeżeli użytkownik dokonał w nim jakichś zmian, to pojawi się okno dialogowe z informacją o konieczności zapisania pliku przed jego zamknięciem przez &kwrite;. </para>
<para>Zamyka okno edycji dokumentu. Nie zostaną zamknięte pozostałe instancje programu &kwrite;, utworzone za pomocą poleceń menu <guimenuitem>Nowy widok</guimenuitem> lub <guimenuitem>Nowe okno</guimenuitem>. </para>
<para>Opcja ta usuwa zaznaczony fragment tekstu i przenosi go do schowka. Schowek stanowi integralną część środowiska &kde;, i umożliwia wymianę danych pomiędzy różnymi programami.</para>
<para>Kopiuje zaznaczony fragment tekstu do schowka, dzięki czemu może on później być wklejony w innym miejscu. Schowek stanowi integralną część środowiska &kde;, i umożliwia wymianę danych pomiędzy różnymi programami.</para>
<para>Wstawia zawartość schowka w aktualnej pozycji kursora. Schowek stanowi integralną część środowiska &kde;, i umożliwia wymianę danych pomiędzy różnymi programami.</para>
<para>Przełącza sposób zaznaczania tekstu. Jeżeli aktywny jest tryb zaznaczania blokowego, użytkownik może zaznaczać pionowe fragmenty tekstu, np.: zaznaczyć kolumny od 5 do 10, w wierszach od 9 do 15. Pasek stanu pokazuje aktualnie aktywny tryb zaznaczania, wyświetlając “NORM” lub “BLK”.</para>
<para>Przełącza pomiędzy trybami nadpisywania i wstawiania tekstu w trakcie pisania. Jeżeli aktywny jest tryb wstawiania, nowe znaki są wstawiane w miejscu kursora. Jeżeli aktywny jest tryb nadpisywania, nowe znaki wprowadzane są w miejscu znaków znajdujących się po prawej stronie kursora. Pasek stanu wyświetla aktualny tryb nadpisywania wyświetlając odpowiednio: "WST" lub "NAD".</para>
<para>Otwiera okno wyszukiwania, w którym użytkownik może wprowadzić <guilabel>szukany tekst</guilabel>. Poszukiwany fragment wprowadza się w małym polu tekstowym, stanowiącym jednocześnie pole listy rozwijanej, wyświetlającej poszukiwane poprzednio fragmenty. Okno pozwala na określenie opcji i parametrów dla operacji wyszukiwania, które czynią je bardziej efektywnym. Zaznaczenie opcji <guilabel>Uwzględniaj wielkość liter</guilabel> ograniczy wyniki wyszukiwania do tekstu dokładnie odpowiadającego wielkości liter fragmentu poszukiwanego (małe lub wielkie litery). <guilabel>Znajdź wstecz</guilabel> określa kierunek szukania od pozycji kursora w kierunku początku dokumentu. <guilabel>Zaznaczony tekst</guilabel> ogranicza pole poszukiwań do zaznaczonego fragmentu tekstu. Wyszukiwanie <guilabel>Całych słów</guilabel> zapobiega znalezieniu poszukiwanego tekstu będącego fragmentem dłuższych wyrazów. Opcja <guilabel>Od kursora</guilabel> spowoduje rozpoczęcie wyszukiwania od aktualnej pozycji kursora w dokumencie. Jeżeli nie jest zaznaczona, to poszukiwanie rozpoczyna się od początku dokumentu.</para>
<para>Polecenie otwiera okno dialogowe zastępowania tekstu. Jest ono bardzo podobne do opisanego wcześniej okna wyszukiwania. Dodatkowym parametrem widocznym w oknie, jest pole/lista rozwijana <guilabel>Zastąp przez:</guilabel>. W oknie użytkownik wprowadza zarówno tekst do znalezienia, jak też tekst, który ma zastąpić wyszukany fragment. Dodatkowa opcja <guilabel>Pytaj przy zamianie</guilabel> powoduje, iż &kwrite; zapyta się użytkownika o jego decyzję przed dokonaniem każdej zamiany. </para>
<para>Opcja ta, otwiera okno idź do wiersza, w którym użytkownik określa numer wiersza, do którego chce przenieść kursor. Numer może być wprowadzony bezpośrednio do pola tekstowego, można użyć strzałek w górę lub w dół znajdujących się obok tego pola, lub też ustawić żądaną linię za pomocą myszki i suwaka. </para>
<menuchoice><shortcut><keycombo action="simul"><keycap>F7</keycap></keycombo></shortcut> <guimenu>Widok</guimenu> <guimenuitem>Przełącz do linii poleceń</guimenuitem> </menuchoice>
<para>Wyświetla linię poleceń składnika "Katepart" w dolnej części okna. Wpisanie w linii poleceni "help" wyświetli pomoc, natomiast "help list" wyświetli listę dostępnych poleceń.</para>
<para>Wybiera sposób wyświetlania znaczników dynamicznego zawijania wyrazów. Opcja staje się dostępna jeżeli <guilabel>Dynamiczne zawijanie wyrazów</guilabel> jest włączone.</para>
<para>Włączenie tej opcji, powoduje wyświetlenie pionowej linii w kolumnie tekstu, w której nastąpiłoby przeniesienie do następnej linii. Numer kolumny zawijania określony jest w menu <menuchoice> <guimenu>Ustawienia</guimenu> <guimenuitem>Konfiguracja edytora...</guimenuitem></menuchoice> w karcie: Edycja. Znacznik zawijania wyrazów widoczny jest jedynie w przypadku użycia czcionki o stałej szerokości.</para>
<listitem><para>Rozwija wszystkie szczytowe poziomy kodu w dokumencie.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap> <keycap>-</keycap></keycombo></shortcut> <guimenuitem>Zwiń jeden poziom lokalny</guimenuitem></menuchoice>
<listitem><para>Zwija jeden poziom kodu znajdujący się najbliżej pozycji kursora.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap> <keycap>+</keycap></keycombo></shortcut> <guimenuitem>Rozwiń jeden poziom lokalny</guimenuitem></menuchoice>
<para>Ustawia bądź usuwa zakładkę w wierszu aktywnego dokumentu, w którym znajduje się kursor. Jeżeli zakładka już jest to zostaje usunięta, a jeśli nie ma to zostaje dodana. </para>
<listitem><para>Przesuwa kursor do pierwszej zakładki znajdującej się przed aktualną pozycją kursora. Ta pozycja menu zawiera numer wiersza z zakładką oraz krótki fragment tekstu. Niniejsza opcja jest dostępna jedynie wtedy, gdy istnieją zakładki poprzedzające aktualną pozycję kursora.</para></listitem>
<listitem><para>Przesuwa kursor do pierwszej zakładki znajdującej się poniżej aktualnej pozycji kursora. Ta pozycja menu zawiera numer wiersza z zakładką oraz krótki fragment tekstu. Ta opcja jest dostępna jedynie wtedy, gdy istnieją zakładki znajdujące się poniżej aktualnej pozycji kursora.</para></listitem>
<para>Opcja pozwala na wybranie typu pliku dla aktywnego dokumentu. Zmiana tutaj dokonana zastępuje ustawienia globalne dla typu pliku, znajdujące się w menu <menuchoice> <guimenu>Ustawienia</guimenu> <guimenuitem>Konfiguracja edytora...</guimenuitem></menuchoice> w karcie Typy plików, ale wyłącznie dla otwartego dokumentu.</para>
<para>Pozwala na wybór reguły podświetlania tekstu. Zmiana ustawienia zastępuje globalne ustawienie zdefiniowane w menu <menuchoice> <guimenu>Ustawienia</guimenu> <guimenuitem>Konfiguracja edytora...</guimenuitem></menuchoice> w zakładce: Podświetlenie.</para>
<para>Pozwala na wybór sposobu wstawiania automatycznych wcięć. Zmiana ustawienia zastępuje globalne ustawienie zdefiniowane w menu <menuchoice> <guimenu>Ustawienia</guimenu> <guimenuitem>Konfiguracja edytora...</guimenuitem></menuchoice> w zakładce: Wcięcia.</para>
<para>Dzięki tej opcji możliwa jest zmiana ustawienia kodowania znaków zdefiniowanego w menu <menuchoice> <guimenu>Ustawienia</guimenu> <guimenuitem>Konfiguracja edytora...</guimenuitem></menuchoice> w zakładce: Otwórz/Zapisz. Dokonana zmiana dotyczyć będzie tylko aktualnie edytowanego dokumentu.</para>
<para>Pozwala na zmianę stosowanych przy zapisywaniu pliku kodów końca wiersza. Zmiana ustawienia napisuje globalne ustawienie zdefiniowane w menu <menuchoice> <guimenu>Ustawienia</guimenu> <guimenuitem>Konfiguracja edytora...</guimenuitem></menuchoice> w zakładce: Otwórz/Zapisz.</para>
<listitem><para><action>Uruchamia program sprawdzania pisowni, który pomaga znaleźć i poprawić błędy ortograficzne</action> Kliknięcie tej pozycji menu rozpocznie sprawdzanie i otworzy okno, za pomocą którego można ten proces kontrolować. Dostępne są cztery pola rozmieszczone w pionie w środkowej części okna, opisane następująco:</para>
<listitem><para>Prezentowane jest słowo, na którym zatrzymało się sprawdzanie pisowni. Następuje to zawsze, gdy program sprawdzający napotka słowo, którego nie ma w swoim słowniku - pliku zawierającego listę poprawnych wyrazów, z którymi porównywany jest każdy wyraz w dokumencie.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Zastąp przez:</guilabel></term>
<listitem><para>Jeżeli program sprawdzający wyszuka w słowniku słowa podobne do wyświetlonego wyżej, to tutaj pojawi się pierwsze z nich. Użytkownik może zaakceptować sugestię, wpisać w tym polu własną wersję skorygowanego słowa, lub wybrać inną sugestię z listy podpowiedzi znajdującej się w następnym polu.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Podpowiedzi:</guilabel></term>
<listitem><para>Program sprawdzający wyświetli tutaj listę słów najbardziej zbliżonych do wyrazu uznanego za błędny. Kliknięcie na pozycji z listy podpowiedzi spowoduje przeniesienie sugerowanego wyrazu do pola <guilabel>Zastąp przez:</guilabel>, znajdującego się powyżej.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Język:</guilabel></term>
<listitem><para>Jeżeli w systemie dostępne są słowniki dla różnych języków, można tutaj wybrać słownik/język, który będzie wykorzystywany do sprawdzania.</para></listitem>
<para>Po prawej stronie okna dialogowego znajduje się 5 przycisków, pozwalających użytkownikowi kontrolować proces sprawdzania i korygowania pisowni. Są to przyciski:</para>
<term><guibutton>Dodaj do słownika</guibutton></term>
<listitem><para>Naciśnięcie przycisku spowoduje dodanie <guilabel>nieznanego słowa</guilabel> do słownika.. Dzięki temu, podczas kolejnego sprawdzania, słowo to zostanie uznane za poprawne.</para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Zastąp</guibutton></term>
<listitem><para>Ten przycisk zamienia znalezione w tekście nieznane słowo, na słowo widoczne w polu <guilabel>Zastąp przez:</guilabel>.</para></listitem>
<listitem><para>Przycisk ten zamienia aktualnie widoczne <guilabel>Nieznane słowo</guilabel> oraz wszystkie inne jego wystąpienia w dokumencie, na słowo widoczne w polu <guilabel>Zastąp przez</guilabel>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Ignoruj</guibutton></term>
<listitem><para>Naciśnięcie przycisku spowoduje zignorowanie faktu znalezienia nieznanego słowa i kontynuację procesu sprawdzania tekstu.</para></listitem>
<listitem><para>Naciśnięcie przycisku spowoduje zignorowanie faktu znalezienia <guilabel>nieznanego słowa</guilabel> i kontynuację procesu sprawdzania tekstu. Zignorowane będą również wszystkie następne wystąpienia tego słowa w tekście.</para> <note><para>Ignoruj wszystkie dotyczy tylko aktualnego wywołania programu pisowni. Jeżeli sprawdzanie zostanie znowu później uruchomione, to program ponownie zatrzyma się na tym słowie.</para></note></listitem>
<listitem><para>Przycisk ten anuluje sprawdzanie pisowni, wszystkie zmiany (operacje zastąpienia słów) są cofane i następuje powrót do aktualnego dokumentu.</para></listitem>
<para>Powoduje zwiększenie wcięcia wybranego zdania o jeden krok. Wielkość kroku zależy od ustawienia parametrów dla <link linkend="pref-indent">reguł wcięć</link>.</para>
<para>Zmniejsza wcięcie danego zdania o jeden krok. Wielkość kroku zależy od ustawienia parametrów dla <link linkend="pref-indent">reguł wcięć</link>.</para>
<para>Poprawia wcięcia dla zaznaczonego fragmentu tekstu lub dla linii, w której znajduje się kursor. Poprawienie wcięć pozwala na zachowanie wybranego trybu wcięć dla danego fragmentu tekstu.</para>
<listitem><para>Zmienia zaznaczony fragment lub bieżącą linię tekstu na komentarz, stosując reguły komentowania zgodne z wybranymi zasadami podświetlania kodu (HTML, C, itp.).</para>
<listitem><para>Usuwa komentarze z zaznaczonego fragmentu lub bieżącej linię tekstu. Komentarze rozpoznawane są zgodne z wybranymi zasadami podświetlania kodu (HTML, C, itp.).</para></listitem>
<listitem><para>Dokonuje połączenia wierszy w wybranym fragmencie, lub wiersza bieżącego z wierszem znajdującym się poniżej, używając spacji jako znaku oddzielającego. Spacje poprzedzające i znajdujące się na końcach łączonych linii są usuwane.</para></listitem>
<listitem><para>Powoduje zastosowanie reguł statycznego zawijania tekstu dla całego dokumentu. Oznacza, to że tekst będzie przenoszony do nowej linii automatycznie, jeżeli bieżąca linia przekroczy ilość znaków zdefiniowaną w karcie: Edycja w menu <menuchoice> <guimenu>Ustawienia</guimenu><guimenuitem>Konfiguracja edytora...</guimenuitem></menuchoice></para></listitem>
<para>Wyświetla lub ukrywa wąski pasek na dole okna edytora, zawierający informacje o stanie poszczególnych funkcji i informacje o edytowanym dokumencie.</para>
<para>Powoduje iż w pasku tytułowym programu &kwrite; wyświetlona zostanie pełna ścieżka w systemie dla aktualnie edytowanego pliku. Ponowne wybranie tej opcji, wyłącza wyświetlanie ścieżki do pliku.</para>
<para>Opcja ta otwiera okno dialogowe zawierające wiele różnych <link linkend="pref-dialog">parametrów</link> konfiguracyjnych &kwrite;, które pozwalają na dostosowanie zachowania programu do specyficznych potrzeb użytkownika. </para>
<para>Pozwala na wybranie używanego przez &kwrite; komponentu edycyjnego. Dostępne są następujące opcje: <guilabel>Systemowy</guilabel>, <guilabel>Osadzony zaawansowany edytor tekstu</guilabel> lub <guilabel>Oparty na &Qt; edytor tekstu</guilabel> (dostępny tylko wtedy, gdy zainstalowano pakiet KDevelop). Wybranie pozycji <guilabel>Systemowy</guilabel> powoduje, iż &kwrite; stosuje ustawienia dla edytora określone w centrum sterowania &kde;. </para>
<para>To polecenie otwiera okno dialogowe, w którym użytkownik może zmienić <link linkend="keybindings">skróty klawiszowe</link> stosowane przez &kwrite;. Okno zawiera listę poleceń (czynności), dla których możliwe jest przypisanie skrótu klawiszowego, a poniżej znajdują się 3 pola: Brak, Domyślny, Własny. Możesz wybrać tylko jedno z nich. Wybranie opcji "Własny" uaktywnia przycisk wyświetlający aktualnie przypisany skrót bądź informacje o jego braku, naciśnięcie go pozwala na zmianę aktualnie zdefiniowanej kombinacji klawiszy. Na przykład wybierając polecenie "Informacje o &kde;" z listy, można nacisnąć kombinację klawiszy &Ctrl; oraz <keycap>Alt</keycap>, i nacisnąć klawisz <keycap>K</keycap>. Spowoduje to, iż każdorazowe użycie kombinacji klawiszy &Ctrl;, <keycap>Alt</keycap> oraz <keycap>K</keycap> (tylko w trakcie korzystania z &kwrite;) spowoduje wyświetlenie okna dialogowe Informacje o &kde;. </para>
<listitem><para>Polecenie otwiera okno dialogowe pozwalające na zmianę zawartości pasków narzędzi. Po lewej stronie okna widać listę dostępnych poleceń, które można umieścić na pasku, z prawej zaś, polecenia aktualnie opcje aktualnie umieszczone na pasku. Zestaw czterech strzałek, pozwala manipulację zawartością obu list. Naciśnięcie strzałki w prawo przenosi pozycję z lewego listy do prawej (tzn. dodaje do paska narzędzi). Lewa strzałka usuwa wybrane zdarzenia z paska narzędzi. Górna i dolna strzałka zmienia pozycję wybranego zdarzenia w prawym oknie, co zmienia pozycję ikony na pasku narzędzi.</para> </listitem>
<para>Wybranie z menu <menuchoice><guimenu>Ustawienia</guimenu><guimenuitem>Konfiguracja edytora</guimenuitem></menuchoice> otwiera okno dialogowe konfiguracji edytora. Jest ono wykorzystywane do modyfikacji wielu różnych parametrów zachowania programu &kwrite;. Dostępne parametry są pogrupowane w kilka kategorii, które użytkownik może wybrać z pionowej listy znajdującej się po lewej stronie okna. W dolnej części okna znajdują się przyciski pozwalające kontrolować proces konfigurowania programu. </para>
<para>Naciśnięcie przycisku <guilabel>Pomoc</guilabel> uruchamia system pomocy środowiska &kde;, przycisk <guibutton>OK</guibutton> zatwierdza dokonane ustawienia i zamyka okno, zaś <guibutton>Anuluj</guibutton> powoduje zamknięcie okna bez zapisywania dokonanych zmian. Poniżej opisane następujące kategorie ustawień: <guilabel>Wygląd</guilabel>, <guilabel>Kolory i czcionki</guilabel>, <guilabel>Kursor i zaznaczanie</guilabel>, <guilabel>Edycja</guilabel>, <guilabel>Wcięcia</guilabel>, <guilabel>Otwórz/Zapisz</guilabel>, <guilabel>Podświetlanie</guilabel>, <guilabel>Typy plików</guilabel>, <guilabel>Skróty</guilabel> i <guilabel>Wtyczki</guilabel>. </para>
<listitem><para>Ustawia sposób wyświetlania znaczników dynamicznego zawijania wyrazów. </para></listitem></varlistentry>
<varlistentry>
<term><guilabel>Wyrównaj pionowo dynamicznie zawijane linie do głębokości wcięć: </guilabel></term>
<listitem><para>Włącza automatyczne wcinanie dynamicznie zawiniętych linii do aktualnego poziomu wcięcia tekstu. Zwiększa to czytelność kodu.</para><para>Dodatkowo, użytkownik może ustawić procent maksymalnej szerokości ekranu, przy której dynamicznie zawijane wiersze nie będą wyrównywane w pionie. Na przykład, ustawienie parametru na 50%, powoduje że poziom wcięcia głębszy niż 50% szerokości ekranu, nie będzie automatycznie wyrównywany w pionie dla dynamicznie zawijanych linii.</para></listitem>
<listitem><para>Włączenie tej opcji, spowoduje pokazanie w aktualnie edytowanym dokumencie znaczników zwijania kodu (jeżeli opcja zwijania jest włączona).</para></listitem>
<listitem><para>Włączenie tej opcji włącza wyświetlanie paska ikon po prawej stronie okna edycyji. Na pasku ikon widoczne są m.in. znaczniki zakładek, czy znaczniki dynamicznego zawijania wyrazów.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Pokaż numery linii </guilabel></term>
<listitem><para>Włącza pokazywanie numerów wierszy po lewej stronie okna edycji.</para></listitem>
<listitem><para>Zaznaczenie opcji powoduje wyświetlenie znaczników na pionowym pasku przewijania. Znaczniki te mogą na przykład wskazywać na miejsce wstawienia zakładki w tekście.</para></listitem>
<term><guilabel>Pokaż linie wcięć </guilabel></term>
<listitem><para>Zaznaczenie tej opcji spowoduje uwidocznienie w oknie edycyjnym linii pomagających zidentyfikować poszczególne poziomy wcięcia tekstu.</para></listitem>
<para>Ta część okna dialogowego pozwala na konfigurację ustawień czcionek i kolorów dla poszczególnych schematów kolorów oraz zdefiniowanie nowych lub usunięcie istniejących schematów. Każdy schemat zawiera ustawienia dotyczące kolorów i czcionek, oraz style tekstu normalnego i podświetlania. </para>
<para>Program &kwrite; 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 <guilabel>Schemat</guilabel>.</para>
<listitem><para>Pozwala określić kolor dla bieżącego wiersza. Jeżeli będzie on troszkę inny od koloru tła, pozwoli to skupić uwagę na aktualnie edytowanej linii tekstu. </para></listitem>
<listitem><para>Rozwijana lista wyboru, pozwalająca określić kolory dla różnych rodzajów zakładek. Kolor jest mieszany z kolorem tła dla 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.</para></listitem>
<term><guilabel>Tło lewej krawędzi</guilabel></term>
<listitem><para>Kolor wykorzystywany dla tła paska znaczników, numerów linii i znacznika zwijania po lewej stronie edytora (jeżeli jest widoczny) </para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Numery linii</guilabel></term>
<listitem><para>Kolor ten wykorzystywany jest dla numerów linii wyświetlonych po lewej stronie okna edycyjnego (jeżeli są widoczne).</para></listitem>
<listitem><para>Kolor służący do wyświetlania wzoru po lewej stronie dynamicznie zawiniętych linii, które zostały automatycznie wcięte i wyrównane pionowo, jak również dla wyświetlania znacznika statycznego zawijania wyrazów.</para></listitem>
<para>Możesz ustawić czcionkę dla konfigurowanego schematu. Dostępna jest lista wszystkich czcionek zainstalowanych w systemie oraz możliwość ustawienia stylu oraz rozmiaru. W dolnej części wyświetlany jest przykładowy tekst z użyciem wybranej czcionki, aby pokazać efekt dokonanego wyboru. </para>
<para>Style normalnego tekstu stanowią domyślną wartość, wykorzystywaną dla określania kolorów dla innych styli 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.</para>
<para>Pozycja na liście stylów wyświetlania pokazana jest z użyciem skonfigurowanych kolorów i wyglądu czcionki, co pozwala na natychmiastowy podgląd stylu. </para>
<para>Każdy styl pozwala na wybór wspólnych atrybutów dotyczących zarówno koloru tła jak i koloru tekstu. Aby usunąć kolor tła, należy nacisnąć prawym przyciskiem i skorzystać z menu kontekstowego.</para>
<para>Ta karta pozwala na ustawienie stylów tekstu, używanych przez określoną regułę podświetlania. Program automatycznie wybiera regułę związaną z aktualnie edytowanym dokumentem. Aby wybrać inną regułę, należy skorzystać z listy rozwijanej <guilabel>Podświetlenie</guilabel>, widocznej w górnej części okna. </para>
<para>Pozycja na liście stylów wyświetlania pokazana jest z użyciem skonfigurowanych kolorów i wyglądu czcionki, co pozwala na natychmiastowy podgląd stylu. </para>
<para>Każdy styl pozwala na wybór wspólnych atrybutów dotyczących zarówno koloru tła jak i koloru tekstu. Aby usunąć kolor tła, należy nacisnąć prawym przyciskiem i skorzystać z menu kontekstowego. Dodatkowo, widoczna jest informacja, czy aktualne ustawienie jest zgodne z ustawieniem domyślnym oraz ewentualnie zmienić je na domyślne.</para>
<para>Reguły podświetlania mogą zawierać inne reguły podświetlania, reprezentowane jako grupy na liście styli. Na przykład większość reguł podświetlania dołącza pozycję "Alert", a formaty podświetlania kodu źródłowego dołączają do siebie format Doxygen. Zmiana kolorów w tych grupach dotyczy tylko styli używanych w edytowanej regule podświetlania. </para>
<para>Wybranie pozycji, powoduje iż naciśnięcie klawisza "Home" przesuwa kursor na początek tekstu w wierszu, pomijając ewentualne znaki wcięcia.</para>
<para>Podczas przesuwania kursora za pomocą <emphasis role="bold">lewego</emphasis> i <emphasis role="bold">prawego</emphasis> klawisza strzałki, będzie on przechodził na początek poprzedniej/następnej linii po osiągnięciu początku/końca wiersza, podobnie jak w innych edytorach.</para><para>Kiedy wybierzemy tę opcję, przesuwanie kursora klawiszami strzałek na koniec linii (do prawej) powoduje przeniesienie go w dół na początek następnej. Podobnie, kiedy kursor jest przesunięty za początek linii (do lewej) powoduje to przeniesienie go na koniec linii powyżej. Kiedy opcja ta nie jest wybrana przesunięcie kursora w prawo powoduje kontynuację pracy w tej samej linii, natomiast przesunięcie w lewo od początku linii jest niemożliwe, co może być użyteczne w pracy programistów.</para>
<para>Opcja ta zmienia zachowanie kursora, w przypadku naciśnięcia klawiszy <keycap>Page Up</keycap> lub <keycap>Page Down</keycap>. kiedy opcja nie jest zaznaczona, kursor zachowuje względną pozycję w widocznym w oknie &kwrite; dokumencie. Jeżeli więc kursor znajduje się w środku okna, to po naciśnięciu tych klawiszy, dalej w środku okna będzie (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.</para>
<para>Zaznaczenie tej opcji powoduje, iż po naciśnięciu klawisza <keycap>TAB</keycap> edytor będzie wstawiał określoną liczbę spacji, w zależności od pozycji, oraz ustawienia <option>Szerokość tabulacji i wcięcia</option>.</para>
<para>Włączenie opcji, spowoduje wyświetlanie przez &kwrite; małej kropki dla oznaczenia znaków tabulacji.</para>
<note><para>Opcja powoduje również wyświetlanie kropki dla spacji poprzedzających w wierszu, zachowanie to zostanie poprawione w przyszłych wersjach &kwrite;.</para></note>
<term id="pref-tab-width">Szerokość tabulacji i wcięcia</term> <listitem><para>Jeśli opcja <link linkend="pref-word-wrap"><guilabel>Zamień tabulację na spacje</guilabel></link> jest włączona, to pole określa liczbę spacji, na które edytor automatycznie zmieni każdy znak tabulacji.</para></listitem>
<listitem><para>Zawijania wyrazów to funkcja, powodująca iż edytor automatycznie zaczyna nową linię tekstu i przenosi (zawija) kursor na jej początek. &kwrite; automatycznie rozpocznie nową linię tekstu, jeżeli ilość znaków w bieżącej linii osiągnie wielkość zdefiniowaną w opcji <link linkend="pref-wrap-words-at">Zawijaj wyrazy na:</link>.</para>
<para>Włączenie tej opcji, powoduje wyświetlenie pionowej linii w kolumnie tekstu, w której nastąpiłoby przeniesienie do następnej linii. Numer kolumny zawijania określony jest w menu <menuchoice> <guimenu>Ustawienia</guimenu> <guimenuitem>Konfiguracja edytora...</guimenuitem></menuchoice> w karcie: Edycja. Znacznik zawijania wyrazów widoczny jest jedynie w przypadku użycia czcionki o stałej szerokości.</para>
<para>Jeśli opcja <link linkend="pref-word-wrap">Zawijanie wyrazów</link> jest wybrana, to pole określa liczbę znaków w linii, przy której edytor automatycznie rozpocznie nową linię.</para>
<term><guilabel>Usuń spacje na końcu wiersza</guilabel></term>
<listitem><para>Włączenie tej opcji powoduje, że &kwrite; automatycznie usunie dodatkowe spacje na końcu linii tekstu.</para></listitem> </varlistentry>
<varlistentry>
<term><guilabel>Automatyczne nawiasy</guilabel></term> <listitem><para>Włączenie tej opcji powoduje, że po wpisaniu lewego nawiasu ([, (, or {) &kwrite; automatycznie doda prawy nawias (odpowiednio: }, ), or ]) po prawej stronie kursora.</para></listitem>
</varlistentry>
<varlistentry> <term>Liczba operacji <link linkend="undo">cofnięć</link>:</term>
<listitem><para>Ta opcja określa liczbę możliwych w programie &kwrite; operacji wycofania pisania lub działań. Im większa liczba określona w tej opcji, tym więcej pamięci program przeznaczy na przechowywanie historii zdarzeń. Ustawienie opcji na 10, spowoduje iż użytkownik będzie mógł wycofać 10 operacji wstecz, naciskając 10-cio krotnie klawisz <guibutton>Cofnij</guibutton>.</para></listitem> </varlistentry>
<varlistentry> <term>Sprytne wyszukiwanie tekstu od:</term>
<listitem><para>Pozwala na określenie pochodzenia tekstu, który &kwrite; wstawi automatycznie w oknie dialogowym wyszukiwania. Dostępne są następujące opcje do wyboru:<itemizedlist> <listitem><para><emphasis role="bold">Nigdzie:</emphasis> Żaden tekst nie zostanie wstawiony.</para></listitem> <listitem><para><emphasis role="bold">Tylko zaznaczenie:</emphasis> Używa zaznaczonego fragmentu jako tekstu wyszukiwanego. </para></listitem> <listitem><para><emphasis role="bold">Zaznaczenie, potem bieżące słowo:</emphasis> Używa zaznaczonego fragmentu (jeżeli dostępny), w przeciwnym wypadku wprowadza bieżące słowo. </para></listitem> <listitem><para><emphasis role="bold">Tylko bieżące słowo:</emphasis> Używa słowa, na którym aktualnie znajduje się kursor. </para></listitem> <listitem><para><emphasis role="bold">Bieżące słowo, potem zaznaczenie:</emphasis> Używa bieżącego słowa, a jeśli brak to zaznaczenia. </para></listitem> </itemizedlist> Dla wszystkich powyższych trybów, jeżeli program nie może ustalić poszukiwanego tekstu, to w oknie dialogowym wyszukiwania pojawi się tekst poprzednio wyszukiwany (zachowanie domyślne). </para></listitem>
<para>Pozwala na określenie domyślnie stosowanej reguły wcięć. Zalecane jest ustawienie tutaj <userinput>Brak</userinput> lub <userinput>Normalny</userinput> i ustawienie reguł wcięć w konfiguracji typów plików, dla takich formatów jak kod w C/C++ czy &XML;.</para>
<para>Automatycznie wstawia otwierający znak Doxygen "*" w czasie pisania w komentarzu w formacie Doxygena. Opcja jest aktywna tylko jeśli ma znaczenie.</para>
<listitem><para>Zaznaczenie tej opcji powoduje, że program nie będzie usuwał wcięć w zaznaczonym fragmencie tekstu, kiedy najmniej wcięta linia przestanie mieć wcięcie. Może to być przydatne, w przypadku usuwania wcięć w dużych fragmentach kodu programu. </para></listitem>
<para>Konfiguruje sposób zapisywania znaków końca linii w aktywnym dokumencie. Dostępny jest wybór pomiędzy trybami: &UNIX;, DOS/&Windows; i Macintosh.</para>
<para>Włączenie tej opcji, powoduje iż edytor automatycznie będzie wykrywał sposób kodowania końca linii. Pierwszy znaleziony w dokumencie koniec linii będzie wykorzystany dla całego dokumentu.</para>
<para>Program załaduje określoną w tej pozycji liczbę bloków (po około 2048 linii każdy) tekstu do pamięci. Jeżeli rozmiar pliku jest większy od ustawionej tu wartości, pozostały bloki zostaną zapisane na dysk i załadowane później w razie potrzeby.</para>
<para>Może to spowodować opóźnienia w trakcie poruszania się po dokumencie, większa liczba bloków zwiększa szybkość kosztem zużycia pamięci. </para><para>W większości przypadków, wybranie największej możliwej wartości jest ustawieniem optymalnym. Należy ją zmniejszyć w przypadku problemów z ilością pamięci.</para>
<para>Program będzie przeszukiwał każdy katalog wgłąb na określoną liczbę poziomów, w poszukiwaniu pliku konfiguracji &kwrite; i załadowania go.</para>
<term><guilabel>Kopia zapasowa przy zapisie</guilabel></term>
<listitem><para>Funkcja ta spowoduje, iż &kwrite; 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 <emphasis role="bold">~</emphasis>. </para>
<para>Poniższe ustawienia stosowane są do konfiguracji reguł podświetlania dla każdego rodzaju dokumentu. Zmiany dokonane w tej karcie dotyczą jedynie konkretnego wybranego typu dokumentu.</para>
<listitem><para>Pozwala na określenie rozszerzeń nazw plików związanych z daną reguła podświetlania, co pozwala na automatyczny wybór reguły w momencie otwierania pliku.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Typy MIME:</guilabel></term>
<listitem><para>Naciśnięcie przycisku asystenta otwiera okno dialogowe, co pozwala wybrać typ MIME z listy dostępnych typów.</para><para>Pole <emphasis role="bold">Rozszerzenia nazw plików</emphasis> zostanie automatycznie uzupełnione, zgodnie z wybranymi typami mime.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Priorytet:</guilabel></term>
<listitem><para>Ustawia priorytet dla danej reguły podświetlania.</para></listitem>
<para>Ta karta pozwala na modyfikację konfiguracji domyślnej dla dokumentu, w zależności od typu MIME pliku. Kiedy program wczyta dokument, przeszuka maski filtra plików lub listę typów MIME, w poszukiwaniu zdefiniowanego rodzaju pliku, a następnie zmieni konfigurację zgodnie z prowadzonymi zmiennymi. Jeżeli dopasowane zostanie kilka typów, to wybierany jest ten o najwyższym priorytecie. </para>
<listitem><para>Typ pliku, dla którego ustawiono najwyższy priorytet, wyświetla się na pierwszym miejscu rozwijanej listy. Jeżeli istnieje więcej typów, to również są one wyświetlane.</para>
<listitem><para>Pozwala na stworzenie nowego typu pliku. Po naciśnięciu przycisku, pola poniżej zostają wyczyszczone, i można w nich wprowadzić ustawienia związane z nowo tworzonym typem pliku.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Usuń</guilabel></term>
<listitem><para>Aby usunąć zdefiniowany typ pliku, należy wybrać go korzystając z przycisku listy rozwijanej, a następnie nacisnąć przycisk Usuń.</para></listitem>
<term><guilabel>Właściwości wybranego typu pliku</guilabel></term>
<listitem><para>Typ pliku, dla którego ustawiono najwyższy priorytet, wyświetla się na pierwszym miejscu rozwijanej listy. Jeżeli istnieje więcej typów, to również są one wyświetlane.</para>
<listitem><para>Nazwa typu pliku, pojawia się jako pozycja w menu <menuchoice><guimenu>Narzędzia</guimenu><guimenuitem>Typy plików</guimenuitem> </menuchoice></para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Sekcja:</guilabel></term>
<listitem><para>Nazwa sekcji, pozwala na właściwą organizację wyświetlania typów plików w menu. Jest też używana w menu <menuchoice> <guimenu>Narzędzia</guimenu> <guimenuitem>Typy plików</guimenuitem> </menuchoice>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Zmienne:</guilabel></term>
<listitem><para>Pole pozwala na dostosowanie konfiguracji &kwrite; do określonego typu mime. Możliwe jest określenie dowolnej opcji konfiguracyjnej, np. podświetlania, reguł wcięć, kodowania, itp.</para><para>Pełna lista możliwych zmiennych dostępna jest w podręczniku.</para></listitem>
<listitem><para>Maska filtra plików, pozwala otwierać pliki z użyciem tylko nazwy. Typowa maska wykorzystuje gwiazdkę oraz rozszerzenie nazwy, przykładowo: <filename>*.txt; *.text</filename>. W polu wprowadza się listę masek, rozdzieloną średnikami.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Typy MIME:</guilabel></term>
<listitem><para>Naciśnięcie przycisku asystenta wyświetla okno dialogowe pozwalające na łatwy wybór typu MIME.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Priorytet:</guilabel></term>
<listitem><para>Konfiguruje priorytet danego typu pliku. Jeżeli do danego pliku, można dopasować kilka typów, to wybierany jest ten o najwyższym priorytecie.</para></listitem>
<para>Możliwa jest tu zmiana konfiguracji skrótów klawiszowych. Wybranie polecenia i zaznaczenie pola opcji: <guilabel>Własny</guilabel> powoduje otwarcie okna, w którym użytkownik definiuje pożądaną kombinację klawiszy.</para>
<para>Pole wyszukiwania pozwala na szybkie odszukanie polecenia i sprawdzenie jego skrótu klawiszowego.</para>
<para>W tej karcie pojawi się lista wszystkich dostępnych wtyczek. Można je w tym oknie włączyć. Po włączeniu wtyczki przycisk <guibutton>Konfiguruj</guibutton> staje się aktywny, dzięki czemu można skonfigurować wybraną wtyczkę.</para>
