gw0 / akademija-fri-www

Spletna stran Akademije FRI

Spletna stran Akademije FRI

Dobrodošli na repozitoriju izvorne kode spletne strani Akademije FRI.

Spletna stran je izdelana z uporabo statičnega generatorja Hugo. Vsebina veje (angl. branch) master se samodejno objavi na spletnem naslovu https://akademijafri.si z uporabo Netlify.

Build with ❤️ using Hugo.

Urejanje vsebine

Vsebino je možno urejati na dva načina.

1. Da kontaktirate vzdrževalca spletne strani (Alenko Bone)
2. Lastno, z uporabo GitHub Pull Request

Kako poteka lastna sprememba vsebine?

Na kratko:

1. Pripravite lokalno okolje
2. Naredite fork repozitorija na GitHub
3. Z uporabo git, klonirajte fork repozitorija
4. Uredite vsebino ter lokalno preverite
5. Z uporabo git, ustvarite commit ter ga potisnete na svoj fork repozitorija (git push)
6. Na GitHub strani vaše kopije (fork) repozitorija, ustvarite pull request (zahtevek za spremembo)
7. Vzdrževalec spletne strani bo vaše spremembe pregledal ter potrdil. O tem boste obveščeni preko emaila.

Priprava lokalnega okolja

Zunanje programske odvisnosti

Programske pakete, ki jih boste potrebovali:

• Hugo (navoidla za namestitev)
• GNU Make

Samo za produkcijo:

• ImageMagick

Struktura repozitorija

Hugo preslika datoteke Markdown v HTML za spletno stran. Na slednji povezavi so kratka navodila za sintakso Markdown.

Vsebina spletne strani je v direktoriju content.

Zaradi večje fleksibilnosti, ko se sklicujete na ostale vire spletne strani, spustite domeno. To seveda ne velja, ko se sklicujemo na zunanje spletne strani. Torej ne https://akademijafri.si/foo/bar, ampak /foo/bar. Tako ohranimo pravilne poti povezav, ko prestavljamo spletno stran na različne domene (npr. lokalno, produkcija, testni strežnik itd.).

Izobraževanja

Vsebina izobraževanj so razdeljene:

• content/izobrazevanje - izobraževanja, ki se izvajajo ob predpisanem terminu (na spletni strani so objavljena kot aktualna in pretekla)
• content/za-podjetja - izobraževanja namenjena za podjetja
• content/za-sole - izobraževanja namenjena za osnovnošolce ter dijake

Izvajalci

Direktorij content/izvajalci vsebuje strani izvajalcev. Če želite dodati izvajalca, ustvarite datoteko ter prepišite strukturo od enega izmed ostalih izvajalcev.

Obvezna polja so: title, firstName, lastName, date, bgImage in image.

Sledite navodil slike in datoteke, da naložite svojo sliko.

Slike in datoteke

Če želite objavti slike ali ostale datoteke, jih lahko kopirajte v direktorij static/uploads. Končna povezavo na vir bo <DOMENA_STRANI>/uploads/<IME_DATOTEKE> (brez static!).

Lokalno zaganjanje strani

Odprite terminal in se primaknite v repozitorij (cd <pot do repositorija>/akademija-fri-www)

Z uporabo ukaza:

make

boste zagnali lokalni strežnik na http://localhost:1313. Spremembe vsebin spletne strani boste lahko v živo si ogledali na prejšnji povezavi.

Napredno

CMS

Spletna stran uporablja Netlify CMS za grafično urejanje vsebine.

URL CMS je na: /admin.

Zaradi tehničnih omejitev (omejeno število računov ter pomanjkanje možnosti določitev pravic) ima dostop do CMS samo vzdrževalec spletne strani.

Ostali make ukazi

Produkcija

# Replace "http://example.com" with the base url of the site
make build-prod url=http://example.com 

Build produkcije bo nastavil ločljivost vseh .jpg slik v direktoriju static/uploads na širino 1920px (razmerje ločljivosti se bo ohranilo).

Za ta proces je potreben ImageMagick.

Ostalo

make clean  # run after "make build-dev" or "make build-prod"

Zbriše datoteke, ki jih make build-prod generira.