To je repozitorij spletne strani osgeo.si. Stran je statična, vsa vsebina pa živi v mapi content/ kot navadne Markdown datoteke. To pomeni, da lahko vsak prispeva — brez nameščanja kakršne koli programske opreme. Spreminjaš direktno na GitHubu, ob commitu se stran samodejno zgradi in objavi.

💡 Še nisi delal/a z Markdownom ali GitHubom? Brez panike — pri vsakem koraku spodaj je predloga, ki jo samo prilepiš in zamenjaš vrednosti.

Vsak commit v vejo main (preko GitHub web UI ali git push) samodejno sproži GitHub Actions workflow .github/workflows/deploy.yml, ki:

1. Naredi gradnjo strani (npm run build),
2. Objavi rezultat na vejo gh-pages,
3. GitHub Pages pa servira to vejo pod domeno osgeo.si.

Skupni čas od commita do objave ~2–3 min. Status posameznega buildanja vidiš na zavihku Actions. Če katero zgradbo poči (rdeč krogec), klikni nanjo za logiranje napake — najpogosteje je razlog napaka v YAML frontmatter datoteki (npr. manjkajoči narekovaji).

✅ Ni možnosti, da z napačnim commitom prestrelimo produkcijo — če gradnja ne uspe, stara verzija strani ostane objavljena. Lahko se varno učiš.

• Hitri pregled mape content/
• ✍️ Dodajanje dogodka
• 📰 Dodajanje novice
• 📸 Dodajanje galerije fotografij
• 📄 Urejanje obstoječe strani (O nas, GeoDev, …)
• 🗺️ Kako pridobiti koordinate
• 📝 Markdown — osnove
• 🧪 Lokalni predogled (neobvezno)
• 💬 Potrebuješ pomoč?
• 🛠️ Za razvijalce

content/
├── events/                       # dogodki, razdeljeni po seriji
│   ├── geodev/                       # GeoDev meetupi
│   ├── osgeo-konferenca/             # letne konference
│   └── svizec/                       # Svizec — skupnostni dogodki
├── news/                         # bilten / novice
└── pages/                        # opisi sekcij (O nas, GeoDev, …)

Vse datoteke so .md (Markdown). Vsak dogodek/novica/stran je svoja datoteka. Slike za galerijo gredo v sosednjo mapo z enakim imenom kot .md datoteka.

• Na GitHubu odpri zgornjo mapo.
• Klikni Add file → Create new file (zgoraj desno).
• Poimenuj jo, npr. geodev-15.md (uporabi enak - slog kot drugi).

---
title: "GeoDev Meetup #15"
slug: geodev-15
date: 2026-02-12
time: "18:00"
location: "Mesto, ulica 1, Ljubljana"
lat: 46.0518
lng: 14.4727
eventUrl: "https://forms.gle/..."
tags: [geodev]
---

Pozdravljeni!

Vabljeni na petnajsti GeoDev meetup, ki bo …

## Program

**Predavanje 1 — Naslov predavanja**

Kratek opis predavanja.

_Ime Priimek, organizacija_

---

**Predavanje 2 — Naslov**

…

## Ostalo

Dogodek je brezplačen in odprt vsem. Pridruži se.

* Brez lat/lng se dogodek ne pojavi na zemljevidu, vse ostalo pa deluje normalno.

Za vsak nov dogodek priporočamo, da naredimo Luma dogodek na lu.ma (brezplačno, brez registracije za udeležence) in njegov URL prilepimo v eventUrl:. Luma poskrbi za:

• potrditveni e-mail,
• opomnike pred dogodkom,
• listo udeležencev,
• kapaciteto z waiting listo,
• dodajanje v koledar.

Tudi gumb "Dodaj v koledar" na strani dogodka deluje samodejno (generiran iz date, time, end_date v frontmatter), ne glede na to, kateri RSVP servis uporabimo.

Spusti se na dno strani, vpiši kratek opis spremembe (npr. Add GeoDev #15) in klikni Commit changes. Po nekaj minutah je dogodek na strani.

Novice so kratka poročila o sodelovanju na hackathonih, konferencah, ali pomembne objave iz društva.

Poimenuj jo s predpono datuma za vrstni red: YYYY-MM-DD-kratek-opis.md

Primer: 2026-05-16-geo-slovenija-hackathon.md

---
title: "Naslov novice"
slug: kratek-opis             # uporabljen v URL: /novice/kratek-opis
date: 2026-05-16
summary: "Kratek povzetek (1–2 stavka). Pokaže se na kartici novice."
tags: [hackathon, sodelovanje]
---

Pozdravljeni!

Tu napišeš celotno besedilo novice. Lahko uporabiš **krepko**, _ležeče_, [povezave](https://primer.si) in seznam:

- točka 1
- točka 2
- točka 3

## Podnaslov, če je daljši članek

Več besedila …

Galerija je opcijska. Velja enak postopek za dogodke in novice:

1. Naredi mapo z istim imenom kot .md datoteka (brez končnice .md):

   content/events/geodev/
   ├─ geodev-12.md
   └─ geodev-12/                     ← ista mapa kot .md (brez končnice)
      ├─ 01-uvod.jpg
      ├─ 02-druzenje.jpg
      └─ 03-skupscina.jpg
   

2. Naloži slike (na GitHubu: Add file → Upload files).

• Vrstni red: imena začni z 01-, 02-, … — to določa vrstni red v galeriji.
• Opis (alt tekst): preostanek imena postane opis slike za dostopnost. Primer: 02-druzenje-po-predavanjih.jpg → "druzenje po predavanjih".
• Formati: .jpg, .jpeg, .png, .webp.
• Velikost: priporočena dolžina daljše stranice ~2400 px. Večje slike po nepotrebnem upočasnijo stran.

Pri novicah lahko ena slika služi kot kartični cover (naslovnica):

• Najlažje: poimenuj jo cover.jpg (ali .png/.webp) — sistem jo prepozna avtomatsko.
• Ali pa v glavo .md datoteke dodaj: cover: ime-datoteke.jpg.

Cover slika se prikaže kot velika slika na vrhu novice in kot sličica na kartici. Preostale slike iz mape gredo v galerijo.

Klik na sliko v galeriji odpre polnozaslonski pregledovalnik:

• Esc zapre
• ← / → za navigacijo med slikami

Opisi posameznih sekcij so v mapi content/pages/:

Klikni datoteko, klikni svinčnik (✏️) za urejanje, naredi spremembe, na dnu klikni Commit changes.

Posebnost glave datoteke pages/*.md:

---
title: "Naslov strani"
tagline: "Kratek podnaslov pod naslovom (opcijsko)"
---

Najlažje preko OpenStreetMap ali Google Maps:

1. Odpri openstreetmap.org
2. Poišči lokacijo
3. Desni klik → Show address (Pokaži naslov)
4. Koordinati sta v zgornjem desnem kotu: prva je lat, druga lng

1. Odpri google.com/maps
2. Poišči lokacijo
3. Desni klik na zemljevidu na pravo točko
4. Prikaže se par številk — najprej lat, potem lng
5. Klikni nanju in se skopirata v odložišče

Primer za Ljubljano: lat: 46.0518, lng: 14.4727

Štiri decimalke so več kot dovolj.

Telo datoteke (pod glavo ---) je v Markdownu. Tu je hitri pregled:

# Naslov (H1) — uporabi le enkrat (sicer pa naslov stran prevzame iz frontmatterja)

## Podnaslov (H2)
### Pod-podnaslov (H3)

**krepko**  ·  _ležeče_  ·  ~~prečrtano~~

[Povezava](https://primer.si)

- alineja
- še ena alineja
  - vgnezdena

1. oštevilčen seznam
2. druga točka

> Citat ali opomba

`inline koda` ali blok:

```python
print("hello")

> Več: [GitHub Markdown vodič](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)

---

## 🧪 Lokalni predogled (neobvezno)

Če želiš pred objavo videti, kako bo sprememba izgledala na strani (npr. preveriti, ali se nova novica res prikaže pravilno z galerijo), lahko stran zaženeš lokalno na svojem računalniku.

**Predpogoj:** nameščen [Node.js](https://nodejs.org/) (vzemi LTS verzijo — 20 ali novejšo).

```bash
# 1. Kloniraj repozitorij
git clone git@github.com:OSGeo-si/landing-page.git
cd landing-page

# 2. Naloži odvisnosti (samo enkrat)
npm install

# 3. Zaženi lokalni strežnik
npm run dev

Terminal ti bo izpisal Local: http://localhost:5173/ — odpri to povezavo v brskalniku.

Stran se samodejno osveži ob vsaki spremembi datoteke (.md, .vue, slika …). Idealno za testiranje nove novice ali dogodka pred commitom.

ℹ️ Lokalno testiranje ne vpliva na produkcijsko stran — ta se posodobi šele, ko pushaš spremembe v main na GitHubu. Tudi če pri lokalnem testiranju kaj zlomiš, na osgeo.si tega nihče ne vidi.

• E-pošta: osgeoslovenija@gmail.com
• Discord: pridruži se skupnosti
• Issue: odpri vprašanje na GitHubu — vsa vprašanja so dobrodošla

Stran je zgrajena z Vue 3 + Vite + Tailwind v4. Vsebina (markdown + slike) se z import.meta.glob zbira ob build času, zato je celotna spletna stran statična in se gosti na GitHub Pages.

npm install
npm run dev      # lokalni razvojni strežnik
npm run build    # produkcijska gradnja v ./dist
npm run preview  # pregled zgrajene strani

src/
├── components/        # SiteHeader, EventCard, EventMap, NewsCard, …
├── views/             # podstrani (HomePage, EventPage, NewsItemPage, …)
├── composables/       # useDarkMode
├── content.js         # branje markdowna (Vite glob) + frontmatter
├── style.css          # Tailwind v4 z OSGeo barvno paleto
├── router.js
└── main.js
content/               # vsa vsebina (glej zgoraj)
public/                # statične datoteke (PDF-i, favicon, sponsorji)

Push v main sproži workflow .github/workflows/deploy.yml, ki zgradi stran in jo objavi na gh-pages veji. Domena osgeo.si je nastavljena preko CNAME datoteke v korenu repozitorija.