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.
Vsebino je možno urejati na dva načina.
- Da kontaktirate vzdrževalca spletne strani (Alenko Bone)
- Lastno, z uporabo GitHub Pull Request
Na kratko:
- Pripravite lokalno okolje
- Naredite fork repozitorija na GitHub
- Z uporabo git, klonirajte fork repozitorija
- Uredite vsebino ter lokalno preverite
- Z uporabo git, ustvarite commit ter ga potisnete na svoj fork repozitorija (
git push
) - Na GitHub strani vaše kopije (fork) repozitorija, ustvarite pull request (zahtevek za spremembo)
- Vzdrževalec spletne strani bo vaše spremembe pregledal ter potrdil. O tem boste obveščeni preko emaila.
Programske pakete, ki jih boste potrebovali:
Samo za produkcijo:
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.).
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 podjetjacontent/za-sole
- izobraževanja namenjena za osnovnošolce ter dijake
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.
Č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
!).
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.
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.
# 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.
make clean # run after "make build-dev" or "make build-prod"
Zbriše datoteke, ki jih make build-prod
generira.