Format wygląda jak Markdown, ale jego składnia strukturalna jest znacznie prostsza. Parser nie analizuje pełnego Markdowna. Interpretuje wyłącznie początki linii:

linia pytania,
linia odpowiedzi błędnej,
linia odpowiedzi poprawnej,
komentarz,
pusta linia.

Treść pytania i odpowiedzi może zawierać Markdown, HTML oraz inline LaTeX, ale parser traktuje je jako zwykły tekst.

Minimalny przykład

// Przykładowa sekcja

Zaznacz zdania prawdziwe
- To jest odpowiedź błędna.
-| To jest odpowiedź poprawna.
- To jest kolejna odpowiedź błędna.

Ile wynosi $2 + 2$?
- 3
-| 4
- 5

Reguły składni

1. Pytanie

Pytaniem jest każda niepusta linia, która:

nie zaczyna się od znaku -,
nie zaczyna się od //.

Pytanie musi mieścić się w jednej linii.

Poprawnie:

Zaznacz zdania prawdziwe dotyczące indukcji matematycznej.

Niepoprawnie:

Zaznacz zdania prawdziwe
dotyczące indukcji matematycznej.

Drugi zapis zostanie zinterpretowany jako dwa osobne pytania.

2. Odpowiedź błędna

Odpowiedź błędna zaczyna się od pojedynczego myślnika -.

Poprawne są oba style:

- Odpowiedź błędna
-Odpowiedź błędna

Parser usuwa znak -, a następnie przycina białe znaki z początku i końca odpowiedzi.

3. Odpowiedź poprawna

Odpowiedź poprawna zaczyna się od -|.

Poprawne są oba style:

-| Odpowiedź poprawna
-|Odpowiedź poprawna

Parser usuwa prefiks -|, a następnie przycina białe znaki z początku i końca odpowiedzi.

4. Pytania jednokrotnego i wielokrotnego wyboru

Format dopuszcza dowolną liczbę poprawnych odpowiedzi, w tym zero poprawnych odpowiedzi albo wszystkie odpowiedzi poprawne.

Pytanie jednokrotnego wyboru:

Ile wynosi $2 + 2$?
- 3
-| 4
- 5

Pytanie wielokrotnego wyboru:

Wskaż liczby pierwsze
-| 2
-| 3
- 4
-| 5

Parser nie narzuca liczby poprawnych odpowiedzi. Zero poprawnych odpowiedzi może oznaczać zadanie, w którym żadna odpowiedź nie jest prawdziwa, a oznaczenie wszystkich odpowiedzi jako -| może oznaczać zadanie, w którym wszystkie odpowiedzi są prawdziwe.

5. Komentarze

Komentarzem jest linia zaczynająca się od //.

Przykłady:

// Sterna 2024/2025 B
// Formanowicz 2021-2022

Komentarze są ignorowane przez parser demonstracyjny. Można ich używać jako nagłówków sekcji, źródeł, dat albo notatek.

6. Puste linie

Puste linie są ignorowane. Można ich używać do oddzielania pytań, odpowiedzi lub sekcji.

LaTeX

Dozwolony jest inline LaTeX między pojedynczymi znakami dolara:

Ile wynosi $\binom{n}{k}$?

Dozwolony przykład:

-| Liczba kombinacji wynosi $\binom{n}{k}$.

Nie jest częścią formalnej składni:

$$
a^2 + b^2 = c^2
$$

oraz:

\[ a^2 + b^2 = c^2 \]

Parser demonstracyjny nie waliduje poprawności LaTeX-a. Traktuje zapis $...$ jako zwykły fragment tekstu.

HTML i obrazki

HTML jest dopuszczony jako część treści pytania lub odpowiedzi.

Przykład:

Zaznacz funkcję odpowiadającą obrazkowi <img src="img/example.png" height="100" />
-| $f(x) = x^2$
- $f(x) = x$

Jeżeli pytania.txt odwołuje się do obrazka przez img/..., plik musi istnieć w katalogu img/ w tym repozytorium.

Jedna linia = jeden element

To najważniejsza zasada formatu.

Każde pytanie i każda odpowiedź muszą mieścić się w jednej fizycznej linii.

Poprawnie:

Zaznacz zdania prawdziwe dotyczące funkcji $f(x) = x^2$.
-| Funkcja jest parzysta.
- Funkcja jest nieparzysta.

Niepoprawnie:

Zaznacz zdania prawdziwe dotyczące funkcji
$f(x) = x^2$.
-| Funkcja jest parzysta.

Parser potraktuje drugą linię jako nowe pytanie.

Walidacja lokalna

php tools/validate_qaml.php pytania.txt