<chapter id="kate-part">
<chapterinfo>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
<othercredit role="translator"
><firstname
>Suse</firstname
><surname
>Polska</surname
><affiliation
><address
><email
>suse@suse.pl</email
></address
></affiliation
><contrib
>Polskie tłumaczenie</contrib
></othercredit
> <othercredit role="translator"
><firstname
>Krzysztof</firstname
><surname
>Woźniak</surname
><affiliation
><address
><email
>wozniakk@ceti.pl</email
></address
></affiliation
><contrib
>Polskie tłumaczenie</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>
<title
>Praca z edytorem &kate;</title>

<sect1 id="kate-part-overview">

<title
>Wstęp</title>

<para
>Edytor &kate; jest częścią środowiska &kde; wykorzystywaną także przez inne programy takie jak np.: &kwrite; lub &konqueror; do wyświetlania plików lokalnych jak i znajdujących się w sieci.</para>

<para
>Edytor składa się z następujących elementów:</para>

<variablelist>

<varlistentry>
<term
>Obszar edycji</term>
<listitem
><para
>Tutaj jest wyświetlana treść dokumentu.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Paski przewijania</term>
<listitem>
<para
>Paski przewijania pozwalają na przesuwanie widocznego obszaru dokumentu. Przesuwanie dokumentu za pomocą pasków przewijania nie powoduje zmiany bieżącej pozycji kursora.</para>
<para
>Paski przewijania są wyświetlane i ukrywane w zależności od potrzeb.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Pasek ikon</term>
<listitem>
<para
>Pasek ikon jest wąskim obszarem po lewej stronie obszaru edycji wyświetlającym różnego rodzaju ikony obok zaznaczonych wierszy tekstu.</para>
<para
>Klikając lewym przyciskiem myszy w pasku ikon można dodać lub usunąć <link linkend="kate-part-bookmarks"
>zakładkę</link
> dla wybranego wiersza dokumentu.</para>
<para
>Przełączenie wyświetlania paska ikon odbywa się poprzez menu: <menuchoice
><guimenu
>Widok</guimenu
> <guimenuitem
>Pokaż pasek ikon</guimenuitem
></menuchoice
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Pasek numerów wierszy</term>
<listitem>
<para
>Pasek numerów wierszy wyświetla numery wszystkich widocznych wierszy dokumentu.</para>
<para
>Przełączanie wyświetlania paska numerów wierszy odbywa się poprzez menu: <menuchoice
><guimenu
>Widok</guimenu
> <guimenuitem
>Pokaż numery wierszy</guimenuitem
></menuchoice
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Pasek znaczników zwijania</term>
<listitem>
<para
>Pozwala użytkownikowi na zwijanie lub rozwijanie fragmentów kodu programu. Rozpoznawanie fragmentu podlegającego operacji zwinięcia/rozwinięcia odbywa się zgodnie z zasadami zdefiniowanymi w regułach podświetlania składni dla danego formatu dokumentu.</para>
</listitem>
</varlistentry>

</variablelist>

<itemizedlist>
<title
>Pozostałe informacje zawarte w niniejszym rozdziale:</title>
<listitem
><para
><link linkend="kate-part-navigation"
>Nawigacja w tekście</link
> </para
></listitem>
<listitem
><para
><link linkend="kate-part-selection"
>Zaznaczanie tekstu</link
></para
></listitem>
<listitem
><para
><link linkend="kate-part-copy-and-paste"
>Kopiowanie i wklejanie</link
></para
></listitem>
<listitem
><para
><link linkend="kate-part-find-replace"
>Wyszukiwanie i zamiana tekstu</link
></para
></listitem>
<listitem
><para
><link linkend="kate-part-bookmarks"
>Korzystanie z zakładek</link
></para
></listitem>
<listitem
><para
><link linkend="kate-part-auto-wrap"
>Automatyczne zawijanie wyrazów</link
></para
></listitem>
<listitem
><para
><link linkend="kate-part-autoindent"
>Korzystanie z automatycznych wcięć</link
></para
></listitem>
</itemizedlist>

</sect1>

<sect1 id="kate-part-navigation">
<title
>Nawigacja w tekście</title>

<para
>Przesuwanie kursora w treści dokumentu odbywa się w &kate; tak, jak w większości graficznych edytorów tekstu. Działają klawisze strzałek, <keycap
>Page Up</keycap
>, <keycap
>Page Down</keycap
>, <keycap
>Home</keycap
>, <keycap
>End</keycap
> oraz ich kombinacje z klawiszami &Ctrl; oraz &Shift;. Klawisz &Shift; zawsze stosowany jest do zaznaczania tekstu zaś klawisz &Ctrl; w różny sposób modyfikuje sposób działania pozostałych klawiszy: <itemizedlist>
<listitem
><para
>W połączeniu z klawiszami strzałek <keycap
>w górę</keycap
> i <keycap
>w dół</keycap
> powoduje przesuwanie zawartości okna zamiast przesuwania kursora.</para
></listitem>
<listitem
><para
>Użycie <keycap
>Ctrl</keycap
> z klawiszami strzałek <keycap
>w lewo</keycap
> oraz <keycap
>w prawo</keycap
> będzie powodowało przesuwanie kursora o całe wyrazy, a nie o pojedyncze znaki.</para
></listitem>
<listitem
><para
>Dla klawiszy <keycap
>Page Up</keycap
> oraz <keycap
>Page Down</keycap
> zmiana działania polega na przesuwaniu kursora najpierw na początek lub koniec bieżącego okna, zamiast przesuwania o jedną stronę z zachowaniem pozycji kursora.</para>
</listitem>
<listitem
><para
>W kombinacji z <keycap
>Home</keycap
> oraz <keycap
>End</keycap
>, <keycap
>Ctrl</keycap
> oznacza przesunięcie na początek lub koniec dokumentu, nie zaś na początek lub koniec wiersza.</para
></listitem>
</itemizedlist>
</para>

<para
>Program &kate; pozwala na szybkie przemieszczanie się pomiędzy odpowiadającymi sobie parami nawiasów lub cudzysłowów. Naciśnięcie klawiszy <keycombo action="simul"
>&Ctrl;<keycap
>6</keycap
></keycombo
> gdy kursor znajduje się obok nawiasu lub cudzysłowu spowoduje przeniesienie go do nawiasu lub cudzysłowu będącego dla niego parą.</para>

<para
>Dodatkowo można skorzystać z mechanizmu <link linkend="kate-part-bookmarks"
>zakładek</link
> w celu szybkiego przenoszenia kursora pomiędzy zdefiniowanymi wcześniej pozycjami w treści dokumentu.</para>

</sect1>

<sect1 id="kate-part-selection">
<title
>Zaznaczanie tekstu</title>

<para
>Fragmenty tekstu w &kate; można zaznaczać za pomocą myszki lub klawiatury.</para>

<para
>Aby zaznaczyć tekst za pomocą myszki, należy nacisnąć i przytrzymać lewy przycisk myszki, a następnie przesunąć kursor z punktu wyjścia do końca zaznaczanego fragmentu. Zaznaczany fragment zmienia kolor tła w czasie zaznaczania.</para>

<para
>Podwójne kliknięcie zaznacza cały wyraz.</para>

<para
>Potrójne kliknięcie zaznacza cały wiersz.</para>

<para
>Przytrzymanie klawisza &Shift; podczas klikania myszy w dokumencie powoduje zaznaczanie tekstu:</para>

<itemizedlist>
<listitem
><para
>Gdy nie ma innego zaznaczenia to zostanie zaznaczony fragment od bieżącej pozycji kursora do pozycji, na której znajdzie się wskaźnik myszy w momencie kliknięcia.</para
></listitem>
<listitem
><para
>Jeżeli istnieje już zaznaczenie to kliknięcie rozszerzy zaznaczenie począwszy od jego granicy do pozycji wskaźnika myszy w momencie kliknięcia.</para
></listitem>
</itemizedlist>

<note>
<para
>Zaznaczanie tekstu za pomocą myszki powoduje automatyczne kopiowanie go do schowka. Można potem zaznaczony fragment wkleić w dowolnym miejscu za pomocą środkowego przycisku myszki. Możliwe jest też wklejenie go w innym programie. </para>
</note>

<para
>Aby zaznaczyć tekst za pomocą klawiatury, należy przytrzymać klawisz &Shift; i przesunąć kursor klawiszami strzałek, <keycap
>Page Up</keycap
>, <keycap
>Page Down</keycap
>, <keycap
>Home</keycap
> i <keycap
>End</keycap
> (działają też ich kombinacje z klawiszem &Ctrl; zwiększając możliwości ruchu kursora).</para>

<para
>Więcej informacji na ten temat w sekcji <link linkend="kate-part-navigation"
>Nawigacja w tekście</link
> niniejszego dokumentu.</para>

<para
>Skopiowanie wybranego fragmentu do schowka możliwe jest za pomocą menu: <menuchoice
><guimenu
>Edycja</guimenu
> <guimenuitem
>Kopiuj</guimenuitem
></menuchoice
> lub skrótu klawiszowego (domyślnie jest to: <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>).</para>

<para
>Usunięcie zaznaczenia dla wybranego fragmentu odbywa się za pomocą opcji menu <menuchoice
><guimenu
>Edycja</guimenu
> <guimenuitem
>Usuń zaznaczenie</guimenuitem
></menuchoice
>, skrótu klawiszowego (domyślnie jest to: <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>A</keycap
></keycombo
>) lub poprzez kliknięcie lewym przyciskiem myszy w dowolnym miejscu obszaru edycji.</para>

<sect2 id="kate-part-selection-block">
<title
>Korzystanie z zaznaczania bloku</title>

<para
>Włączenie trybu zaznaczania bloku pozwala na <quote
>zaznaczanie tekstu w pionie</quote
>, tzn. wybór tych samych kolumn z wielu następujących po sobie wierszy. Funkcja ta jest przydatna w pracy z plikami zawierającymi kolumny o stałej szerokości np.: z danymi, liczbami, itp.</para>

<para
>Tryb zaznaczania bloku może być włączony w menu <menuchoice
><guimenu
>Edycja</guimenu
> <guimenuitem
>Tryb zaznaczania bloku</guimenuitem
></menuchoice
>. Domyślną kombinacją klawiszy jest: <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>B</keycap
></keycombo
></para>

</sect2>

<sect2 id="kate-part-selection-overwrite">

<title
>Tryb zastępowania zaznaczenia</title>

<para
>Włączenie trybu zastępowania zaznaczenia powoduje, iż wprowadzenie lub wklejenie tekstu przy istniejącym zaznaczeniu fragmentu dokumentu spowoduje zastąpienie tego fragmentu wprowadzanym znakiem lub wklejanym tekstem. Jeżeli tryb zastępowania zaznaczenia jest wyłączony to nowy tekst zostanie dodany w miejscu bieżącej pozycji kursora.</para>

<para
>Tryb zastępowania zaznaczenia jest domyślnie włączony.</para>

<para
>Zmiana tego ustawienia jest możliwa w karcie <link linkend="pref-edit-cursor-selection"
>Kursor i zaznaczanie</link
> okna dialogowego <link linkend="config-dialog"
>Konfiguracja &kate;</link
>.</para>

</sect2>

<sect2 id="kate-part-selection-persistent">

<title
>Korzystanie z trwałego zaznaczenia</title>

<para
>Przy włączonej opcji trwałego zaznaczenia operacje wpisywania znaków lub przemieszczania kursora nie powodują usunięcia zaznaczenia. Oznacza to, że można przesuwać kursor poza miejscem zaznaczenia, a także wprowadzać wewnątrz zaznaczenia nowy tekst, nie tracąc tego zaznaczenia.</para>

<para
>Opcja trwałego zaznaczenia domyślnie jest wyłączona.</para>

<para
>Trwałe zaznaczanie, może zostać włączone w zakładce <link linkend="pref-edit-cursor-selection"
>Kursor i zaznaczenie</link
> <link linkend="config-dialog"
>Okna konfiguracji</link
>.</para>

<warning>
<para
>Jednoczesne włączenie trybu trwałego zaznaczenia i zastępowania zaznaczenia powoduje, iż wpisywanie lub wklejanie tekstu wewnątrz zaznaczonego fragmentu spowoduje, że zostanie on zastąpiony nowym tekstem, a zaznaczenie usunięte.</para>
</warning>

</sect2>

</sect1>

<sect1 id="kate-part-copy-and-paste">

<title
>Kopiowanie i wklejanie tekstu</title>

<para
>Aby skopiować fragment tekstu należy go wcześniej zaznaczyć, a następnie użyć menu <menuchoice
><guimenu
>Edycja</guimenu
> <guimenuitem
>Kopiuj</guimenuitem
></menuchoice
>. Niezależnie od tego polecenia, każde zaznaczenie fragmentu tekstu powoduje automatyczne skopiowanie go do schowka menedżera okien X.</para>

<para
>Wklejenie tekstu ze schowka możliwe jest za pomocą polecenia menu <menuchoice
> <guimenu
>Edycja</guimenu
><guimenuitem
>Wklej</guimenuitem
></menuchoice
> .</para>

<para
>Dodatkowo każdy fragment zaznaczony myszką może zostać wklejony w innym miejscu dokumentu za pomocą <mousebutton
>środkowego</mousebutton
> przycisku myszy.</para>

<tip>
<para
>Środowisko &kde; umożliwia dostęp do wielu poprzednio kopiowanych fragmentów tekstu za pomocą narzędzia &klipper;, którego ikona widoczna jest w zasobniku systemowym.</para>
</tip>

</sect1>

<!-- change in 4 see updated kwrite docs-->
<sect1 id="kate-part-find-replace">
<title
>Wyszukiwanie i zamiana tekstu</title>

<sect2 id="find-replace-bars">
<title
>Paski szukania i zamiany</title>


<para
>&kate; ma paski przyrostowego wyszukiwania i zaawansowanego wyszukiwania i zamiany, w którym można wprowadzić poszukiwany i zamieniany tekst, a także ustawić kilka dodatkowych opcji.</para>

<para
>Paski szukania zawierają następujące wspólne ustawienia:</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Znajdź</guilabel
></term>
<listitem
><para
>Tutaj należy wprowadzić poszukiwany napis. Sposób wyszukiwania zależy od zaznaczenia opisanych poniżej opcji.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Podświetl wszystko</guilabel
></term>
<listitem>
<para
>Jeżeli opcja jest aktywna, to wszystkie wystąpienia poszukiwanego fragmentu tekstu w dokumencie będą podświetlone.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Uwzględnij wielkość liter</guilabel
></term>
<listitem>
<para
>Jeżeli opcja będzie aktywna, funkcja wyszukiwania będzie uwzględniać wielkość liter (małe i duże) podanych we wzorcu wyszukiwania.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Od kursora</guilabel
></term>
<listitem>
<para
>Jeśli wybrano tę opcję, to wyszukiwanie zacznie się od miejsca położenia kursora, w przeciwnym wypadku rozpocznie się od początku dokumentu.</para>
</listitem>
</varlistentry>

</variablelist>

<para
>Pasek zaawansowanego wyszukiwania i zamiany zawiera kilka dodatkowych opcji:</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Zwykły tekst</guilabel
></term>
<listitem>
<para
>Dokładnie dopasowuje każde wystąpienie poszukiwanego tekstu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Całe słowa</guilabel
></term>
<listitem>
<para
>Jeżeli opcja zostanie włączona, wyszukiwanie będzie działać tylko dla ciągów ograniczanych z obu stron. Ograniczeniem jest każdy znak niealfanumeryczny - zarówno widoczny (jak spacja) jak i koniec linii.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Sekwencje sterujące</guilabel
></term>
<listitem>
<para
>Jeżeli opcja zostanie włączona, to uaktywni się przycisk <guibutton
>Dodaj</guibutton
>, pozwalający na dodanie sekwencji sterujących do wzorca wyszukiwania z wcześniej zdefiniowanej listy.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Wyrażenie regularne</guilabel
></term>
<listitem>
<para
>Jeśli ta opcja jest zaznaczona to wzorzec wyszukiwania jest interpretowany jako wyrażenie regularne. Uaktywni się też przycisk <guibutton
>Dodaj</guibutton
>, pozwalający na dodanie najczęściej stosowanych sekwencji wyrażeń regularnych do wzorca wyszukiwania z wcześniej zdefiniowanej listy.</para>
<para
>Więcej informacji na ten temat znajduje się w sekcji: <link linkend="regular-expressions"
> Wyrażenia regularne</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Tylko zaznaczenie   </guilabel
></term>
<listitem>
<para
>Jeżeli opcja jest włączona, funkcja poszukiwania i zamiany będzie działać tylko na zaznaczonym fragmencie tekstu.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="finding-text">
<title
>Wyszukiwanie tekstu</title>

<para
>Aby wyszukać tekst, należy wyświetlić pasek wyszukiwania przyrostowego naciskając klawisze <keycombo action="simul"
>&Ctrl;<keycap
>F</keycap
></keycombo
> lub wybierając pozycję<menuchoice
><guimenu
>Edycja</guimenu
> <guimenuitem
>Znajdź...</guimenuitem
></menuchoice
> z menu głównego.</para>
<para
>Powoduje wyświetlenie paska wyszukiwania na dole okna edytora. Po lewej stronie paska znajduje się ikona zamykająca go, zaraz po niej zaś niewielkie pole tekstowe, służące do wpisywania tekstu, który należy wyszukać.</para>
<para
>Gdy zaczniesz pisać w pasku wyszukiwania, wyszukiwanie rozpocznie się natychmiast. Jeśli istnieje w tekście odpowiednie dopasowanie, tekst w polu tekstowym wyróżniany jest za pomocą jasnozielonego koloru tła. Jeśli wyszukiwarka nie znajdzie żadnych dopasowań, tekst ten otrzymuje jasnoczerwone tło, zaś po prawej stronie paska wyszukiwania pojawia się napis <guilabel
>Nie znaleziono</guilabel
>.</para>
<para
>Użyj przycisku <guilabel
>Następny</guilabel
> lub <guilabel
>Poprzedni</guilabel
>, aby przejść do następnego lub poprzedniego dopasowania w dokumencie.</para
> 
<para
>Można modyfikować zachowanie funkcji znajdź i zamień poprzez wybranie różnych <guilabel
>opcji</guilabel
> opisanych powyżej. </para>
<para
>Kliknij na zielonej strzałce po prawej stronie paska wyszukiwania, aby przełączyć pasek do bardziej zaawansowanego trybu wyszukiwania/zastępowania. </para>
<para
>Aby powtórzyć ostatnią operację wyszukiwania, bez wyświetlania paska wyszukiwania, należy użyć: <menuchoice
> <shortcut
><keycombo action="simul"
><keycap
>F3</keycap
></keycombo
></shortcut
> <guimenu
>Edycja</guimenu
><guimenuitem
>Znajdź następne</guimenuitem
></menuchoice
> lub <menuchoice
><shortcut
> <keycombo action="simul"
>&Shift;<keycap
>F3</keycap
></keycombo
></shortcut
> <guimenu
>Edycja</guimenu
><guimenuitem
>Znajdź poprzednie</guimenuitem
></menuchoice
>. </para>

</sect2>

<sect2>
<title
>Zastępowanie tekstu</title>

<para
>Aby zamienić tekst, należy uruchomić pasek zaawansowanego wyszukiwania i zamiany za pomocą polecenia<menuchoice
><guimenu
>Edycja</guimenu
> <guimenuitem
>Zamień</guimenuitem
></menuchoice
> z menu, lub klawiszy <keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
>.</para>
<para
>W prawym górnym rogu tego paska znajduje się przycisk zamykający, pod nim zaś niewielkie pole tekstowe, służące do wpisywania szukanego tekstu.</para>
<para
>Można ustawiać pożądany tryb szukania i zamiany wybierając opcje <guilabel
>Zwykły tekst</guilabel
>, <guilabel
>Całe wyrazy</guilabel
>, <guilabel
>Sekwencje sterujące</guilabel
> lub <guilabel
>Wyrażenie regularne</guilabel
>, które zostały opisane powyżej. </para>
<para
>Użyj przycisku <guilabel
>Następny</guilabel
> lub <guilabel
>Poprzedni</guilabel
>, aby przejść do następnego lub poprzedniego dopasowania w dokumencie.</para>
<para
>Należy wprowadzić tekst do zamiany w polu oznaczonym: <guilabel
>Zamień</guilabel
> i kliknąć przycisk <guibutton
>Zamień</guibutton
> aby zamienić podświetlony fragment tekstu, lub przycisk <guibutton
>Zamień wszystkie</guibutton
> aby zamienić wszystkie wystąpienia odszukanego fragmentu w całym dokumencie. Jeżeli zaznaczona została opcja <guilabel
>Użyj znaczników miejsca</guilabel
> można dołożyć dodatkowe specjalne elementy do zamienianego tekstu poprzez kliknięcie przycisku <guibutton
>Dodaj</guibutton
>.</para>
<para
>Można modyfikować zachowanie funkcji znajdź i zamień poprzez wybranie różnych opcji w pasku po prawej stronie. </para>
<para
>Kliknij zieloną strzałkę po prawej stronie zaawansowanego paska wyszukiwania/zastępowania, aby przełączyć do zwykłego paska wyszukiwania. </para>
<tip>
<para
>W przypadku korzystania z wyrażeń regularnych dla poszukiwania tekstu przy operacjach zastępowania można skorzystać z odwołań zwrotnych do przechwytywania dopasowanego tekstu i wykorzystywania go w napisie zastępującym.</para>
<para
>Więcej informacji na ten temat znajduje się w sekcji: <xref linkend="regular-expressions"/> .</para>
</tip>

<tip
><para
>Dodatkowo możliwe jest wykorzystanie poleceń <command
>find</command
>, <command
>replace</command
> oraz <command
>ifind</command
> (wyszukiwanie przyrostowe) dostępnych w <link linkend="advanced-editing-tools-commandline"
>linii poleceń edytora</link
>.</para>
</tip>

</sect2>

</sect1>

<sect1 id="kate-part-bookmarks">
<title
>Korzystanie z zakładek</title>

<para
>Mechanizm zakładek pozwala na oznaczenie wybranych fragmentów dokumentu w celu ich szybkiego wyszukiwania.</para>

<para
>Zakładkę dla wiersza można zdefiniować na dwa sposoby:</para>

<itemizedlist>
<listitem>
<para
>Należy przesunąć kursor do wybranej linii a następnie wybrać polecenie<menuchoice
><guimenu
>Zakładki</guimenu
><guimenuitem
>Ustaw zakładkę</guimenuitem
></menuchoice
> (<keycombo action="simul"
>&Ctrl;<keycap
>B</keycap
></keycombo
>).</para>
</listitem>
<listitem>
<para
>Można kliknąć na pasek ikon obok wybranego wiersza.</para>
</listitem>
</itemizedlist>


<para
>Zdefiniowane w dokumencie zakładki widoczne są w menu <guimenu
>Zakładki</guimenu
> jako pozycje menu, zawierające w swej treści numer wiersza i jego kilka początkowych słów. Wybranie zakładki z menu spowoduje przeniesienie kursora na początek oznaczonego przez tę zakładkę wiersza.</para>

<para
>Aby szybko przenosić kursor pomiędzy zakładkami należy użyć poleceniapoleceń menu <menuchoice
><guimenu
>Zakładki</guimenu
><guimenuitem
>Następna</guimenuitem
> </menuchoice
> (<keycombo action="simul"
><keycap
>&Ctrl;</keycap
> <keycap
>Page Down</keycap
></keycombo
>) lub <menuchoice
> <guimenu
>Zakładki</guimenu
><guimenuitem
>Poprzednia</guimenuitem
></menuchoice
> (<keycombo action="simul"
><keycap
>&Ctrl;</keycap
><keycap
>Page Up</keycap
> </keycombo
>).</para>

</sect1>

<sect1 id="kate-part-auto-wrap">

<title
>Automatyczne zawijanie wyrazów</title>

<para
>Funkcja pozwala na formatowanie tekstu tak, iż wyrazy wykraczające poza zdefiniowaną dla wiersza maksymalną liczbę znaków, zostają automatycznie przeniesione do następnego wiersza, chyba że w wierszu tym zapisany jest dłuższy napis nie zawierający spacji i innych tzw. białych znaków.</para>

<para
>Aby włączyć/wyłączyć to ustawienie, należy zaznaczyć/odznaczyć pole <guibutton
>Statyczne zawijanie wyrazów</guibutton
> na stronie <link linkend="pref-word-wrap"
>Edycja</link
> w oknie dialogowym <link linkend="config-dialog"
>Konfiguracji</link
>.</para>

<para
>Aby ustawić maksymalną liczbę znaków w linii po której następuje zawijanie wyrazów, należy skorzystać z opcji <link linkend="pref-wrap-words-at"
><guibutton
>Zawijaj wyrazy na...</guibutton
></link
> w karcie <link linkend="pref-edit"
>Edycja</link
> okna dialogowego <link linkend="config-dialog"
>Konfiguracja</link
>.</para>

<para
>Efekty działania tej funkcji są następujące: <itemizedlist>
<listitem
><para
>W trakcie pisania edytor automatycznie wstawi znak przeniesienia do następnego wiersza po ostatniej spacji poprzedzającej wyraz, który spowodował przekroczenie maksymalnej liczby znaków w wierszu.</para
></listitem>
<listitem
><para
>Podczas wczytywania dokumentu program zawinie wyrazy w taki sam sposób, aby wiersze dokumentu nie przekraczały zdefiniowanej liczby znaków (przy założeniu, że zawierają spacje pozwalające na przeniesienie całego wyrazu).</para
></listitem>
</itemizedlist>

</para>

<note
><para
>Obecna wersja programu nie pozwala na odmienne ustawienie działania funkcji zawijania wyrazów dla różnych typów dokumentów lub dla poszczególnych otwartych plików. Zostanie to poprawione w następnych wersjach programu &kate;.</para
></note>

</sect1>

<sect1 id="kate-part-autoindent">
<title
>Korzystanie z funkcji automatycznych wcięć</title>

<para
>Program &kate; umożliwia stosowanie różnorodnych trybów automatycznego generowania wcięć w tekście, przystosowanych dla różnych rodzajów dokumentów. Użytkownik może wybrać tryb generowania wcięć w menu: <menuchoice
><guimenu
>Narzędzia</guimenu
><guisubmenu
>Wcięcia</guisubmenu
></menuchoice
>. Uzupełnieniem funkcji automatycznych wcięć jest polecenie <menuchoice
><guimenu
>Narzędzia</guimenu
><guimenuitem
>Wyrównaj</guimenuitem
></menuchoice
>, które powoduje regenerację wielkości wcięć dla zaznaczonego fragmentu lub bieżącego wiersza. Można zastosować to polecenie dla całego dokumentu zaznaczając cały tekst przed jego uruchomieniem.</para>

<para
>Wszystkie tryby automatycznych wcięć wykorzystują ustawienia konfiguracyjne dla bieżącego dokumentu.</para>

<tip
><para
>Użytkownik może określić różnorodne wartości parametrów konfiguracyjnych związanych z wcięciami za pomocą <link linkend="config-variables"
>Zmiennych dokumentu</link
> oraz <link linkend="pref-open-save-modes-filetypes"
>Typów pliku</link
>.</para
></tip>

<variablelist>

<title
>Dostępne tryby pracy automatycznych wcięć</title>

<varlistentry>
<term
>Brak</term>
<listitem
><para
>Wyłącza funkcję automatycznych wcięć.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Normalny</term>
<listitem
><para
>W tym trybie generowania wcięć program stara się utrzymać wcięcie na poziomie podobnym do wcięcia w poprzednim wierszu. Ten tryb może być używany z poleceniami "wcięcie" i "usuń wcięcie" dla samodzielnego ustalania poziomów wcięć w dokumencie. </para
></listitem>
</varlistentry>

<varlistentry
><term
>Styl C</term>
<listitem
><para
>Moduł generowania wcięć dla języka C, C++, C#, java, javascript i innych podobnych. Ten moduł nie będzie dobrze działać dla języków skryptowych takich jak Perl czy PHP.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Styl SS &amp; C</term>
<listitem
><para
>Alternatywny moduł generowania wcięć dla języków programowania z rodziny C.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Styl Python</term>
<listitem
><para
>Moduł generowania automatycznych wcięć dostosowany do języka Python. </para
></listitem>
</varlistentry>

<varlistentry>
<term
>XML</term>
<listitem
><para
>Moduł automatycznego generowania wcięć dla dokumentów w standardzie XML. Nie należy go używać dla dokumentów HTML, ponieważ nie będzie sobie radził z otwartymi znacznikami (takimi jak np.: &lt;br&gt;))</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Program wcinający na podstawie zmiennych</term>
<listitem>

<note>
<para
>Funkcja generowania wcięć na podstawie zmiennych ma charakter eksperymentalny. Jej działanie może się zmienić, może też zostać usunięta w przyszłych wersjach programu.</para>
</note>

<para
>Program wcinający na podstawie zmiennych jest konfigurowany za pomocą zmiennych zapisanych w edytowanym pliku lub w definicji typu pliku. Obsługiwanesą następujące zmienne: <variablelist>
<varlistentry>
<term
>var-indent-indent-after</term>
<listitem>
<para
>Wyrażenie regularne, które spowoduje zwiększenie wcięcia o jednostkę w przypadku spełnienia warunku.</para>
</listitem>
</varlistentry>


<varlistentry>
<term
>var-indent-indent</term>
<listitem>
<para
>Wyrażenie regularne, które spowoduje zwiększenie wcięcia o jednostkę w przypadku spełnienia warunku.</para>
</listitem>
</varlistentry>


<varlistentry>
<term
>var-indent-unindent</term>
<listitem>
<para
>Wyrażenie regularne, które powoduje zmniejszenie wcięcia o jednostkę w przypadku spełnienia warunku.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>var-indent-triggerchars</term>
<listitem>
<para
>Lista znaków, których wprowadzenie spowoduje ponowne przeliczenie wielkości wcięcia.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>var-indent-handle-couples</term>
<listitem>
<para
>Lista zestawów nawiasów generujących wcięcie. Może to być dowolna kombinacja nawiasów zwykłych, klamrowych i kwadratowych. Każdy para nawiasów traktowana jest następująco: jeżeli w dokumencie znajdują się niedopasowane nawiasy otwierające to wcięcie zwiększy się o jednostkę. Jeżeli zaś występują niedopasowane nawiasy zamykające w bieżącym wierszu to wcięcie zmniejszy się o jednostkę.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>var-indent-couple-attribute</term>
<listitem>
<para
>Atrybut znaków rozpoznawanych podczas operacji poszukiwania pasujących do siebie par znaków otwarcia i zamknięcia. Wartością zmiennej jest nazwa atrybutu z pliku XML definiującego reguły podświetlania składni (np. "Symbol"). Wartością domyślną jest 0 (co oznacza z reguły styl "zwykłego tekstu").</para>
</listitem>
</varlistentry>

</variablelist>

</para
></listitem>
</varlistentry>

</variablelist>

</sect1>

</chapter>
