Wiki-Quellcode von Anleitung

Zuletzt geändert von Holger Engels am 2024/11/06 09:21

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 34.1 122 \begin{align*}
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 34.1 126 \end{align*}
VBS 31.1 127
Holger Engels 34.1 128 \begin{align*}
129 &\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}\\
Holger Engels 38.1 130 &\Rightarrow x_1=1;\: x_2=13
Holger Engels 34.1 131 \end{align*}
VBS 17.1 132 {{/formula}}
133 }}}
VBS 18.1 134 {{/info}}
135
Holger Engels 37.1 136 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 137
138 {{formula}}
Holger Engels 34.1 139 \begin{align*}
Holger Engels 38.1 140 & g(x) & =\: & 0\\
141 \Rightarrow\: & \frac{1}{2}(x^2-4x+3) & =\: & 0\\
142 \Rightarrow\: & x^2-4x+3 & =\: & 0\\
Holger Engels 34.1 143 \end{align*}
VBS 31.1 144
Holger Engels 34.1 145 \begin{align*}
146 &\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}\\
Holger Engels 38.1 147 &\Rightarrow x_1=1;\: x_2=13
Holger Engels 34.1 148 \end{align*}
VBS 31.1 149 {{/formula}}
150
Holger Engels 47.1 151 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 152
Holger Engels 43.1 153 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.
154
VBS 30.1 155 == Wichtige Formatierungen ==
VBS 26.1 156
VBS 30.1 157 |{{{(% style="list-style: alphastyle" %)
158 1. Punkt eins
159 1. Punkt zwei
160 }}}|(((
161 (% style="list-style: alphastyle" %)
162 1. Punkt eins
163 1. Punkt zwei
164 )))
VBS 32.1 165 |kursiv {{{//f//}}}| //f//
166 |fett {{{**L**}}}| **L**
VBS 30.1 167
VBS 26.1 168 == Bilder einbinden ==
169
170 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
171
172 {{info}}
173 {{{
174 [[image:name.png]]
175 }}}
176 {{/info}}
177
Holger Engels 49.1 178 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 179
180 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 181
182 == Tabellen ==
183
184 {{info}}
185 {{{
186 |=Überschriftenzelle|=noch eine
187 |Normale Zelle|ohne =
188 }}}
189 {{/info}}
190
191 |=Überschriftenzelle|=noch eine
192 |Normale Zelle|ohne =
193
194 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:
195
196 {{info}}
197 {{{
198 (% class="noborder" %)
199 |=Überschriftenzelle|=noch eine
200 |Normale Zelle|ohne =
201 }}}
202 {{/info}}
203
204 (% class="noborder" %)
205 |=Überschriftenzelle|=noch eine
206 |Normale Zelle|ohne =
207
208 {{info}}
209 {{{
210 (% class="border" %)
211 |=Überschriftenzelle|=noch eine
212 |Normale Zelle|ohne =
213 }}}
214 {{/info}}
215
216 (% class="border" %)
217 |=Überschriftenzelle|=noch eine
218 |Normale Zelle|ohne =
219
220 {{info}}
221 {{{
222 (% class="border slim" %)
223 |=Überschriftenzelle|=noch eine
224 |Normale Zelle|ohne =
225 }}}
226 {{/info}}
227
228 (% class="border slim" %)
229 |=Überschriftenzelle|=noch eine
230 |Normale Zelle|ohne =
231
232 **Beachte:** ##slim## ist kombinierbar mit ##border## und ##noborder##
Holger Engels 50.1 233
234 == Listen ==
235
236 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.
237
238 {{info}}
239 {{{
240 (% class="abc" %)
241 1. Unteraufgabe eins
242 1. Unteraufgabe zwei
243 1. Unteraufgabe drei
244 }}}
245 {{/info}}
246
247 (% class="abc" %)
248 1. Unteraufgabe eins
249 1. Unteraufgabe zwei
250 1. Unteraufgabe drei