Gestures.rst (#7)

MarcinOstaszewski · deshipu · commit 1756264ae2b4 · 2018-02-28T12:17:03.000+01:00
* introduction for buttons * Translated 4 paragraphs of tutorial buttons * First translation for hello.rst * Few fixes for hello.rst * Final fixes * half translated buttons page * next part of page buttons.rst * last part of translation buttons.rst * Update hello.rst according to review comments Fixed as suggested by deshipu in deshipu#3 * Change translation of word "flash" * Grammar fix * Corrections * one word chenged * changed; my propositions: else if -> jeśli jednak; else -> w pozostałych przypadkach * Translate buttons (#2) * introduction for buttons * Translated 4 paragraphs of tutorial buttons * half translated buttons page * next part of page buttons.rst * last part of translation buttons.rst * Corrections * one word chenged * changed; my propositions: else if -> jeśli jednak; else -> w pozostałych przypadkach * Poprawki od Radomira * Kolejne poprawki od Radomira + korekta literówek * Przywrócona właściwa wersja akapitu * tlumaczenie tutoriala modulu Random * Translation of gestures.rst (#1) * update gestures.rst - requested changes and minor corrections * update gestures.rst (#3) * Revert "tlumaczenie tutoriala modulu Random" This reverts commit fce2ece.
diff --git a/docs/tutorials/gestures.rst b/docs/tutorials/gestures.rst
@@ -1,20 +1,22 @@
-Gestures
+Gesty
 --------
 
-The really interesting side-effect of having an accelerometer is gesture
-detection. If you move your BBC micro:bit in a certain way (as a gesture) then
-MicroPython is able to detect this.
+Naprawdę interesującym efektem ubocznym posiadania akcelerometru jest wykrywanie gestów. 
+Jeśli poruszysz swoim micro:bitem w pewien specjalny sposób (jak przy wykonywaniu gestu), 
+MicroPython jest w stanie to wykryć.
 
-MicroPython is able to recognise the following gestures: ``up``, ``down``,
-``left``, ``right``, ``face up``, ``face down``, ``freefall``, ``3g``, ``6g``,
-``8g``, ``shake``. Gestures are always represented as strings. While most of
-the names should be obvious, the ``3g``, ``6g`` and ``8g`` gestures apply when
-the device encounters these levels of g-force (like when an astronaut is
-launched into space).
+MicroPython potrafi rozpoznać następujące gesty: ``up`` (ang. w górę), ``down`` (ang. w dół),
+``left`` (ang. w lewo), ``right`` (ang. w prawo), ``face up`` (ang. zwrócony w górę), 
+``face down`` (ang. zwrócony w dół), ``freefall`` (ang. swobodne spadanie), ``3g``, ``6g``,
+``8g``, ``shake`` (ang. potrząśnięcie). Gesty zawsze są reprezentowane przez ciągi znaków.
+Podczas gdy większość z tych nazw powinna być oczywista, gesty ``3g``, ``6g`` oraz ``8g``
+odnoszą się do sytuacji, w której na urządzenie oddziałują odpowiadające poziomy przeciążenia 
+(jak na astronautę, kiedy jest wystrzeliwany w kosmos).
 
-To get the current gesture use the ``accelerometer.current_gesture`` method.
-Its result is going to be one of the named gestures listed above. For example,
-this program will only make your device happy if it is face up::
+Aby pobrać aktualny gest użyj metody ``accelerometer.current_gesture``.
+Jej wynikiem będzie jeden z nazwanych gestów z powyższej listy. Na przykład,
+ten program sprawi, że Twoje urządzenie będzie szczęśliwe tylko, 
+kiedy będzie zwrócone ku górze::
 
     from microbit import *
 
@@ -25,46 +27,46 @@ this program will only make your device happy if it is face up::
         else:
             display.show(Image.ANGRY)
 
-Once again, because we want the device to react to changing circumstances we
-use a ``while`` loop. Within the *scope* of the loop the current gesture is
-read and put into ``gesture``. The ``if`` conditional checks if ``gesture`` is
-equal to ``"face up"`` (Python uses ``==`` to test for equality, a single
-equals sign ``=`` is used for assignment - just like how we assign the gesture
-reading to the ``gesture`` object). If the gesture is equal to ``"face up"``
-then use the display to show a happy face. Otherwise, the device is made to
-look angry!
+Ponieważ chcemy, aby urządzenie reagowało na zmieniające się okoliczności,
+używamy pętli ``while``. Wewnątrz pętli aktualny gest jest odczytywany
+i podstawiany pod zmienną ``gesture``. Warunek ``if`` sprawdza, czy ``gesture`` 
+jest równa ``"face up"`` (Python używa ``==`` aby sprawdzić równość, pojedynczy
+znak równości ``=`` jest używany do przypisywania - tak samo jak przypisujemy 
+odczyt gestu do objektu ``gesture``). Jeżeli ``gesture`` jest równa ``"face up"``,
+używamy wyświetlacza do pokazania szczęśliwej miny. W przeciwnym przypadku, 
+urządzenie wyświetli rozzłoszczoną minę.
 
 Magic-8
 +++++++
 
-A Magic-8 ball is a toy first invented in the 1950s. The idea is to ask
-it a yes/no question, shake it and wait for it to reveal the truth. It's rather
-easy to turn into a program::
+Magiczna bila 8 to zabawka wynaleziona w latach pięćdziesiątych. Pomysł polega na zadaniu 
+pytania typu tak lub nie, potrząśnięciu bilą i poczekaniu, aż wyjawi prawdę. Raczej
+łatwo jest napisać działający w taki sposób program::
 
     from microbit import *
     import random
 
     answers = [
-        "It is certain",
-        "It is decidedly so",
-        "Without a doubt",
-        "Yes, definitely",
-        "You may rely on it",
-        "As I see it, yes",
-        "Most likely",
-        "Outlook good",
-        "Yes",
-        "Signs point to yes",
-        "Reply hazy try again",
-        "Ask again later",
-        "Better not tell you now",
-        "Cannot predict now",
-        "Concentrate and ask again",
-        "Don't count on it"
-        "My reply is no",
-        "My sources say no",
-        "Outlook not so good",
-        "Very doubtful",
+        "To pewne",
+        "Zdecydowanie tak",
+        "Bez wątpienia",
+        "Tak, z pewnością",
+        "Możesz na tym polegać",
+        "Jak ja to widzę, tak",
+        "Najprawdopodobniej",
+        "Wygląda dobrze",
+        "Tak",
+        "Znaki wskazują na tak",
+        "Odpowiedź niejasna, spróbuj ponownie",
+        "Zapytaj ponownie później",
+        "Lepiej, abym teraz nie powiedziała",
+        "Nie mogę teraz przewidzieć",
+        "Skoncentruj się i zapytaj ponownie",
+        "Nie licz na to",
+        "Moja odpowiedź brzmi nie",
+        "Moje źródła mówią nie",
+        "Nie wygląda to dobrze",
+        "Bardzo wątpliwe",
     ]
 
     while True:
@@ -74,17 +76,18 @@ easy to turn into a program::
             sleep(1000)
             display.scroll(random.choice(answers))
 
-Most of the program is a list called ``answers``. The actual game is in the
-``while`` loop at the end.
+Większość programu to tablica nazwana ``answers`` (ang. odpowiedzi). 
+Sama gra znajduje się w pętli ``while`` na końcu.
 
-The default state of the game is to show the character ``"8"``. However, the
-program needs to detect if it has been shaken. The ``was_gesture`` method uses
-its argument (in this case, the string ``"shake"`` because we want to detect
-a shake) to return a ``True`` / ``False`` response. If the device was shaken
-the ``if`` conditional drops into its block of code where it clears the screen,
-waits for a second (so the device appears to be thinking about your question)
-and displays a randomly chosen answer.
+Domyślny stan gry wyświetla cyfrę ``"8"``. Jednak program musi wykryć, 
+że nastąpiło potrząśnięcie. Metoda ``was_gesture`` używa swojego argumentu (w tym przypadku
+ciągu ``"shake"``, ponieważ chcemy wykryć potrząśnięcie) i zwraca ``True`` lub ``False``.
+
+Jeżeli urządzenie było potrząśnięte, warunek ``if`` wykonuje swój blok kodu, w którym 
+czyści ekran, czeka przez sekundę (aby urządzenie wyglądało, jakby zastanawiało się nad 
+twoim pytaniem), a następnie wyświetla losowo wybraną odpowiedź.
+
+Nie masz wrażenia, że jest to najlepszy program na świecie? Co mógłbyś
+zrobić, aby "oszukać" i uzyskać zawsze pozytywną lub negatywną odpowiedź? 
+(Podpowiedź: użyj przycisków).
 
-Why not ask it if this is the greatest program ever written? What could you do
-to "cheat" and make the answer always positive or negative? (Hint: use the
-buttons.)
