Pár typografických vsuvek (PEP8), a CSS pro ně

#307

Author: encukou

lessons/beginners/hello-world/index.md

@@ -91,3 +91,25 @@ kouče.
 zkušenějšího programátora. <!-- XXX: where to direct people? -->
 {% endif %}
 
+
+> [style-note] Typografická vsuvka
+>
+> V Pythonu je většinou jedno, kde napíšeš mezeru. Stejně jako náš příkaz
+> `print("Ahoj světe!")` by fungovalo třeba:
+>
+> ```python
+> print      (   "Ahoj světe!"     )
+> ```
+>
+> Je ale zvykem dodržovat určitá pravidla.
+> Jako v češtině se po otvírací závorce a za
+> ozavírací závorkou nepíše mezera.
+> Na rozdíl od češtiny ale mezeru nepiš ani mezi `print` a závorkou.
+> „Správně“ je tedy:
+>
+> ```python
+> print("Ahoj světe!")
+> ```
+>
+> V rámci uvozovek má pak každá mezera význam: když napíšeš
+> `"    Ahoj      světe!"`, mezery navíc se objeví ve výsledné hlášce.

lessons/beginners/print/index.md

@@ -103,3 +103,23 @@ Třeba výraz `3 + 8` sečítá výrazy `3` a `8`.
 
 V sekci o [proměnných]({{ lesson_url('beginners/variables') }}) se
 na výrazy a jejich hodnoty podíváme podrobněji.
+
+> [style-note] Typografická vsuvka
+> Všimni si stylu zápisu: jako v češtině se po otvírací závorce a za
+> ozavírací závorkou nepíše mezera; na rozdíl od češtiny ale mezera není
+> mezi `print` a závorkou.
+> ```python
+> print("Ahoj!")
+> ```
+>
+> S čárkou je to jako v češtině: mezeru píšeme po čárce, ale ne před ní:
+> ```python
+> print(1, 2, 3)
+> ```
+>
+> Kolem operátorů jako `+` a `*` se obyčejně píše jedna mezera zleva a
+> jedna zprava. Někdy je ale přehlednější obě vynechat:
+> ```python
+> print(2 + 8)
+> print("Jedna a půl je", 1 + 1/2)
+> ```

lessons/beginners/variables/index.md

@@ -82,6 +82,9 @@ jehož hodnota se do proměnné *přiřadí*.
 Když potom napíšeš jméno proměnné ve výrazu,
 použije se zapamatovaná hodnota.
 
+> [style-note]
+> Je zvykem dát před i za rovnítko po jedné mezeře.
+
 To nás vede k jedné ze základních programátorských
 zásad: „neopakuj se“ (anglicky *Don't repeat yourself*, <abbr class="initialism">DRY</abbr>).
 Když se někde opakuje stejná hodnota, stejný výraz
@@ -143,6 +146,11 @@ print('Obvod čtverce se stranou', strana, 'je', 4 * strana, 'cm')
 print('Obsah čtverce se stranou', strana, 'je', strana * strana, 'cm2')
 ```
 
+> [style-note]
+> Píšeš-li komentáš na stejný řádek jako kód, je zvykem před `#` dát dvě
+> mezery (nebo i víc).
+> Za `#` pak patří právě jedna.
+
 ## Načítání vstupu
 
 Nakonec se podíváme, jak zařídit, aby číslo nemuselo být

naucse/static/css/body.css

@@ -112,6 +112,19 @@ p kbd {
     font-size: 6rem;
 }
 
+.admonition.style-note {
+    border-left: 3px rgba(240, 173, 78, 0.2) solid;
+}
+
+.admonition.style-note > *:first-child:before {
+    content: '&';
+    color: rgba(240, 173, 78, 0.2);
+    font-style: italic;
+    top: -3rem;
+    right: -0.3rem;
+    font-size: 6rem;
+}
+
 /*** Solutions ***/
 
 .solution {