# Użycie &kturtle;

Zrzut ekranowy &kturtle; podczas jego pracy
Okno główne &kturtle;

Okno główne &kturtle; składa się z trzech głównych części: edytora (1) po lewej, gdzie wpisujesz polecenia &turtlescript;, płótna (2) po prawej, gdzie rysuje żółw i podglądu (3), wyświetlającego informację w czasie działania programu. Oprócz nich znajdziesz: pasek menu (5), skąd mogą być wybrane wszystkie akcje, pasek narzędzi (4), który pozwala na szybki wybór najczęściej używanych akcji, konsola, której możesz używać do testowania jednego, wpisanego wiersza, oraz pasek stanu (wzdłuż dolnej krawędzi okna), gdzie znajdziesz aktualny stan działania &kturtle;.

## Edytor

W edytorze wprowadza się polecenia &turtlescript;. Większość funkcji edytora można znaleźć w menu Plik i Edycja. Edytor może być dowolnie przesuwany, przyczepiany do dowolnego miejsca na oknie głównym, a także może być umieszczony w dowolnym miejscu na pulpicie.

Istnieje kilka sposobów uzyskania kodu w edytorze. Najprostszy to użycie przykładu wybranego z menu Plik Przykłady w menu Plik a następnie wybrać plik. Przykład, który wybrałeś zostanie otwarty w edytorze, możesz użyć Wykonaj Wykonaj z paska menu lub Wykonaj z paska narzędzi, aby uruchomić kod.

Pliki &turtlescript; można otworzyć wybierając Plik Otwórz... .

Trzecim sposobem jest wprowadzenie własnego kodu w edytorze bądź skopiowanie gotowego kodu.

## Płótno

Płótno jest przestrzenią żółwia, gdzie rysuje zgodnie z otrzymywanymi poleceniami. Po wprowadzeniu kodu do Edytora i wykonaniu go, mogą stać się dwie rzeczy: albo kod zostanie wykonany pomyślnie i zobaczysz prawdopodobnie zmianę na płótnie; albo okażę się, że zrobiłeś błąd w kodzie, który jest przyczyną błędu. Pojawi się wtedy komunikat wyjaśniający, gdzie się pomyliłeś.

Możesz dowolnie powiększać i zmniejszać płótno za pomocą koła myszy.

## Podgląd

Podgląd informuje o zmiennych, przyswajanych funkcjach i pokazuje drzewo kodu podczas pracy programu.

Podgląd można umieścić przy dowolnym brzegu okna głównego lub odłączyć i umieścić w dowolnym miejscu na pulpicie.

## Pasek narzędzi

Tutaj możesz szybko dotrzeć do najbardziej użytecznych czynności. Pasek narzędzi zawiera również Konsolę, gdzie możesz szybko wywołać polecenie, co może być użyteczne, kiedy zechcesz testować polecenie bez modyfikowania zawartości Edytora.

Pasek narzędzi można skonfigurować przy użyciu menu Ustawienia Konfiguracja pasków narzędzi... Służy to lepszemu dopasowaniu programu do Twoich preferencji.

## Pasek menu

W pasku menu można znaleźć wszystkie akcje &kturtle;. Pogrupowane są one następująco: Plik, Edycja, Płótno, Wykonaj, Narzędzia, Ustawienia i Pomoc. Pomoc opisuje wszystkie poprzednie.

### Menu Plik

&Ctrl;N Plik Nowy

  Tworzy nowy, pusty plik &turtlescript;.

&Ctrl;O Plik Otwórz...

  Otwiera plik &turtlescript;.

Plik Otwórz poprzedni

  Otwiera ostatnio używany plik &turtlescript;.

Plik Przykłady

  Pokazuje katalog z przykładami programów w &turtlescript;. Przykłady będą w ulubionym języku użytkownika wybranym w menu Ustawienia Język .

Plik Pobierz więcej przykładów...

  Otwiera okno Gorące Nowości, aby pobrać dodatkowe pliki &turtlescript; z internetu.

&Ctrl;S Plik Zapisz

  Zapisuje aktualnie otworzony plik &turtlescript;.

Plik Zapisz jako...

  Zapisuje aktualnie otwarty plik &turtlescript; w wybranej lokalizacji.

Plik Zapisz jako plik HTML...

  Eksportuje obecną zawartość edytora do pliku HTML z zachowaniem kolorowania.

&Ctrl;P Plik Drukuj...

  Rozpoczyna pisanie bieżącego kodu w edytorze.

&Ctrl;Q Plik Wyjście

  Wychodzi z &kturtle;.

### Menu Edycja

&Ctrl;Z Edycja Cofnij

  Anuluje ostatnią zmianę w kodzie. &kturtle; posiada nieskończona liczbę kroków cofania.

&Ctrl;&Shift;Z Edycja Powtórz

  Powtarza ostatnio wprowadzoną zmianę w kodzie.

&Ctrl;X Edycja Wytnij

  Wycina zaznaczony tekst z edytora do schowka.

&Ctrl;C Edycja Kopiuj

  Kopiuje zaznaczony tekst z edytora do schowka.

&Ctrl;V Edycja Wklej

  Wkleja tekst ze schowka do edytora.

&Ctrl;A Edycja Zaznacz wszystko

  Zaznacza cały tekst w edytorze.

&Ctrl;F Edycja Znajdź...

  Znajduje w kodzie wskazaną frazę.

F3 Edycja Znajdź następne

  Znajduje kolejne pojawienie się wyszukiwanej fazy.

&Shift;F3 Edycja Znajdź poprzednie

  Znajduje poprzednie pojawienie się wyszukiwanej fazy.

Ins Edycja Tryb zastępowania

  Przełączanie pomiędzy trybem "wstawiania" i "zastępowania".

### Menu Płótno

Płótno Zapisz jako obrazek PNG...

  Zapisuje obecną zawartość Płótna jako rastrowy obraz typu PNG (ang. Portable Network Graphics).

Płotno Zapisz jako obrazek wektorowy (SVG)...

  Zapisuje obecną zawartość Płótna jako wektorowy obraz typu SVG (ang. Scalable Vector Graphics).

Płótno Drukuj Płótno...

  Drukuje obecną zawartość Płótna.

### Menu Wykonaj

F5 Wykonaj Wykonaj

  Rozpoczyna wykonanie poleceń w edytorze.

F6 Wykonaj Wstrzymaj

  Zatrzymuje wykonanie programu. Akcja dostępna jedynie podczas wykonywania poleceń.

F7 Wykonaj Przerwij

  Przerywa wykonywanie. Akcja dostępna jedynie podczas wykonywania poleceń.

Run Szybko

  Lista możliwych prędkości wykonania składa się z następujących prędkości: Pełna prędkość (bez podświetlania), Szybko, Wolno, Wolniej, Najwolniej i Krok po kroku. Gdy prędkość wykonania ustawiona jest na Szybko (domyślnie), z trudnością można zauważyć, co dzieje się na ekranie. Czasami jest to pożądane, a czasami chcemy zatrzymać ślad wykonania. W tym wypadku należy ustawić prędkość wykonania na Wolno, Wolniej bądź Najwolniej. Gdy wybrana jest któraś z tych prędkości aktualnie wykonywana pozycja będzie wskazywana w edytorze. Krok po kroku wykona tylko jedno polecenie jednocześnie.

### Menu Narzędzia

Narzędzia Wybór kierunku

  To działanie otwiera okno wyboru kierunku.

Narzędzia Wybór koloru...

  To działanie otwiera okno wyboru koloru.

### Menu Ustawienia

Ustawienia Język

  Wybierz język kodu.

&Ctrl;E Ustawienia Pokaż edytor

  Pokazuje lub ukrywa Edytor.

&Ctrl;I Ustawienia Pokaż podgląd

  Pokazuje lub ukrywa Podgląd.

Ustawienia Pokaż błędy

  Pokaż/ukryj kartę Błędy, zawierającą listę błędów, które mogłyby wystąpić po uruchomieniu kodu. Jeśli ta opcja jest włączona, kliknij na Płótno, aby znów zobaczyć żółwia.

F11 Widok Pokaż numery wierszy

  Opcja ta pokazuje numer wiersza w edytorze. Może być użyteczne przy znajdowaniu błędów.

Ustawienia Pokaż pasek narzędzi

  Włączenie głównego paska narzędzi.

Ustawienia Pokaż pasek stanu

  Włączenie/wyłączenie paska statusu.

Ustawienia Konfiguracja skrótów...

  Standardowe okno konfiguracji skrótów &kde;.

Ustawienia Konfiguracja pasków narzędzi...

  Standardowe okno konfiguracji pasków narzędzi &kde;.

### Menu Pomoc

&help.menu.documentation;

F2 Pomoc Pomoc na temat: ...

  to bardzo użyteczna opcja: przewiduje pomoc dla kodu, gdzie znajduje kursor w edytorze. Przykładowo, &eg;, użyłeś polecenia `pisz` w Twoim programie i chciałbyś przeczytać i dowiedzieć się, copodręcznik mówi o tym poleceniu. Wystarczy, że umieścisz kursor w poleceniu `pisz` i naciśniesz F2. Podręcznik pokaże wszystkie informację o poleceniu `pisz`.

  Ta funkcja może okazać się bardzo przydatna w czasie nauki &turtlescript;.

## Pasek statusu

W pasku stanu można znaleźć pomoc dotyczącą działania &kturtle;. Po lewej stronie pokazany jest opis ostatniej czynności. Po prawej stronie można znaleźć obecną lokalizację kursora (numer wiersza i kolumny). W środku paska statusu pokazany jest obecny język poleceń.