Spletna stran RKV

Ta repozitorij vsebuje vso gradivo, ki sestavlja spletno stran Radiokluba Vegova. Uporabljeno je ogrodje Next.js.

Struktura imenikov

• content/blog/ vsebuje izvorne datoteke objav v formatu MDX
• public/ hrani slike, fotografije in dokumente
• src/ pa ima izvorno kodo spletne strani

Pisanje ali urejanje članka

Najprej prenesite ali se sinhronizirajte z delovno različico repozitorija:

• git clone git@gitlab.vegova.si:rkv/spletisce.git, če ga še nimate
• git pull --prune, če imate repozitorij prenesen in so datoteke nedotaknjene
• git fetch --prune, kontrola in git merge origin, če imate v repozitoriju spremembe, ki so lahko v sporu

Članki s kratkim, a nazornim datotečnim imenom brez presledkov (besede ločene z -), spadajo v imenik content/blog/<leto>, morebitno pripadajoče slikovno in fotografsko gradivo pa v public/images/blog/<ime-članka>/. Fotografije naj bodo v formatu JPG, slike v PNG (lahko tudi v drugih formatih, če ustrezajo).

Primer članka: content/blog/2024/izpit-izid.mdx

Novo datoteko pripravite s kopiranjem enega od obstoječih člankov. S tem si boste zagotovili potrebno preambulo (metapodatke na začetku datoteke) in osnovo za pisanje svojega besedila.

Po pisanju je zaželeno preveriti korektnost datotek, kot je opisano v kasnejšem poglavju (Lokalno delo). Če nimate npm-a in tega ne morete storiti, ne bo konec sveta, se pa lahko kasneje pojavi napaka, ki jo bo treba naknadno odpravljati.

Sledi vnos v Git. Ker je neposreden potisk v glavno vejo repozitorija zaklenjen, je potrebno ustvariti novo (npr. z git switch -c novi-clanek) in vanjo objaviti spremembe (npr. git add content/blog/2025/novi-clanek.mdx in git commit). Naslov sporočila naj bo jedrnat, nimamo pa strogih pravil glede tega.

Preostane še potisk veje na strežnik: git push origin novi-clanek. Ob uspehu naj bi se izpisal URL, ki vodi do zahtevka za združitev vej, obvestilo o tem pa se pojavi tudi v spletnem vmesniku. Tega se po potrebi dopolni (opis, določitev uporabnikov za pregled) in odda. Eden od uporabnikov z uredniškimi pravicami bo zahtevek potrdil, po potrebi tudi pokomentiral.

Za validacijo in objavo člankov deluje samodejni tristopenjski cevovod, ki ob vsaki spremembi spletne strani preveri sintakso, izgradi končno različico in jo objavi. V tej točki lahko pride do težav, ki jih je treba odpraviti z urejanjem lokalnih datotek in vnovičnim potiskom.

Če so zahtevane spremembe, bodisi vsebinske bodisi sintaktične, se lokalne datoteke uredi in potisne v isto vejo, GitLab pa bo zahtevek posodobil. V primeru, da je sprememb malo, lahko izvedemo:

<popravki datoteke>
$ git add -u
$ git commit --amend  (sporočilo lahko ostane isto)
$ git push --force origin novi-clanek

Lokalno delo

Če imate nameščene pakete za Next.js:

• yarn dev (lokalni spletni strežnik)
• yarn lint (preverjanje sintakse)
• yarn format (preoblikovanje datotek po pravilih)

Sicer so na voljo operacije prek Docker zabojnika:

• docker build --rm -t rkv-spletisce . (izgradnja zabojnika)
• docker run -it --name rkv-spletisce -p 3000:3000 rkv-spletisce (zagon lokalnega spletnega strežnika na vratih 3000)