89 lines
2.2 KiB
Markdown
89 lines
2.2 KiB
Markdown
# ASK-Machen
|
|
|
|
Repozytorium zawiera bazę pytań do quizu ASK-Machen.
|
|
|
|
W repozytorium znajdują się dane quizu: `pytania.txt` oraz opcjonalnie katalog `img/` z obrazkami używanymi w pytaniach. Kod aplikacji nie jest częścią tego repozytorium.
|
|
|
|
## Jak zgłaszać poprawki
|
|
|
|
Poprawki zgłaszamy przez Pull Request.
|
|
|
|
Logowanie w systemie nie wymaga weryfikacji e-mail. Można podać dowolne dane; system jest w pełni anonimowy.
|
|
|
|
Najczęstsze dobre zmiany:
|
|
|
|
- poprawienie literówki,
|
|
- oznaczenie prawidłowej odpowiedzi jako `-|`,
|
|
- usunięcie błędnej odpowiedzi,
|
|
- dopisanie źródła w komentarzu `//`,
|
|
- dodanie brakującego obrazka do `img/`.
|
|
|
|
Nie zmieniaj formatu pliku na pełny Markdown, JSON, CSV ani HTML. To repozytorium używa prostego formatu QAML opisanego niżej.
|
|
|
|
## QAML
|
|
|
|
QAML, czyli Question Answer Markdown Lines, to prosty liniowy format zapisu pytań testowych wielokrotnego wyboru.
|
|
|
|
Parser 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
|
|
|
|
```text
|
|
// Przykładowa sekcja
|
|
|
|
Zaznacz zdania prawdziwe
|
|
- To jest odpowiedź błędna.
|
|
-| To jest odpowiedź poprawna.
|
|
- To jest kolejna odpowiedź błędna.
|
|
```
|
|
|
|
## Reguły składni
|
|
|
|
### Pytanie
|
|
|
|
Pytaniem jest każda niepusta linia, która nie zaczyna się od `-` ani `//`.
|
|
|
|
Pytanie musi mieścić się w jednej linii.
|
|
|
|
### Odpowiedź błędna
|
|
|
|
Odpowiedź błędna zaczyna się od pojedynczego myślnika `-`.
|
|
|
|
```text
|
|
- Odpowiedź błędna
|
|
-Odpowiedź błędna
|
|
```
|
|
|
|
### Odpowiedź poprawna
|
|
|
|
Odpowiedź poprawna zaczyna się od `-|`.
|
|
|
|
```text
|
|
-| Odpowiedź poprawna
|
|
-|Odpowiedź poprawna
|
|
```
|
|
|
|
### Liczba poprawnych odpowiedzi
|
|
|
|
Format dopuszcza dowolną liczbę poprawnych odpowiedzi, w tym zero poprawnych odpowiedzi albo wszystkie odpowiedzi poprawne.
|
|
|
|
### HTML i obrazki
|
|
|
|
HTML jest dopuszczony jako część treści pytania lub odpowiedzi.
|
|
|
|
Jeżeli `pytania.txt` odwołuje się do obrazka przez `img/...`, plik musi istnieć w katalogu `img/` w tym repozytorium.
|
|
|
|
## Walidacja lokalna
|
|
|
|
```bash
|
|
php tools/validate_qaml.php pytania.txt
|
|
```
|