====== Weiterentwicklung Dokuwiki - Geführte Übungen ======

===== Kurzbeschreibung =====

In diesem Dokuwiki sind verschiedene Lern/Lehrmaterialien für Studierende hinterlegt. 
Es soll für verschiedene Fächer geführte Übungen erstellt werden. 
Darunter sind Übungsaufgaben zu verstehen, die Studierende durchrechnen sollen, um im Anschluss - je nach Antwort - auf verschiedene weitere Aufgaben oder Dokumente geführt zu werden.

Für die zusätzlich gewünschten Features ist die Entwicklung eines Plugins notwendig. 

===== Mockup =====

<panel type="info" title="Beispielseite">
===== Widerstand eines Drahts =====

Berechnen Sie den ohmschen Widerstand $R$ eines Kupfer-Drahts ($\rho = 1.59 {{\Omega\cdot {mm^2}}\over{m}}$) mit dem Durchmesser $d = 7.25 mm$ und der Länge $l = 10 m$!

$0 m\Omega$

<WRAP left>{{drawio>studentische_arbeiten:Textboxen.svg}} 
<btn type="default">[[|Ergebnis als mathem. Formel anzeigen]]</btn> <button type="default" collapse="CollapseFuerNochKeineLoesungEingegeben">Ergebnis prüfen</button>

</WRAP>

~~PAGEBREAK~~ ~~CLEARFIX~~
<collapse id="CollapseFuerNochKeineLoesungEingegeben" collapsed="true"><well>
Es wurde noch kein Wert eingegeben. Bitte tragen Sie den korrekten Zahlenwert ein.
</well></collapse>

</panel>

===== Features =====

Studierendensicht: 
  - Auf einer Wikiseite ist für den Studierenden eine Aufgabenstellung beschrieben. Diese enthält verschiedene, variable Werte, sowie Eingabefelder für ein Ergebnis und Buttons.
  - Nachdem der Studierende die Aufgabe gelesen hat, soll er das Ergebnis berechnen und in die Eingabefelder eintragen. Dabei können Text/Zahlenfelder oder Dropdownfelder zur Verfügung stehen.
  - Der Student kann im Anschluss über Knopfdruck seine Eingabe in MathJax-Darstellung rendern lassen. 
  - Wenn der Student meint seine Antworten wären passend, kann er mit einem weiteren Knopfdruck seine Eingabe überprüfen lassen.
  - Nach der Überprüfung kann entweder auf der gleichen Seite eine Rückmeldung angezeigt werden (z.B. ob das Ergebnis richtig oder falsch ist, bzw. die Notwendige Formel o.ä.) oder direkt eine neue Seite geladen werden.

Bearbeitersicht:
  - Eine Basis dafür kann das [[https://www.dokuwiki.org/plugin:const|Plugin:const]] sein. Für die Buttons kann auf [[https://www.dokuwiki.org/plugin:bootswrapper|plugin:bootswrapper]] zurückgegriffen werden.
  - Dem Bearbeiter soll es möglich sein, Werte für Aufgaben vorzugeben. 
    - Es soll eine Liste als Wertebereich vorgegeben werden können, aus der zufällig ein Wert ausgewählt wird. \\ Im Mockup: Länge $l$ aus der Liste ''(10, 12, 15, 20)''
    - Es soll eine n-dimensionale Liste als Wertebereich vorgegeben werden können, aus der zufällig eine n-1 Gruppe ausgewählt wird. \\ Im Mockup: Der Materialname (''Kupfer'') und der Wert $\rho$ (''1.59'') gehören zusammen. Diese wurden aus der Liste ''( ("Silber", 1.59), ("Kupfer", 1.79), ("Aluminium", 2.78) )'' ausgewählt. In den Textangaben in der Liste sollen alle Zeichen nutzbar sein, also auch Komma und Anführungszeichen. Das kann z.B. durch Verwendung von Backslash als Escapezeichen geschehen.
    - Es soll eine Zufallszahl mit Grenzen und Nachkommastellen vorgegeben werden können: \\Im Mockup: Der Durchmesser $d$ soll sich aus einer Zufallszahl zwischen ''5'' und ''10'' mit zwei Nachkommastellen ergeben, mit einer Schrittweite von 0.05
  - Dem Bearbeiter soll es möglich sein, Eingabefelder für Aufgaben vorzugeben. Die Auswahl/Eingabe soll ausgewertet werden.
    - Es soll Text/Zahlenfelder oder Dropdownfelder geben.
    - Eingaben über Text/Zahlenfelder sollen als Formeln interpretiert werden können (also z.b. ''4+5'' oder ''e^4''), jedoch ohne Zugriff auf Variablen (z.B. die Länge ''l''). 
    - Die Interpretation als Formel bei Eingaben über Text/Zahlenfelder soll auch unterbunden werden können.
    - Für die Text/Zahlenfelder kann der Bearbeiter eine maximale Anzahl an Nachkommastellen oder eine maximale Anzahl an Zeichen angeben. 
    - Bei Dropdownfeldern soll eine zufällige Reihenfolge einer Liste möglich sein. 
    - Optional soll eine Teilmenge aus einer Liste auch darstellbar sein. In diesem Fall ist zu prüfen, wie eine korrekte Antwort durch den Bearbeiter markiert und durch das Plugin immer eingefügt werden kann.

  - Für die finale Auswertung des Ergebnisses muss der Bearbeiter Aktionen angeben.
    - Es soll eine Möglichkeit bestehen die festzustellen, wie weit das eingegebene Ergebnis vom korrekten Ergebnis abweicht. 
    - Es ist vorzusehen, dass je nach Ergebnisart (leer, Falsch, richtig) sich weitere Unterbereiche der Wikiseite öffnen sollen. Die kann z.B. durch ein Setzen von ''collapse id''s für die [[https://www.lotar.altervista.org/wiki/wiki/plugin/bootswrapper/collapse|collapse]] Komponenten des bootswrapper möglich sein.

===== Syntax-Beispiel =====

Im Folgenden ist ein Beispiel für eine Syntax dargestellt. Von dieser kann abgewichen werden.

<sxh html>
<const>
rhoEinheit           = {{\Omega\cdot {mm^2}}\over{m}}

l                    = (10, 12, 15, 20)
d                    = %RANDOM%[min=1,max=2, digits=2] * 5
(Material, rho)      = (("Silber", 1.59), ("Kupfer", 1.79), ("Aluminium", 2.78))
erg                  = rho * l / (d^2 *pi/4)

(praefix, prxMult)   = ((m , 0.001), ( , 1), (k, 1000), (M, 1000000))[randomOrder=no]
naechsteSeite()      = CollapseFuerNochKeineLoesungEingegeben, CollapseFuerRichtigeLoesung, CollapseFuerFalscheLoesung
ergAbwBool           = eingebErg * ((abs((eingebErg * prxMult - Erg) / Erg) < 0.01) + 1)                        // workaround, um 0 für keine Eingabe , 1 für ein korrektes Ergebnis, 

eingebErg            = 0[digits = 3, evaluation=no]
</const>


===== Widerstand eines Drahts =====

Berechnen Sie den ohmschen Widerstand $R$ eines %%Material%%-Drahts ($\rho = %%rho%% rhoEinheit$) mit dem Durchmesser $d = %%d%% mm$ und der Länge $l = %%l%% m$!

<result>
$%%eingebErg%% %%prxMult%% \Omega$
</result>

<input-form> erg </input-form> <input-form> prx_mult </input-form> $\Omega$

<btn type="default">[[|Ergebnis als mathem. Formel anzeigen]]</btn> 
<btn type="default">[[%%NaechsteSeite(ergAbwBool)%%|Ergebnis prüfen]]</btn>

<collapse id="CollapseFuerNochKeineLoesungEingegeben" collapsed="true"><well>
Es wurde noch kein Wert eingegeben. Bitte tragen Sie den korrekten Zahlenwert ein.
</well></collapse>

<collapse id="CollapseFuerRichtigeLoesung" collapsed="true"><well>
Ja, %%erg%% ist richtig! Toll gemacht.
</well></collapse>

<collapse id="CollapseFuerFalscheLoesung" collapsed="true"><well>
%%eingebErg%% ist leider nicht richtig. Die korrekte Lösung lautet %%erg%%.

Es ist die Formel ... zu nutzen.
</well></collapse>
</sxh>  

$\require{\hyperref}$
<wrap #anchor1 />

======  Das ist eine Überschrift. $\\ \\$ Sie enthält aber einen $\href{http://wiki.mexle.org}{\text{Link zum MEXLE} } $ und eine $\int_0^t Formel$ $\\ \\$ Etwas umständlich, aber würde als Quickfix auch für andere syntaxreduzierte Bereiche gehen. ======

<callout title="Selbiges klappt auch in Strings, wie dem 'title' eines Callouts. $\\ \\$ Auch hier wären Links, z.B. auf eine $\href{http://wiki.mexle.org}{\text{MEXLE-Seite} } $ möglich. ">
</callout>

<quizlib id="quiz" rightanswers="[['a0']]" submit="check answers">
    <question title="auch im quizlib plugin möglich: $\int_0^t Formel$" type="checkbox">
$R_O = \Delta U_I / \Delta I_O$|
The apparent impedance is: $$ Z ={{U}\over{I}}= {{230V}\over{5A}} = 46 \Omega $$ For the series circuit, the impedances add up like: $R_s + j\cdot X_{Ls} = \underline{Z} $ , and $R_s = Z cos\varphi$ such as $X_{Ls} = Z sin\varphi$.  Therefore: $$ R_s    ={{U}\over{I}} \cdot cos \varphi    = {{230V}\over{5.00A}} \cdot cos 60° = \boldsymbol{23.0 \Omega}   \\ X_{Ls} ={{U}\over{I}} \cdot sin \varphi    = {{230V}\over{5.00A}} \cdot sin 60° = 39.8 \Omega  = \omega \cdot L_s \\ \rightarrow L_s = {{X_{Ls}}\over{2\pi f}}  = {{{{U}\over{I}} \cdot sin \varphi}\over{2\pi f}} = \boldsymbol{127mH} $$


</question>
</quizlib>