.. _edytory: Edytory ####### Edytory programistyczne to edytory plików źródłowych zapisywanych w postaci tekstu. Wszystkie oferują mechanizmy ułatwiające kodowanie, takie jak kolorowanie składni, wsparcie standardów kodowania, automatyczne domykanie nawiasów, cudzysłowów, tagów, autowcięcia, dopełnianie poleceń, czy wreszcie kompilowanie, budowanie i uruchamianie tworzonego kodu. Wymienione poniżej edytory mają budowę modułową, tzn. obsługują wtyczki, za pomocą których rozszerzamy możliwości programu. .. _geany-opis: Geany ===== .. figure:: ../img/geany01.png `Geany `_ to proste i lekkie środowisko IDE dostępne na licencji `GNU General Public Licence `_. Linux ---------------- W systemach linuksowych korzystamy z dedykowanych menedżerów, np. w systemach opartych na Debianie (MX Linux, Ubuntu, Linux Mint) wystarczy wpisać w terminalu: .. code-block:: bash ~$ sudo apt-get install geany geany-plugins W Ubuntu można też skorzystać z graficznego instalatora "Oprogramowanie". .. figure:: ../img/geany02.png Windows ------------------ Ze strony `Download / Releases `_ ściągamy instalator *geany-1.38_setup.exe* (wersja może być nowsza) i uruchamiamy. Podczas instalacji nic nie musimy zmieniać. Następnie ze strony `Download Geany-Plugins `_ pobieramy *geany-plugins-1.38_setup.exe* (wersja może być nowsza) i doinstalowujemy wtyczki. Podczas instalacji niczego nie musimy zmieniać. Konfiguracja ------------ Dodatkowe **schematy kolorowania** składni można pobrać ze strony `Geany Themes on GitHub `_. Katalog :file:`colorschemes` należy skopiować do katalogu konfiguracyjnego edytora, np. w systemie Linux będzie to :file:`~/.config/geany`. Wyboru schematu kolorowania dokonujemy w menu *Widok / Schematy kolorów*. **Wtyczki** włączamy w menu `Narzędzia / Menedżer wtyczek`. Warto zaznaczyć przynajmniej "Addons" i "Przeglądarka plików". Zanim wyjdziemy z okna naciskamy przycisk "Preferencje" i na zakładce "Przeglądarka plików" zaznaczamy opcję "Podążanie za ścieżką do bieżącego pliku". W menu `Edycja / Preferencje` :kbd:`CTRL+ALT+P` w zakładce `Edytor / Wcięcia` zaznaczamy opcje, jak na zrzucie poniżej: .. figure:: ../img/geany03.png W następnej zakładce `Auto-uzupełnianie` zaznaczmy m.in. domykanie nawiasów: .. figure:: ../img/geany04.png Czcionki można dostosować w `Edycja / Preferencje / Interfejs`. Kodowanie --------- W zależności od języka programowania nowe pliki można tworzyć na podstawie szablonów: `Plik / Nowy z szablonu`. Menu *Zbuduj* zawiera polecenia kompilacji (:kbd:`F8`), budowania (:kbd:`F9`) oraz uruchamiania kodu (:kbd:`F5`). Narzędzia wykorzystywane do wykonywania tych akcji definiujemy w *Zbuduj / Zdefiniuj polecenia budowania*. Np. dla kodu Pythona warto (zwłaszcza w systemie Linux) wskazać interpreter w wersji 3: .. figure:: ../img/geany05.png Wcięcia wstawiają się automatycznie lub poprzez naciśnięcie klawisza :kbd:`TAB`. Jeżeli chcielibyśmy wciąć od razu cały blok kodu, zaznaczamy go i również używamy :kbd:`TAB` lub :kbd:`CTRL+I`, zmniejszenie wcięcia uzyskamy naciskając :kbd:`CTRL+U`. .. _st3-opis: Sublime Text ============== .. figure:: ../img/st301.png Sublime Text to szybki, lekki i elastyczny edytor dla programistów. Wybrane narzędzia: * szybkie i wygodne otwieranie plików: :kbd:`CTRL+P`, * wielokrotna selekcja i edycja: po zaznaczeniu zmiennej :kbd:`CTRL+D`, * zaznaczenie wszystkich wystąpień i jednoczesna edycja: :kbd:`ALT+F3`, * lista wszystkich poleceń: :kbd:`CTRL+SHIFT+P`, * lista wszystkich definicji: :kbd:`CTRL+R`, * równoczesna edycja kilku plików: *View / Layout*, * pokazanie / ukrycie panelu bocznego: :kbd:`CTRL+K, CTRL+B`. Linux ------- W systemach opartych na Debianie (MX Linux, Ubuntu, Linux Mint) wchodzimy na stronę `Linux Package Manager Repositories `_ i wykonujemy instrukcje dla menedżera `apt` wybierając wersję stabilną (ang. *stable*). .. figure:: ../img/st302.png W Windows ------------------ Po wejściu na stronę `Sublime Text – Download `_ pobieramy instalator. Instalujemy standardowo dwukrotnie klikając pobrany plik. Konfiguracja ------------ Konfiguracja wszystkich ustawień wymaga przeczytania dokumentacji programu oraz instalowanych wtyczek. Zamiast tego możesz spróbować wgrać przygotowane archiwa, które znajdziesz w serwisie GitHub pod adresem `lo1cgsan/konfig `_. Archiwum dla Linuksa (`st3-linux.tgz`) po pobraniu wypakuj poleceniem: .. code-block:: bash ~/Pobrane$ tar xzvf st3-linux.tgz -d ~/.config Archiwum dla Windowsa (`st3-windows.zip`) wypakuj przy użyciu wbudowanego lub zainstalowanego menedżera archiwum do katalogu: :file:`C:\\Użytkownicy\\nazwa_użytkownika\\Dane aplikacji` lub :file:`C:\\Users\\nazwa_użytkownika\\AppData\\Roaming`. Systemy budowania ----------------- Do kompilacji (budowania) i uruchamiania Sublime Text wykorzystuje tzw. systemy budowania. Dostępne systemy sprawdzisz i wybierzesz w *Tools / Build System*. W archiwach konfiguracyjnych dodane zostały systemy budowania języka Python. Jeżeli z nich skorzystasz: * szkielet skryptu Pythona wstawisz wpisując "py" i naciskając klawisz :kbd:`TAB`; * skrypty Pythona uruchomisz naciskając :kbd:`CTRL+SHIFT+R`; * interaktywną konsolę otworzysz po naciśnięciu :kbd:`CTRL+SHIFT+P`, wpisaniu `python3` i wybraniu "SublimeREPL: Python3" * lokalne pliki HTML otworzysz w przeglądarce (domyślnie Mozilla Firefox) naciskając :kbd:`CTRL+B` i wybierając "Browser" * pliki źródłowe C++ skompilujesz / uruchomisz naciskając :kbd:`CTRL+SHIFT+B` i wybierając "C++" / "C++ - Uruchom". Repozytoria Git-a ----------------- Repozytoria obsłużymy za pomocą: * wtyczki `GitSavvy `_ (jest zawarta w archiwach) – wciśnij :kbd:`CTRL+SHIFT+P`, wpisz "git" i wybierz "git:status"; * lub dedykowanego programu `Sublime Merge `_. W systemie Linux Ubuntu itp., jeżeli dodaliśmy wcześniej repozytoria dla SublimeText3, wystarczy wydać polecenie: .. code-block:: bash $ sudo apt install sublime-merge W Windows pobieramy instalator ze strony `Download `_ i instalujemy. Poprawnie zainstalowany program można wywołać z poziomu SublimeText, jeżeli otworzyliśmy katalog zawierający repozytorium. Wystarczy kliknąć charakterystyczną dla Gita rozgałęzioną ikonę na dolnym pasku statusu. Wtyczki ------- Poniżej uwagi dla tych, którzy chcą samodzielnie instalować wtyczki. Wtyczki do ST przechowywane są w repozytorium `Package Control `_, zarządzamy nimi z poziomu edytora. Instalacja każdej wtyczki polega na wywołaniu listy poleceń :kbd:`CTRL+SHIFT+P` i wpisaniu *Install Package*. Na początku trzeba zainstalować wtyczkę *Package Control*: wpisz *Install Package Control* i zatwierdź :kbd:`Enter`. W podobny sposób instalujemy inne wtyczki. Na początek warto zainstalować następujące: * `Anaconda `_ – podstawowy dodatek do programowania w Pythonie dostępny w menu podręcznym podczas edycji plików ".py" * `SublimeREPL `_ – pozwala uruchamiać kod Pythona w terminalu osadzonym w edytorze za pomocą skrótu :kbd:`CTRL+SHIFT+R` * `Emmet `_ – rozszerzanie / uzupełnianie składni HTML, CSS itp. * `View in Browser `_ – otwiera edytowane dokumenty HTML w przeglądarce (domyślnie Firefox), ale można to zmienić w konfiguracji: *Preferences > Package Settings > View In Browser* * `Color Picker `_ – dodaje próbnik kolorów wywoływany skrótem :kbd:`CTRL+SHIFT+C` Ustawienia wtyczek opisane są w dokumentacji. Globalne ustawienia edytora definiujemy w *Preferences > Settings – User*. Ustawienia dla wybranego języka programowania dostępne są po wybraniu *Preferences > Settings – More > Syntax Specific – User*, ewentualne zmiany należy zapisać pod nazwą *LANGUAGE.sublime-settings*, np. *Python.sublime-settings* w podkatalogu :file:`Packages/User`. .. tip:: Położenie i zawartość katalogu, o którym mowa powyżej, możesz sprawdzić wybierając *Preferences / Browse Packages* i wchodząc do katalogu :file:`User`. VS Code ======= .. figure:: ../img/vscodium.png `Visual Studio Code `_ to otwartoźródłowy edytor programistyczny firmy Microsoft. Wykorzystuje framework Electron napisany w języku Java Script, dlatego zajmuje relatywnie dużo miejsca i jest wolniejszy od aplikacji tworzonych w innych językach. Oferuje jednak wiele przydatnych narzędzi (m. in. wbudowana obsługa Gita) i ułatwień, działa na różnych systemach. Linux ----- Wersje binarne przygotowywane przez Microsoft nie są zgodne z zasadami `licencji FLOSS `_, zawierają również telemetrię. Dlatego lepiej użyć wersji przygotowanych w ramach projektu `VSCodium `_. W systemach opartych na Debianie (MX Linux, Ubuntu, Linux Mint) na stronie projektu klikamy "INSTALL" i postępujemy zgodnie z instrukcjami z sekcji "Install with Package Manager (Linux) -> Debian / Ubuntu (deb package)". Windows ------- Ze strony `Download Visual Studio Code `_ pobieramy wersję "User" (instalacja dla jednego użytkownika) lub "System installer" (instalacja ogólnosystemowa) i instalujemy. Konfiguracja ------------ Jak każdy profesjonalny edytor programistyczny, program wymaga poznania odpowiednich skrótów klawiaturowych i doinstalowania dodatków zależnych od używanego języka programowania. Pomaga w tym bardzo dobrze przygotowana dokumentacja dla większości języków, np.: * `Python `_ * `C++ `_ * `HTML `_ * `CSS itd. `_ * `PHP `_ Dostępne są również przewodniki omawiające programnowanie w wybranych językach, np.: * `Getting Started with Python in VS Code `_ * `Using GCC with MinGW `_ * `Using C++ on Linux in VS Code `_ Wspomnieć można, że wersja dla Windowsa pozwala zainstalować dodatek umożliwiający pracę na projektach zapisanych w środowisku `WSL (Windows Subsystem for Linux) `_. Nie jest to co prawda rozwiązanie dorównujące wygodzie programowania w Linuksie, ale jako proteza wystarczy. Python ------ * Po zainstalowaniu rozszerzenia Microsoft "Python" i otwarciu skryptu Pythona, możesz zobaczyć komunikat typu "Linter pylint is not installed", wybierz wtedy "Install". * Błędy składniowe w skryptach zobaczysz po naciśnięciu :kbd:`CTRL+SHIFT+M` * Skrypty Pythona uruchomisz używając ikony w prawym górnym rogu okna edytora lub z menu podręcznego "Run Python File in Terminal". * Interaktywny interpreter Pythona wywołasz po naciśnięciu :kbd:`CTRL+SHIFT+P` i wpisaniu "Python: Start REPL". C++ ----- * Po zainstalowaniu rozszerzenia Microsoft "C/C++" trzeba utworzyć nowe zadanie budowania plików C++, należy postąpić zgodnie z instrukcjami na stronie dokumentacji C++ Edytora (zobacz wyżej). Po utworzeniu zadania kompilację wywołujemy naciśnięciem :kbd:`CTRL+SHIFT+B`, natomiast pliki wynikowe uruchamiamy ręcznie w terminalu. PyCharm ======= .. figure:: ../img/pycharm2022.png PyCharm to profesjonalne, komercyjne środowisko programistyczne dostępne za darmo do celów szkoleniowych. Interfejs nie został na razie spolszczony. To IDE doskonale wspiera proces uczenia się. Udostępnia nawigację po kodzie, podpowiedzi, wykrywa błędy i ma wbudowanych wiele innych udogodnień. Najprościej zainstalować Zarówno w systemach Linux, jak i MS Windows, na początku pobieramy i instalujemy aplikację `Toolbox App `_. Po jej uruchomieniu wybieramy instalację PyCharma w wersji Professional (po okresie próbnym wymaga rejestracji) lub Community (darmowa). Bezpłatna licencja ------------------ Każdy nauczyciel może wystąpić o klucz licencyjny przy pomocy `formularza `_ dostępnego na stronie producenta. Polski słownik -------------- W programie możemy włączyć sprawdzanie polskiej pisowni. Naciskamy :kbd:`Ctrl+Alt+S` i wyszukujemy "languages" i na zakładce "Natural Languages" dodajemy język polski.