Add Help page with markdown support and routing

This commit is contained in:
2026-01-18 15:52:46 +01:00
parent eab5303c0f
commit 22fb4b9b20
7 changed files with 2172 additions and 278 deletions

View File

@@ -0,0 +1,419 @@
# Korištenje aplikacije - Znakovni.hr
## Priručnik za korištenje aplikacije za hrvatski znakovni jezik
---
## 📚 Sadržaj
1. [Uvod](#uvod)
2. [Prijava i autentifikacija](#prijava-i-autentifikacija)
3. [Početna stranica](#početna-stranica)
4. [Rječnik (Riječi)](#rječnik-riječi)
5. [Znakopis (Graditelj rečenica)](#znakopis-graditelj-rečenica)
6. [Oblak (Upravljanje dokumentima)](#oblak-upravljanje-dokumentima)
7. [Video rečenica](#video-rečenica)
8. [Portal za podršku](#portal-za-podršku)
9. [Administracija (samo za administratore)](#administracija-samo-za-administratore)
10. [Česta pitanja](#česta-pitanja)
---
## Uvod
Znakovni.hr je web aplikacija za učenje i korištenje hrvatskog znakovnog jezika (HZJ). Aplikacija omogućava:
- **Pretraživanje rječnika** - Video rječnik hrvatskog znakovnog jezika
- **Gradnju rečenica** - Alat za sastavljanje rečenica pomoću znakova
- **Spremanje dokumenata** - Pohrana vaših rečenica u oblaku
- **Video reprodukciju** - Reprodukcija video rečenica
- **Zajednicu** - Komentari, povratne informacije i prijava grešaka
---
## Prijava i autentifikacija
### Kako se prijaviti
1. Kliknite na **"Sign in"** u donjem dijelu bočne trake
2. Unesite svoju **email adresu** i **lozinku**
3. Kliknite **"Sign in"**
### Metode prijave
Aplikacija podržava sljedeće metode prijave:
- **Email/Lozinka** - Tradicionalna lokalna autentifikacija
- **Google OAuth** - Prijava pomoću Google računa (u razvoju)
- **Microsoft OAuth** - Prijava pomoću Microsoft računa (u razvoju)
### Odjava
1. Kliknite na **"Sign out"** u donjem dijelu bočne trake
2. Bit ćete automatski odjavljeni i preusmjereni na stranicu za prijavu
### Napomena o pristupima
- **Anonimni korisnici** mogu pregledavati rječnik
- **Prijavljeni korisnici** mogu spremati dokumente, komentirati i prijavljivati greške
- **Administratori** imaju pristup upravljanju korisnicima i riječima
---
## Početna stranica
Početna stranica prikazuje pregled svih glavnih funkcionalnosti aplikacije:
### Dostupne funkcionalnosti
1. **Riječi** (Rječnik) - Pregledajte i pretražujte rječnik hrvatskog znakovnog jezika
2. **Znakopis** - Gradite rečenice koristeći znakovni jezik
3. **Video rečenica** - Gledajte i učite iz video rečenica
4. **Oblak** - Spremite i upravljajte svojim dokumentima u oblaku
Kliknite na bilo koju karticu za pristup toj funkcionalnosti.
---
## Rječnik (Riječi)
Rječnik omogućava pretraživanje i pregledavanje hrvatskog znakovnog jezika.
### Pretraživanje riječi
1. Idite na **"Riječi"** u bočnoj traci
2. Koristite **traku za pretraživanje** za unos teksta
3. Rezultati se automatski filtriraju dok tipkate
### Filtriranje riječi
Možete filtrirati riječi prema:
- **Vrsta riječi** (Word Type):
- NOUN (Imenica)
- VERB (Glagol)
- ADJECTIVE (Pridjev)
- ADVERB (Prilog)
- PRONOUN (Zamjenica)
- PREPOSITION (Prijedlog)
- CONJUNCTION (Veznik)
- INTERJECTION (Uzvik)
- NUMERAL (Broj)
- PARTICLE (Čestica)
- OTHER (Ostalo)
- **CEFR razina** (Razina složenosti):
- A1 (Početna razina)
- A2 (Osnovna razina)
- B1 (Srednja razina)
- B2 (Viša srednja razina)
- C1 (Napredna razina)
- C2 (Majstorska razina)
### Prikaz detalja riječi
1. Kliknite na **ikonu informacija ()** na kartici riječi
2. Otvara se modal s detaljima:
- Video prikaz znaka
- Vrsta riječi
- CEFR razina
- Kratki opis
- Primjeri korištenja
- Oznake (tags)
### Dodavanje riječi u rečenicu
1. Kliknite na **"Dodaj"** gumb na kartici riječi
2. Riječ se automatski dodaje u trenutnu rečenicu
3. Idite na **"Znakopis"** za uređivanje rečenice
### Paginacija
- Koristite **"Prethodna"** i **"Sljedeća"** gumbe za navigaciju kroz stranice
- Prikazuje se trenutna stranica i ukupan broj stranica
---
## Znakopis (Graditelj rečenica)
Znakopis je alat za sastavljanje rečenica pomoću znakova iz rječnika.
### Dodavanje riječi u rečenicu
1. Idite na **"Riječi"** i kliknite **"Dodaj"** na željenim riječima
2. Riječi se dodaju u **"Trenutna rečenica"** panel
3. Idite na **"Znakopis"** za uređivanje
### Preuređivanje riječi (Drag & Drop)
1. Kliknite i držite riječ u **"Trenutna rečenica"** panelu
2. Povucite riječ na željenu poziciju
3. Pustite za postavljanje riječi na novu poziciju
### Uklanjanje riječi
- Kliknite na **"X"** gumb na riječi za uklanjanje pojedinačne riječi
- Kliknite **"Očisti sve"** za uklanjanje svih riječi iz rečenice
### Spremanje rečenice
1. Kliknite **"Spremi"** gumb
2. Ako nemate otvoren dokument, unesite:
- **Naslov dokumenta** (obavezno)
- **Opis dokumenta** (opcionalno)
3. Kliknite **"Spremi dokument"**
4. Rečenica se sprema na trenutnu stranicu dokumenta
### Učitavanje dokumenta
1. Kliknite **"Učitaj dokument"** gumb
2. Odaberite dokument iz popisa
3. Dokument se učitava s svim stranicama i rečenicama
### Upravljanje stranicama
- **Nova stranica** - Kliknite za dodavanje nove stranice u dokument
- **Navigacija** - Koristite **"Prethodna"** i **"Sljedeća"** za navigaciju između stranica
- Prikazuje se trenutna stranica i ukupan broj stranica
### Popis rečenica
- Prikazuje sve rečenice na trenutnoj stranici
- Kliknite **"Obriši"** za brisanje rečenice
- Rečenice su numerirane (Rečenica 1, Rečenica 2, itd.)
---
## Oblak (Upravljanje dokumentima)
Oblak omogućava centralizirano spremanje i upravljanje vašim dokumentima.
### Pregled dokumenata
1. Idite na **"Oblak"** u bočnoj traki
2. Prikazuju se svi vaši spremljeni dokumenti
3. Za svaki dokument vidite:
- Naslov
- Opis
- Datum zadnje izmjene
- Broj stranica
- Broj rečenica
### Učitavanje dokumenta
1. Kliknite na dokument u popisu
2. Dokument se učitava u Znakopis
3. Možete nastaviti s uređivanjem
### Brisanje dokumenta
1. Kliknite **"Obriši"** gumb na dokumentu
2. Potvrdite brisanje
3. Dokument se trajno briše
### Uređivanje dokumenta
1. Kliknite **"Uredi"** gumb na dokumentu
2. Možete promijeniti:
- Naslov dokumenta
- Opis dokumenta
3. Kliknite **"Spremi"** za spremanje promjena
---
## Video rečenica
Video rečenica omogućava reprodukciju video zapisa rečenica sastavljenih od znakova.
### Reprodukcija video rečenice
1. Idite na **"Video rečenica"** u bočnoj traci
2. Odaberite dokument s rečenicama
3. Video se automatski reproducira
4. Kontrole:
- **Play/Pause** - Reprodukcija/Pauza
- **Brzina reprodukcije** - Prilagodite brzinu
- **Glasnoća** - Kontrola glasnoće
- **Puni zaslon** - Prikaz u punom zaslonu
### Playlist
- Sve rečenice u dokumentu se reproduciraju redom
- Možete preskočiti na sljedeću ili prethodnu rečenicu
- Prikazuje se trenutna rečenica i ukupan broj rečenica
---
## Portal za podršku
### Korištenje aplikacije
- Ovaj priručnik s uputama za korištenje aplikacije
### Zajednica
- Pregledajte komentare i povratne informacije drugih korisnika
- Sudjelujte u raspravi o aplikaciji
### Komentari
1. Idite na **"Komentari"** u bočnoj traci
2. Napišite svoj komentar ili povratnu informaciju
3. Kliknite **"Pošalji"**
4. Vaš komentar će biti vidljiv svim korisnicima
### Prijavi grešku
1. Idite na **"Prijavi grešku"** u bočnoj traci
2. Ispunite obrazac:
- **Naslov** - Kratki opis greške
- **Opis** - Detaljan opis problema
- **Koraci za reprodukciju** - Kako reproducirati grešku
- **Očekivano ponašanje** - Što ste očekivali
- **Stvarno ponašanje** - Što se zapravo dogodilo
3. Kliknite **"Pošalji prijavu"**
4. Vaša prijava će biti pregledana od strane administratora
---
## Administracija (samo za administratore)
Administratorski panel je dostupan samo korisnicima s administratorskim pravima.
### Upravljanje korisnicima
1. Idite na **"Korisnici"** u sekciji Administracija
2. Pregledajte sve korisnike u sustavu
3. Dostupne akcije:
- **Dodaj korisnika** - Kreirajte novog korisnika
- **Uredi korisnika** - Promijenite podatke korisnika
- **Obriši korisnika** - Uklonite korisnika iz sustava
- **Aktiviraj/Deaktiviraj** - Omogućite ili onemogućite pristup
#### Kreiranje novog korisnika
1. Kliknite **"Dodaj korisnika"**
2. Ispunite obrazac:
- **Email** (obavezno)
- **Ime** (opcionalno)
- **Lozinka** (obavezno)
- **Uloga** - USER ili ADMIN
- **Aktivan** - Da/Ne
3. Kliknite **"Kreiraj"**
#### Uređivanje korisnika
1. Kliknite **ikonu olovke** pored korisnika
2. Promijenite željene podatke
3. Kliknite **"Spremi"**
#### Resetiranje lozinke
1. Uredi korisnika
2. Unesite novu lozinku
3. Kliknite **"Spremi"**
### Upravljanje riječima
1. Idite na **"Upravljanje riječima"** u sekciji Administracija
2. Pregledajte sve riječi u rječniku
3. Dostupne akcije:
- **Dodaj riječ** - Dodajte novu riječ u rječnik
- **Uredi riječ** - Promijenite podatke riječi
- **Obriši riječ** - Uklonite riječ iz rječnika
- **Dodaj video** - Dodajte video prikaz znaka
#### Dodavanje nove riječi
1. Kliknite **"Dodaj riječ"**
2. Ispunite obrazac:
- **Riječ** (obavezno) - Tekst riječi
- **Vrsta riječi** (obavezno) - NOUN, VERB, itd.
- **CEFR razina** (obavezno) - A1, A2, B1, B2, C1, C2
- **Kratki opis** (opcionalno)
- **Oznake** (opcionalno) - Odvojene zarezom
3. Kliknite **"Spremi"**
#### Dodavanje videa
1. Kliknite **ikonu videa** pored riječi
2. Odaberite video datoteku (MP4, WebM, OGG)
3. Kliknite **"Upload"**
4. Video se automatski učitava i povezuje s riječju
#### Uređivanje riječi
1. Kliknite **ikonu olovke** pored riječi
2. Promijenite željene podatke
3. Kliknite **"Spremi"**
#### Brisanje riječi
1. Kliknite **ikonu kante** pored riječi
2. Potvrdite brisanje
3. Riječ i svi povezani videi se trajno brišu
---
## Česta pitanja
### Mogu li koristiti aplikaciju bez prijave?
Da, možete pregledavati rječnik bez prijave. Međutim, za spremanje dokumenata, komentiranje i prijavu grešaka potrebna je prijava.
### Kako mogu promijeniti svoju lozinku?
Trenutno možete promijeniti lozinku samo putem administratora. Kontaktirajte administratora za resetiranje lozinke.
### Mogu li dijeliti svoje dokumente s drugim korisnicima?
Trenutno su svi dokumenti privatni. Funkcionalnost dijeljenja dokumenata je u razvoju.
### Koliko dokumenata mogu spremiti?
Nema ograničenja na broj dokumenata koje možete spremiti.
### Koliko stranica može imati dokument?
Nema ograničenja na broj stranica u dokumentu.
### Koliko rečenica može imati stranica?
Nema ograničenja na broj rečenica po stranici.
### Koje video formate podržava aplikacija?
Aplikacija podržava MP4, WebM i OGG video formate.
### Kako mogu prijaviti grešku?
Idite na "Prijavi grešku" u portalu za podršku i ispunite obrazac s detaljima greške.
### Kako mogu kontaktirati podršku?
Možete ostaviti komentar u sekciji "Komentari" ili prijaviti grešku u sekciji "Prijavi grešku".
### Je li aplikacija dostupna na mobilnim uređajima?
Da, aplikacija je responzivna i radi na mobilnim uređajima, tabletima i desktop računalima.
---
## Tehnička podrška
Za dodatnu pomoć ili pitanja, molimo kontaktirajte:
- **Email**: podrska@znakovni.hr
- **Komentari**: Koristite sekciju "Komentari" u aplikaciji
- **Prijava grešaka**: Koristite sekciju "Prijavi grešku" u aplikaciji
---
**Verzija priručnika**: 1.0
**Datum ažuriranja**: 2026-01-18
**Status aplikacije**: Faza 3 dovršena (Znakopis)
---
© 2026 Znakovni.hr - Sva prava pridržana