# 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, ⪚, 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ń.