docs design

This commit is contained in:
jorenchik
2024-11-04 20:54:04 +02:00
parent 50f219da9e
commit 0bb2a265f9

View File

@@ -1257,7 +1257,6 @@ iegūtas tekstvienības. Veidojot tekstvienības, tiek saglabāta informācija p
atrašanos vietu - rindu un kolonnu. Leksiskās analīzes process ir aprakstīts
aktivitāšu diagrammā (skat. attēlu @fig:lexing-activity).
#pagebreak(weak: true)
#figure(
caption: "Tekstvienības",
kind: table,
@@ -1305,39 +1304,107 @@ aktivitāšu diagrammā (skat. attēlu @fig:lexing-activity).
#figure(
caption: "Leksiskās analīzes aktivitātes diagramma",
placement: none,
placement: auto,
image("img/lexer_activity.svg"),
) <lexing-activity>
Parsēšanas procesā tekstvienības tiek pārveidotas uz jautājumu objektu sarakstu
un pēdējās mācīšanās laiku, ja tāds ir norādīts.
un pēdējās mācīšanās laiku, ja tāds ir norādīts. Process sākas ar mācīšanās
datuma un laika noteikšanu, kas atrodas apstrādājamās virknes sākumā. Tālāk
tiek apstrādāti jautājumi un dažādu veidu atbildes elementi, veidojot
apstrādātu jautājumu sarakstu. Process turpinās līdz visas tekstvienības ir
apstrādātas. Ja procesā rodas kļūdas -- sastopamas negaidāmas tekstvienības,
neveiksmīga datuma un laika formāta parsēšana, pārtraukuma parsēšana u.c. --
tiek atgriezta kļūda, kas paskaidro kļūdas cēloni. Parsēšanas process ir
aprakstīts aktivitāšu diagrammā (skat. attēlu @fig:parsing-activity).
Aktivitātē ir izmantota jautājumu parēšanas: apakšaktivitāte (skat. attēlu
@fig:parsing-answer-activity), kas apraksta viena jautājuma tekstvienību
jautājumu apstrādi. Process sākas ar vairāku karodziņu uzstādīšanu, kas tiek
izmantoti jautājumu veidu noteikšanai. Tiek noteikts atbildes elementa veids no
tekstvienību secības. Tiek veidots saraksts ar jautājumu elementiem, kurā tiek
pievienotas apskatāmas vērtības. Ja elementu vērtībās ir pretrunas, piemēram,
izvēles elements ar secības jautājumu, secības modifikators elementā ar grupas
atdalītāju u.c., apstrāde tiek beigta, izvadot kļūdu. Process turpinās līdz
tiek sastapts nākamā jautājuma sākums vai tekstvienību saraksta beigas.
#figure(
caption: "Parsēšanas aktivitātes diagramma",
placement: none,
placement: auto,
image("img/parsing_activity.svg"),
) <parsing-acticity>
) <parsing-activity>
#figure(
caption: "Atbildes parsēšanas aktivitātes diagramma",
placement: none,
caption: "Atbilžu parsēšanas aktivitātes diagramma",
placement: auto,
image("img/parsing_answer_activity.svg"),
) <parsing-answer-activity>
Mācīšanas procesā jautājumi tiek izvēlēti, izmantojot trīs algoritmus pēc
lietotāja izvēles (katrs algoritms neiekļauj pašreizējo jautājumu izvēlē):
+ intervālu -- nākamais jautājums tiek izvēlēts nejaušā kārtībā starp tiem
jautājumiem, kā pārtraukums pēc pēdējās mācīšanās reizes ir beidzies vai
nemaz tas nebija uzstādīts;
+ nejaušais -- nākamais jautājums tiek izvēlēts nejaušā kārtībā;
+ primārais -- nākamais jautājums ir nākamais pēc pozīcijas failā.
Nākamā jautājuma izvēles process atajauno jautājumu pārtraukumus, balstoties uz
tagadējo laiku, un izvēlas nākamo jautājumu atbilstoši izvēlētam algoritmam.
Process ir aprakstīts nākamā jautājuma noteikšanas aktivitātes diagrammā
(skat. @fig:next-question-activity).
#figure(
caption: "Nākamā jautājuma noteikšanas aktivitātes diagramma",
placement: none,
placement: auto,
image("img/next_question_activity.svg"),
) <next-question-activitt>
) <next-question-activity>
#pagebreak(weak: true)
== Saskarnes projektējums
Kartīšu saraksta skats (skat. @fig:mdem-list-view) satur informāciju par
atmiņas kartīšu direktoriju un kartīšu faila saturu. Kartīšu informācija
iekļauj kartīšu faila direktorija nosaukumu, atmiņas kartīšu faila nosaukumu un
pēdējo faila mācīšanās laiku. Atmiņas bāzes faila saraksts rāda visus atmiņas
kartītes failus un apakšdirektorijus ar atmiņas kartīšu failiem, kas tiek
izmantoti organizēšanai. Atmiņas kartīšu saraksts attēlo pagaidu atmiņas
kartīšu glabātuves sarakstu. Kartītes var pievienot un rediģēt, izmantojot
kartīšu redaktoru (skat. TODO) un dzēst. Katrai kartītei var apskatīties
atbildi.
#figure(
caption: "Kartīšu saraksta skats",
placement: none,
placement: auto,
image("img/screens/mdem_list.png"),
) <mdem-list-view>
/*
TODO
#figure(
caption: "Atbildes redaktora skats",
placement: auto,
image("img/screens/answer_question.png"),
) <answer-question-view> */
// Overall
Katram jautājumam ir sava mācīšanās skata variācija. Katra variācija satur
jautājuma priekšas tesktu. Atkarībā no jautājuma ir pieejama pārbaudīšanas un
atbildes parādīšanas funkcija.
// Interval
// Question type
Atbildes jautājuma skatā ir paslēptas atbildes teksts ar vienu vai vairākiem
atbildes teksta elementiem (skat. attēlu @fig:answer-question-view). Izvēles
jautājuma skatā (skat. attēlu @fig:choice-question-view) ir saraksts ar izvēlēm
ar pārbaudes funkciju. Secības jautājuma skatā (skat. attēlu
@fig:order-question-view) ir saraksts ar vairākiem elementiem, kuru secību var
pārkārtot. Secības jautājumam ir pieejama pārbaudes un pareizās atbildes
parādīšanas funkcijas. Grupēšanas jautājuma skatā ir saraksts ar visiem grupu
elementiem un tukšiem sarakstiem katrai grupai. Tā ietvaros var sagrupēt
elementus pa grupām, pārbaudīt un parādīt pareizo atbildi.
#figure(
caption: "Atbildes jautājuma skats",
placement: auto,
@@ -1364,13 +1431,13 @@ un pēdējās mācīšanās laiku, ja tāds ir norādīts.
#figure(
caption: "Konfigurācijas skats",
placement: none,
placement: auto,
image("img/screens/config.png"),
) <config-view>
#figure(
caption: "Apmācības skats",
placement: none,
placement: auto,
image("img/screens/help.png"),
) <help-view>