Added a metacourse with instructions on how to add a course/run #394

mikicz · 2018-04-19T14:07:03Z

No description provided.

mikicz · 2018-04-19T14:09:56Z

I'm gonna update the last part about adding the webhook once I code the automatic webhook installation.

hroncok · 2018-04-19T14:47:24Z

Hodně děláš odkazy "zde". To se mi nelíbí. http://pristupnost.nawebu.cz/texty/pravidla-standardy.php?full#rule27

mikicz · 2018-04-19T14:55:34Z

Opravím.

mikicz · 2018-04-19T15:30:20Z

Takhle?

hroncok · 2018-04-19T15:31:26Z

Ano.

hroncok · 2018-04-19T15:22:13Z

lessons/meta/installing-naucse/index.md

+
+## Instalace
+
+Nejprve musíš naklonovat repozitář ze kterého se Nauč se Python vykresluje.


čárka před ze kterého

lessons/meta/installing-naucse/info.yml

+style: md
+attribution: Napsal Mikuláš Poul, 2018
+license: cc-by-sa-40
+license_code: cc0


hroncok · 2018-04-19T15:23:08Z

lessons/meta/local-run/index.md

+
+Teď když už máš lokální instalaci Nauč se, můžeš začít vytvářet vlastní kurz.
+
+První věc, kterou musíš udělat je vybrat si identifikátor kurzu, pod kterým bude kurz uložený.


udělat čárka

hroncok · 2018-04-19T15:23:25Z

lessons/meta/local-run/index.md

+### O formátu YAML
+
+Formát se skládá z několika stavebních bloků, které se dají poté skládat dohromady.
+Prvním je seznam hodnot (pokud umíš v Pythonu, tak si to představ jako pole).


seznam, ne pole.

hroncok · 2018-04-19T15:23:36Z

lessons/meta/local-run/index.md

+- První položka
+- Druhá položka
+- 3
+- Položka můžeš být i něco jiného než text!


hroncok · 2018-04-19T15:42:06Z

lessons/meta/local-run/index.md

+## Otestování vlastního kurzu
+
+Po vytvoření souboru ``info.yml`` se povinnými položkami se můžeš konečně podívat na svůj kurz jak bude vypadat.
+Podle instrukcí z předchozí části manuálu si spusť Nauč se v režimu ``serve``.


odkaz na předchozí část

hroncok · 2018-04-19T15:42:25Z

lessons/meta/local-run/index.md

+
+Po vytvoření souboru ``info.yml`` se povinnými položkami se můžeš konečně podívat na svůj kurz jak bude vypadat.
+Podle instrukcí z předchozí části manuálu si spusť Nauč se v režimu ``serve``.
+Otevři si adresu, který ti příkaz napíše a odnaviguj se do části s kurzy.


hroncok · 2018-04-19T15:43:54Z

lessons/meta/local-run/index.md

+
+Pokud se stránka s kurzy nevykreslí, tak jsi nejspíš udělal{{a}} někde nějakou chybu při definici povinných údajů – zkontroluj si jestli jsi vážně vyplnil{{a}} všechny údaje.
+V opačném případě si rozklikni svůj kurz.
+Pokud se ti nevykreslí detail kurzu, nejspíš jsi udělal{{a}} nějakou chybu v definici lekcí nebo materiálů – zkontroluj si, jestli například nemáš dvě lekce se stejným identifikátorem, jesli není překlep v nějakém klíčí a jestli například neodkazuješ na materiál, který neexistuje.


uvidíš python výjimku, která ti může pomoct, ale taky může být pěkně matoucí. kdyžtak se nám ozvi (přes issues?)

hroncok · 2018-04-19T15:44:22Z

lessons/meta/local-run/index.md

+Pokud se ti nevykreslí detail kurzu, nejspíš jsi udělal{{a}} nějakou chybu v definici lekcí nebo materiálů – zkontroluj si, jestli například nemáš dvě lekce se stejným identifikátorem, jesli není překlep v nějakém klíčí a jestli například neodkazuješ na materiál, který neexistuje.
+
+Dále si pak můžeš proklikat všechny jednotlivé materiály, jestli vše funguje.
+Pokud se ti to nechce dělat ručně, můžeš pustit Nauč se v druhém režimu, který projde všechny stránky sám a vyhodí chybu, pokud v nějaké bude chyba.


Tuhle větu bych přepsal, nezí moc lidsky.

Jak vidíš, tak já na tom s češtinou nejsem o moc líp oproti angličtině :)

hroncok · 2018-04-19T15:45:13Z

lessons/meta/local-run/index.md

+``title`` nastavuje název, ``style`` může být ``md`` nebo ``ipynb`` podle toho jaký formát bude mít text.
+``license`` nastavuje licensi pod kterou materiály píšeš – identifikátor ze složky ``licenses``.
+
+Dále má soubor nepovinné položky, první ``attributuons`` – buď jednoduchý text nebo seznam textů s informacemi o tom kdo a proč materiál napsal.


mikicz · 2018-04-19T19:44:51Z

Samozřejmě si všímám dalších chyb až co jsem to pushnul... Ještě si to projdu...

hroncok · 2018-04-20T15:19:30Z

lessons/meta/local-run/index.md

 ```

-Druhým stavebním blokem je mapa (v Pythonu slovník), která se skládá z klíčů a hodnot, nezáleží v ní tedy na pořadí, protože se k informaci vždy člověk dostance pomocí klíče.
-Mapa se ve formátu YAML zapisuje následovně:
+Druhým stavebním blokem je slovník (zase podobně jako v Pythonu), která se skládá z klíčů a hodnot, nezáleží v ní tedy na pořadí, protože se k informaci vždy člověk dostance pomocí klíče.


slovník, který

encukou · 2018-04-20T19:12:51Z

lessons/meta/installing-naucse/index.md

+$ cd naucse.python.cz
+```
+
+A vytvoři si v něm virtuální prostředí – pokud nevíš jak na to, můžeš se podívat do návodu na instalaci Pythonu, na který je odkaz výše.


vytvoři → vytvoř

encukou · 2018-04-20T19:13:50Z

lessons/meta/installing-naucse/index.md

+ * Restarting with stat
+ * Debugger is active!
+ * Debugger PIN: 256-270-314
+```


Funguje nastavování proměnné prostředí takhle i na Windows?

Nefunguje, přidal jsem nad to separátně nastavování proměné

encukou · 2018-04-20T19:15:01Z

lessons/meta/installing-naucse/index.md

+V ukázce vidíš rovnou i příklad toho co to vypíše – zajímá tě jen ta adresa, to ve formátu `http://0.0.0.0:8003/`.
+Když si ji zkopíruješ a otevřeš ve webovém prohlížeči, uvidíš Nauč se.
+
+Druhý režim je nejdříve vykreslí všechny stránky a až poté ti je zobrazí – hodí se spíše na kontrolu toho, že se při vývoji nic nepokazilo.


"Druhý režim je" → "Druhý režim"

encukou · 2018-04-20T19:16:34Z

lessons/meta/local-run/index.md

+
+První věc, kterou musíš udělat, je vybrat si identifikátor kurzu, pod kterým bude kurz uložený.
+Tento identifikátor také bude ve všech adresách, které se budou týkat tohoto kurzu.
+Identifikátor se může skládat pouze z malých alfanumerických znaků a pomlček a musí být uníkátní, alespoň v daném roce.


Tady by bylo fajn dát pár příkladů, ať lidi líp ví o co jde a co v těch runs hledají.

Přidal jsem pod to poznámku

encukou · 2018-04-20T19:24:53Z

lessons/meta/submitting-a-run/index.md

+</div>
+
+Vytvoření chvilku trvá.
+To, že je fork vytvořen poznáš tak, že tě GitHub přesměruje na stránku, která bude skoro stejná, ale v hlavičce bude tvoje username a pod tím text `forked from pyvec/naucse.python.cz`.


Preferoval bych "username" → "uživatelské jméno" (tady i níže)

encukou · 2018-04-20T19:25:42Z

lessons/meta/submitting-a-run/index.md

+$ git checkout -b pridanikurzu origin/master
+```
+
+Možná sis všiml{{a}}, že tvoje změny jsou najednou pryč, ale neboj, oni jsou uložené jak na tvém počítači tak na GitHubu, jen zrovna nejsou vidět.


oni → ony

encukou · 2018-04-20T19:30:45Z

naucse/models.py

@@ -500,7 +504,8 @@ def __str__(self):
    description = DataProperty(info)
    long_description = DataProperty(info)

-    vars = DataProperty(info)
+    # none of the variables are required, so empty ``vars:`` should not be required either
+    vars = DataProperty(info, default=None, convert=lambda x: dict(x) if x else {})


Fungovalo by default=(), convert=dict?

mikicz · 2018-04-26T09:00:55Z

Blokuje tohle ještě něco? AFAIK jsem udělal všechny požadované změny.

Jsem si vědom #397, nicméně to vypadá, že bude nějakou chvíli trvat než se to tam definuje, takže by se to mohlo přidat až to bude nadefinované?

hroncok · 2018-04-26T09:08:18Z

Projdu to ještě jednou.

encukou · 2018-04-26T20:35:35Z

naucse/templates/_base.html

+
+                <p>
+                    <a href="{{ url_for("course", course="course/meta") }}">Jak přidat kurz</a>
+                </p>


Myslím že není potřeba mít odkaz na metakurz na každé stránce.
Můžeš to dát třeba jen na úvodní stránku?

encukou · 2018-04-26T20:46:18Z

lessons/meta/submitting-a-run/index.md

+Po tom co se správci PR schváli a sloučí tvoje změny do základního repozitáře, stačí počkat pár minut a tvůj kurz se objeví na [naucse.python.cz](https://naucse.python.cz/).
+
+## Upravování kurzu
+


Tady ještě chybí přepnutí větve v Gitu zpátky tam, kde je kurz co se má upravovat :)

mikicz requested review from encukou and hroncok April 19, 2018 14:07

hroncok requested changes Apr 19, 2018

View reviewed changes

mikicz force-pushed the meta-course branch from 469ef40 to bac254a Compare April 19, 2018 19:47

hroncok reviewed Apr 20, 2018

View reviewed changes

encukou reviewed Apr 20, 2018

View reviewed changes

hroncok mentioned this pull request Apr 21, 2018

Definovat workflow s forky #397

Open

mikicz force-pushed the meta-course branch from 22ec19b to 4ca1d23 Compare April 26, 2018 08:57

encukou reviewed Apr 26, 2018

View reviewed changes

encukou approved these changes Apr 27, 2018

View reviewed changes

Added a metacourse with instructions on how to add a course/run

78bf5a0

mikicz force-pushed the meta-course branch from d54609b to 78bf5a0 Compare April 28, 2018 08:26

hroncok approved these changes Apr 28, 2018

View reviewed changes

hroncok merged commit 192184a into pyvec:master Apr 28, 2018

mikicz deleted the meta-course branch April 28, 2018 08:47

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Added a metacourse with instructions on how to add a course/run #394

Added a metacourse with instructions on how to add a course/run #394

mikicz commented Apr 19, 2018

mikicz commented Apr 19, 2018

hroncok commented Apr 19, 2018

mikicz commented Apr 19, 2018

mikicz commented Apr 19, 2018

hroncok commented Apr 19, 2018

hroncok Apr 19, 2018

This comment was marked as outdated.

hroncok Apr 19, 2018

hroncok Apr 19, 2018

hroncok Apr 19, 2018

hroncok Apr 19, 2018

hroncok Apr 19, 2018

hroncok Apr 19, 2018

hroncok Apr 19, 2018

mikicz Apr 19, 2018

hroncok Apr 19, 2018

mikicz commented Apr 19, 2018

hroncok Apr 20, 2018

encukou Apr 20, 2018

encukou Apr 20, 2018

mikicz Apr 23, 2018

encukou Apr 20, 2018

encukou Apr 20, 2018

mikicz Apr 23, 2018

encukou Apr 20, 2018

encukou Apr 20, 2018

encukou Apr 20, 2018

mikicz commented Apr 26, 2018

hroncok commented Apr 26, 2018

encukou Apr 26, 2018

encukou Apr 26, 2018


		## Instalace

		Nejprve musíš naklonovat repozitář ze kterého se Nauč se Python vykresluje.


		Teď když už máš lokální instalaci Nauč se, můžeš začít vytvářet vlastní kurz.

		První věc, kterou musíš udělat je vybrat si identifikátor kurzu, pod kterým bude kurz uložený.

		Po tom co se správci PR schváli a sloučí tvoje změny do základního repozitáře, stačí počkat pár minut a tvůj kurz se objeví na [naucse.python.cz](https://naucse.python.cz/).

		## Upravování kurzu

Added a metacourse with instructions on how to add a course/run #394

Added a metacourse with instructions on how to add a course/run #394

Conversation

mikicz commented Apr 19, 2018

mikicz commented Apr 19, 2018

hroncok commented Apr 19, 2018

mikicz commented Apr 19, 2018

mikicz commented Apr 19, 2018

hroncok commented Apr 19, 2018

Choose a reason for hiding this comment

This comment was marked as outdated.

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mikicz commented Apr 19, 2018

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mikicz commented Apr 26, 2018

hroncok commented Apr 26, 2018

Choose a reason for hiding this comment

Choose a reason for hiding this comment