Copyright © 2000, 2001 Thad McGinnis
Copyright © 2005 Anne-Marie Mahfouf <annma@kde.org>
, Anders Lund <anders@alweb.dk>
Dozwolone jest kopiowanie, dystrybucja i/lub modyfikacja tego dokumentu na zasadach licencji GNU Free Documentation License, w wersji 1.1 lub dowolnej późniejszej wersji, opublikowanej przez Free Software Foundation; bez Sekcji Niezmiennych, bez Tekstu Początkowego i bez tekstu Końcowego. Kopia tej licencji znajduje się w sekcji zatytułowanej "GNU Free Documentation License".
KWrite jest edytorem tekstu dla KDE
Spis treści
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, HTML i Ada.
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.
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 Konquerora.
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.
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:
%
kwrite
/home/mój_katalog_domowy/docs/mój_plik.txt
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:
%
kwrite
ftp://ftp.kde.org/pub/kde/Welcome.msg
Dostępne są następujące komendy wyświetlania pomocy w linii poleceń
kwrite --help
Komenda ta wyświetli listę dostępnych podstawowych opcji.
kwrite --help-qt
Lista dostępnych opcji dotyczących współpracy KWrite z biblioteką Qt™.
kwrite --help-kde
Lista dostępnych opcji dotyczących zachowania KWrite w środowisku KDE.
kwrite --help-all
Lista wszystkich opcji linii poleceń.
kwrite --author
Wyświetli listę autorów programu KWrite.
kwrite --version
Wyświetla informacje o wersji Qt™, KDE, oraz KWrite. Również dostępna przez kwrite
. -v
kwrite --stdin
Opcja powoduje, że KWrite odczytuje dokument ze standardowego wejścia. Opcja ta jest podobna do opcji -
wykorzystywanej przez wiele programów, i pozwala przekierowywać wyjście dowolnego programu do KWrite.
kwrite --encoding
kodowanie
URL
Wymusza stosowanie określonego systemu kodowania znaków dla danego dokumentu.
kwrite --line
wiersz
URL
Opcja powoduje iż, po otwarciu dokumentu KWrite przeniesie kursor do określonego w wywołaniu wiersza tekstu.
kwrite --column
kolumna
URL
Opcja powoduje iż, po otwarciu dokumentu KWrite przeniesie kursor do określonej w wywołaniu kolumny tekstu.
Wiele skrótów klawiszowych może być skonfigurowanych poprzez opcję Konfiguracja skrótów w menu Ustawienia. Domyślnie KWrite obsługuje nastepujące klawisze:
Insert | 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. |
Strzałka w lewo | Przesuniecie kursora w lewo |
Strzałka w prawo | Przesunięcie kursora w prawo |
Strzałka do góry | Przesunięcie kursora w górę |
Strzałka w dół | Przesunięcie kursora w dół |
Page Up | Przesunięcie kursora o jedną stronę do góry |
Alt+Page Up | Przejście do poprzedniej zakładki |
Page Down | Przesunięcie kursora o jedną stronę w dół |
Alt+Page Down | Przejście do następnej zakładki |
Backspace | Usunięcie znaku na lewo od kursora |
Home | Przesunięcie kursora na początek wiersza |
End | Przesuniecie kursora na koniec wiersza |
Delete | Usunięcie znaku na prawo od kursora (lub zaznaczonego fragmentu tekstu) |
Shift+Strzałka w lewo | Zaznacza tekst, przesuwając o jeden znak w lewo |
Shift+Strzałka w prawo | Zaznacza tekst, przesuwając o jeden znak w prawo |
F1 | Pomoc |
Shift+F1 | Co to jest? |
F3 | |
Shift+F3 | |
Ctrl+A | Zaznacza wszystko |
Ctrl+Shift+A | Anuluje zaznaczenie |
Ctrl+Shift+B | Tryb zaznaczania blokowego |
Ctrl+B | Ustawienie zakładki |
Ctrl+C | Skopiowanie zaznaczonego tekstu do schowka |
Ctrl+D | Wstawienie tekstu w komentarz |
Ctrl+Shift+D | Usunięcie komentarza |
Ctrl+F | |
Ctrl+G | Przejście do wiersza... |
Ctrl+I | Wcięcie tekstu |
Ctrl+Shift+I | Usunięcie wcięcia tekstu |
Ctrl+J | Połączenie wierszy |
Ctrl+N | |
Ctrl+O | |
Ctrl+P | |
Ctrl+Q | Zakończenie - zamknięci aktywnego okna edytora |
Ctrl+R | |
Ctrl+S | |
Ctrl+U | Zamiana na wielkie litery |
Ctrl+Shift+U | Zamiana na małe litery |
Alt+Ctrl+U | Zamiana na kapitaliki |
Ctrl+V | Wkleja zawartość schowka do edytora |
Ctrl+W | |
Ctrl+X | Usuwa zaznaczony tekst i kopiuje go do schowka. |
Ctrl+Z | |
Ctrl+Shift+Z | |
Ctrl+- | Zwija jeden poziom lokalny |
Ctrl+Shift+- | Zwija najwyższy poziom |
Ctrl++ | Rozwija jeden poziom lokalny |
Ctrl+Shift++ | Rozwija najwyższy poziom |
F5 | |
F6 | Pokazuje pasek ikon |
F7 | Przełącza do linii poleceń |
F9 | Pokazuje znaczniki zwijania |
F10 | Włącza dynamiczne zawijanie wyrazów |
F11 | Pokazuje numery wierszy |
Rozpoczyna edycję nowego dokumentu w edytorze. Jeśli bieżący dokument zawiera niezapisane zmiany, program zapyta czy zapisać zmiany.
Wyświetla standardowe okno dialogowe Otwórz plik. Pojawi się lista plików, spośród których możesz wybrać plik do otworzenia. Następnie kliknij przycisk , aby go otworzyć. Więcej informacji na temat okna dialogowego Otwórz plik znajduje się w Podręczniku użytkownika środowiska KDE.
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.
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 (opisane poniżej).
Zapisuje dokument pozwalając na nadanie mu nowej nazwy. Po wybraniu tej pozycji otwiera się okno dialogowe analogiczne jak opisane wcześniej okno Otwórz.
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.
Otwiera proste okno drukowania, w którym użytkownik określa, co, gdzie i w jaki sposób drukować.
Pozwala na zapisanie pliku w formacie HTML, dzięki czemu dokument może być oglądany jak strona WWW.
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.
Zamyka okno edycji dokumentu. Nie zostaną zamknięte pozostałe instancje programu KWrite, utworzone za pomocą poleceń menu lub .
Anuluje lub wycofuje ostatnie dokonane przez użytkownika zmiany.
Opcja ta przywraca zmiany w dokumencie wycofane za pomocą operacji Cofnij.
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.
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.
Kopiuje zaznaczony fragment tekstu do schowka stosując format HTML.
Wstawia zawartość schowka w aktualnej pozycji kursora. Schowek stanowi integralną część środowiska KDE, i umożliwia wymianę danych pomiędzy różnymi programami.
Powoduje zaznaczenie całego dokumentu, co jest przydatne np. przy kopiowaniu całego tekstu do innego programu.
Anuluje zaznaczenie fragmentu tekstu w edytorze.
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”.
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".
Otwiera okno wyszukiwania, w którym użytkownik może wprowadzić szukany tekst. 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 Uwzględniaj wielkość liter ograniczy wyniki wyszukiwania do tekstu dokładnie odpowiadającego wielkości liter fragmentu poszukiwanego (małe lub wielkie litery). Znajdź wstecz określa kierunek szukania od pozycji kursora w kierunku początku dokumentu. Zaznaczony tekst ogranicza pole poszukiwań do zaznaczonego fragmentu tekstu. Wyszukiwanie Całych słów zapobiega znalezieniu poszukiwanego tekstu będącego fragmentem dłuższych wyrazów. Opcja Od kursora spowoduje rozpoczęcie wyszukiwania od aktualnej pozycji kursora w dokumencie. Jeżeli nie jest zaznaczona, to poszukiwanie rozpoczyna się od początku dokumentu.
Powtarza ostatnią operację wyszukiwania tekstu, bez wywoływania okna dialogowego.
Powtarza ostatnią operację wyszukiwania tekstu, bez wywoływania okna dialogowego, określając jednocześnie kierunek wyszukiwania wstecz.
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 Zastąp przez:. W oknie użytkownik wprowadza zarówno tekst do znalezienia, jak też tekst, który ma zastąpić wyszukany fragment. Dodatkowa opcja Pytaj przy zamianie powoduje, iż KWrite zapyta się użytkownika o jego decyzję przed dokonaniem każdej zamiany.
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.
Menu pozwala na określenie ustawień związanych z aktywnym oknem edytora, oraz na zarządzanie ramkami.
Otwiera nowe okno zawierające aktualnie edytowany dokument.
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ń.
Pozwala na wybranie schematu czcionek.
Powoduje, że wiersze będą zawijane na krawędzi okna.
Wybiera sposób wyświetlania znaczników dynamicznego zawijania wyrazów. Opcja staje się dostępna jeżeli Dynamiczne zawijanie wyrazów jest włączone.
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 -> w karcie: Edycja. Znacznik zawijania wyrazów widoczny jest jedynie w przypadku użycia czcionki o stałej szerokości.
Przełącza wyświetlanie paska z ikonami po lewej stronie okna dokumentu.
Przełącza wyświetlanie paska po lewej stronie aktywnego okna edytora, zawierającego numery wierszy.
Zaznaczenie tej opcji włącza wyświetlanie znaczników na pionowym pasku przewijania.
Zaznaczenie tej opcji spowoduje ukrycie znaczników zwijania kodu źródłowego.
Zwija wszystkie szczytowe poziomy zwijania w dokumencie.
Rozwija wszystkie szczytowe poziomy kodu w dokumencie.
Zwija jeden poziom kodu znajdujący się najbliżej pozycji kursora.
Rozwija fragment kodu znajdujący się najbliżej kursora.
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.
Usuwa wszystkie zakładki z dokumentu oraz czyści listę zakładek znajdujących się w dolnej części tego menu.
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.
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.
Na dole menu pojawi się lista zakładek znajdujących się w edytowanym dokumencie (o ile zostały one zdefiniowane).
Ustawia aktualny dokument w tryb tylko to odczytu. Blokuje to możliwość dodawania i zmieniania tekstu w bieżącym dokumencie.
Opcja pozwala na wybranie typu pliku dla aktywnego dokumentu. Zmiana tutaj dokonana zastępuje ustawienia globalne dla typu pliku, znajdujące się w menu -> w karcie Typy plików, ale wyłącznie dla otwartego dokumentu.
Pozwala na wybór reguły podświetlania tekstu. Zmiana ustawienia zastępuje globalne ustawienie zdefiniowane w menu -> w zakładce: Podświetlenie.
Pozwala na wybór sposobu wstawiania automatycznych wcięć. Zmiana ustawienia zastępuje globalne ustawienie zdefiniowane w menu -> w zakładce: Wcięcia.
Dzięki tej opcji możliwa jest zmiana ustawienia kodowania znaków zdefiniowanego w menu -> w zakładce: Otwórz/Zapisz. Dokonana zmiana dotyczyć będzie tylko aktualnie edytowanego dokumentu.
Pozwala na zmianę stosowanych przy zapisywaniu pliku kodów końca wiersza. Zmiana ustawienia napisuje globalne ustawienie zdefiniowane w menu -> w zakładce: Otwórz/Zapisz.
Uruchamia program sprawdzania pisowni, który pomaga znaleźć i poprawić błędy ortograficzne 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:
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.
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.
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 Zastąp przez:, znajdującego się powyżej.
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.
Po prawej stronie okna dialogowego znajduje się 5 przycisków, pozwalających użytkownikowi kontrolować proces sprawdzania i korygowania pisowni. Są to przyciski:
Naciśnięcie przycisku spowoduje dodanie nieznanego słowa do słownika.. Dzięki temu, podczas kolejnego sprawdzania, słowo to zostanie uznane za poprawne.
Ten przycisk zamienia znalezione w tekście nieznane słowo, na słowo widoczne w polu Zastąp przez:.
Przycisk ten zamienia aktualnie widoczne Nieznane słowo oraz wszystkie inne jego wystąpienia w dokumencie, na słowo widoczne w polu Zastąp przez.
Naciśnięcie przycisku spowoduje zignorowanie faktu znalezienia nieznanego słowa i kontynuację procesu sprawdzania tekstu.
Naciśnięcie przycisku spowoduje zignorowanie faktu znalezienia nieznanego słowa i kontynuację procesu sprawdzania tekstu. Zignorowane będą również wszystkie następne wystąpienia tego słowa w tekście.
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.
Następne trzy przyciski widoczne w oknie sprawdzania pisowni, zlokalizowane są w jego dolnej części. Są to:
Opcja ta uruchamia system pomocy KDE i otwiera niniejszą dokumentację programu KWrite.
Przycisk ten kończy proces sprawdzania pisowni i wraca do aktualnego dokumentu.
Przycisk ten anuluje sprawdzanie pisowni, wszystkie zmiany (operacje zastąpienia słów) są cofane i następuje powrót do aktualnego dokumentu.
Uruchamia program sprawdzający pisownię, ale dla tekstu rozpoczynającego się w aktualnej pozycji kursora (zamiast od początku dokumentu).
Sprawdza pisownię zaznaczonego fragmentu tekstu.
Powoduje zwiększenie wcięcia wybranego zdania o jeden krok. Wielkość kroku zależy od ustawienia parametrów dla reguł wcięć.
Zmniejsza wcięcie danego zdania o jeden krok. Wielkość kroku zależy od ustawienia parametrów dla reguł wcięć.
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.
Powoduje ponowne wyrównanie bieżącej linii lub wybranego fragmentu tekstu, zgodnie z trybem wcięć ustawionym dla dokumentu.
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.).
Usuwa komentarze z zaznaczonego fragmentu lub bieżącej linię tekstu. Komentarze rozpoznawane są zgodne z wybranymi zasadami podświetlania kodu (HTML, C, itp.).
Zmienia wszystkie litery w zaznaczonym fragmencie (lub jedną literę za kursorem) na duże.
Zmienia wszystkie litery w zaznaczonym fragmencie (lub jedną literę za kursorem) na małe.
Przekształca zaznaczony fragment lub bieżące słowo na pisane kapitalikami.
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.
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 ->
Wyświetla lub chowa ruchomy pasek narzędzi zawierający przyciski powiązane z najczęściej wykorzystywanymi operacjami.
Wyświetla lub ukrywa wąski pasek na dole okna edytora, zawierający informacje o stanie poszczególnych funkcji i informacje o edytowanym dokumencie.
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.
Opcja ta otwiera okno dialogowe zawierające wiele różnych parametrów konfiguracyjnych KWrite, które pozwalają na dostosowanie zachowania programu do specyficznych potrzeb użytkownika.
Pozwala na wybranie używanego przez KWrite komponentu edycyjnego. Dostępne są następujące opcje: Systemowy, Osadzony zaawansowany edytor tekstu lub Oparty na Qt™ edytor tekstu (dostępny tylko wtedy, gdy zainstalowano pakiet KDevelop). Wybranie pozycji Systemowy powoduje, iż KWrite stosuje ustawienia dla edytora określone w centrum sterowania KDE.
To polecenie otwiera okno dialogowe, w którym użytkownik może zmienić skróty klawiszowe 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 Alt, i nacisnąć klawisz K. Spowoduje to, iż każdorazowe użycie kombinacji klawiszy Ctrl, Alt oraz K (tylko w trakcie korzystania z KWrite) spowoduje wyświetlenie okna dialogowe Informacje o KDE.
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.
Uruchamia System pomocy KDE na stronie pomocy programu (czyli na tym dokumencie).
Zmienia kursor myszy w strzałkę ze znakiem zapytania . Kliknięcie na elemencie programu spowoduje otworzenie okna pomocy objaśniającego funkcję tego elementu (o ile taka pomoc istnieje).
Otwiera okienko zgłoszenia błędu, w którym możesz zgłosić błąd lub prośbę o dodanie nowej funkcji.
Wyświetla informację o autorach i wersji programu.
Wyświetla informację o wersji KDE i inne podstawowe informacje.
Wybranie z menu -> 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.
Naciśnięcie przycisku Pomoc uruchamia system pomocy środowiska KDE, przycisk zatwierdza dokonane ustawienia i zamyka okno, zaś powoduje zamknięcie okna bez zapisywania dokonanych zmian. Poniżej opisane następujące kategorie ustawień: Wygląd, Kolory i czcionki, Kursor i zaznaczanie, Edycja, Wcięcia, Otwórz/Zapisz, Podświetlanie, Typy plików, Skróty i Wtyczki.
Zaznaczenie tej opcji włącza przenoszenie tekstu do następnej linii jeżeli osiągnie prawą granicę okna edytora.
Ustawia sposób wyświetlania znaczników dynamicznego zawijania wyrazów.
Włącza automatyczne wcinanie dynamicznie zawiniętych linii 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%, powoduje że poziom wcięcia głębszy niż 50% szerokości ekranu, nie będzie automatycznie wyrównywany w pionie dla dynamicznie zawijanych linii.
Włączenie tej opcji, spowoduje pokazanie w aktualnie edytowanym dokumencie znaczników zwijania kodu (jeżeli opcja zwijania jest włączona).
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.
Włącza pokazywanie numerów wierszy po lewej stronie okna edycji.
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.
Zakładki zostaną posortowane w kolejności numerów wierszy, w których zostały ustawione.
Każda nowa zakładka zostanie dodana do listy na końcu, niezależnie od miejsca jej położenia w dokumencie.
Zaznaczenie tej opcji spowoduje uwidocznienie w oknie edycyjnym linii pomagających zidentyfikować poszczególne poziomy wcięcia tekstu.
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.
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 Schemat.
Kolor domyślny dla tła obszaru edycyjnego, jest on kolorem wyraźnie dominującym w oknie edytora.
Pozwala wybrać tło dla zaznaczonego tekstu. Wartości domyślne są pobierane z ustawień globalnych środowiska KDE.
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.
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.
Kolor wykorzystywany dla tła paska znaczników, numerów linii i znacznika zwijania po lewej stronie edytora (jeżeli jest widoczny)
Kolor ten wykorzystywany jest dla numerów linii wyświetlonych po lewej stronie okna edycyjnego (jeżeli są widoczne).
Kolor ten, wykorzystywany jest do podświetlania tła par odpowiadających sobie wzajemnie nawiasów w kodzie programu.
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.
W kolorze tym wyświetlane są znaczniki tabulacji.
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.
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.
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ąć kolor tła, należy nacisnąć prawym przyciskiem i skorzystać z menu kontekstowego.
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 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ąć 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.
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.
Wybranie pozycji, powoduje iż naciśnięcie klawisza "Home" przesuwa kursor na początek tekstu w wierszu, pomijając ewentualne znaki wcięcia.
Podczas przesuwania kursora za pomocą lewego i prawego 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.
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.
Opcja ta zmienia zachowanie kursora, w przypadku naciśnięcia klawiszy Page Up lub Page Down. 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.
Określa liczbę wierszy, które program stara się pokazywać ponad i pod aktualną pozycją kursora.
Zaznaczony fragment zostanie zastąpiony przez wprowadzany tekst, zaś przesunięcie kursora zlikwiduje zaznaczenie.
Zaznaczenie pozostanie aktywne nawet po przesunięciu kursora czy też wprowadzeniu tekstu.
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 i wcięcia
.
Włączenie opcji, spowoduje wyświetlanie przez KWrite 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 KWrite.
Jeśli opcja Zamień tabulację na spacje jest włączona, to pole określa liczbę spacji, na które edytor automatycznie zmieni każdy znak tabulacji.
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 Zawijaj wyrazy na:.
Opcja włącza lub wyłącza statyczne zawijanie wyrazów
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 -> w karcie: Edycja. Znacznik zawijania wyrazów widoczny jest jedynie w przypadku użycia czcionki o stałej szerokości.
Jeśli opcja Zawijanie wyrazów jest wybrana, to pole określa liczbę znaków w linii, przy której edytor automatycznie rozpocznie nową linię.
Włączenie tej opcji powoduje, że KWrite automatycznie usunie dodatkowe spacje na końcu linii tekstu.
Włączenie tej opcji powoduje, że po wpisaniu lewego nawiasu ([, (, or {) KWrite automatycznie doda prawy nawias (odpowiednio: }, ), or ]) po prawej stronie kursora.
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 .
Pozwala na określenie pochodzenia tekstu, który KWrite wstawi automatycznie w oknie dialogowym wyszukiwania. Dostępne są następujące opcje do wyboru:
Nigdzie: Żaden tekst nie zostanie wstawiony.
Tylko zaznaczenie: Używa zaznaczonego fragmentu jako tekstu wyszukiwanego.
Zaznaczenie, potem bieżące słowo: Używa zaznaczonego fragmentu (jeżeli dostępny), w przeciwnym wypadku wprowadza bieżące słowo.
Tylko bieżące słowo: Używa słowa, na którym aktualnie znajduje się kursor.
Bieżące słowo, potem zaznaczenie: Używa bieżącego słowa, a jeśli brak to zaznaczenia.
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.
Automatycznie wstawia otwierający znak Doxygen "*" w czasie pisania w komentarzu w formacie Doxygena. Opcja jest aktywna tylko jeśli ma znaczenie.
Powoduje zamianę znaku tabulacji na zdefiniowaną poniżej Liczbę spacji:
Powoduje użycie zarówno znaków tabulacji jak i spacji dla wcięć.
Pozwala na ustawienie liczby spacji, używanych do wcięć po wybraniu opcji Użyj spacji zamiast znaków Tab do wcięć.
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.
Wcięcie większe niż wybrana liczba spacji nie będzie pomniejszone.
Pozwala na użycie klawisza Tab do wstawiania wcięć.
Pozwala na użycie klawisza Backspace do zmniejszania wcięć.
Powoduje iż naciśnięcie klawisza Tab wprowadza znaki wcięcia.
Powoduje iż naciśnięcie klawisza Tab wprowadza znaki tabulacji.
Powoduje iż naciśnięcie klawisza Tab wcina bieżącą linię.
Ustawia domyślne kodowanie znaków dla plików.
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.
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.
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.
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.
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.
KWrite automatycznie usunie dodatkowe spacje na końcu wierszy w tekście, podczas operacji zapisu lub odczytu pliku.
Program będzie przeszukiwał każdy katalog wgłąb na określoną liczbę poziomów, w poszukiwaniu pliku konfiguracji KWrite i załadowania go.
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 ~.
Powoduje włączenie tworzenia kopii zapasowej dla plików lokalnych.
Włącza tworzenie kopii zapasowych plików zdalnych.
Tekst dodany przed nazwą pliku oryginalnego przy tworzeniu kopii zapasowej.
Tekst dodany do nazwy pliku oryginalnego przy tworzeniu kopii zapasowej.
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.
Pole listy rozwijanej pozwalające wybrać rodzaj dokumentu/języka programowania, dla którego wprowadzane są zmiany.
Wyświetla informacje o wybranej regule podświetlania: nazwisko autora oraz rodzaj licencji.
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.
Naciśnięcie przycisku asystenta otwiera okno dialogowe, co pozwala wybrać typ MIME z listy dostępnych typów.
Pole Rozszerzenia nazw plików zostanie automatycznie uzupełnione, zgodnie z wybranymi typami mime.
Ustawia priorytet dla danej reguły podświetlania.
Naciśnięcie tego przycisku pozwala na pobranie nowych lub zaktualizowanych reguł podświetlania składni ze strony WWW programu Kate.
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.
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.
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.
Aby usunąć zdefiniowany typ pliku, należy wybrać go korzystając z przycisku listy rozwijanej, a następnie nacisnąć przycisk Usuń.
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 typu pliku, pojawia się jako pozycja w menu ->
Nazwa sekcji, pozwala na właściwą organizację wyświetlania typów plików w menu. Jest też używana w menu ->.
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.
Pełna lista możliwych zmiennych dostępna jest w podręczniku.
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 wprowadza się listę masek, rozdzieloną średnikami.
Naciśnięcie przycisku asystenta wyświetla okno dialogowe pozwalające na łatwy wybór typu MIME.
Konfiguruje priorytet danego typu pliku. Jeżeli do danego pliku, można dopasować kilka typów, to wybierany jest ten o najwyższym priorytecie.
Możliwa jest tu zmiana konfiguracji skrótów klawiszowych. Wybranie polecenia i zaznaczenie pola opcji: Własny powoduje otwarcie okna, w którym użytkownik definiuje pożądaną kombinację klawiszy.
Pole wyszukiwania pozwala na szybkie odszukanie polecenia i sprawdzenie jego skrótu klawiszowego.
W tej karcie pojawi się lista wszystkich dostępnych wtyczek. Można je w tym oknie włączyć. Po włączeniu wtyczki przycisk staje się aktywny, dzięki czemu można skonfigurować wybraną wtyczkę.
KWrite Prawa autorskie (c) 2001 dla zespołu Kate.
Na podstawie pierwotnej wersji KWrite, Prawa autorskie (c) 2000 dla Jochen Wilhelmy (digisnap AT cs.tu-berlin.de)
Współpraca:
Christoph Cullmann (cullmann AT kde.org)
Michael Bartl (michael.bartl1 AT chello.at)
Phlip (phlip_cpp AT my-deja.com)
Anders Lund (anders AT alweb.dk)
Matt Newell (newellm AT proaxis.com)
Joseph Wenninger (kde AT jowenn.at)
Jochen Wilhely (digisnap AT cs.tu-berlin.de)
Michael Koch (koch AT kde.org)
Christian Gebauer (gebauer AT kde.org)
Simon Hausmann (hausmann AT kde.org)
Glen Parker (glenebob AT nwlink.com)
Scott Manson (sdmanson AT altel.net)
John Firebaugh (jfirebaugh AT kde.org)
Dokumentacja pierwotna: Thad McGinnis (ctmcginnis AT compuserve.com)
Uaktualnienie: Anne-Marie Mahfouf (annma AT kde.org)
oraz Anders Lund (anders AT alweb.dk)
Ta wersja podręcznika KWrite została opracowana na podstawie oryginału autorstwa: Christian Tibirna (tibirna AT kde.org)
Konwersja na format docbook oraz korekta przez: Lauri Watts (lauri AT kde.org)
Polskie tłumaczenie: (c) 2005 Mandriva Poland(biuro AT mandriva.pl)
Polskie tłumaczenie: (c) 2006 Krzysztof Woźniak(wozniakk AT ceti.pl)
Ta dokumentacja jest rozprowadzana na zasadach Licencji GNU Free Documentation License.
Ten program jest rozprowadzany na zasadach Licencji GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team