prosberry/README.md

1. Opis Projekta

Prosberry.si je profesionalna spletna stran za podjetje PROSBERRY, Amra Kurešepi Zulji s.p. Stran služi kot digitalna vizitka in informacijska točka za storitve, ki jih podjetje ponuja. Glavni cilj projekta je predstaviti strokovnost in osebni pristop Amre Kurešepi Zulji na področju jezikovnega izobraževanja in medkulturnega posredovanja.

Spletna stran je zasnovana kot statična stran (HTML, CSS, JavaScript), kar zagotavlja hitro nalaganje in enostavno vzdrževanje. Za funkcionalnost kontaktnega obrazca se uporablja PHP. Projekt vključuje tudi nabor skript za avtomatizacijo (Python in Shell), ki poenostavljajo procese, kot so optimizacija slik in posodabljanje ponavljajočih se elementov (glava, noga).

Glavne funkcionalnosti in vsebine:

• Predstavitev storitev: Podroben opis jezikovnih tečajev (angleščina, albanščina, slovenščina), medkulturnega posredovanja in specializiranih delavnic.
• Osebna predstavitev: Stran "Kdo sem" z osebno zgodbo in kvalifikacijami izvajalke.
• Cenik in reference: Pregled cen storitev in mnenja zadovoljnih strank.
• Kontaktni obrazec: Enostaven način za pošiljanje povpraševanj.
• Pogosta vprašanja (FAQ): Odgovori na najpogostejša vprašanja za lažje informiranje obiskovalcev.
• Odziven dizajn: Stran je prilagojena za optimalen prikaz na različnih napravah (mobilni telefoni, tablice, namizni računalniki).

2. Struktura Projekta (Zemljevid)

.
├── assets
│   ├── favicon
│   │   └── site.webmanifest
│   ├── images/
│   └── pdf/
├── cene-in-reference
│   └── index.html
├── cene-in-sodelovanja
│   └── index.html
├── css
│   ├── animations.css
│   └── style.css
├── delavnice
│   └── index.html
├── js
│   └── main.js
├── kdo-sem
│   └── index.html
├── kontakt
│   ├── index.html
│   └── process_form.php
│── politika-zasebnosti
│   └── index.html
├── pogosta-vprasanja
│   └── index.html
├── ponudba
│   └── index.html
├── skupaj-za-vkljucevanje
│   ├── delavnica-od-tujca-do-sosolca
│   │   └── index.html
│   ├── delavnica-sola-in-starsi
│   │   └── index.html
│   ├── delavnica-vrtec-novi-zacetki
│   │   └── index.html
│   ├── delavnica-zakaj-znati-slovensko
│   │   └── index.html
│   └── medkulturno-posredovanje
│       └── index.html
├── error_log
├── footer-template.html
├── header-template.html
├── generate_responsive_images.py
├── index.html
├── minify_js.py
├── optimize_images.py
├── robots.txt
├── sitemap.xml
├── update-footer.sh
└── update-menus.sh

3. Opis Datotek in Map

📁 Korenske datoteke in mape

• index.html: Glavna vstopna stran (domača stran), ki pozdravi obiskovalca in na kratko predstavi ključne storitve ter ga usmeri na podstrani.
• kdo-sem/index.html: Stran "Kdo sem", ki vsebuje podrobnejšo osebno predstavitev Amre Kurešepi Zulji, njeno zgodbo in strokovno ozadje.
• ponudba/index.html: Stran, ki podrobno predstavlja ponudbo jezikovnih tečajev in medkulturnega posredovanja.
• cene-in-reference/index.html: Stran s cenikom za posamezne storitve in referencami (mnenji) strank.
• cene-in-sodelovanja/index.html: Alternativna ali starejša stran za cene, ki uporabnika preusmeri na kontaktno stran za več informacij.
• kontakt/index.html: Stran s kontaktnimi podatki in obrazcem za pošiljanje sporočil.
• pogosta-vprasanja/index.html: Stran z zbranimi pogostimi vprašanji in odgovori (FAQ).
• politika-zasebnosti/index.html: Pravna stran, ki opisuje politiko varovanja osebnih podatkov v skladu z GDPR.
• delavnice/index.html: Pregledna stran, ki deluje kot kazalo za vse razpoložljive delavnice in vodi do njihovih podstrani.
• skupaj-za-vkljucevanje/: Mapa, ki združuje vsebine, povezane s programom "Skupaj za vključevanje". Vsebuje podstrani za medkulturno posredovanje in posamezne delavnice.

📁 assets/

Mapa za vse statične vire, kot so slike, ikone in dokumenti.

• favicon/site.webmanifest: Manifest datoteka, ki brskalnikom omogoča, da spletno stran prikažejo z lastnostmi spletne aplikacije (npr. ikona na domačem zaslonu).
• images/: Mapa, kjer so shranjene vse slike, uporabljene na spletni strani.
• pdf/: Mapa za PDF dokumente, ki ponujajo podrobnejše opise delavnic.

📁 css/

Mapa za stilsko oblikovanje spletne strani.

• style.css: Glavna in obsežna CSS datoteka, ki vsebuje vse stile za celotno spletno stran, vključno z odzivnostjo in oblikovanjem posameznih sekcij.
• animations.css: Ločena CSS datoteka, namenjena izključno animacijam.

📁 js/

Mapa za JavaScript kodo, ki skrbi za interaktivnost.

• main.js: Osrednja JavaScript datoteka, ki upravlja:
  • Delovanje navigacije (mobilni meni, večnivojski dropdown meniji).
  • Interaktivne elemente, kot so "harmonika" (accordion) na straneh s pogostimi vprašanji.
  • Inicializacijo knjižnice AOS (Animate On Scroll) za animacije ob drsenju.
  • Logiko za pošiljanje podatkov iz kontaktnega obrazca.

⚙️ Backend in konfiguracija

• kontakt/process_form.php: PHP skripta, ki na strežniški strani obdela podatke, poslane preko kontaktnega obrazca, in jih pošlje na e-poštni naslov.
• robots.txt: Datoteka, ki spletnim iskalnikom (npr. Google) daje navodila, katere dele spletne strani naj indeksirajo in katerih ne.
• sitemap.xml: Zemljevid spletnega mesta v XML formatu, ki iskalnikom pomaga pri lažjem in učinkovitejšem odkrivanju vseh podstrani.
• error_log: Samodejno generirana datoteka s strani strežnika, ki beleži morebitne PHP napake.

🛠️ Orodja za avtomatizacijo in vzdrževanje

• header-template.html in footer-template.html: Predlogi za glavo in nogo spletne strani. Uporabljata se za centralno upravljanje teh elementov, da jih ni treba ročno urejati na vsaki strani posebej.
• update-menus.sh in update-footer.sh: Shell skripti, ki avtomatizirata posodabljanje glave in noge. Skripta prebere vsebino iz predloge in jo vstavi v vse .html datoteke v projektu.
• optimize_images.py: Python skripta za optimizacijo slik. Slike pretvori v sodoben in učinkovit .webp format, jih po potrebi pomanjša in originale shrani v varnostno kopijo.
• generate_responsive_images.py: Python skripta, ki iz originalnih slik ustvari več manjših različic za odziven prikaz na različnih velikostih zaslonov.
• minify_js.py: Preprosta Python skripta, ki iz datoteke main.js odstrani komentarje in odvečne presledke ter tako zmanjša njeno velikost za hitrejše nalaganje.