micorbit:Slovensko webstránka

Switch README.rst to English

Webová stranka microbit:Slovensko, založená na frameworku Flask, z ktorého sa vygeneruje statické HTML. Stránka nie je vyvíjaná a je presmerovaná na https://ucimeshardverom.sk

Ako pomôct?

Od komunity pre komunitu. Stránka je spravovaná dobrovoľníkmi a budeme veľmi radi keď sa pridáš. Príspevky su viac než vítané. Prečítaj si našu prispievateľskú príručku a pridaj sa k nám!

Štruktúra projektu

1 branch:

• master - Flask aplikácia, šablony, statické súbory.

Adresare

• root - Flask aplikácia je koreňovom adresáry.
• docs - Vygenerovaná statická webová stranka microbit:Slovensko. Neditujte súbory v tomto adresáry, lebo budú pregenerované! Postup na vygenerovanie je popísany nižšie.

Inštalácia

Pre vývoj používame Python 3. Príkazy su pre terminál v Linuxe, ale mali by fungovať aj pre Mac OS.

• Naklonujeme si repozitár lokálne ku sebe:

  git clone https://github.com/microbitsk/microbit.github.io
  cd microbit.github.io
  

• Vytvoríme si Python virtualné prostredie (modul venv je súčasť Python 3) a nainštalujeme všetky potrebné závislosti:

  python3 -m venv envs3
  

• Aktivujeme Python virtuálne prostredie:

  source envs3/bin/activate
  

• Nainštalujeme závislosti:

  pip install -r requirements.txt
  

• Spustíme Flask server a prípadne otvoríme vo webovom prehliadači (http://127.0.0.1:5000):

  python views.py
  

Pokiaľ nájdete chyby, prosím nahláste ich! Vytvorte prosím issue na GitHube. Ak máte nápad na zlepšenie, môžete vytvoriť issue na GitHube, alebo nám napíšte email: [email protected].

Preklady

Pomôžte nám preložiť stránku do cudzích jazykov. Na preklad nemusíte mať žiadnu znalosť programovania, stačí vedieť iba cudzí jazyk. Preklad zabezpečujeme pomocou služby crowdin.com.

Vygenerujeme statickú stránku

Frozen-Flask "zamrzne" Flask aplikáciu do statických súborov. Výsledok môže byť uložený na servery a zobrazovanú iba pomocou klasického web serveru.

• vygenerujeme statickú stránku, výsledok je uložený v docs adresáry:

  python freezer.py
  

• preveríme výsledok v prehliladači (http://127.0.0.1:8000/en/index.html):

  cd docs
  python -m SimpleHTTPServer 8000
  

Continuous Deployment

Všetko čo sa dostane to master vetvy (branch) je automaticky zobrazené na servery. Zobrazuje sa iba vygenerovaná statická stránka ktorá je v docs adresáry.

Webové odkazy

• web: https://www.microbit.sk, https://www.micropython.sk, https://www.python.sk
• email: [email protected]

Licencia

MIT licencia pre kód (GitHub repo), CC-BY pre ostatný obsah (pokiaľ nie je stanovené ináč). Viac informácií o licenciách je v súbore LICENSE (iba po anglicky).