zmiana struktury w narzędziach

docs/tools/bazy/index.rst

@@ -0,0 +1,69 @@
+.. _bazy-danych:
+
+Baza SQLite
+###########
+
+W wielu projektach nie ma potrzeby wykorzystywania dużych i skomplikowanych systemów zarządzania
+bazami danych takich jak MySQL, MariaDB czy PostgreSQL. Lepiej skorzystać
+z prostszej `bazy SQLite <https://www.sqlite.org/>`_, która ma jednak duże możliwości.
+Do zarządzania bazami danych SQLite'a, które przechowywane są w pojednyczych plikach,
+wykorzystuje się **interepreter** działający w terminalu.
+
+Linux
+=====
+
+Do instalacji możemy użyć polecenia:
+
+.. code-block:: bash
+
+    ~$ sudo apt-get install sqlite3
+
+Narzędzie uruchamiany komendą ``sqlite3``. Podstawowe polecenia:
+
+.. code-block:: bash
+
+    ~$ sqlite3 baza.db // otwarcie pliku z bazą
+    ~$ sqlite3 baza.db < schemat.sql // utworzenie bazy na podstawie pliku .sql
+    sqlite> .tables // lista tabel
+    sqlite> .help // lista poleceń interpretera
+    sqlite> .schema tabela // pokazuje klauzulę CREATE dla podanej tabeli
+    sqlite> .quit // wyjście z interpretera
+
+Windows
+=======
+
+Ze strony `SQLite3 Download Page <https://www.sqlite.org/download.html>`_
+z sekcji *Precompiled Binaries for Windows* pobieramy archiwum *sqlite-tools-win32-(...).zip*.
+Następnie należy je rozpakować najlepiej do katalogu będącego w ścieżce systemowej.
+Interpreter uruchamiamy albo poleceniem ``sqlite3`` albo podwójnym kliknięciem.
+
+Narzędzia GUI
+=============
+
+Bardzo dobrym narzędziem z interfejsem graficznym jest polski program `SQLiteStudio <http://sqlitestudio.pl/>`_.
+Najnowsze wersje pobierzemy ze strony `repozytorium <https://github.com/pawelsalawa/sqlitestudio/releases>`_
+programu w serwisie Github.
+
+W systemie Linux pobieramy pierwszy plik o nazwie ``InstallSQLiteStudio-3.2.1``.
+Nadajemy mu uprawnnienia wykonywalności w menedżerze plików lub w terminalu:
+
+.. code-block:: bash
+
+    ~/Pobrane$ chmod a+x InstallSQLiteStudio-3.2.1
+
+W systemie Windows pobieramy plik ``InstallSQLiteStudio-3.2.1.exe``.
+
+Instalatory uruchamiamy podwójnym kliknięciem i postępujemy wg instrukcji. Po zainstalowaniu program
+uruchamiamy poleceniem ``sqlitestudio``.
+
+.. figure:: ../img/sqlitestudio.png
+
+Inne programy obsługujące bazę SQLite3 to np. angielskojęzyczne `DB Browser for SQLite <http://sqlitebrowser.org/>`_
+i `DBeaver Community Edition <https://dbeaver.io/>`_.
+
+Materiały
+=========
+
+1. `Interpreter SQLite3`_
+
+.. _Interpreter SQLite3: https://www.sqlite.org/cli.html

docs/tools/cpp/index.rst

@@ -0,0 +1,57 @@
+.. _kompilator-cpp:
+
+Kompilator C/C++
+################
+
+W systemie **Linux** potrzebne narzędzia są zazwyczaj obecne, ale w razie potrzeby wystarczy
+doinstalować pakiet ``gcc`` odpowiednim menedżerem pakietów, np.:
+
+.. code-block:: bash
+
+    ~$ sudo apt-get install gcc
+
+
+W **MS Windows** instalujemy minimalistyczne środowisko deweloperskie
+dostarczające wolne narzędzia :term:`GNU Compiler Collection`, czyli `MinGw`_. W tym
+celu pobieramy instalator `mingw-get-setup.exe <http://sourceforge.net/projects/mingw/files/Installer>`_
+i uruchamiamy.
+
+.. figure:: ../img/mingw01.jpg
+
+W oknie wyboru pakietów zaznaczamy widoczne poniżej paczki, w tym przede wszystkim
+``mingw32-gcc-g++``, a następnie wybieramy polecenie *Installation/Apply*.
+
+.. figure:: ../img/mingw02.jpg
+
+Po pobraniu i rozpakowaniu wskazanych narzędzi oraz zakończeniu instalatora (*Close*)
+trzeba dodać do ścieżki systemowej położenie kompilatora i linkera;
+dzięki temu będzie można korzystać z tych i innych narzędzi bezpośrednio
+z Geany lub okienka konsoli tekstowej. W oknie "Uruchamianie" (:kbd:`WIN+R`)
+wpisujemy polecenie wywołujące okno "Zmienne środowiskowe" – można je również
+uruchomić z okna właściwości komputera:
+
+.. figure:: ../img/mingw03.jpg
+.. figure:: ../img/mingw04.jpg
+
+Klikamy przycisk *Nowa* i tworzymy nową zmienną użytkownika zgodnie z podanym
+zrzutem:
+
+.. figure:: ../img/mingw05.jpg
+.. figure:: ../img/mingw06.jpg
+
+.. tip::
+
+    Powyżej przedstawiliśmy instalację narzędzi :term:`MinGw` z konta zwykłego
+    użytkownika. Można w razie potrzeby czynności te wykonać również z konta administratora,
+    co pozwoli udostępnić narzędzia wszystkim użytkownikom. Podobnie
+    ścieżkę do kompilatora itd. można dopisać do zmiennej systemowej ``PATH``,
+    dzięki czemu wszyscy użytkownicy będą mogli wywoływać narzędzia bez
+    podawania pełnej ich lokalizacji.
+
+Materiały
+=========
+
+1. `MinGw`_
+
+.. _MinGw: http://www.mingw.org/
+

docs/tools/edytory/index.rst

@@ -0,0 +1,28 @@
+.. _edytory:
+
+Edytory
+#######
+
+.. _geany-opis:
+
+Geany
+=====
+
+`Instrukcja instalacji Geany <http://python101.readthedocs.io/pl/latest/env/ide.html#geany>`_
+
+.. _st3-opis:
+
+Sublime Text 3
+==============
+
+Sublime Text 3 to profesjonalny edytor dla programistów, który właściwie skonfigurowany
+bardzo dobrze nadaje się do pisania programów w wielu językach, m.in. w Pythonie.
+Zobacz: `instalacja i konfiguracja ST3 <http://python101.readthedocs.io/pl/latest/env/ide.html#sublime-text-3>`_.
+
+Materiały
+=========
+
+1. `Edytor Geany`_
+
+.. _Edytor Geany: http://www.geany.org/
+

docs/tools/glossary.rst

@@ -0,0 +1,83 @@
+Słownik
+===========
+
+.. glossary::
+
+    Qt
+        zestaw bibliotek programistycznych ułatwiających tworzenie aplikacji
+        z interfejsem graficznym w językach C++, QML i Java.
+
+    środowisko IDE
+        zintegrowane środowisko programistyczne (ang. Integrated Development Environment, IDE),
+        składające się z jednej lub wielu aplikacji, umożliwiające tworzenie,
+        testowanie, budowanie i uruchamianie kodu.
+
+    Qt Creator
+        wieloplatformowe :term:`środowisko IDE` dla aplikacji pisanych
+        w językach C++, JavaScript i QML.
+        Zawiera m.in. `debugger <http://pl.wikipedia.org/wiki/Debugger>`_
+        i edytor GUI (graficznego interfejsu użytkownika).
+
+    MinGw
+        ang. *Minimalist GNU for Windows*; minimalistyczne środowisko
+        dostarczające narzędzia GNU (linker, kompilator itd.) pozwalające
+        na kompilację natywnych plików wykonywalnych dla Windows
+        z kodu pisanego w C/C++.
+
+    GNU Compiler Collection
+        zestaw kompilatorów do różnych języków programowania rozwijany
+        w ramach projektu GNU i udostępniany na licencji GPL oraz LGPL.
+        Zob. hasło w `Wikipedii <http://pl.wikipedia.org/wiki/GNU_Compiler_Collection>`__.
+
+    GPL
+        ang. GNU General Public License – licencja wolnego i otwartego
+        oprogramowania stworzona w 1989 roku przez Richarda Stallmana
+        i Ebena Moglena na potrzeby Projektu GNU. Ostatnia wersja, trzecia,
+        opublikowana została 29 czerwca 2007 r.
+        Zob. hasło w `Wikipedii <http://pl.wikipedia.org/wiki/GNU_General_Public_License>`__.
+
+    Debian
+        jedna z najstarszych i wiądących dystrybucji Linuksa, umożliwia
+        elastyczną konfigurację systemu i dostosowanie go do własnych potrzeb.
+        Jak większość dystrybucji, umożliwia wybór wielu środowisk graficznych,
+        np. XFCE lub Gnome.
+
+    Xubuntu 14.04
+        odmiana jednej z najpopularniejszych dystrybucji Linuksa, Ubuntu,
+        dostarczana z klasycznym, lekkim i konfigurowlanym środowiskiem
+        graficznym XFCE.
+
+    środowisko graficzne
+        w systemach linuksowych zestaw oprogramowania tworzący GUI, czyli graficzny
+        interfejs użytkownika, często zawiera domyślny wybór aplikacji przeznaczonych
+        do wykonywania typowych zadań. Najpopularnijesze środowiska to `XFCE`_,
+        `Gnome`_, `KDE`_, `LXDE`_, `Cinnamon`_, `Mate`_.
+
+    serwer WWW
+        (ang. web server) – oprogramowanie obsługujące protokół http, podstawowy protokół sieci WWW,
+        służący przesyłaniu dokumentów hipertekstowych.
+
+    interpreter
+        program, który analizuje kod źródłowy, a następnie go wykonuje. Interpretery są
+        podstawowym składnikiem języków wykorzystywanych do pisania skryptów wykonywanych
+        po stronie klienta WWW (`JavaScript`_) lub serwera (np. Python, `PHP`_).
+
+    system bazodanowy
+        system zarządzania bazą danych (ang. Database Management System, DBMS) – oprogramowanie
+        służące do zarządzania bazami danych, np. SQLite, MariaDB, MySQL, PostgreSQL.
+
+    framework
+        (ang. framework – struktura) – oprogramowanie będące zestawem narzędzi ułatwiających
+        i przyśpieszających tworzenie aplikacji.
+
+.. _Debian: https://www.debian.org/index.pl.html
+.. _Ubuntu: http://ubuntu.pl
+.. _Xubuntu: http://xubuntu.org/
+.. _Gnome: http://pl.wikipedia.org/wiki/GNOME
+.. _KDE: http://pl.wikipedia.org/wiki/KDE
+.. _LXDE: http://pl.wikipedia.org/wiki/LXDE
+.. _Cinnamon: http://en.wikipedia.org/wiki/Cinnamon_%28software%29
+.. _Mate: http://pl.wikipedia.org/wiki/MATE
+.. _XFCE: http://www.xfce.org/
+.. _JavaScript: http://pl.wikipedia.org/wiki/JavaScript
+.. _PHP: http://pl.wikipedia.org/wiki/PHP

docs/tools/index.rst

@@ -3,11 +3,6 @@ Narzędzia
 
 .. _tools:
 
-Poniżej przedstawiamy zestaw przykładowych narzędzi informatycznych.
-
-.. contents:: Spis treści
-    :backlinks: none
-
 .. note::
 
     Przykłady poleceń wydawanych w terminalu będziemy podawali dla systemu Debian
@@ -23,10 +18,14 @@ Poniżej przedstawiamy zestaw przykładowych narzędzi informatycznych.
 Spis treści:
 
 .. toctree::
-    :maxdepth: 2
-
-    tools.rst
-    python/index
-    lamp/index
-    git/index
-    sphinxrst.rst
+   :maxdepth: 2
+
+   python/index
+   cpp/index
+   edytory/index
+   git/index
+   lamp/index
+   bazy/index
+   qt/index
+   sphinxrst.rst
+   glossary.rst

docs/tools/qt/index.rst

@@ -0,0 +1,53 @@
+.. _biblioteka-qt:
+
+Biblioteka Qt
+#############
+
+:term:`Qt` to zestaw bibliotek przeznaczonych dla języka C++, QML i Java,
+który znakomicie ułatwia tworzenie graficznego interfejsu użytkownika.
+Zawiera również klasy udostępniające obsługę m.in. multimediów , sieci
+czy baz danych.
+
+System i środowisko IDE
+=======================
+
+Bilioteka :term:`Qt` jest przenośna z założenia, więc programować z jej wykorzystaniem
+można w wielu systemach i środowiskach. Proponujemy system Linux,
+np. dystrybucję :term:`Debian` (v. Jessie) lub :term:`Xubuntu 14.04`.
+Instalacja wymaganych narzędzi sprowadza się do wydania prostych poleceń
+w terminalu:
+
+.. code-block:: bash
+
+    ~$ sudo apt-get update
+    ~$ sudo apt-get install qtcreator qt5-qmake qt5-default qt4-qtconfig
+
+Pierwsze polecenie zaktualizuje repoytoria, czyli wersje dostępnego oprogramowania;
+drugie zainstaluje dedykowane :term:`środowisko IDE`, które pozwala projektować
+interfejs graficzny, bardzo ułatwia edycję kodu, pozwala budować, uruchamiać
+i debugować różne wersje tworzonych aplikacji.
+
+Qt5 w systemie Windows
+========================
+
+Instalacja jest bardzo prosta. Pobieramy `Qt Online Installer for Windows <https://www.qt.io/download-open-source/>`_
+i uruchamiamy. Następnie przeprowadzamy standardową instalację z domyślnymi
+ustawieniami, podając w razie potrzeby hasło administratora.
+
+.. figure:: ../img/qtwin01.jpg
+
+.. figure:: ../img/qtwin02.jpg
+
+Wygląd i działanie aplikacji :term:`Qt Creator` w systemie Linux i Windows są
+takie same.
+
+.. figure:: ../img/qtcreator.png
+
+Materiały
+=========
+
+1. `Biblioteka Qt`_
+2. `Qt Creator`_
+
+.. _Biblioteka Qt: https://qt-project.org/
+.. _Qt Creator: http://pl.wikipedia.org/wiki/Qt_Creator