Skip to content

Commit 0744522

Browse files
authored
Beginners updates from brno (GH-41)
- fix typos and similar mistakes - add missing comas in sentences
2 parents 8275e82 + dd77261 commit 0744522

File tree

17 files changed

+51
-53
lines changed

17 files changed

+51
-53
lines changed

lessons/beginners/and-or/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ else:
110110
```
111111
112112
> [note]
113-
> Všimni si co se stane, když zadáš něco jiného než „ano“ nebo „ne“.
113+
> Všimni si, co se stane, když zadáš něco jiného než „ano“ nebo „ne“.
114114
>
115115
> Proměnná `stastna` nebo `bohata` se nenastaví, a když je ji potom
116116
> potřeba použít, program skončí s chybou.

lessons/beginners/circular-imports/index.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Po rozdělení bude projekt vypadat třeba nějak takhle:
88
(Šipky mezi moduly znázorňují importování.)
99

1010
```plain
11-
┌──────────────────╮ ┌───────────────╮ ┌──────────────────╮
11+
┌──────────────────╮ ┌───────────────╮ ┌──────────────────╮
1212
│ ai.py │ │ piskvorky.py │ │ hra.py │
1313
├──────────────────┤ ├───────────────┤ ├──────────────────┤
1414
│ │◀-│ import ai │◀-│ import piskvorky │
@@ -37,7 +37,7 @@ Můžeš importovat `ai` z `piskvorky` a zároveň
3737
│ │ │ def tah │
3838
└──────────────────┘ │ def tah_hrace │
3939
│ │
40-
└───────────────┘
40+
└───────────────┘
4141
```
4242

4343
Můžeš se na to podívat z pohledu Pythonu,
@@ -75,7 +75,7 @@ Jak na to? Máš dvě možnosti.
7575

7676
## Organizace modulů podle závislostí
7777

78-
První možnost je importovat funkci `tah` v modulu `ai`
78+
První možnost je definovat funkci `tah` v modulu `ai`
7979
a používat ji odtamtud.
8080
To je jednoduché, ale nerespektuje účel modulu
8181
`ai`, který má obsahovat jenom logiku
@@ -99,7 +99,7 @@ můžou být potřeba i jinde.
9999
Druhá možnost je definovat nový, sdílený modul,
100100
který se použije jak v `piskvorky.py` tak v `ai.py`.
101101

102-
Takový modul se často se pojmenovává
102+
Takový modul se často pojmenovává
103103
`util.py` (z angl. *utility*, pomůcka, nástroj).
104104

105105
```plain

lessons/beginners/cmdline/index.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@
1919
V této lekci se seznámíme s *příkazovou řádkou* – černým okýnkem,
2020
které programátoři používají na zadávání textových příkazů.
2121

22-
Na většinu z toho co příkazová řádka umí můžeš použít i něco jiného – ikonku
22+
Na většinu z toho, co příkazová řádka umí, můžeš použít i něco jiného – ikonku
2323
na ploše, speciální program nebo editor, webovou aplikaci – ale tyhle
2424
vychytávky mají dvě nevýhody:
2525
* č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.
137137
## Co v tom adresáři je?
138138

139139
Příkaz `ls` nebo `dir` (z angl. *list* – vyjmenovat, resp. *directory* – adresář)
140-
ti vypíše co aktuální adresář obsahuje: všechny soubory,
140+
ti vypíše, co aktuální adresář obsahuje: všechny soubory,
141141
včetně podadresářů, které se v aktuálním adresáři nacházejí.
142142

143143
{% call sidebyside() %}
@@ -201,6 +201,9 @@ $ mkdir zkouska
201201
> mkdir zkouska
202202
{% endcall %}
203203

204+
Vypiš si teď obsah aktuálního adresáře pomocí `ls` nebo `dir`.
205+
Jeden z vypsaných adresářů bude `zkouska`.
206+
204207
Když je adresář vytvořený, můžeš do něj přejít podobně jako jsi před chvílí
205208
{{gnd('přešel', 'přešla')}} na `Desktop` nebo `Plocha`:
206209

@@ -210,9 +213,6 @@ $ cd zkouska
210213
> cd zkouska
211214
{% endcall %}
212215

213-
Vypiš si teď obsah aktuálního adresáře pomocí `ls` nebo `dir`.
214-
Jeden z vypsaných adresářů bude `zkouska`.
215-
216216

217217
## V grafickém hledátku
218218

@@ -247,15 +247,15 @@ Tenhle program je na každém systému jiný:
247247
</div>
248248
</div>
249249

250-
Možná umíš v tomhle programu klikáním „donavigovat“ do adresáře který je
250+
Možná umíš v tomhle programu klikáním „donavigovat“ do adresáře, který je
251251
aktivní v příkazové řádce.
252252
V budoucnu to ale bude složitější, takže bude dobré si vyzkoušet kopírovat text
253253
z příkazové řádky a vložit ho do prohlížeče souborů.
254254

255255
Bohužel se to dělá na každém systému jinak.
256256
A protože známé zkratky <kbd>Ctrl</kbd>+<kbd>C</kbd> a
257257
<kbd>Ctrl</kbd>+<kbd>V</kbd> dělají v příkazové řádce něco jiného než
258-
kopírování, nejspíš se to dělá jinak než jsi zvykl{{gnd('ý', 'á')}}.
258+
kopírování, nejspíš se to dělá jinak, než jsi zvykl{{gnd('ý', 'á')}}.
259259

260260
Nejdřív si pomocí příkazu `cd` nebo `pwd` nech vypsat celé jméno adresáře
261261
`zkouska`:
@@ -329,7 +329,7 @@ je ale občas jiné než v ostatních pogramech:
329329
Vyzkoušej si, že se v řádce projeví i změny, které na počítači
330330
uděláš jiným způsobem.
331331
332-
V grafickém prohlížeči, který se „dívá“ na stejný adresář který máš aktivní
332+
V grafickém prohlížeči, který se „dívá“ na stejný adresář, jako máš aktivní
333333
v příkazové řádce, vytvoř nový soubor nebo adresář.
334334
Pak se pomocí příkazu `ls` nebo `dir` podívej, že se opravdu vytvořil.
335335
Potom ho v grafickém programu smaž – a v příkazové řádce se ujisti,

lessons/beginners/comparisons/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ nebo pusť `python` z příkazové řádky.)
6262
</tr>
6363
</table>
6464

65-
Hodnoty provnání jsou takzvané *booleovské* hodnoty
65+
Hodnoty porovnání jsou takzvané *booleovské* hodnoty
6666
(angl. *boolean*, podle [G. Boolea](http://en.wikipedia.org/wiki/George_Boole)).
6767
V Pythonu je můžeš použít vždycky, když potřebuješ vědět, jestli něco platí
6868
nebo neplatí.

lessons/beginners/def/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ nove_slovo = zacatek + novy_znak + konec
2525
Z takového kódu není na první pohled jasné, co přesně dělá.
2626
Zvlášť když kód použiješ ve složitějším programu.
2727

28-
Dá se to vyřešit komentářem: ten, kdo bude program číst, si může přečíst
28+
Dá se to vyřešit komentářem: ten, kdo bude program číst, si může přečíst,
2929
co to má dělat. Samotný složitější kód pak může ignorovat.
3030

3131
```python
@@ -79,7 +79,7 @@ pak do závorky seznam *parametrů*, které funkce bere, a pak dvojtečku.
7979

8080
Potom následuje odsazené *tělo funkce* – příkazy, které funkce provádí.
8181

82-
Tělo může začít *dokumentačním řetězcem* (angl. *docstring*), který popisuje
82+
Tělo může začít *dokumentačním řetězcem* (angl. *docstring*), který popisuje,
8383
co funkce dělá.
8484
To může být jakýkoli řetězec, ale tradičně se uvozuje třemi uvozovkami
8585
(i v případě, že je jen jednořádkový).

lessons/beginners/exceptions/index.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -28,10 +28,10 @@ Co s tím má chudák funkce `int` dělat?
2828
Není žádná rozumná hodnota, kterou by mohla vrátit.
2929
Převádění tohoto textu na celé číslo nedává smysl.
3030

31-
Až funkce `nacti_cislo` nejlíp „ví“, co se má stát když uživatel nezadá
31+
Až funkce `nacti_cislo` nejlíp „ví“, co se má stát, když uživatel nezadá
3232
číslice.
3333
Stačí se uživatele zeptat znovu!
34-
Kdybys měl{{a}} funkci, která zjistí jestli jsou v řetězci jen číslice,
34+
Kdybys měl{{a}} funkci, která zjistí, jestli jsou v řetězci jen číslice,
3535
mohlo by to fungovat nějak takhle:
3636

3737
```python
@@ -141,8 +141,8 @@ připraví, může hodně ulehčit hledání chyby.
141141
Zachytávej tedy jenom ty chyby, které *očekáváš* – víš přesně, která chyba může
142142
nastat a proč; máš možnost správně zareagovat.
143143

144-
V našem příkladu to platí pro `ValueError` z funkce `int`: víš že uživatel
145-
nemusí vždy zadat číslo ve správném formátu a víš že správná
144+
V našem příkladu to platí pro `ValueError` z funkce `int`: víš, že uživatel
145+
nemusí vždy zadat číslo ve správném formátu, a víš, že správná
146146
reakce na tuhle situaci je problém vysvětlit a zeptat se znovu.
147147

148148
Co ale dělat, když uživatel chce ukončit program a zmáčkne

lessons/beginners/first-steps/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,7 +108,7 @@ Na to má Python operátory `//` (podíl) a `%` (zbytek):
108108

109109
Pokud ses dostal{{a}} až sem, gratuluji!
110110
Python máš nejen nainstalovaný, ale taky ti funguje.
111-
Stačí ho už jen zavřít a pak opustit i samotnou příkazovou řádku.
111+
Stačí ho už jen zavřít.
112112
V Pythonu se to dělá pomocí `quit()`, s prázdnými závorkami na konci.
113113

114114
<div class="highlight"><pre>

lessons/beginners/functions/index.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -40,11 +40,11 @@ Třeba program v jazyce APL laik jednoduše ani nenapíše, ani nepřečte:
4040
Expert v APL může být vysoce produktivní, ale Python se zaměřuje spíš na to,
4141
aby se dal snadno naučit.
4242
A tak používá symboly jen pro ty nejčastější operace.
43-
Operátorů které využívají symboly je tak málo, že už jich zhruba půlku znáš!
43+
Operátorů, které využívají symboly, je tak málo, že už jich zhruba půlku znáš!
4444

4545
> [note]
4646
> Pro zajímavost, tady jsou všechny – i ty co ještě neznáš:
47-
>
47+
>
4848
> <!--
4949
> “Operátor” není přesně definovaný termín.
5050
> Tenhle seznam by měl odpovídat https://docs.python.org/3/reference/expressions.html#operator-precedence
@@ -196,7 +196,7 @@ Funkce `print` sice něco *udělá* – vypíše text
196196
na obrazovku – ale nevrátí žádný smysluplný výsledek, který by zbytek programu
197197
mohl dál zpracovat.
198198

199-
Funkcím, které nic nevrací (jen něco udělají) se občas říká *procedury*.
199+
Funkcím, které nic nevrací (jen něco udělají), se občas říká *procedury*.
200200
V Pythonu není hranice mezi „normální“ funkcí a procedurou příliš ostrá,
201201
ale přesto se hodí tento koncept znát.
202202
Pár příkladů:
@@ -206,7 +206,7 @@ Pár příkladů:
206206
* Funkce, která vykreslí na obrazovku kolečko, je *procedura*.
207207
Žádnou zajímavou hodnotu programu nevrací.
208208
* Funkce, která spočítá průměrný věk obyvatelstva podle informací ze sčítání
209-
lidu je „normální“. Svůj výsledek vrátí a program s ním může dál pracovat.
209+
lidu, je „normální“. Svůj výsledek vrátí a program s ním může dál pracovat.
210210
* Funkce, která přehraje písničku reproduktorem, je *procedura*.
211211
Nic zajímavého programu nevrací.
212212

@@ -221,8 +221,8 @@ Pár příkladů:
221221
## Argumenty
222222

223223
Argument je to, co funkci dáš k dispozici. Hodnota, se kterou funkce pracuje.
224-
Chceš-li délku řetězce `Ahoj!`, použiješ funkci `len` která umí vypočítat
225-
délku *jakéhokoli* řetězce a jako argument, v závorkách, jí dáš tu svoji
224+
Chceš-li délku řetězce `Ahoj!`, použiješ funkci `len`, která umí vypočítat
225+
délku *jakéhokoli* řetězce, a jako argument, v závorkách, jí dáš tu svoji
226226
konkrétní hodnotu: `len('Ahoj!')`.
227227

228228
Podobně funkce `print` umí vypsat jakoukoli hodnotu.
@@ -268,7 +268,7 @@ print(1, 2, 3, 4, sep=', ') # Místo mezery odděluj čárkou
268268
```
269269

270270
Dá se změnit i to, co `print` udělá na konci výpisu.
271-
Normálně přejde na nový řádek, ale argumentem `end` můžeš říct, co se má vypsat
271+
Normálně přejde na nový řádek, ale argumentem `end` můžeš říct, co se má vypsat
272272
*místo toho*.
273273

274274
> [note]
@@ -289,10 +289,10 @@ Pozor na to, že když nenapíšeš závorky, funkce se nezavolá!
289289
Výraz `len(s)` je *volání funkce*, ale `len` bez závorek označuje
290290
*funkci samotnou*.
291291

292-
Výsledek `len(s)` je číslo; `len` je funkce.
292+
Výsledek výrazu `len(s)` je číslo; výsledek výrazu `len` je samotná funkce `len`.
293293

294-
Čísla můžeš sečítat, můžeš tedy napsat `len(s) + 1`.
295-
Funkce ale sečítat nejde – `len + 1` nedává smysl.
294+
Čísla můžeš sčítat, můžeš tedy napsat `len(s) + 1`.
295+
Funkce ale sčítat nejde – `len + 1` nedává smysl.
296296

297297
Často se ale stane, že závorky prostě zapomeneš.
298298
Zkus si, co dělají následující příklady, a pozorně si přečti výsledky

lessons/beginners/hello-world/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ Aktivuj si virtuální prostředí.
4848
> [návodu na tvorbu virtuálního prostředí](../venv-setup/); končí `activate`.
4949
5050

51-
Pak a zadej tento příkaz:
51+
Pak zadej tento příkaz:
5252

5353
```console
5454
(venv)$ python ahoj.py
@@ -71,7 +71,7 @@ Jestli to nefunguje, zkontroluj, že:
7171
Jestli ne, ulož ho znovu pod správným jménem.
7272
* Soubor `ahoj.py` obsahuje správný příkaz, včetně všech uvozovek a závorek.
7373
* Slovo `(venv)` ani znak `$` nezadáváš – v materiálech jsou proto, aby bylo
74-
poznat že jde o příkaz příkazové řádky.
74+
poznat, že jde o příkaz příkazové řádky.
7575
Na `$` (nebo, na Windows, `>`) končí dotaz, který vypíše sám počítač.
7676
Příkaz, který zadáváš ty, je jen `python ahoj.py`.
7777

lessons/beginners/install-editor/index.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ pro někoho, kdo se jimi má řídit:
2626
* Nakresli mi beránka!
2727
* <font color="green">Nakresli <big><big>mi</big> <u>beránka</u>!</big></font>
2828

29-
To, že neumí formátování, neznamená že jsou naše editory úplně „hloupé“
29+
I když neumí formátování, neznamená to, že jsou naše editory úplně „hloupé“
3030
nástroje.
3131
Aby se nám programy upravovaly pohodlněji, mají několik vychytávek:
3232

@@ -36,7 +36,7 @@ Podpora více souborů
3636

3737
Číslování řádků
3838
: Před každým řádkem se ukazuje číslo.
39-
To se bude velice hodit, až Python bude nadávat, že chyba je na řádku 183.
39+
To se bude velice hodit, až Python bude nadávat, že chyba je na řádku 183.
4040

4141
Odsazování
4242
: V Pythonu je důležité, kolika mezerami řádek začíná.
@@ -99,8 +99,7 @@ Pokud se jeden z nich rozhodneš použít, neuděláš chybu:
9999
Máš-li už svůj oblíbený editor – Vim, Emacs, Geany, apod., použij ten:
100100
101101
* [Ostatní]({{ subpage_url('others') }}) – máš-li jiný editor, zkontroluj
102-
si že je správně nastaven.
103-
102+
si, že je správně nastaven.
104103
105104
### IDE
106105
@@ -122,4 +121,3 @@ takže nemusí být schopní s pokročilým IDE rychle pomoct.
122121
[PyCharm]: https://www.jetbrains.com/pycharm/
123122
[Eclipse]: https://eclipse.org/
124123
[KDevelop]: https://www.kdevelop.org/
125-

0 commit comments

Comments
 (0)