Zum Inhalt springen

Änderungen von Dokument Anleitung

Zuletzt geändert von Holger Engels am 2026/07/15 13:21
Von Version 6.2
bearbeitet von holger
am 2023/05/10 12:55
Änderungskommentar: Update document after refactoring.
Auf Version 75.1
bearbeitet von Holger Engels
am 2026/07/15 13:21
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Übergeordnete Seite
... ... @@ -1,1 +1,1 @@
1 -Hilfe.WebHome
1 +Dokumentation.WebHome
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.holger
1 +XWiki.holgerengels
Inhalt
... ... @@ -1,20 +1,21 @@
1 -{{box cssClass="floatinginfobox" title="**Contents**"}}
2 -{{toc start=2 depth=2 /}}
3 -{{/box}}
1 +{{seiteninhalt/}}
4 4  
3 +[[XWikiSyntax>>https://mathe-arbeitsheft.zsl-bw.de/xwiki/bin/view/XWiki/XWikiSyntax?syntax=2.1&category=1]]
4 +
5 5  == Aufgabenseite ==
6 6  
7 -Auf jeder Seite sollte ganz oben das Inhaltsverzeichnis eingebunden werden. Das leistet folgender Code:
7 +Eine Aufgabenseite beginnt mit dem Inhaltsverzeichnis, gefolgt von den Kompetenzen. Das leistet folgender Code:
8 8  
9 9  {{info}}
10 10  {{{
11 -{{box cssClass="floatinginfobox" title="**Contents**"}}
12 -{{toc start=2 depth=2 /}}
13 -{{/box}}
11 +{{seiteninhalt/}}
12 +
13 +[[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
14 +[[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
14 14  }}}
15 15  {{/info}}
16 16  
17 -Eine Aufgabenseite ist in Abschnitte unterteilt. Die Abschnitte werden von Überschriften der Ebene 2 angeführt. Beispielsweise ..
18 +Eine Aufgabenseite kann in Abschnitte unterteilt sein. Die Abschnitte werden von Überschriften der Ebene 2 angeführt. Beispielsweise ..
18 18  
19 19  {{info}}
20 20  {{{
... ... @@ -32,82 +32,245 @@
32 32  }}}
33 33  {{/info}}
34 34  
35 -Jede Aufgabe wird von einer Überschrift der Ebene 3 angeführt. Das muss mit dem Macro //aufgabe// gemacht werden, damit direkt zur Lösung verlinkt werden kann:
36 +Jede Aufgabe ist von einem Macro //aufgabe// umgeben. Das kann z.B. so aussehen:
36 36  
37 37  {{info}}
38 38  {{{
39 -{{aufgabe ref="AllgemeinesA1"}}Aufgabe 1{{/aufgabe}}
40 +{{aufgabe id="Eindeutiger Name" afb="I" kompetenzen="K5,K6" quelle="Martina Wagner" 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}}
40 40  }}}
41 41  {{/info}}
42 42  
43 -"AllgemeinesA1" ist die ID, unter der die Lösung auf der Lösungsseite zu finden ist.
51 +Folgende Parameter werden unterstützt:
44 44  
45 -Unter jeder Aufgabe wird eine Tabelle mit Metainformationen dargestellt.
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 +|niveau|"g" oder "e"|optional
59 +|links|{{{[[kmap.eu]]}}}, {{{[[serlo.org]]}}}|optional
46 46  
61 +Wenn es schwer fällt, einer Aufgabe einen AFB und eine Teilmenge der Kompetenzen zuzuordnen, sollte diese eventuell in mehrere Teilaufgaben gesplittet werden.
62 +
63 +Die Aufgabenseite wird von der Seitenreflexion abgeschlossen:
64 +
47 47  {{info}}
48 48  {{{
49 -{{tags afb="I" kompetenzen="K6" quelle="KMap" lizenz="CC BY-SA"/}}
67 +{{seitenreflexion bildungsplan="5" kompetenzen="3" anforderungsbereiche="1" kriterien="2" menge="1"/}}
50 50  }}}
51 51  {{/info}}
52 52  
53 -Beachte den / vor den schließenden geschweiften Klammern!
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.
54 54  
55 -Optional kann auf weiterführendes Material zum Thema verlinkt werden:
73 +|bildungsplan|Ganze Zahl von 1 .. 5|erforderlich
74 +|kompetenzen|Ganze Zahl von 1 .. 5|erforderlich
75 +|anforderungsbereiche|Ganze Zahl von 1 .. 5|erforderlich
76 +|kriterien|Ganze Zahl von 1 .. 5|erforderlich
77 +|menge|Ganze Zahl von 1 .. 5|erforderlich
56 56  
79 +== Lösungsseite ==
80 +
81 +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.
82 +
83 +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.
84 +
85 +(% style="list-style: alphastyle" %)
86 +1. {{formula}}f(x) = 0
87 +
88 +\Rightarrow \frac12\left(x-1\right)\left(x-3\right)=0
89 +
90 +\Rightarrow x-1=0\vee x-3=0
91 +
92 +\Rightarrow x_1=1; x_2=3{{/formula}}
93 +1. {{formula}}g(x) = 0
94 +
95 +\Rightarrow \frac{1}{2}(x^2-4x+3) = 0
96 +
97 +\Rightarrow x^2-4x+3=0
98 +
99 +\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
100 +
101 +\Rightarrow x_1=1; x_2=3{{/formula}}
102 +1. {{formula}}h(x) = \frac{1}{2} \cdot \left(x-2\right)^2 - \frac{1}{2}{{/formula}}
103 +...
104 +
105 +== LaTeX ==
106 +
107 +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/]].
108 +
109 +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.:
110 +
111 +{{formula}}
112 +\int_a^b f(x)\cdot dx
113 +{{/formula}}
114 +
115 +Für mehrzeilige Lösungswege hat sich folgende Formatierung bewährt:
116 +
57 57  {{info}}
58 58  {{{
59 -{{tags afb="I" kompetenzen="K6" quelle="KMap" lizenz="CC BY-SA"}}[[KMap Termbaum>>https://kmap.eu/app/browser/Mathematik/Tools/Termbaum]]{{/tags}}
119 +{{formula}}
120 +\begin{aligned}
121 +&& g(x) &= 0 & \vert & g(x)\text{ einsetzen}\\
122 +&\Rightarrow & \frac{1}{2}(x^2-4x+3) &= 0 & \vert & \cdot 2\\
123 +&\Rightarrow & x^2-4x+3 &= 0 & \vert & \text{abc-Formel}
124 +\end{aligned}
125 +{{/formula}}
126 +
127 +{{formula}}
128 +\begin{aligned}
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{aligned}
132 +{{/formula}}
60 60  }}}
61 61  {{/info}}
62 62  
63 -Hier hat das Macro einen Inhalt. Der / befindet sich jetzt am schliessenden Tag vorne!
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.
64 64  
65 -Eine vollständige Aufgabe sieht dann beispielsweise folgendermaßen aus:
138 +{{formula}}
139 +\begin{aligned}
140 +&& g(x) &= 0 & \vert & g(x)\text{ einsetzen}\\
141 +&\Rightarrow & \frac{1}{2}(x^2-4x+3) &= 0 & \vert & \cdot 2\\
142 +&\Rightarrow & x^2-4x+3 &= 0 & \vert & \text{abc-Formel}
143 +\end{aligned}
144 +{{/formula}}
66 66  
146 +{{formula}}
147 +\begin{aligned}
148 +&\Rightarrow & x_{1,2} &=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2} & & \\
149 +&\Rightarrow & x_1 &=1;\: x_2=13
150 +\end{aligned}
151 +{{/formula}}
152 +
153 +
154 +
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}##.
156 +
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 +
159 +== Wichtige Formatierungen ==
160 +
161 +|{{{(%class="abc"%)
162 +1. Punkt eins
163 +1. Punkt zwei
164 +}}}|(((
165 +(% class="abc" %)
166 +1. Punkt eins
167 +1. Punkt zwei
168 +)))
169 +|kursiv {{{//f//}}}| //f//
170 +|fett {{{**L**}}}| **L**
171 +
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 +
67 67  {{info}}
68 68  {{{
69 -{{aufgabe ref="AllgemeinesA1"}}Aufgabe 1{{/aufgabe}}
178 + [[image:name.png]]
70 70  
71 -Entscheide, ob es sich um eine Summe, ein Produkt oder eine Potenz handelt und begründe Deine Wahl!
180 + [[image:rechtsvomtext.png||class=right width=450]]
181 +}}}
182 +{{/info}}
72 72  
73 -a) {{formula}} 2 \cdot a + 3 {{/formula}}
184 +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 ##{{{||class=center}}}## kann das Bild zentriert werden. Mit ##{{{||class=right}}}## wird das Bild am rechten Rand positioniert und auf der linken Seite von Text umflossen.
74 74  
75 -b) {{formula}} 2 \cdot (a + 3) {{/formula}}
186 +Je nachdem, von wo das Bild kommt, muss ein Lizenzhinweis dazugeschrieben werden. Dabei kann der [[Lizenhinweisgenerator>>https://lizenzhinweisgenerator.de]] hilfreich sein.
76 76  
77 -c) {{formula}} 2 \cdot a^3 {{/formula}}
188 +=== GeoGebras einbinden ===
78 78  
79 -d) {{formula}} 2^{(a + 3)} {{/formula}}
190 +Wenn Schaubilder mit GeoGebra erstellt werden, sollten sie als SVG exportiert werden (//Speichern als//). Um einen bestimmten Ausschnitt festzulegen, erstellt man zwei Punkte mit den Namen Export,,1,, und Export,,2,, und macht sie unsichtbar. Z.B.:
80 80  
81 -{{tags afb="I" kompetenzen="K6" quelle="KMap" lizenz="CC BY-SA"}}[[KMap Termbaum>>https://kmap.eu/app/browser/Mathematik/Tools/Termbaum]]{{/tags}}
192 + ##Export_1 = (-1, -1)## und ##Export_2 = (16, 11)##
193 +
194 +== Tabellen ==
195 +
196 +{{info}}
197 +{{{
198 +|=Überschriftenzelle|=noch eine
199 +|Normale Zelle|ohne =
82 82  }}}
83 83  {{/info}}
84 84  
85 -== Lösungsseite ==
203 +|=Überschriftenzelle|=noch eine
204 +|Normale Zelle|ohne =
86 86  
87 -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.
206 +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:
88 88  
89 -Der Aufbau einer Lösungsseite ist analog zur Aufgabenseite. Oben das Inhaltsverzeichnis, dann die gleichen Abschnitte, dann jeweils eine Lösung, angeführt vom Macro //lösung//. Beispiel:
208 +{{info}}
209 +{{{
210 +(% class="noborder" %)
211 +|=Überschriftenzelle|=noch eine
212 +|Normale Zelle|ohne =
213 +}}}
214 +{{/info}}
90 90  
216 +(% class="noborder" %)
217 +|=Überschriftenzelle|=noch eine
218 +|Normale Zelle|ohne =
219 +
91 91  {{info}}
92 92  {{{
93 -{{box cssClass="floatinginfobox" title="**Contents**"}}
94 -{{toc start=2 depth=2 /}}
95 -{{/box}}
222 +(% class="border" %)
223 +|=Überschriftenzelle|=noch eine
224 +|Normale Zelle|ohne =
225 +}}}
226 +{{/info}}
96 96  
97 -== Allgemeines ==
228 +(% class="border" %)
229 +|=Überschriftenzelle|=noch eine
230 +|Normale Zelle|ohne =
98 98  
99 -{{lösung id="AllgemeinesA1"}}Aufgabe 1{{/lösung}}
232 +{{info}}
233 +{{{
234 +(% class="border slim" %)
235 +|=Überschriftenzelle|=noch eine
236 +|Normale Zelle|ohne =
237 +}}}
238 +{{/info}}
100 100  
101 -Handelt es sich um eine Summe, ein Produkt oder eine Potenz?
240 +(% class="border slim" %)
241 +|=Überschriftenzelle|=noch eine
242 +|Normale Zelle|ohne =
102 102  
103 -a) Es handelt sich um eine Summe. Das · bindet stärker als das +. Siehe Termbaum!
104 -[[image:Allgemeines 1a Summe.png]]
244 +**Beachte:** ##slim## ist kombinierbar mit ##border## und ##noborder##
105 105  
246 +== Listen ==
247 +
248 +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.
249 +
250 +{{info}}
251 +{{{
252 +(% class="abc" %)
253 +1. Unteraufgabe eins
254 +1. Unteraufgabe zwei
255 +1. Unteraufgabe drei
106 106  }}}
107 107  {{/info}}
108 108  
109 -Die //id// der Lösung muss jeweils mit dem //ref// der Aufgabe übereinstimmen!
259 +(% class="abc" %)
260 +1. Unteraufgabe eins
261 +1. Unteraufgabe zwei
262 +1. Unteraufgabe drei
110 110  
111 -== LaTeX ==
264 +== Tastenkombinationen ==
112 112  
113 -[[Formeln testen>>https://katex.org/]]
266 +[Strg][Alt][Umschalt][?]
267 +
268 +|=F|{{{{{formula}}{{/formula}}}}}
269 +|=A|{{{{{aufgabe id="" afb="" kompetenzen="" quelle="" zeit="" cc="by-sa" tags=""}}{{/aufgabe}}}}}
270 +|=I|{{{{{seiteninhalt/}}}}}
271 +|=R|{{{{{seitenreflexion bildungsplan="" kompetenzen="" anforderungsbereiche="" kriterien="" menge=""/}}}}}
272 +|=B|{{{[[image:]]}}}
273 +|=L|{{{(%class=abc%)
274 +1. }}}
275 +|=W|{{{(%class="border slim"%)
276 +|=x|0
277 +|=f{{{(x)}}}|}}}
XWiki.XWikiComments[0]
Autor
... ... @@ -1,0 +1,1 @@
1 +XWiki.fujan
Kommentar
... ... @@ -1,0 +1,1 @@
1 +Wie kann man denn Abbildungen im Wiki skalieren? Danke schon mal!
Datum
... ... @@ -1,0 +1,1 @@
1 +2023-10-25 18:08:43.4
XWiki.XWikiComments[1]
Autor
... ... @@ -1,0 +1,1 @@
1 +XWiki.holgerengels
Kommentar
... ... @@ -1,0 +1,1 @@
1 +Danke für die Frage! Ich hab die erforderlichen Infos [[hier>>https://mathe-arbeitsheft.zsl-bw.de/xwiki/bin/view/Dokumentation/Anleitung/#HBildereinbinden]] ergänzt.
Datum
... ... @@ -1,0 +1,1 @@
1 +2024-07-11 13:36:25.122