Wiki-Quellcode von Anleitung

Version 50.2 von Holger Engels am 2025/08/07 20:03

Verstecke letzte Bearbeiter
VBS 20.1 1 {{seiteninhalt/}}
VBS 1.1 2
VBS 19.1 3 [[XWikiSyntax>>https://mathe-arbeitsheft.zsl-bw.de/xwiki/bin/view/XWiki/XWikiSyntax?syntax=2.1&category=1]]
4
VBS 4.1 5 == Aufgabenseite ==
6
VBS 27.1 7 Eine Aufgabenseite beginnt mit dem Inhaltsverzeichnis, gefolgt von den Kompetenzen. Das leistet folgender Code:
VBS 1.1 8
9 {{info}}
10 {{{
VBS 20.1 11 {{seiteninhalt/}}
VBS 1.1 12
VBS 27.1 13 [[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
14 [[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
VBS 21.1 15 }}}
16 {{/info}}
17
18 Eine Aufgabenseite kann in Abschnitte unterteilt sein. Die Abschnitte werden von Überschriften der Ebene 2 angeführt. Beispielsweise ..
19
20 {{info}}
21 {{{
VBS 1.1 22 == Allgemeines ==
23 ... Aufgaben zu Allgemeines ...
holger 6.1 24
VBS 1.1 25 == Potenzen ==
26 ... Aufgaben zu Potenzen ...
27
28 == Wurzeln ==
29 ... Aufgaben zu Wurzeln ...
30
31 == Brüche ==
32 ... Aufgaben zu Brüche ...
33 }}}
34 {{/info}}
35
VBS 8.1 36 Jede Aufgabe ist von einem Macro //aufgabe// umgeben. Das kann z.B. so aussehen:
VBS 1.1 37
38 {{info}}
39 {{{
VBS 27.1 40 {{aufgabe id="Eindeutiger Name" afb="I" kompetenzen="K5,K6" quelle="Martina Wagner" cc="BY-SA" niveau="e" zeit="7"}}
holger 13.1 41 Berechne jeweils die Nullstellen!
VBS 27.1 42
VBS 16.1 43 * {{formula}}f(x) = \frac{1}{2}(x-1)(x-3){{/formula}}
44 * {{formula}}g(x) = \frac{1}{2}(x^2-4x+3){{/formula}}
VBS 17.1 45 * {{formula}}h(x) = \frac{1}{2}(x-2)^2-\frac{1}{2}{{/formula}}
VBS 27.1 46
holger 7.1 47 {{/aufgabe}}
Holger Engels 24.1 48 }}}
VBS 1.1 49 {{/info}}
50
holger 7.1 51 Folgende Parameter werden unterstützt:
VBS 1.1 52
VBS 27.1 53 |id|Ein (innerhalb der Seite) eindeutiger Name|erforderlich
VBS 9.1 54 |afb|entweder "I" oder "II" oder "III"|erforderlich
55 |kompetenzen|eine "K1" oder mehrere "K4,K5"|erforderlich
Holger Engels 23.1 56 |zeit|Bearbeitungszeit in Minuten|erforderlich
VBS 8.1 57 |quelle|Text oder Link, z.B. "Holger Engels" oder "{{{[[serlo.org]]}}}"|erforderlich
VBS 9.1 58 |cc|Creative Commons Lizenzen in der aktuellen Version, z.B. "BY-SA"|cc oder lizenz erforderlich
59 |lizenz|z.B. {{{[[CC BY-SA>>https://creativecommons.org/licenses/by-sa/3.0/deed.en]]}}}|cc oder lizenz erforderlich
VBS 8.1 60 |niveau|"g" oder "e"|optional
VBS 10.1 61 |links|{{{[[kmap.eu]]}}}, {{{[[serlo.org]]}}}|optional
VBS 1.1 62
Holger Engels 48.1 63 Wenn es schwer fällt, einer Aufgabe einen AFB und eine Teilmenge der Kompetenzen zuzuordnen, sollte diese eventuell in mehrere Teilaufgaben gesplittet werden.
64
VBS 21.1 65 Die Aufgabenseite wird von der Seitenreflexion abgeschlossen:
66
67 {{info}}
68 {{{
Holger Engels 49.2 69 {{seitenreflexion bildungsplan="5" kompetenzen="3" anforderungsbereiche="1" kriterien="2" menge="1"/}}
VBS 21.1 70 }}}
71 {{/info}}
72
73 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.
74
Holger Engels 45.1 75 |bildungsplan|Ganze Zahl von 1 .. 5|erforderlich
VBS 21.1 76 |kompetenzen|Ganze Zahl von 1 .. 5|erforderlich
77 |anforderungsbereiche|Ganze Zahl von 1 .. 5|erforderlich
78 |kriterien|Ganze Zahl von 1 .. 5|erforderlich
79 |menge|Ganze Zahl von 1 .. 5|erforderlich
80
VBS 4.1 81 == Lösungsseite ==
82
VBS 27.1 83 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.
VBS 4.1 84
VBS 27.1 85 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.
VBS 4.1 86
VBS 29.1 87 (% style="list-style: alphastyle" %)
Holger Engels 33.1 88 1. {{formula}}f(x) = 0
VBS 16.1 89
90 \Rightarrow \frac12\left(x-1\right)\left(x-3\right)=0
91
92 \Rightarrow x-1=0\vee x-3=0
93
Holger Engels 33.1 94 \Rightarrow x_1=1; x_2=3{{/formula}}
95 1. {{formula}}g(x) = 0
VBS 16.1 96
97 \Rightarrow \frac{1}{2}(x^2-4x+3) = 0
98
99 \Rightarrow x^2-4x+3=0
100
101 \Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
102
Holger Engels 33.1 103 \Rightarrow x_1=1; x_2=3{{/formula}}
104 1. {{formula}}h(x) = \frac{1}{2} \cdot \left(x-2\right)^2 - \frac{1}{2}{{/formula}}
VBS 16.1 105 ...
VBS 4.1 106
holger 6.1 107 == LaTeX ==
108
VBS 31.1 109 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/]].
holger 15.1 110
VBS 31.1 111 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.:
112
113 {{formula}}
114 \int_a^b f(x)\cdot dx
115 {{/formula}}
116
117 Für mehrzeilige Lösungswege hat sich folgende Formatierung bewährt:
118
VBS 18.1 119 {{info}}
VBS 17.1 120 {{{
121 {{formula}}
Holger Engels 50.2 122 \begin{aligned}
Holger Engels 38.1 123 & g(x) & =\: & 0\\
124 \Rightarrow\: & \frac{1}{2}(x^2-4x+3) & =\: & 0\\
125 \Rightarrow\: & x^2-4x+3 & =\: & 0\\
Holger Engels 50.2 126 \end{aligned}
127 {{/formula}}
VBS 31.1 128
Holger Engels 50.2 129 {{formula}}
130 \begin{aligned}
Holger Engels 34.1 131 &\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}\\
Holger Engels 38.1 132 &\Rightarrow x_1=1;\: x_2=13
Holger Engels 50.2 133 \end{aligned}
VBS 17.1 134 {{/formula}}
135 }}}
VBS 18.1 136 {{/info}}
137
Holger Engels 37.1 138 Die //align//-Umgebung richtet die Zeilen an den Stellen aus, die mit einem & markiert sind. Zeilenumbrüche werden mit {{{\\}}} markiert. Damit die //align//-Umgebung funktioniert, muss LaTeX in im //display math//-Modus sein (siehe oben). Beachte die Leerzeile zwischen den beiden //align//-Blöcken! In LaTeX ist es ähnlich, wie im Wiki. Was unmittelbar untereinander steht, gehört zum selben Block. Eine Leerzeile trennt in zwei Blöcke.
VBS 31.1 139
140 {{formula}}
Holger Engels 50.2 141 \begin{aligned}
Holger Engels 38.1 142 & g(x) & =\: & 0\\
143 \Rightarrow\: & \frac{1}{2}(x^2-4x+3) & =\: & 0\\
144 \Rightarrow\: & x^2-4x+3 & =\: & 0\\
Holger Engels 50.2 145 \end{aligned}
146 {{/formula}}
VBS 31.1 147
Holger Engels 50.2 148 {{formula}}
149 \begin{aligned}
Holger Engels 34.1 150 &\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}\\
Holger Engels 38.1 151 &\Rightarrow x_1=1;\: x_2=13
Holger Engels 50.2 152 \end{aligned}
VBS 31.1 153 {{/formula}}
154
Holger Engels 47.1 155 Um beispielsweise das **D**, **L** oder **W** fett zu setzen, kann ##\boldsymbol{D}## verwendet werden. Für Zahlenmengen mit doppelt gestrichenen Buchstaben, wie z.B. {{formula}}\mathbb{R}{{/formula}} schreibt man ##\mathbb{R}##.
Holger Engels 46.1 156
Holger Engels 43.1 157 Hier gibt es ein sehr übersichtliches [[Cheat-Sheet>>https://www.cmor-faculty.rice.edu/heinken/latex/symbols.pdf]] mit allen möglichen Symbolen, Operatoren, etc.
158
VBS 30.1 159 == Wichtige Formatierungen ==
VBS 26.1 160
VBS 30.1 161 |{{{(% style="list-style: alphastyle" %)
162 1. Punkt eins
163 1. Punkt zwei
164 }}}|(((
165 (% style="list-style: alphastyle" %)
166 1. Punkt eins
167 1. Punkt zwei
168 )))
VBS 32.1 169 |kursiv {{{//f//}}}| //f//
170 |fett {{{**L**}}}| **L**
VBS 30.1 171
VBS 26.1 172 == Bilder einbinden ==
173
174 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
175
176 {{info}}
177 {{{
178 [[image:name.png]]
179 }}}
180 {{/info}}
181
Holger Engels 49.1 182 einbinden. Als Dateiformate für Bilder werden PNG und SVG und JPG empfohlen. SVG hat den Vorteil, dass es verlustfrei skaliert und auch ausgedruckt perfekt aussieht. PNG eignet sich für Schaubilder, JPG für Fotos. Bei beiden empfiehlt es sich, das Bild mit einer hohen Auflösung (z.B. HD: 1.280 x 720 Pixel) hochzuladen und dann mit ##{{{[[image:name.png||width=600]]}}}## auf eine passende Größe zu skalieren. Dank der zusätzlichen Pixel sieht das Bild dann auch im Ausdruck gut aus. Mit ##{{{||style="display: block; margin: auto"}}}## kann das Bild zentriert werden. Mit ##{{{||style="float: right"}}}## wird das Bild am rechten Rand positioniert und auf der linken Seite von Text umflossen.
Holger Engels 41.1 183
184 Je nachdem, von wo das Bild kommt, muss ein Lizenzhinweis dazugeschrieben werden. Dabei kann der [[Lizenhinweisgenerator>>https://lizenzhinweisgenerator.de]] hilfreich sein.
Holger Engels 42.1 185
186 == Tabellen ==
187
188 {{info}}
189 {{{
190 |=Überschriftenzelle|=noch eine
191 |Normale Zelle|ohne =
192 }}}
193 {{/info}}
194
195 |=Überschriftenzelle|=noch eine
196 |Normale Zelle|ohne =
197
198 So sieht eine Standard Tabelle aus. Die ist nicht für jeden Zweck geeignet. Manchmal möchte man keine Rahmen oder vollständige Rahmen oder weniger Innenabstand. Dafür gibt es drei fertige Designs, die man folgendermaßen applizieren kann:
199
200 {{info}}
201 {{{
202 (% class="noborder" %)
203 |=Überschriftenzelle|=noch eine
204 |Normale Zelle|ohne =
205 }}}
206 {{/info}}
207
208 (% class="noborder" %)
209 |=Überschriftenzelle|=noch eine
210 |Normale Zelle|ohne =
211
212 {{info}}
213 {{{
214 (% class="border" %)
215 |=Überschriftenzelle|=noch eine
216 |Normale Zelle|ohne =
217 }}}
218 {{/info}}
219
220 (% class="border" %)
221 |=Überschriftenzelle|=noch eine
222 |Normale Zelle|ohne =
223
224 {{info}}
225 {{{
226 (% class="border slim" %)
227 |=Überschriftenzelle|=noch eine
228 |Normale Zelle|ohne =
229 }}}
230 {{/info}}
231
232 (% class="border slim" %)
233 |=Überschriftenzelle|=noch eine
234 |Normale Zelle|ohne =
235
236 **Beachte:** ##slim## ist kombinierbar mit ##border## und ##noborder##
Holger Engels 50.1 237
238 == Listen ==
239
240 Normalerweise werden geordnete Listen (Markup: {{code}}1. {{/code}}) mit Zahlen nummeriert. In den Aufgaben verwendet man folgenden Code, um stattdessen a, b, c zu bekommen.
241
242 {{info}}
243 {{{
244 (% class="abc" %)
245 1. Unteraufgabe eins
246 1. Unteraufgabe zwei
247 1. Unteraufgabe drei
248 }}}
249 {{/info}}
250
251 (% class="abc" %)
252 1. Unteraufgabe eins
253 1. Unteraufgabe zwei
254 1. Unteraufgabe drei