Zum Inhalt springen

Änderungen von Dokument Anleitung

Zuletzt geändert von Holger Engels am 2024/11/06 09:21
Von Version 34.1
bearbeitet von Holger Engels
am 2023/10/17 13:21
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 19.2
bearbeitet von VBS
am 2023/09/11 12:27
Änderungskommentar: Update document after refactoring.

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.holgerengels
1 +XWiki.vbs
Inhalt
... ... @@ -1,21 +1,22 @@
1 -{{seiteninhalt/}}
1 +{{box cssClass="floatinginfobox" title="**Contents**"}}
2 +{{toc start=2 depth=2 /}}
3 +{{/box}}
2 2  
3 3  [[XWikiSyntax>>https://mathe-arbeitsheft.zsl-bw.de/xwiki/bin/view/XWiki/XWikiSyntax?syntax=2.1&category=1]]
4 4  
5 5  == Aufgabenseite ==
6 6  
7 -Eine Aufgabenseite beginnt mit dem Inhaltsverzeichnis, gefolgt von den Kompetenzen. Das leistet folgender Code:
9 +Auf jeder Seite sollte ganz oben das Inhaltsverzeichnis eingebunden werden. Das leistet folgender Code:
8 8  
9 9  {{info}}
10 10  {{{
11 -{{seiteninhalt/}}
12 -
13 -[[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
14 -[[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
13 +{{box cssClass="floatinginfobox" title="**Contents**"}}
14 +{{toc start=2 depth=2 /}}
15 +{{/box}}
15 15  }}}
16 16  {{/info}}
17 17  
18 -Eine Aufgabenseite kann in Abschnitte unterteilt sein. Die Abschnitte werden von Überschriften der Ebene 2 angeführt. Beispielsweise ..
19 +Eine Aufgabenseite ist in Abschnitte unterteilt. Die Abschnitte werden von Überschriften der Ebene 2 angeführt. Beispielsweise ..
19 19  
20 20  {{info}}
21 21  {{{
... ... @@ -37,23 +37,21 @@
37 37  
38 38  {{info}}
39 39  {{{
40 -{{aufgabe id="Eindeutiger Name" afb="I" kompetenzen="K5,K6" quelle="Martina Wagner" cc="BY-SA" niveau="e" zeit="7"}}
41 +{{aufgabe afb="I" kompetenzen="K5,K6" quelle="Martina Wagner" cc="BY-SA" niveau="e"}}
41 41  Berechne jeweils die Nullstellen!
42 -
43 +
43 43  * {{formula}}f(x) = \frac{1}{2}(x-1)(x-3){{/formula}}
44 44  * {{formula}}g(x) = \frac{1}{2}(x^2-4x+3){{/formula}}
45 45  * {{formula}}h(x) = \frac{1}{2}(x-2)^2-\frac{1}{2}{{/formula}}
46 -
47 +
47 47  {{/aufgabe}}
48 -}}}
49 + }}}
49 49  {{/info}}
50 50  
51 51  Folgende Parameter werden unterstützt:
52 52  
53 -|id|Ein (innerhalb der Seite) eindeutiger Name|erforderlich
54 54  |afb|entweder "I" oder "II" oder "III"|erforderlich
55 55  |kompetenzen|eine "K1" oder mehrere "K4,K5"|erforderlich
56 -|zeit|Bearbeitungszeit in Minuten|erforderlich
57 57  |quelle|Text oder Link, z.B. "Holger Engels" oder "{{{[[serlo.org]]}}}"|erforderlich
58 58  |cc|Creative Commons Lizenzen in der aktuellen Version, z.B. "BY-SA"|cc oder lizenz erforderlich
59 59  |lizenz|z.B. {{{[[CC BY-SA>>https://creativecommons.org/licenses/by-sa/3.0/deed.en]]}}}|cc oder lizenz erforderlich
... ... @@ -60,37 +60,47 @@
60 60  |niveau|"g" oder "e"|optional
61 61  |links|{{{[[kmap.eu]]}}}, {{{[[serlo.org]]}}}|optional
62 62  
63 -Die Aufgabenseite wird von der Seitenreflexion abgeschlossen:
62 +== Lösungsseite ==
64 64  
64 +Eine Lösungsseite hat immer den gleichen Namen wie die Aufgabenseite, zu der sie gehört, gefolgt von "- Lösungen". Die Lösungsseite entsteht automatisch, wenn man das erste mal in der Aufgabenseite auf den Link zur Lösungsseite klickt.
65 +
66 +Der Aufbau einer Lösungsseite ist analog zur Aufgabenseite. Oben das Inhaltsverzeichnis, dann die gleichen Abschnitte:
67 +
65 65  {{info}}
66 66  {{{
67 -{{seitenreflexion kompetenzen="3" anforderungsbereiche="1" kriterien="2" menge="1"/}}
70 +{{box cssClass="floatinginfobox" title="**Contents**"}}
71 +{{toc start=2 depth=2 /}}
72 +{{/box}}
73 +
74 +== Allgemeines ==
75 +
76 +... Lösungen zu Allgemeines ...
68 68  }}}
69 69  {{/info}}
70 70  
71 -Mit den Parametern wird quantifiziert, wie nah die Seite am Soll ist. Sprich: "Sind die Kompetenzen abgedeckt, die Anforderungsbereiche? Genügen die Aufgaben den Qualitätskriterien und passt die Menge zum Gewicht der BPE im Bildungsplan.
80 +Jede Lösung ist von einem Macro //lösung// umgeben. Das kann z.B. so aussehen:
72 72  
73 -|kompetenzen|Ganze Zahl von 1 .. 5|erforderlich
74 -|anforderungsbereiche|Ganze Zahl von 1 .. 5|erforderlich
75 -|kriterien|Ganze Zahl von 1 .. 5|erforderlich
76 -|menge|Ganze Zahl von 1 .. 5|erforderlich
82 +{{info}}
83 +{{{
84 +{{lösung}}
85 +* {{formula}}
86 +\begin{equation*}
77 77  
78 -== Lösungsseite ==
88 +f(x) = 0
79 79  
80 -Der Name der Lösungsseite entspricht der ID der Aufgabe, zu der sie gehört, angeführt von "Lösung ". Die Lösungsseite entsteht automatisch, wenn man das erste mal in der Aufgabenseite auf den Link zur Lösungsseite klickt.
81 -
82 -Eine Lösungsseite hat keine besondere Struktur. Es empfiehlt sich in der Lösung Teile der Aufgabe zu wiederholen. Wenn z.B. eine Gleichung zu lösen ist, sollte die erste Zeile die Ausgangsgleichung sein. Enthält die Aufgabe mehrere Teilfragen, sollten die Antworten sich jeweils explizit darauf beziehen. Z.B. indem ein Teil der Frage wiederholt wird.
83 -
84 -(% style="list-style: alphastyle" %)
85 -1. {{formula}}f(x) = 0
86 -
87 87  \Rightarrow \frac12\left(x-1\right)\left(x-3\right)=0
88 88  
89 89  \Rightarrow x-1=0\vee x-3=0
90 90  
91 -\Rightarrow x_1=1; x_2=3{{/formula}}
92 -1. {{formula}}g(x) = 0
94 +\Rightarrow x_1=1; x_2=3
93 93  
96 +\end{equation*}
97 +{{/formula}}
98 +* {{formula}}
99 +\begin{equation*}
100 +
101 +g(x) = 0
102 +
94 94  \Rightarrow \frac{1}{2}(x^2-4x+3) = 0
95 95  
96 96  \Rightarrow x^2-4x+3=0
... ... @@ -97,75 +97,46 @@
97 97  
98 98  \Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
99 99  
100 -\Rightarrow x_1=1; x_2=3{{/formula}}
101 -1. {{formula}}h(x) = \frac{1}{2} \cdot \left(x-2\right)^2 - \frac{1}{2}{{/formula}}
102 -...
109 +\Rightarrow x_1=1; x_2=3
103 103  
104 -== LaTeX ==
105 -
106 -Das Formulieren von mathematischen Termen und Gleichungen mit LaTeX ist etwas mühsam. Einfacher geht es mit einem Formeleditor, wie z.B [[MathLive>>https://cortexjs.io/mathlive/demo/]].
107 -
108 -Wenn das {{{{{formula}}}}}-Macro innerhalb einer Zeile verwendet wird, dann entsteht eine kompakte Darstellung (//inline math//). Z.B.: {{formula}}\int_a^b f(x)\cdot dx{{/formula}}. Wenn es alleinstehend verwendet wird (Lehrzeile davor und danach), dann wird es als Block formatiert (//display math//). Z.B.:
109 -
110 -{{formula}}
111 -\int_a^b f(x)\cdot dx
111 +\end{equation*}
112 112  {{/formula}}
113 +* {{formula}}
114 +\begin{equation*}
113 113  
114 -Für mehrzeilige Lösungswege hat sich folgende Formatierung bewährt:
116 +h(x) = \frac{1}{2} \left(x-2\right)^2-\frac{1}{2}
115 115  
116 -{{info}}
117 -{{{
118 -{{formula}}
119 -\begin{align*}
120 -& g(x) &= 0\\
121 -\Rightarrow & \frac{1}{2}(x^2-4x+3) &= 0\\
122 -\Rightarrow & x^2-4x+3 &= 0\\
123 -\end{align*}
124 -
125 -\begin{align*}
126 -&\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}\\
127 -&\Rightarrow x_1=1; x_2=13
128 -\end{align*}
118 +\end{equation*}
129 129  {{/formula}}
120 +...
121 +{{/lösung}}
130 130  }}}
131 131  {{/info}}
132 132  
133 -Die //align//-Umgebung richtet die Zeilen an den Stellen aus, die mit einem & markiert sind. Zeilenumbrüche werden mit {{{\\}}} markiert. (Die Lehrzeile ist wichtig!)
125 +Die Aufgaben auf der Aufgabenseite und die Lösungen auf der Lösungsseite müssen in der gleichen Reihenfolge sein und es muss zu **jeder** Aufgabe auch eine Lösung geben. Denn nur dann funktionieren die Links von //Aufgabe X// zur //Lösung X// korrekt.
134 134  
127 +== LaTeX ==
128 +
129 +Das Formulieren von mathematischen Termen und Gleichungen mit LaTeX ist etwas mühsam. Einfacher geht es mit einem Formeleditor, wie z.B [[MathLive>>https://cortexjs.io/mathlive/demo/]]. Für mehrzeilige Lösungswege hat sich folgende Formatierung bewährt:
130 +
131 +{{info}}
132 +{{{
135 135  {{formula}}
136 -\begin{align*}
137 -& g(x) &= 0\\
138 -\Rightarrow & \frac{1}{2}(x^2-4x+3) &= 0\\
139 -\Rightarrow & x^2-4x+3 &= 0\\
140 -\end{align*}
134 +\begin{equation*}
141 141  
142 -\begin{align*}
143 -&\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}\\
144 -&\Rightarrow x_1=1; x_2=13
145 -\end{align*}
146 -{{/formula}}
136 +g(x) = 0
147 147  
148 -== Wichtige Formatierungen ==
138 +\Rightarrow \frac{1}{2}(x^2-4x+3) = 0
149 149  
150 -|{{{(% style="list-style: alphastyle" %)
151 -1. Punkt eins
152 -1. Punkt zwei
153 -}}}|(((
154 -(% style="list-style: alphastyle" %)
155 -1. Punkt eins
156 -1. Punkt zwei
157 -)))
158 -|kursiv {{{//f//}}}| //f//
159 -|fett {{{**L**}}}| **L**
140 +\Rightarrow x^2-4x+3=0
160 160  
161 -== Bilder einbinden ==
142 +\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
162 162  
163 -Um ein Bild einzubinden, muss man den Bearbeitungsmmodus verlassen und ganz unten auf der Seite das Bild als Anhnag hochladen. Anschliessend kann man das Bild mit
144 +\Rightarrow x_1=1; x_2=3
164 164  
165 -{{info}}
166 -{{{
167 - [[image:name.png]]
146 +\end{equation*}
147 +{{/formula}}
168 168  }}}
169 169  {{/info}}
170 170  
171 -einbinden.
151 +Die Leerzeilen sind entscheidend!