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: info@python.sk.

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: info@python.sk

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).

microbitsk / microbit.github.io