Wiki-Quellcode von Anleitung

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

Zeige letzte Bearbeiter
1 {{seiteninhalt/}}
2
3 [[XWikiSyntax>>https://mathe-arbeitsheft.zsl-bw.de/xwiki/bin/view/XWiki/XWikiSyntax?syntax=2.1&category=1]]
4
5 == Aufgabenseite ==
6
7 Eine Aufgabenseite beginnt mit dem Inhaltsverzeichnis, gefolgt von den Kompetenzen. Das leistet folgender Code:
8
9 {{info}}
10 {{{
11 {{seiteninhalt/}}
12
13 [[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
14 [[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
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 {{{
22 == Allgemeines ==
23 ... Aufgaben zu Allgemeines ...
24
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
36 Jede Aufgabe ist von einem Macro //aufgabe// umgeben. Das kann z.B. so aussehen:
37
38 {{info}}
39 {{{
40 {{aufgabe id="Eindeutiger Name" afb="I" kompetenzen="K5,K6" quelle="Martina Wagner" cc="BY-SA" niveau="e" zeit="7"}}
41 Berechne jeweils die Nullstellen!
42
43 * {{formula}}f(x) = \frac{1}{2}(x-1)(x-3){{/formula}}
44 * {{formula}}g(x) = \frac{1}{2}(x^2-4x+3){{/formula}}
45 * {{formula}}h(x) = \frac{1}{2}(x-2)^2-\frac{1}{2}{{/formula}}
46
47 {{/aufgabe}}
48 }}}
49 {{/info}}
50
51 Folgende Parameter werden unterstützt:
52
53 |id|Ein (innerhalb der Seite) eindeutiger Name|erforderlich
54 |afb|entweder "I" oder "II" oder "III"|erforderlich
55 |kompetenzen|eine "K1" oder mehrere "K4,K5"|erforderlich
56 |zeit|Bearbeitungszeit in Minuten|erforderlich
57 |quelle|Text oder Link, z.B. "Holger Engels" oder "{{{[[serlo.org]]}}}"|erforderlich
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
60 |niveau|"g" oder "e"|optional
61 |links|{{{[[kmap.eu]]}}}, {{{[[serlo.org]]}}}|optional
62
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
65 Die Aufgabenseite wird von der Seitenreflexion abgeschlossen:
66
67 {{info}}
68 {{{
69 {{seitenreflexion bildungsplan="5" kompetenzen="3" anforderungsbereiche="1" kriterien="2" menge="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
75 |bildungsplan|Ganze Zahl von 1 .. 5|erforderlich
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
81 == Lösungsseite ==
82
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.
84
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.
86
87 (% style="list-style: alphastyle" %)
88 1. {{formula}}f(x) = 0
89
90 \Rightarrow \frac12\left(x-1\right)\left(x-3\right)=0
91
92 \Rightarrow x-1=0\vee x-3=0
93
94 \Rightarrow x_1=1; x_2=3{{/formula}}
95 1. {{formula}}g(x) = 0
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
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}}
105 ...
106
107 == LaTeX ==
108
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/]].
110
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
119 {{info}}
120 {{{
121 {{formula}}
122 \begin{align*}
123 & g(x) & =\: & 0\\
124 \Rightarrow\: & \frac{1}{2}(x^2-4x+3) & =\: & 0\\
125 \Rightarrow\: & x^2-4x+3 & =\: & 0\\
126 \end{align*}
127
128 \begin{align*}
129 &\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}\\
130 &\Rightarrow x_1=1;\: x_2=13
131 \end{align*}
132 {{/formula}}
133 }}}
134 {{/info}}
135
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.
137
138 {{formula}}
139 \begin{align*}
140 & g(x) & =\: & 0\\
141 \Rightarrow\: & \frac{1}{2}(x^2-4x+3) & =\: & 0\\
142 \Rightarrow\: & x^2-4x+3 & =\: & 0\\
143 \end{align*}
144
145 \begin{align*}
146 &\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}\\
147 &\Rightarrow x_1=1;\: x_2=13
148 \end{align*}
149 {{/formula}}
150
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}##.
152
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
155 == Wichtige Formatierungen ==
156
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 )))
165 |kursiv {{{//f//}}}| //f//
166 |fett {{{**L**}}}| **L**
167
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
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.
179
180 Je nachdem, von wo das Bild kommt, muss ein Lizenzhinweis dazugeschrieben werden. Dabei kann der [[Lizenhinweisgenerator>>https://lizenzhinweisgenerator.de]] hilfreich sein.
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##
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