Instrukcja obsługi

1. Wprowadzenie

Witaj w Aplikacji Tajweed Koranu — interaktywnej platformie edukacyjnej, która uczy zasad Tajweed, weryfikuje Twoją wymowę podczas recytacji, testuje Twoje zapamiętywanie i odpowiada na pytania dotyczące Koranu i zasad Tajweed.

Tekst Koranu jest zawsze wyświetlany w arabskim piśmie Uthmani. Interfejs aplikacji (przyciski, menu i objaśnienia) jest tłumaczony na ponad 68 języków, w zależności od wyboru z listy języków u góry strony.

2. Panel główny i zakładki

Po otwarciu aplikacji pojawiają się trzy główne zakładki:

Każda płytka zasady otwiera stronę, która wyświetla wersety, w których zasada się pojawia, z pokolorowanymi słowami, dźwiękiem recytatora referencyjnego oraz tłumaczeniem/interpretacją wersetu w zależności od języka wyświetlania.

3. Język i pomoc

Wybór języka

W lewym górnym rogu każdej strony (lub w prawym górnym rogu w językach pisanych od prawej do lewej) znajdziesz listę języków. Wybierz swój język — przyciski menu, nagłówki i objaśnienia natychmiast się zmienią. Domyślnym językiem jest arabski.

Przycisk pomocy

Obok listy języków znajduje się przycisk „Pomoc”. Otwiera on tę instrukcję w Twoim aktualnym języku w nowym oknie. Jeśli tłumaczenie na Twój język nie jest jeszcze dostępne, instrukcja zostanie wyświetlona w języku arabskim.

Powrót do panelu

Przycisk „Panel zasad Tajweed” w prawym górnym rogu strony przenosi Cię z powrotem do strony głównej z dowolnej podstrony.

4. Strony zasad Tajweed

Każda strona zasady wyświetla:

• Definicję zasady w języku arabskim z tłumaczeniem/transliteracją w języku wyświetlania.
• Tabelę lub Mushaf, która wyróżnia dotknięte słowa charakterystycznym kolorem.
• Wybór recytatora i odtwarzanie dźwięku wersetu lub strony.
• Wyróżnianie słów podczas odtwarzania (karaoke): wyróżnienie przesuwa się wraz z recytatorem słowo po słowie.
• Pole tłumaczenia: z Kalimat.dev lub lokalnej interpretacji w zależności od wybranego języka.

Odtwarzanie dźwięku i wybieranie słów

• Pojedyncze kliknięcie na słowo: Wybiera je jako punkt początkowy (niebieskie wyróżnienie).
• Pojedyncze kliknięcie na inne słowo: Rozszerza zaznaczenie, tworząc zakres między dwoma słowami.
• Kliknięcie wewnątrz zaznaczonego zakresu: Odtwarza dźwięk tylko dla zaznaczonego zakresu z śledzeniem czytania (karaoke).
• Kliknięcie poza zakresem: Resetuje zaznaczenie do nowo klikniętego słowa.
• Podwójne kliknięcie: Wybiera słowo i odczytuje je pojedynczo.
• Przeciąganie (dotyk/mysz): Aby zaznaczyć fragment jednym dotknięciem i odtworzyć go natychmiast po zwolnieniu.
• Przycisk „Słuchaj”: Czyta od zaznaczonego słowa do końca wersetu (w trybie wersetu i strony) z kolorowaniem karaoke słów.
• Przycisk „Powtórz”: Odtwarza zaznaczony fragment w pętli do ćwiczenia.
• Kliknięcie poza obszarem wersetu: Anuluje zaznaczenie, aby przycisk „Słuchaj” ponownie odczytał werset od początku.

5. Inteligentna recytacja (korekta wymowy)

Strona /r/recite/ umożliwia recytację przed mikrofonem z weryfikacją słowo po słowie za pomocą specjalnego modelu transkrypcji Koranu (Whisper).

Układ ekranu

Od góry do dołu:

1. Obszar sterowania: Wybór sury, zakresu (werset/strona/sura), recytatora, mikrofonu i progu akceptacji.
2. Pasek nawigacji: Odtwarzanie/zatrzymywanie dźwięku wersetu, następnie przyciski „ » ” dla wersetów, „ › ” dla słów i dla powtórzenia.
3. Przewodnik po kolorach Tajweed: Pojawia się bezpośrednio nad tekstem wersetu, aby ułatwić jego przeglądanie podczas recytacji.
4. Tekst wersetu: Pokolorowane i wyróżnione słowa dla bieżącego słowa.

Rozpoczęcie recytacji

1. Wybierz surę i zakres (dla początkujących zalecany jest jeden werset).
2. Tekst jest wyświetlany automatycznie po otwarciu strony lub zmianie sury.
3. Wprowadź swój adres e-mail (zapisywany jednorazowo dla wszystkich stron).
4. Kliknij „Rozpocznij recytację” i zezwól przeglądarce na dostęp do mikrofonu.
5. Przeczytaj wyróżnione słowo; po prawidłowej wymowie zmieni kolor na zielony, a wyróżnienie przesunie się do następnego słowa.

Przyciski nawigacji

Próg akceptacji słowa

Możesz dostosować minimalny poziom pewności (od 30% do 70%) za pomocą suwaka. Słowo jest akceptowane, jeśli jego wymowa osiągnie lub przekroczy ten próg. Słowo poniżej progu jest wyświetlane z oceną w kolorze pomarańczowym, aby pomóc Ci w poprawie.

Kolorowanie zasad Tajweed

Włącz „Kolorowanie zasad Tajweed”, aby zobaczyć kolory podpowiedzi na słowach (Qalqalah, Ghunnah, Ikhfa, Iẓhār, Lām al-Jalālah…). Można to wyłączyć, jeśli chcesz Mushaf bez kolorów.

Ocena zasad Tajweed (opcjonalnie)

Po włączeniu „Oceny zasad Tajweed” المد (Madd), الغنة (Ghunnah) i القلقلة (Qalqalah) są również sprawdzane akustycznie — sama pewność dźwiękowa nie wystarczy.

Wyszukiwanie przez recytację

Kliknij „Wyszukaj przez recytację” i przeczytaj kilka słów; aplikacja wyświetli pasujące wersety. Wybierz werset, aby otworzyć go bezpośrednio.

Wyniki słów i czyszczenie

Po powrocie do wersetu, który został już zrecytowany, Twoje wyniki pojawią się przy każdym słowie. Użyj „Wyczyść wyniki zakresu”, aby wyczyścić wyniki wersetu/strony/sury i spróbować ponownie.

6. Test zapamiętywania (Tasmīʿ)

Strona /r/hifz/ testuje Twoje zapamiętywanie: werset zaczyna się pusty, a każde słowo pojawia się po prawidłowej wymowie.

• Kliknij „Start” i czytaj z pamięci; poprawne słowa pojawiają się stopniowo.
• Błąd w wymowie wyda sygnał ostrzegawczy bez ujawniania słowa.
• Możesz ręcznie „Pokaż słowo” lub „Pokaż werset” jako podpowiedź.
• Przejście do następnego wersetu jest ręczne, chyba że ukończysz cały werset poprawnie.
• Wyniki kumulatywne dla sury i całego Koranu są zapisywane i powiązane z Twoim adresem e-mail.

7. Inteligentny asystent

Z zakładki „Inteligentny asystent” lub strony /r/chatbot/ możesz zadawać pytania dotyczące:

• Zasad Tajweed (Co to jest الإخفاء (Ikhfāʾ)? Gdzie znajduje się w surze…?)
• Tekstu Koranu (Ile wersetów jest w Juz Amma? Wersety zawierające słowo…)
• Wyszukiwania według rdzenia, powtórzeń lub pisowni ortograficznej/Uthmani

Asystent używa bazy wiedzy Tajweed i bazy danych Koranu z Gemini-2.5-flash, aby odpowiadać w Twoim języku. Możesz:

• Rozszerzyć pole pytania (przeciągnij dolną krawędź lub wpisz wiele wierszy za pomocą Shift+Enter).
• Otwierać nowe rozmowy, archiwizować je, usuwać lub pobierać jako PDF/Markdown.
• Używać przykładowych pytań do szybkiego rozpoczęcia.

8. Wyniki i raporty

Wprowadź swój adres e-mail jednorazowo — zostanie on użyty do recytacji, zapamiętywania i testu Tajweed. Wyniki są zapisywane w bazie danych i możesz:

• Wyświetlić skumulowany wynik dla sury i całego Koranu na pasku stanu.
• Przejrzeć swoje poprzednie próby dla każdego wersetu.
• Poprosić o „Wyślij mój raport PDF”, aby otrzymać szczegółowy raport na swój adres e-mail (średnia, najwyższa, najniższa, daty).

9. Ustawienia dźwięku

Z przycisku „Dźwięk” na stronie recytacji lub zapamiętywania:

• Mikrofon: Wybierz urządzenie wejściowe, jeśli jest ich więcej niż jedno.
• Głośnik: Wybierz urządzenie wyjściowe (obsługiwane w Chrome/Edge; może nie działać w Safari).
• Wskaźnik poziomu: Zielony pasek pokazujący siłę Twojego głosu podczas recytacji.
• Diagnostyka: Techniczny zapis do rozwiązywania problemów z transkrypcją (dodaj ?debug=1 do linku).

10. Często zadawane pytania

Dlaczego aplikacja oczekuje słów, których nie powiedziałem (np. Basmala)?

Niektórzy recytatorzy rozpoczynali Basmalą przed „الم” lub „آلم” na początku sur. Naprawiliśmy to, wykrywając otwarcie i ponownie wyrównując. Jeśli problem nadal występuje, użyj diagnostyki lub spróbuj ponownie po trzech nieudanych próbach, aplikacja automatycznie przejdzie dalej.

Czy działa na urządzeniach mobilnych?

Tak — Chrome na Androida i Safari na iOS. Może być konieczne pierwsze kliknięcie, aby aktywować dźwięk (polityka przeglądarki).

Czy moje dane są prywatne?

Wyniki są powiązane z Twoim adresem e-mail i są izolowane między użytkownikami. Nagrania audio nie są udostępniane stronom trzecim — są przetwarzane na serwerze wyłącznie w celu weryfikacji.

Skąd pochodzą tłumaczenia wersetów?

Kalimat.dev, lokalna baza danych lub Tafsir al-Jalalayn przetłumaczony za pomocą Gemini dla nieobsługiwanych języków — a nie bezpośrednie tłumaczenie tekstu Koranu przez sztuczną inteligencję.