From 0bb2a265f974a4b4c99525655f4ab2aa3d696d4c Mon Sep 17 00:00:00 2001 From: jorenchik Date: Mon, 4 Nov 2024 20:54:04 +0200 Subject: [PATCH] docs design --- docs/main.typst | 91 ++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 79 insertions(+), 12 deletions(-) diff --git a/docs/main.typst b/docs/main.typst index 68c436a..12c239e 100644 --- a/docs/main.typst +++ b/docs/main.typst @@ -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"), ) 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"), -) +) #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"), ) +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"), -) +) +#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"), ) +/* +TODO +#figure( + caption: "Atbildes redaktora skats", + placement: auto, + image("img/screens/answer_question.png"), +) */ + +// 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"), ) #figure( caption: "Apmācības skats", - placement: none, + placement: auto, image("img/screens/help.png"), )