s59veg/spletisce
2
0
Fork 0
mirror of https://gitlab.vegova.si/rkv/spletisce.git synced 2025-08-15 09:37:42 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

chore: Update readme

Browse Source
This commit is contained in:
Jakob Kordež
2025-02-16 18:32:22 +01:00
parent 4dad2a6c59
commit 5493e1d05a
1 changed files with 5 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
README.md
View File

@ -16,13 +16,15 @@ Najprej prenesite ali se sinhronizirajte z delovno različico repozitorija:
- `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 in vodilnim datumom, v obliki `leto-mesec-dan_<naslov>`, spadajo v imenik `content/blog/`, 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).
Č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`](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.
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/novi-clanek.md` in `git commit`). Naslov sporočila naj bo jedrnat, nimamo pa strogih pravil glede tega.
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.