From d0d39ac84ae8396c37c427f743e79ff8a3bcbc1a Mon Sep 17 00:00:00 2001 From: Tomas Jelinek Date: Sun, 25 Feb 2024 16:20:06 +0100 Subject: [PATCH 1/3] beginners: fix typos and do minor improvements --- lessons/beginners/and-or/index.md | 2 +- lessons/beginners/circular-imports/index.md | 8 ++++---- lessons/beginners/cmdline/index.md | 10 +++++----- lessons/beginners/comparisons/index.md | 2 +- lessons/beginners/def/index.md | 4 ++-- lessons/beginners/exceptions/index.md | 8 ++++---- lessons/beginners/first-steps/index.md | 2 +- lessons/beginners/functions/index.md | 20 ++++++++++---------- lessons/beginners/hello-world/index.md | 4 ++-- lessons/beginners/install-editor/index.md | 5 ++--- lessons/beginners/local-variables/index.md | 6 +++--- lessons/beginners/nested-traceback/index.md | 2 +- lessons/beginners/prefer-return/index.md | 2 +- lessons/beginners/recursion/index.md | 4 ++-- lessons/beginners/str-index-slice/index.md | 2 +- lessons/beginners/str/index.md | 2 +- lessons/beginners/venv-setup/index.md | 12 ++++++------ 17 files changed, 47 insertions(+), 48 deletions(-) diff --git a/lessons/beginners/and-or/index.md b/lessons/beginners/and-or/index.md index 1e0df2cf..19de22e2 100644 --- a/lessons/beginners/and-or/index.md +++ b/lessons/beginners/and-or/index.md @@ -110,7 +110,7 @@ else: ``` > [note] -> Všimni si co se stane, když zadáš něco jiného než „ano“ nebo „ne“. +> Všimni si, co se stane, když zadáš něco jiného než „ano“ nebo „ne“. > > Proměnná `stastna` nebo `bohata` se nenastaví, a když je ji potom > potřeba použít, program skončí s chybou. diff --git a/lessons/beginners/circular-imports/index.md b/lessons/beginners/circular-imports/index.md index cfc0e745..2947075e 100644 --- a/lessons/beginners/circular-imports/index.md +++ b/lessons/beginners/circular-imports/index.md @@ -8,7 +8,7 @@ Po rozdělení bude projekt vypadat třeba nějak takhle: (Šipky mezi moduly znázorňují importování.) ```plain -┌──────────────────╮ ┌───────────────╮ ┌──────────────────╮ +┌──────────────────╮ ┌───────────────╮ ┌──────────────────╮ │ ai.py │ │ piskvorky.py │ │ hra.py │ ├──────────────────┤ ├───────────────┤ ├──────────────────┤ │ │◀-│ import ai │◀-│ import piskvorky │ @@ -37,7 +37,7 @@ Můžeš importovat `ai` z `piskvorky` a zároveň │ │ │ def tah │ └──────────────────┘ │ def tah_hrace │ │ │ - └───────────────┘ + └───────────────┘ ``` Můžeš se na to podívat z pohledu Pythonu, @@ -75,7 +75,7 @@ Jak na to? Máš dvě možnosti. ## Organizace modulů podle závislostí -První možnost je importovat funkci `tah` v modulu `ai` +První možnost je definovat funkci `tah` v modulu `ai` a používat ji odtamtud. To je jednoduché, ale nerespektuje účel modulu `ai`, který má obsahovat jenom logiku @@ -99,7 +99,7 @@ můžou být potřeba i jinde. Druhá možnost je definovat nový, sdílený modul, který se použije jak v `piskvorky.py` tak v `ai.py`. -Takový modul se často se pojmenovává +Takový modul se často pojmenovává `util.py` (z angl. *utility*, pomůcka, nástroj). ```plain diff --git a/lessons/beginners/cmdline/index.md b/lessons/beginners/cmdline/index.md index c1ba6419..8aadda17 100644 --- a/lessons/beginners/cmdline/index.md +++ b/lessons/beginners/cmdline/index.md @@ -19,7 +19,7 @@ V této lekci se seznámíme s *příkazovou řádkou* – černým okýnkem, které programátoři používají na zadávání textových příkazů. -Na většinu z toho co příkazová řádka umí můžeš použít i něco jiného – ikonku +Na většinu z toho, co příkazová řádka umí, můžeš použít i něco jiného – ikonku na ploše, speciální program nebo editor, webovou aplikaci – ale tyhle vychytávky mají dvě nevýhody: * často se liší mezi různými počítači, takže s „tvojí“ variantou ti bude moci @@ -137,7 +137,7 @@ Příkazová řádka umí soubory ukazovat taky – ale musíš si o to říct. ## Co v tom adresáři je? Příkaz `ls` nebo `dir` (z angl. *list* – vyjmenovat, resp. *directory* – adresář) -ti vypíše co aktuální adresář obsahuje: všechny soubory, +ti vypíše, co aktuální adresář obsahuje: všechny soubory, včetně podadresářů, které se v aktuálním adresáři nacházejí. {% call sidebyside() %} @@ -247,7 +247,7 @@ Tenhle program je na každém systému jiný: -Možná umíš v tomhle programu klikáním „donavigovat“ do adresáře který je +Možná umíš v tomhle programu klikáním „donavigovat“ do adresáře, který je aktivní v příkazové řádce. V budoucnu to ale bude složitější, takže bude dobré si vyzkoušet kopírovat text z příkazové řádky a vložit ho do prohlížeče souborů. @@ -255,7 +255,7 @@ z příkazové řádky a vložit ho do prohlížeče souborů. Bohužel se to dělá na každém systému jinak. A protože známé zkratky Ctrl+C a Ctrl+V dělají v příkazové řádce něco jiného než -kopírování, nejspíš se to dělá jinak než jsi zvykl{{gnd('ý', 'á')}}. +kopírování, nejspíš se to dělá jinak, než jsi zvykl{{gnd('ý', 'á')}}. Nejdřív si pomocí příkazu `cd` nebo `pwd` nech vypsat celé jméno adresáře `zkouska`: @@ -329,7 +329,7 @@ je ale občas jiné než v ostatních pogramech: Vyzkoušej si, že se v řádce projeví i změny, které na počítači uděláš jiným způsobem. -V grafickém prohlížeči, který se „dívá“ na stejný adresář který máš aktivní +V grafickém prohlížeči, který se „dívá“ na stejný adresář, jako máš aktivní v příkazové řádce, vytvoř nový soubor nebo adresář. Pak se pomocí příkazu `ls` nebo `dir` podívej, že se opravdu vytvořil. Potom ho v grafickém programu smaž – a v příkazové řádce se ujisti, diff --git a/lessons/beginners/comparisons/index.md b/lessons/beginners/comparisons/index.md index 061043a8..6d87e5e6 100644 --- a/lessons/beginners/comparisons/index.md +++ b/lessons/beginners/comparisons/index.md @@ -62,7 +62,7 @@ nebo pusť `python` z příkazové řádky.) -Hodnoty provnání jsou takzvané *booleovské* hodnoty +Hodnoty porovnání jsou takzvané *booleovské* hodnoty (angl. *boolean*, podle [G. Boolea](http://en.wikipedia.org/wiki/George_Boole)). V Pythonu je můžeš použít vždycky, když potřebuješ vědět, jestli něco platí nebo neplatí. diff --git a/lessons/beginners/def/index.md b/lessons/beginners/def/index.md index 39a86e38..a571815b 100644 --- a/lessons/beginners/def/index.md +++ b/lessons/beginners/def/index.md @@ -25,7 +25,7 @@ nove_slovo = zacatek + novy_znak + konec Z takového kódu není na první pohled jasné, co přesně dělá. Zvlášť když kód použiješ ve složitějším programu. -Dá se to vyřešit komentářem: ten, kdo bude program číst, si může přečíst +Dá se to vyřešit komentářem: ten, kdo bude program číst, si může přečíst, co to má dělat. Samotný složitější kód pak může ignorovat. ```python @@ -79,7 +79,7 @@ pak do závorky seznam *parametrů*, které funkce bere, a pak dvojtečku. Potom následuje odsazené *tělo funkce* – příkazy, které funkce provádí. -Tělo může začít *dokumentačním řetězcem* (angl. *docstring*), který popisuje +Tělo může začít *dokumentačním řetězcem* (angl. *docstring*), který popisuje, co funkce dělá. To může být jakýkoli řetězec, ale tradičně se uvozuje třemi uvozovkami (i v případě, že je jen jednořádkový). diff --git a/lessons/beginners/exceptions/index.md b/lessons/beginners/exceptions/index.md index af27d8a0..fbf667ba 100644 --- a/lessons/beginners/exceptions/index.md +++ b/lessons/beginners/exceptions/index.md @@ -28,10 +28,10 @@ Co s tím má chudák funkce `int` dělat? Není žádná rozumná hodnota, kterou by mohla vrátit. Převádění tohoto textu na celé číslo nedává smysl. -Až funkce `nacti_cislo` nejlíp „ví“, co se má stát když uživatel nezadá +Až funkce `nacti_cislo` nejlíp „ví“, co se má stát, když uživatel nezadá číslice. Stačí se uživatele zeptat znovu! -Kdybys měl{{a}} funkci, která zjistí jestli jsou v řetězci jen číslice, +Kdybys měl{{a}} funkci, která zjistí, jestli jsou v řetězci jen číslice, mohlo by to fungovat nějak takhle: ```python @@ -141,8 +141,8 @@ připraví, může hodně ulehčit hledání chyby. Zachytávej tedy jenom ty chyby, které *očekáváš* – víš přesně, která chyba může nastat a proč; máš možnost správně zareagovat. -V našem příkladu to platí pro `ValueError` z funkce `int`: víš že uživatel -nemusí vždy zadat číslo ve správném formátu a víš že správná +V našem příkladu to platí pro `ValueError` z funkce `int`: víš, že uživatel +nemusí vždy zadat číslo ve správném formátu, a víš, že správná reakce na tuhle situaci je problém vysvětlit a zeptat se znovu. Co ale dělat, když uživatel chce ukončit program a zmáčkne diff --git a/lessons/beginners/first-steps/index.md b/lessons/beginners/first-steps/index.md index eb080bfb..f9a1b1b3 100644 --- a/lessons/beginners/first-steps/index.md +++ b/lessons/beginners/first-steps/index.md @@ -108,7 +108,7 @@ Na to má Python operátory `//` (podíl) a `%` (zbytek): Pokud ses dostal{{a}} až sem, gratuluji! Python máš nejen nainstalovaný, ale taky ti funguje. -Stačí ho už jen zavřít a pak opustit i samotnou příkazovou řádku. +Stačí ho už jen zavřít. V Pythonu se to dělá pomocí `quit()`, s prázdnými závorkami na konci. 
diff --git a/lessons/beginners/functions/index.md b/lessons/beginners/functions/index.md
index 4b82f295..5cef160a 100644
--- a/lessons/beginners/functions/index.md
+++ b/lessons/beginners/functions/index.md
@@ -40,11 +40,11 @@ Třeba program v jazyce APL laik jednoduše ani nenapíše, ani nepřečte:
 Expert v APL může být vysoce produktivní, ale Python se zaměřuje spíš na to,
 aby se dal snadno naučit.
 A tak používá symboly jen pro ty nejčastější operace.
-Operátorů které využívají symboly je tak málo, že už jich zhruba půlku znáš!
+Operátorů, které využívají symboly, je tak málo, že už jich zhruba půlku znáš!
 
 > [note]
 > Pro zajímavost, tady jsou všechny – i ty co ještě neznáš:
-> 
+>
 >