📖 Dokumentáció & Súgó

Üdvözöllek a WebVidrában!

Ez a program segít létrehozni egy villámgyors és modern weboldalt programozói tudás nélkül. Az alábbiakban megtalálod a legfontosabb tudnivalókat.

🚀 Kezdeti Lépések

Hogyan kezdjek hozzá?
  1. A program indításakor válaszd ki a Projekt Mappát ("Projekt Mappa Megnyitása" gomb).
  2. Ez az a mappa a gépeden, ahol a weboldalad összes fájlja tárolódik.
  3. A program automatikusan létrehozza a szükséges almappákat:
    • uploads: Ide másolódnak a beillesztett fotók.
    • munkaim (vagy egyéni kategória nevek): Ide kerülnek a generált projekt aloldalak.
  4. A legutóbb megnyitott projektek megjelennek az indítóképernyőn — kattints rájuk a gyors visszatéréshez.
💡 Tipp: Érdemes minden weboldaladnak egy teljesen üres, új mappát létrehozni a Dokumentumok között.
A Kezelőfelület felépítése
Billentyűparancsok
BillentyűFunkció
Ctrl+SProjekt mentése
Ctrl+ZVisszavonás (Undo)
Ctrl+YÚjra (Redo)
EscAktuális ablak/párbeszédpanel bezárása
Ctrl++Felügyeleti felület nagyítása (GUI zoom in)
Ctrl+Felügyeleti felület kicsinyítése (GUI zoom out)
Ctrl+0Felügyeleti felület méretének visszaállítása (100%)

🎨 Szerkesztés és Blokkok

Elérhető blokk típusok
BlokkLeírás
Hero / BorítóNagy, figyelemfelkeltő borítókép szöveggel. Lehet egyetlen kép vagy automatikusan váltakozó diavetítés. Különálló mobil képeket is beállíthatsz.
SzövegdobozSzerkeszthető szöveg blokk formázási lehetőségekkel (félkövér, dőlt, link, szín, stb.).
Teljes KépEgy kép az oldal teljes szélességében, vagy állítható mérettel.
Kép + Szöveg / Szöveg + KépKétoszlopos elrendezés: kép az egyik oldalon, szöveg a másikon.
Projekt GalériaKattintható csempék, amik a részletes projekt aloldalakra vezetnek. Automatikusan generálódik a beállításokból.
Képrács (Photo Grid)Fotók mozaik-szerű galériában, lightbox előnézettel.
Videó LejátszóVideó blokk, amelyhez közvetlenül fájlt választhatsz (.mp4, .webm).
GombKattintható gomb egyedi színnel, szöveggel és URL-lel.
Egyedi HTMLTetszőleges HTML kód beillesztése (pl. beágyazott videó, térkép, kérdőív).
Flex ContainerRugalmas konténer: akár 5 különböző elemet rakhatsz egymás mellé. Keskeny képernyőn automatikusan több sorba csordulnak.
Blokkok hozzáadása és mozgatása

Hozzáadás: Kattints bármelyik gombra a jobb oldali sávban, vagy húzd át az előnézeti vászonra a kívánt pozícióba.

Mozgatás: A középső előnézeti képen fogd meg az egeret egy blokkon, és húzd feljebb vagy lejjebb (Drag & Drop).

Szerkesztés: Kattints egy blokkra az előnézetben — a bal oldali panelben megjelennek a tulajdonságai. Szöveg blokkoknál dupla kattintással közvetlenül is szerkeszthetsz.

Törlés: Jelöld ki a blokkot, majd a bal oldali sáv tetején nyomd meg a piros "Blokk Törlése" gombot. A törlés visszavonható Ctrl+Z-vel.

Blokk stílusok testreszabása

Minden blokknak van egy "🎨 Blokk Stílus Szerkesztése" gombja a tulajdonságok panelen. Ezzel egyéni CSS stílusokat adhatsz hozzá az adott blokkhoz (pl. háttérszín, margó, kitöltés, keret).

A vizuális Box Model szerkesztővel intuitívan állíthatod be a margókat és kitöltéseket.

Képek kezelése és Galériák

Kétféle galéria típus van:

💡 A program automatikusan átméretezi a képeket több felbontásra, hogy a weboldalad mobilon is villámgyors legyen. A smal mappában találod az átméretezett változatokat.

🤖 Mesterséges Intelligencia (AI)

Mire képes az AI asszisztens a programban?

Az AI segítségével utasításokat adhatsz a szerkesztőnek természetes nyelven (pl. "Készíts egy színátmenetes hátterű bemutatkozó részt", vagy "Írd át a szövegeket barátságosabb stílusra"). Az AI képes:

Három üzemmód közül választhatsz: Szerkesztés (élő változtatásokat hajt végre), Csak chat (csak javaslatokat ad) és SEO mód, ami keresőoptimalizálás javaslatokat ad.

Biztonságban vannak az adataim az AI használatakor?

Ez a választott szolgáltatótól függ:

⚠️ Fontos: A felhő alapú AI szolgáltatók (OpenAI, Gemini, Groq) használatakor a weboldalad tartalma elhagyja a gépedet és a szolgáltató szerverein kerül feldolgozásra. Ha ez nem elfogadható, használd az Ollama helyi megoldást.

API kulcsok tárolása: Az API kulcsaid helyben kerülnek mentésre — a böngésző helyi tárhelyén (localStorage) és egy konfigurációs fájlban a felhasználói mappádban (~/.webvidra_ai_settings.json). A WebVidra nem továbbítja semmilyen saját szervernek az adataidat, kizárólag az általad kiválasztott AI szolgáltatónak.

Kell fizetnem az AI használatért?

A WebVidra AI funkciója ingyenes, de a működéshez szükséges "motor" eltérő lehet:

Az AI beállításait a "Weboldal Beállítások" → "Alkalmazás" fülön konfigurálhatod.

Hibázhat az AI? Kell biztonsági mentés?

Igen, az AI modellek néha "hallucinálhatnak" vagy félreérthetik az utasítást, ami ritkán a weboldal tartalmának nem kívánt módosításához vezethet.

⚠️ Erősen javasoljuk, hogy mielőtt nagyobb átalakítást kérsz az AI-tól, készíts másolatot a projekt mappádról. A programban van Visszavonás (Ctrl+Z) funkció, de a biztonsági mentés a legbiztosabb.

⚙️ Oldalak és Navigáció

Új oldal létrehozása és Menü kezelés

A felső eszköztárban található gombok segítségével kezelheted az oldalakat:

GombFunkció
+Új oldal létrehozása (megadhatod a nevét)
Jelenlegi oldal törlése
Oldal átnevezése (megváltoztatja a megjelenített nevet és a fájlnevet is)
📝Oldal SEO leírásának szerkesztése (meta description — a Google találatokban jelenik meg)
Oldal duplikálása az összes blokkal együtt
↑ ↓Oldalak sorrendjének változtatása a weboldal menüjében
👁Oldal elrejtése/megjelenítése a navigációs menüből (a link megmarad)
💡 Tipp: Az index oldal a főoldal — ez mindig a weboldal gyökéroldalaként jelenik meg. Ennek a kulcsneve nem változtatható, de a megjelenített címe igen.
Globális Beállítások

A bal oldali sáv alján a "⚙ Weboldal Beállítások" gombbal érheted el. Több lapra van osztva:

Stílus sablonok (Presets)

A "Weboldal Beállítások" → "Stílusok" lapon találod a beépített stílus sablonokat. Ezek egy kattintással megváltoztatják a weboldalad teljes kinézetét (színek, árnyékok, keretek, stb.).

🎬 Videók és Speciális Tartalmak

Videó hozzáadása

Kétféleképpen adhatsz videót a weboldaladhoz:

1. Videó Lejátszó blokk

A jobb oldali panelból add hozzá a "Videó Lejátszó" blokkot. A tulajdonságoknál a "..." gombbal kiválaszthatod a videófájlt (.mp4 vagy .webm), és beállíthatod a maximális szélességet/magasságot.

2. Videó a projektekben

A projektek aloldalain is megjelenhet videó:

  1. A "Weboldal Beállítások" → "Projects" lapon hozd létre a projektet.
  2. A projekt szerkesztőben használd a videó blokk típust, vagy másold be a videófájlt a projekt mappájába.
  3. A GENERÁLÁS gomb automatikusan felismeri a videót és lejátszót generál köré.
Egyedi HTML beillesztése (haladó)

Ha egyedi objektumot (pl. beágyazott YouTube videót, Google térképet, közösségi média posztot vagy kérdőívet) szeretnél hozzáadni az oldaladhoz, használd a Custom HTML (Egyedi HTML) blokkot.

A szövegszerkesztővel vagy közvetlenül HTML kóddal is szerkesztheted a tartalmat.

🌐 Publikálás és Deploy

Hogyan lesz ebből weboldal? (GENERÁLÁS)

Amikor kész vagy a szerkesztéssel, nyomd meg a kék GENERÁLÁS gombot a felső sávban.

Ekkor a program a munkamappádban létrehozza a végleges .html, .css, és .js fájlokat, valamint az optimalizált képeket.

💡 A generálás után a program felismeri az ismeretlen fájlokat, és felajánlja a törlésüket vagy kivételként jelölésüket.
Deploy — Közvetlen publikálás az internetre

A Deploy gombbal közvetlenül feltöltheted a weboldaladat az internetre, anélkül hogy kézzel kellene másolnod fájlokat.

Támogatott szolgáltatók:

A Deploy ablakban a "❓ Hogyan állítsam be?" gomb részletes, lépésről-lépésre útmutatót ad a bejelentkezési adatok beszerzéséhez.

⚠️ Milyen adatok kerülnek feltöltésre? A Deploy során a weboldalad összes generált fájlja (HTML, CSS, JS, képek, videók) feltöltődik a kiválasztott szolgáltató szervereire. A projekt.json (a projekt forrásadatai) nem kerül feltöltésre — az mindig a gépeden marad.
💡 A bejelentkezési adataid helyben kerülnek mentésre (a böngésző helyi tárhelyén és a ~/.webvidra_deploy_settings.json fájlban) — nem kell minden alkalommal újra megadnod őket.
Kézi feltöltés (alternatíva)

Ha nem a beépített Deploy-t használod, a generálás után a munkamappa teljes tartalmát töltsd fel egy tárhelyre (pl. GitHub Pages, vagy FTP-n a szolgáltatódhoz).

📁 Fájlkezelés és Projekt Szerkezete

Hogyan épül fel a projekt mappája?

Amikor megnyitsz (vagy létrehozol) egy projektet, a WebVidra az alábbi struktúrát hozza létre a kiválasztott mappában:

Fájl / MappaLeírás
projekt.jsonA projekt összes adatát tároló fő fájl (oldalak, blokkok, beállítások). Ez a projekt "agya".
uploads/Ide kerülnek az összes feltöltött kép másolatai. Ne töröld manuálisan!
smal/Az automatikusan generált, optimalizált (kisebb felbontású) képek. Ezeket a program kezeli.
index.htmlA generált főoldal. Csak a GENERÁLÁS gomb után jön létre.
[oldalnév].htmlMinden egyéb oldalhoz egy-egy HTML fájl generálódik.
style.cssA generált weboldal stíluslapja (szín, betűtípus, layout).
lightbox.jsA lightbox (képnagyítós) funkció JavaScript fájlja.
sitemap.xmlKeresőoptimalizáláshoz generált oldaltérkép.
404.htmlNem található oldal (404-es hibaoldal).
[kategória]/Minden projekt kategória egy almappát kap, benne az aloldalak HTML fájljaival.
💡 Tipp: A projekt.json fájl a legfontosabb — ez tartalmaz mindent. Ha biztonsági mentést csinálsz, elég ezt a fájlt (és az uploads mappát) elmenteni.
Mi történik a képekkel? (Feltöltés és optimalizálás)

Amikor egy képet hozzáadsz valamelyik blokkhoz, a program a háttérben az alábbiakat teszi:

  1. Másolás: Az eredeti képfájlt átmásolja az uploads/ mappába (ha még nincs ott).
  2. Átméretezés: Több különböző felbontású verziót készít: 48px, 480px, 800px, 1200px, 1600px, 2000px, 2400px szélességeken. Ezek a smal/ almappákba kerülnek.
  3. Reszponzív HTML: A GENERÁLÁS során a program automatikusan srcset attribútumokkal generál képcímkéket, amitől a böngésző a képernyőhöz legjobban illő méretet tölti le.
💡 Az optimalizálatlan eredeti kép az uploads/ mappában marad — ez szükséges, de a weboldalon mindig a kisebb (smal/) verziók töltődnek be gyorsabb betöltés érdekében.
⚠️ Ne nevezd át és ne töröld a képeket kézzel az uploads/ vagy smal/ mappából, mert a projekt.json ezekre az útvonalakra hivatkozik — a projekt elromolhat.
Mikor kell menteni és mi mentődik el?

A Mentés (Ctrl+S) kizárólag a projekt.json fájlt írja/frissíti a projekt mappájában. A generált HTML fájlok nem mentés, hanem a GENERÁLÁS gomb hatására jönnek létre.

MűveletMit csinálMikor használd
💾 MentésA projekt.json-t frissíti a jelenlegi állapottal.Rendszeresen, minden módosítás után.
⚡ GENERÁLÁSLétrehozza/frissíti az összes HTML, CSS, JS fájlt a mappában.Mielőtt előnézetet nyitsz, vagy deploy előtt.
🚀 DeployFeltölti a generált fájlokat az internetre.Amikor a weboldalt élőben szeretnéd megjeleníteni.
⚠️ Ha csak mentesz, de nem generálsz, a weboldal fájljai (HTML-ek) még a régi tartalmat mutatják. A Deploy mindig generál is — de manuális előnézet előtt érdemes kézzel is generálni.
Ismeretlen fájlok kezelése generálás után

A GENERÁLÁS gomb megnyomása után a program összehasonlítja a projekt mappájának tartalmát azzal, amit ő generált. Ha ismeretlen fájlokat talál (amiket te adtál oda kézzel), megkérdezi, mit tegyen velük:

💡 Ha például egy robots.txt fájlt vagy egyéb egyéni fájlt helyezel a projekt mappájába, jelöld kivételnek, hogy a program ne törölje azt.
Biztonsági mentés és a projekt áthelyezése

A projekt teljes körű biztonsági mentéséhez másold el az egész projekt mappát. A legfontosabb fájlok:

Ha másik számítógépre viszed a projektet:

  1. Másold át a teljes projekt mappát az új gépre.
  2. Nyisd meg a WebVidrát az új gépen.
  3. Válaszd a "Projekt Mappa Megnyitása" opciót, és tallózz a másolt mappára.
  4. A program automatikusan felismeri a projekt.json-t és betölti a projektet.
💡 A generált HTML fájlok (index.html, style.css, stb.) nem szükségesek az átvitelhez — ezeket a GENERÁLÁS gombbal bármikor újra létre lehet hozni a projekt.json alapján.

🔄 Teljes Munkafolyamat — Lépésről Lépésre

Új weboldal készítése az elejétől a végéig

1. lépés — Projekt létrehozása

  1. Hozz létre egy üres mappát a számítógépeden (pl. Dokumentumok/sajat-weboldal).
  2. Nyisd meg a WebVidrát, és kattints a "Projekt Mappa Megnyitása" gombra.
  3. Tallózz a létrehozott mappára, és nyisd meg.
  4. A program automatikusan létrehozza az alap struktúrát (projekt.json, stb.).

2. lépés — Weboldal alapadatok beállítása

  1. Kattints a bal oldali sáv alján a "⚙ Weboldal Beállítások" gombra.
  2. A Globális fülön add meg: weboldal neve, URL-je, rövid leírása, nyelve.
  3. Válassz egy stílus sablont a Stílusok fülön (később bármikor módosítható).
  4. Zárd be a beállításokat.

3. lépés — Oldalak megtervezése

  1. Az index főoldal alapból létezik — ezt szerkeszd először.
  2. Adj hozzá további oldalakat a felső eszköztár + gombjával (pl. Rólam, Kapcsolat).
  3. Állítsd be az oldalak sorrendjét a ↑↓ gombokkal — ez lesz a navigációs menü sorrendje.

4. lépés — Tartalom szerkesztése

  1. Válassz ki egy oldalt az oldalválasztóból.
  2. A jobb oldali panelből húzd a kívánt blokk típust az előnézetre, vagy kattints rá a hozzáadáshoz.
  3. Kattints a blokkra az előnézetben — a bal oldali panelben beállíthatod a tartalmát.
  4. Szöveg blokknál duplán kattintva közvetlenül szerkeszthetsz az előnézetben.
  5. Képeknél a "..." gombbal vagy a képre kattintva tallózhatsz fájlt.
  6. A blokk sorrendjét fogd meg és húzd az előnézeti vásznon.

5. lépés — Mentés

  1. Nyomd meg Ctrl+S-t vagy a Mentés gombot rendszeresen.
  2. A mentés a projekt.json fájlba ír — ez az egyetlen fájl, ami a projekt állapotát tárolja.

6. lépés — Generálás és helyi előnézet

  1. Nyomd meg a kék GENERÁLÁS gombot.
  2. A program elkészíti az összes HTML, CSS és JS fájlt a projekt mappában.
  3. A generálás után automatikusan megnyílik a helyi előnézet a böngésződben.
  4. Ellenőrizd, hogy minden rendben van-e, majd szükség esetén módosíts és generálj újra.

7. lépés — Deploy (Publikálás az internetre)

  1. Kattints a Deploy gombra.
  2. Válassz szolgáltatót (Netlify vagy Bunny.net) és add meg a hozzáférési adatokat.
  3. Kattints a Deploy gombra — a program feltölti a fájlokat és megmutatja az eredményt.
  4. A weboldal elérhető lesz az interneten az általad megadott URL-en.
💡 Tipp: A fenti folyamatot bármikor megismételheted — módosítasz, mentesz, generálsz, deploy-olsz. A módosítások perceken belül élőben megjelennek.
Már meglévő projekt folytatása
  1. Nyisd meg a WebVidrát.
  2. Az indítóképernyőn a legutóbb megnyitott projektek listájában kattints a projekt nevére — azonnal betöltődik.
  3. Vagy kattints a "Projekt Mappa Megnyitása" gombra, és tallózz a mappa elérési útjára.
  4. Folytasd a szerkesztést, mentsd el a változtatásokat, majd generálj és deploy-olj szükség szerint.
Projekt galéria oldalak (munkák/projektek aloldalak) készítése

Ha portfóliót vagy projekt-bemutató oldalt készítesz, az alábbi lépésekkel hozhatsz létre kattintható csempéket, amelyek detail oldalakra vezetnek:

  1. Nyisd meg a "⚙ Weboldal Beállítások""Projects" fület.
  2. Hozz létre egy kategóriát (pl. "fotóim", "munkáim").
  3. A kategórián belül adj hozzá projekteket: cím, borítókép, leírás, blokkok (szöveg, galéria, videó).
  4. A kívánt oldalra adj hozzá egy "Projekt Galéria" blokkot a jobb oldali panelből.
  5. A blokk tulajdonságainál válaszd ki, melyik kategória projektjeit mutassa.
  6. Nyomd meg a GENERÁLÁS gombot — a program létrehozza a galéria csempéket és minden projekt aloldalát.
💡 Minden projekt aloldalán megjelenik a projekt neve, leírása, blokkai (képrács, szöveg, videó) — mindezt automatikusan a projekt adataiból generálja.
A mentés–generálás–deploy ciklus megértése

A WebVidra három különálló műveletet különböztet meg, amelyeket fontos érteni:

LépésMit ír?Szükséges-e a másikhoz?
1. MentésCsak projekt.jsonIgen — a generálás ebből dolgozik
2. GenerálásHTML, CSS, JS, sitemap, 404 oldalIgen — a deploy ezeket tölti fel
3. DeployNincs helyi írás, feltölti a fájlokatAutomatikusan generál is előtte

Javasolt sorrend:

  1. Módosíts valamit a szerkesztőben.
  2. Nyomd meg Ctrl+S-t (mentés).
  3. Nyomd meg a GENERÁLÁS gombot (HTML-ek frissítése).
  4. Ellenőrizd a helyi előnézetben.
  5. Ha minden rendben, nyomd meg a Deploy gombot (publikálás).

🔒 Adatvédelem és Adatkezelés

Milyen adatok hagyják el a gépemet?

A WebVidra alapesetben offline alkalmazás — a szerkesztés, mentés és generálás során semmilyen adat nem hagyja el a számítógépedet. Azonban két funkció használatakor adatok kerülhetnek külső szerverekre:

FunkcióMikor hagyja el adat a gépet?Milyen adatok?
AI (Felhő) Ha OpenAI, Gemini vagy Groq szolgáltatót választasz Weboldalad tartalma (szövegek, címek, oldal-struktúra, meta leírások), az utasításod, csatolt fájlok tartalma
AI (Ollama) Soha — minden helyben fut
Deploy Amikor a Deploy gombot megnyomod Az összes generált weboldal fájl (HTML, CSS, JS, képek, videók) feltöltődik a szolgáltató szerverére (Netlify / Bunny.net)
Szerkesztés, Mentés, Generálás Soha
💡 A projekt.json (a projekt forrásfájlja) soha nem kerül feltöltésre deploy során sem — az mindig kizárólag a gépeden marad.
A WebVidra gyűjt telemetriát vagy analitikát?

Nem. A WebVidra nem küld semmilyen használati adatot, statisztikát vagy hibajelentést semmilyen szerverre. A program kizárólag az általad választott szolgáltatókkal kommunikál (AI szolgáltató és/vagy Deploy platform), és csak akkor, ha te kezdeményezed.

Hol tárolódnak a bejelentkezési adataim (API kulcsok)?

Az API kulcsaid és bejelentkezési adataid kizárólag a te gépeden kerülnek mentésre, két helyen:

Az adatok helyi titkosítással vannak tárolva. A WebVidra soha, semmilyen saját szerverre nem küldi el a kulcsaidat — kizárólag az általad kiválasztott szolgáltatónak (OpenAI, Gemini, Groq, Netlify, Bunny.net).

↩ Visszavonás és Előzmények

Visszavonás (Undo) és Újra (Redo)

A program megjegyzi a változtatásaidat, és visszavonhatod őket:

Az előzmények projektváltáskor törlődnek.

⚠️ A visszavonás a blokkok tartalmát és sorrendjét kezeli, de a globális beállítások (stílusok, projektek) változásait nem mindig — fontos beállítás-módosítás előtt érdemes menteni.
WebVidra | ← Vissza a szerkesztéshez