From 05639dbfc2e55f6a3fd23dbe49d317bff5f8c3d1 Mon Sep 17 00:00:00 2001 From: encyk Date: Fri, 15 Sep 2023 16:15:13 +0200 Subject: [PATCH 1/5] docs: student's catalog --- students/basics/index.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/students/basics/index.md b/students/basics/index.md index e05ee32..8ba7881 100644 --- a/students/basics/index.md +++ b/students/basics/index.md @@ -38,6 +38,17 @@ V prostředku jsou zobrazeny aktuálně běžící úlohy, aby nebyly potřeba s A v neposlední řadě je zcela nahoře vidět základní statistika o postupu studenta – Celkový počet vlajek, které vyřešil a procentuální vyjádření ze všech vlajek všech zadaných úloh. ## Katalog + +Katalog je místo pro studenty i učitele, kde si můžou projít úlohy, které jsou zde (na rozdíl od stránky [Přehled](#prehled)) uspořádané do tematických kategorií. Každá úloha zde má krátké shrnutí, aby bylo ryhle jasné, čemu se věnuje, dále pak datum, kdy ji student dostal zadanou k vyřešení a počet jejích vlajek. + +Vyhledávat úlohy v horní části lze jak podle jejich jména, tak i podle jména jejich kategorie. Vyhledávací políčko je možné také aktivovat klávesou `/`. +Po vyhledání úlohy se otevře zobrazení kategorie s rozbaleným krátkým shrnutím vybrané úlohy, aby uživatel jednoduše viděl, co dané úloze předchází a co následuje. + +V detailu každé kategorie jsou vidět pouze ty úlohy, které má žák zadané od svého učitele. + +V pravé části jsou opět statistiky o studentově postupu kategorií – Počet splněných vlajek z úloh této kategorie a jejich procentuální vyjádření k celkovému počtu vlajek v kategorii. +Hned pod tím je celkový počet úloh v kategorii, včetně těch, které žák nemá zadané. A jako poslední může student v pravém panelu vidět, které úlohy z těch zadaných má dokončené (číslice je zelená) a které mu ještě chybí (šedá). + ## Žebříčky ## Nastavení ## VPN Konfigurace From be74cefe2d73955257d7b77ec4091b0b4d5c4708 Mon Sep 17 00:00:00 2001 From: encyk Date: Fri, 15 Sep 2023 22:32:53 +0200 Subject: [PATCH 2/5] docs: finished basics for users --- students/basics/index.md | 46 +++++++++++++++++++++++++++++++++++----- 1 file changed, 41 insertions(+), 5 deletions(-) diff --git a/students/basics/index.md b/students/basics/index.md index 8ba7881..e6fd8c6 100644 --- a/students/basics/index.md +++ b/students/basics/index.md @@ -1,4 +1,4 @@ -# Základní používání +# Základní používání platformy HAXAGON Studenti jsou na platformě rozděleni do skupin, které většinou představují třídy, popřípadě skupiny, do kterých chodí. Veškerá cvičení a úkoly se zadávají právě pro určité skupiny a Žebříčky také fungují v rozsahu skupin. @@ -39,7 +39,7 @@ A v neposlední řadě je zcela nahoře vidět základní statistika o postupu s ## Katalog -Katalog je místo pro studenty i učitele, kde si můžou projít úlohy, které jsou zde (na rozdíl od stránky [Přehled](#prehled)) uspořádané do tematických kategorií. Každá úloha zde má krátké shrnutí, aby bylo ryhle jasné, čemu se věnuje, dále pak datum, kdy ji student dostal zadanou k vyřešení a počet jejích vlajek. +Katalog je místo pro studenty i učitele, kde si můžou projít úlohy, které jsou zde (na rozdíl od stránky [Přehled](#prehled)) uspořádané do tematických kategorií. Každá úloha zde má krátké shrnutí, aby bylo rychle jasné, čemu se věnuje, dále pak datum, kdy ji student dostal zadanou k vyřešení a počet jejích vlajek. Vyhledávat úlohy v horní části lze jak podle jejich jména, tak i podle jména jejich kategorie. Vyhledávací políčko je možné také aktivovat klávesou `/`. Po vyhledání úlohy se otevře zobrazení kategorie s rozbaleným krátkým shrnutím vybrané úlohy, aby uživatel jednoduše viděl, co dané úloze předchází a co následuje. @@ -50,9 +50,45 @@ V pravé části jsou opět statistiky o studentově postupu kategorií – Poč Hned pod tím je celkový počet úloh v kategorii, včetně těch, které žák nemá zadané. A jako poslední může student v pravém panelu vidět, které úlohy z těch zadaných má dokončené (číslice je zelená) a které mu ještě chybí (šedá). ## Žebříčky + +Žebříčky poskytují studentům okamžitou informaci o jejich postupu ve třídě nebo v soutěži. Každá splněná vlajka v úloze přidá studentovi určitý počet bodů za její úspěšné vyřešení. Zcela nahoře je vidět posledních několik vlajek, které student splnil, a kdy se tak stalo. + +Tři studenti s nejvyšším počtem bodů v aktuálně vybrané skupině se zobrazují na "stupních vítězů", spolu s jejich vybraným avatarem. + +Všichni studenti jsou také řazeni postupně v tabulce, podle svých bodů. Pro jednoduché zobrazení jsou také jejich body reprezentovány grafem – počet bodů nejlepšího studenta se ukazuje jako plný řádek, ostatní studenti mají svůj progress bar vyplněný proporcionálně k tomu. + ## Nastavení + +V nastavení si každý může trochu přizpůsobit platformu HAXAGON k obrazu svému. Také si zde studenti mění vzhled svého profilu. + +### Discord integrace +Pro přístup na [komunitní Discord server](https://discord.gg/Z3bn4EyE3H) je potřeba ověřit, že jste skutečně uživateli HAXAGONu. Pro to se používá autorizace discord účtem. + +Pro propojení klikněte na tlačítko s logem Discord vlevo nahoře. To Vás přesměruje na stránky discord.com, kde povolíte přístup ke jménu Vašeho účtu. Pokud nejste v prohlížeči přihlášení do Discordu, budete se muset přihlásit. + +Po propojení účtů můžete pokračovat na Discord server a řídit se pokyny pro ověření napsanými v kanálu #verification. + +### Avatar +Avatar si lze vybrat z několika předvytvořených možností. Nahrávání vlastních obrázků možné není. +Uživatelský avatar se poté zobrazuje na několika místech: V Žebříčcích, v seznamu řešitelů úlohy a učitelé ho vidí v seznamu svých studentů. + +### Nastavení Platformy +Webová stránka HAXAGON je dostupná jak v češtině, tak v angličtině. Pokud někde naleznete chybějící překlad, nahlaste ho, prosím, na našem [discord serveru](https://discord.gg/Z3bn4EyE3H). + +### Připojení +Někteří vybraní studenti mohou vidět v nastavení možnost změnit způsob připojení k úlohám. Možnost "VPN" se bude chovat stejně, jako doposud (je nutné si nastavit VPN do HAXAGON sítě, viz [VPN Konfigurace](#vpn-konfigurace)), možnost "Veřejná IP" poskytne studentovi při připojování možnost použít veřejnou IP jednoho ze serverů, tudíž umožňuje připojení i na zařízeních, na kterých VPN není nastavená. + + ## VPN Konfigurace -## Spravovat -### Uživatelé -### Skupiny \ No newline at end of file +Pro připojení do úloh je potřeba využít VPN a připojit se do sítě HAXAGONu. + +Stránka VPN Konfigurace obsahuje všechny potřebné informace k nastavení VPN na Vašem oblíbeném operačním systému. Možnost pro váš aktuálně používaný operační systém by se měla detekovat automaticky, zvýraznit a zobrazit v seznamu na prvním místě. Pokud se toto nestane, jednoduše vyberte svůj OS ze seznamu a klikněte na tlačítko "Nastavit VPN". + +Poté stačí následovat kroky na stránce pro instalaci VPN klienta, import konfiguračního souboru a spuštění VPN připojení. +Návody pro Linux a macOS/OS X obsahují také předpřipravený shell script, který stačí vložit do příkazové řádky a spustit. Příkaz obsahuje Vaši VPN konfiguraci a automaticky Vás připojí na VPN. + +::: danger Pozor! +Nikdy s nikým nesdílejte svůj `.conf` VPN soubor / QR kód pro mobilní zařízení / shell příkaz na připojení! +Obsahuje údaje pro připojení k HAXAGON úlohám pod Vaším účtem! +::: \ No newline at end of file From e2a51ed19c2a16ca99833b88c047c12134038aba Mon Sep 17 00:00:00 2001 From: encyk Date: Fri, 15 Sep 2023 22:41:28 +0200 Subject: [PATCH 3/5] docs: add file structure for teachers and students --- students/challenges/index.md | 14 ++++++++++++++ students/index.md | 5 +++++ students/troubleshooting/index.md | 3 +++ teachers/basics/index.md | 23 +++++++++++++++++++++++ teachers/index.md | 22 ++++++++++++++++++++++ teachers/troubleshooting/index.md | 3 +++ 6 files changed, 70 insertions(+) create mode 100644 students/challenges/index.md create mode 100644 students/troubleshooting/index.md create mode 100644 teachers/basics/index.md create mode 100644 teachers/index.md create mode 100644 teachers/troubleshooting/index.md diff --git a/students/challenges/index.md b/students/challenges/index.md new file mode 100644 index 0000000..d472337 --- /dev/null +++ b/students/challenges/index.md @@ -0,0 +1,14 @@ + +::: info INFO ⚒ +Tato stránka není hotová a je stále v procesu psaní. +::: + +Something something, + + +Reference na [VPN konfiguraci](./../basics/index.md#vpn-konfigurace) pro připojení k úloze + + + \ No newline at end of file diff --git a/students/index.md b/students/index.md index 19de9e0..c8dfa5f 100644 --- a/students/index.md +++ b/students/index.md @@ -14,6 +14,11 @@ features: title: Základy details: Struktura platformy a návody pro studenty + - icon: 📝 + link: ./challenges/ + title: Úlohy + details: Řešení úloh + - icon: 🛠 link: ./troubleshooting/ title: Troubleshooting diff --git a/students/troubleshooting/index.md b/students/troubleshooting/index.md new file mode 100644 index 0000000..30ae534 --- /dev/null +++ b/students/troubleshooting/index.md @@ -0,0 +1,3 @@ +::: info INFO ⚒ +Tato stránka není hotová a je stále v procesu psaní. +::: diff --git a/teachers/basics/index.md b/teachers/basics/index.md new file mode 100644 index 0000000..b7a9325 --- /dev/null +++ b/teachers/basics/index.md @@ -0,0 +1,23 @@ + +::: info INFO ⚒ +Tato stránka není hotová a je stále v procesu psaní. +::: + + + +Předpokládá se seznámení se studentským pohledem na stránky v [studentské sekci](./../../students/) + +rozdíly v učitelském rozhraní: +- Detail úlohy + - příručka + - uživatelé +- katalog + - jsou vidět všechny úlohy + - zadávání +- Žebříčky + - live feed zobrazuje všechny uživatele +- celá "Spravovat" sekce + + \ No newline at end of file diff --git a/teachers/index.md b/teachers/index.md new file mode 100644 index 0000000..e7ab968 --- /dev/null +++ b/teachers/index.md @@ -0,0 +1,22 @@ +--- +layout: home + +hero: + name: Učitelé + tagline: |- + Navigace platformou, + Úlohy – zadávání, vyhodnocování + + +features: + - icon: 👨‍🎓 + link: ./basics/ + title: Základy + details: Struktura platformy a návody pro učitele + + - icon: 🛠 + link: ./troubleshooting/ + title: Troubleshooting + details: Řešení na běžné problémy + +--- \ No newline at end of file diff --git a/teachers/troubleshooting/index.md b/teachers/troubleshooting/index.md new file mode 100644 index 0000000..b9864c8 --- /dev/null +++ b/teachers/troubleshooting/index.md @@ -0,0 +1,3 @@ +::: info INFO ⚒ +Tato stránka není hotová a je stále v procesu psaní. +::: \ No newline at end of file From 5fdb3c00300cdb53548848b2445a06edf5531b31 Mon Sep 17 00:00:00 2001 From: encyk Date: Sat, 16 Sep 2023 17:58:05 +0200 Subject: [PATCH 4/5] docs: difference between student and teacher view --- teachers/basics/StopRunningInstance.png | Bin 0 -> 3638 bytes teachers/basics/index.md | 84 +++++++++++++++++++----- 2 files changed, 68 insertions(+), 16 deletions(-) create mode 100644 teachers/basics/StopRunningInstance.png diff --git a/teachers/basics/StopRunningInstance.png b/teachers/basics/StopRunningInstance.png new file mode 100644 index 0000000000000000000000000000000000000000..7597007c0c8db6f4e53fe6ef92e28e0d62a2ff52 GIT binary patch literal 3638 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 IM6N<$f)^t2RR910 literal 0 HcmV?d00001 diff --git a/teachers/basics/index.md b/teachers/basics/index.md index b7a9325..c6273b9 100644 --- a/teachers/basics/index.md +++ b/teachers/basics/index.md @@ -1,23 +1,75 @@ +# Základní používání platformy HAXAGON pro učitele a lektory -::: info INFO ⚒ -Tato stránka není hotová a je stále v procesu psaní. +::: info +Celá tato sekce předpokládá znalost funkcí platformy z pohledu studentů. +Pro lepší porozumnění si proto nejdříve projděte [studentskou sekci](./../../students/). ::: +# Odlišnosti od studentského rozhraní + +Učitelé vidí na některých stránkách více věci, než studenti. V této sekci si probereme právě tyto rozdíly. + +## Detail úlohy + +Každou úlohu si učitelé mohou spustit, stejně jako jejich žáci. Navíc ale v detailu každé úlohy mají k dispozici několik nástrojů a informací navíc. + +### Příručka + +První z nich je záložka "Příručka", která se se nachází těsně pod krátkým popisem úlohy, vedle záložek "Vlajky" a "Řešitelé". Tedy pokud ji daná úloha má definovanou. Může se stát, že autor úlohy příručku vynechá. + +V příručce standardně bývá opsané zadání úkolů a podrobné návody, jak postupovat při jejich řešení. Ty mohou posloužit učitelům při výkladu a vysvětlování některých metod, nebo třeba když potřebují popostrčit studenta k vyřešení některého z úkolů. + +### Uživatelé + +Druhou záložkou exkluzivně pro učitele jsou "Uživatelé". Tam jsou vypsáni věichni studenti, kteří mají úlohu zadanou. +Vedle každého studenta je vidět status jeho instance úlohy (offline, splněná, běžící, spouštění nebo zastavování). +U každého studenta se také zobrazuje v reálném čase počet vlajek, které splnil. + +Učitel má několik možností, jak spravovat instance úlohy: + +- U běžících instancí může zcela vpravo vybrat možnost "Zastavit běžící úlohu" +![Screenshot tlačítka pro zastavení běžící úlohy studenta](./StopRunningInstance.png) + +- V levé části tabulky může zaškrtávacími políčky vybrat více studentů, kterým chce zastavit úlohu, což provede tlačítkem nad tabulkou. + Toto se hodí třeba po hodině, když si studenti zapomenou vypnout úlohy - stačí zaškrtnou všechny tlačítkem v hlavičce tabulky a hromadně instance zastavit. + +- Nebo pokud při [zadávání úlohy](#zadavani-uloh) v počátku špatně odhadl potřebný čas, nebo prostě jen studentům čas vypršel, může všem studentům resetovat čas na plnou původní hodnotu tlačítkem nad tabulkou. + +### Mazání úlohy + +Posledním z administrativních nástrojů je možnost smazat zadanou úlohu. + +Tím zmizí studentům ze stránky [Přehled](/students/basics/index.md#prehled), z [Katalogu](/students/basics/index.md#katalog) a body, které za úlohu získali, se jim odečtou z žebříčků. +::: warning Pozor! +Mazání úlohy nevyžaduje potvrzení, takže pozor na ukliknutí-se –⁠ smazání úlohy smaže studentům i všechen jejich postup v dané úloze. + +::: + + +## Katalog + +Na stránce katalog vidí učitelé, na rozdíl od studentů, všechny dostupné okruhy úloh. U každého okruhu navíc mají v pravém horním rohu informaci, kolik úloh je zadaných právě vybrané skupině. + +V detailu kategorie jsou zadané úlohy rozlišeny barvou čísla a textem "Zadáno" pod jménem každé úlohy. + +Více o zadávání úloh dále na této stránce v sekci [Zadávání Úloh](#zadavani-uloh). + + +## Žebříčky + +Jediný dozdíl pro učitelské účty na stránce Žebříčky je živý záznam vlajek v horní části stránky. Učitelům se zde ukazují všechny nové vlajky všech studentů v právě vybrané skupině. + + +# Zadávání úloh + + +::: info INFO ⚒ +Tato stránka není hotová a je stále v procesu psaní. +::: -Předpokládá se seznámení se studentským pohledem na stránky v [studentské sekci](./../../students/) -rozdíly v učitelském rozhraní: -- Detail úlohy - - příručka - - uživatelé -- katalog - - jsou vidět všechny úlohy - - zadávání -- Žebříčky - - live feed zobrazuje všechny uživatele -- celá "Spravovat" sekce - \ No newline at end of file +# Správa skupin From 3d312ff4bbf972b997ec5d0b37f277a7266374f2 Mon Sep 17 00:00:00 2001 From: encyk Date: Mon, 18 Sep 2023 20:21:01 +0200 Subject: [PATCH 5/5] docs: assigning challenges --- teachers/basics/BackToPickingChallenges.png | Bin 0 -> 5457 bytes teachers/basics/RemainingChallengeTime.png | Bin 0 -> 4438 bytes teachers/basics/index.md | 58 +++++++++++++++++++- 3 files changed, 56 insertions(+), 2 deletions(-) create mode 100644 teachers/basics/BackToPickingChallenges.png create mode 100644 teachers/basics/RemainingChallengeTime.png diff --git a/teachers/basics/BackToPickingChallenges.png b/teachers/basics/BackToPickingChallenges.png new file mode 100644 index 0000000000000000000000000000000000000000..5bd749266fee73e746f6519f2dd8b62bfb539bb8 GIT binary patch literal 5457 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 CB59xi literal 0 HcmV?d00001 diff --git a/teachers/basics/index.md b/teachers/basics/index.md index c6273b9..0019f1e 100644 --- a/teachers/basics/index.md +++ b/teachers/basics/index.md @@ -65,11 +65,65 @@ Jediný dozdíl pro učitelské účty na stránce Žebříčky je živý zázna # Zadávání úloh +Proces zadávání úloh začíná v [Katalogu úloh](/students/basics/index.md#katalog). Zde si učitelé mohou projít všechny úlohy podle kategorií, prohlédnout si jejich teorii i Příručku s postupem řešení. +V každé kategorii je jasně vidět, které úlohy jsou již pro vybranou skupinu zadané a které ještě ne. -::: info INFO ⚒ -Tato stránka není hotová a je stále v procesu psaní. +Zadávání funguje podobnou formou, jako nákupní košíky v e-shopech: Vyberete položky (úlohy), tlačítkem "Přidat" je přidáte do Košíku, který si je pamatuje napříč celou webovou stránkou –⁠ můžete si tedy libovolně prohlížet detaily úloh. Košík také fugnuje mezi jednotlivými kategoriemi v Katalogu, můžete tedy přidat jednu úlohu z kategorie "Web", vrátit se do přehledu a vybrat další úlohu na příklad z kategorie "Crypto". +Pro zadání všech úloh z kategorie lze použít tlačítko nad seznamem úloh, pod popiskem kategorie. + +## Košík + +Košík vybraných úloh pro zadání se nachází v pravé části obrazovky (nebo zcela nahoře na mobilních telefonech). + +Na vrchu košíku je jednoduché shrnutí zadání, tedy kolik celkových úloh bude zadáno a jaký je souhrnný odhadovaný čas potřebný pro vyřešení. + +Dále jsou podrobnější informace o jednotlivých úlohách: Jejich jméno, počet vlajek, odhadovaná časová náročnost a štítky. +Pořadí, v jakém jsou zde úlohy vylistovány nemá žádný význam, je to pouze pořadí, ve kterém je učitel vybral. + +Každou úlohu je možné odebrat z košíku několika způsoby: + +- V seznamu úloh v rámci kategorie bude mít úloha, která je v košíku, vedle sebe tlačítko "Odebrat" +- Přímo v košíku má vedle sebe každá úloha malý červený křížek +- Nad seznamem úloh v košíku je také možnost košík vyprázdnit tlačítkem "🗑 Vše" + +## Zadání délky úloh + +Pokud jste spokojeni se seznamem vybraných úloh pro zadání, pokračujte tlačítkem "Zadat úlohy" na spodku košíku. + +Na této obrazovce je možné nastavit kolik času budou mít studenti na vyřešení úloh. + +Délka úlohy znamená čas, po který mají studenti povoleno mít úlohu spuštěnou a pracovat na ní, tedy čas, po který poběží servery a za který bude škola účtována. +Na některých úlohách je možné pracovat i bez spuštění, pokud obsahují všechny informace k řešení v popisku. Většinou je ale potřeba úlohy pro práci spouštět, aby se studenti mohli připojit na simulované zařízení. +![Screenshot příkladu úlohy, u které zbývá pro vyřešení pouze hodina a třičtvrtě z původně zadaných dvou hodin.](./RemainingChallengeTime.png) + +::: tip +Vybraný čas se aplikuje pro všechny vybrané úlohy. Pro nastavení rozdílného času pro různé úlohy je nutné zadat úlohy jednotlivě. ::: +Čas je možné vybrat buďto výberem z možností v levé části, nebo posuvníkem. Oba mají stejnou funkci. +Pod délkou úloh je krátké shrnutí zadání: Které skupině budou úlohy zadány a o kterou skupinu se jedná. + +::: tip +Kdykoliv během procesu zadávání je možné [změnit skupinu](/students/basics/index.md#zakladni-pouzivani-platformy-haxagon) výběrem v horní části navigačního menu stránky. +::: + +
+ +::: info +V budoucnu v této sekci přibudou i další možnosti nastavení, na příklad možnost uveřejnit zadané úlohy až od zadaného data a času nebo podobné vychytávky. +::: + +Pokud chcete v tomto kroku upravit, které úlohy se zadají, využijte tlačítko "1. Úkoly" zhruba vprostřed stránky pod shrnutím počtu a odhadované délky úloh. +![Screenshot tlačítka "1. Úkoly" vlevo od tlačítka "2. Délka trvání, pod shrnutím počtu a odhadované délky úloh."](./BackToPickingChallenges.png) + +
+ +Celý proces zadávání se ukončí tlačítkem "Zadat úlohy", které zpřístupní vybrané úlohy studentům. # Správa skupin + +::: info INFO ⚒ +Tato stránka není hotová a je stále v procesu psaní. +::: +