README.sk-SK.md

Paralelná Polis Košice

English | Slovensky

---

Písanie

Blogové príspevky sa nachádzajú v zložke ./src/pages/blog a sú písane pomocou syntaxe Markdown.

Pridanie/úprava príspevkov

• vytvor nový pull request s tvojimi zmenami
• pokiaľ máš právo na zápis do repozitára, môžeš sa prihlásiť do administrácie a editovať príspevky jednoducho pomocou Netlify CMS

Vývoj

Prerekvizity

• potrebuješ mať nainštalovaný node a npm (node package manager), aby si mohol vytvoriť a spustiť stránku lokálne na tvojom počítači. Použi LTS verziu (verzia s dlhodobou podporou).
• git je potrebný pre pridanie nových zmien; môžeš použiť aj programy, ktoré ti s tým môžu pomôcť.
  • vytvor si nový SSH kľúč a pripoj ho k tvojmu GitHub účtu
  • ako pracovať s git-om? Pozri si túto jednoduchú príručku
• použi svoj obľúbený editor (pokorne odporúčame vscode)

Inštalácia

V príkazovom riadku spusti tieto príkazy:

git clone git@github.com:ParalelnaPolisKE/paralelnapoliskosice.sk.git
cd paralelnapoliskosice.sk
npm install

Skopíruj súbor .env.example do .env (aj s bodkou v názve na začiatku) a nastav správne konštanty (alebo ich nechaj prázdne).

Premenné prostredia v .env

Názov premennej	Povinná	Default hodnota	Popis
FACEBOOK_ACCESS_TOKEN	Áno	null	Prístupový token pre Facebook

Lokálne spustenie stránky

V zložke projektu spusti:

npm start

Dostupné príkazy

npm run ...	Popis
npm start	spúšťa lokálny vývojový server na adrese localhost:8000
npm run build	vytvára verziu vhodnú pre ostrú prevádzku
npm run format	opravuje programovacie štandardy
npm run serve	spúšťa lokálny server vhodný pre testovanie

Programovacie štandardy

Prosím, dodržuj štandardy definované pomocou EditorConfig a Prettier - použi príkaz npm run format na automatické formátovanie kódu.

VS Code

Môžeš nainštalovať niekoľko odporúčaných doplnkov, ktoré ti môžu pri vývoji pomôcť.