Anleitung - XWiki

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:

{{{

{{seitenreflexion bildungsplan="5" kompetenzen="3" anforderungsbereiche="1" kriterien="2" menge="1"/}}

}}}

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.

72

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

== Lösungsseite ==

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}}

...

== LaTeX ==

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

112

\int_a^b f(x)\cdot dx

113

114

115

Für mehrzeilige Lösungswege hat sich folgende Formatierung bewährt:

{{{

\begin{aligned}

& & 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}\\

\end{aligned}

\begin{aligned}

&\Rightarrow & x_{1,2} &=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2} & & \\

128

&\Rightarrow & x_1 &=1;\: x_2=13 & &

\end{aligned}

}}}

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.

135

136

{{formula}}\begin{aligned}

137

&& g(x) &= 0 & \vert & g(x)\text{ einsetzen}\\

138

&\Rightarrow & \frac{1}{2}(x^2-4x+3) &= 0 & \vert & \cdot 2\\

139

&\Rightarrow & x^2-4x+3 &= 0 & \vert & \text{abc-Formel}

140

\end{aligned}{{/formula}}

141

{{formula}}\begin{aligned}

142

&\Rightarrow & x_{1,2} &=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2} & & \\

143

&\Rightarrow & x_1 &=1;\: x_2=13

144

\end{aligned}{{/formula}}

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}##.

149

150

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.

151

152

== Wichtige Formatierungen ==

|{{{(%class="abc"%)

1. Punkt eins

1. Punkt zwei

}}}|(((

(% class="abc" %)

1. Punkt eins

1. Punkt zwei

)))

|kursiv {{{//f//}}}| //f//

163

|fett {{{**L**}}}| **L**

164

165

== Bilder einbinden ==

166

167

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

{{{

[[image:name.png]]

[[image:rechtsvomtext.png||class=right width=450]]

}}}

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.

178

179

Je nachdem, von wo das Bild kommt, muss ein Lizenzhinweis dazugeschrieben werden. Dabei kann der [[Lizenhinweisgenerator>>https://lizenzhinweisgenerator.de]] hilfreich sein.

== Tabellen ==

{{{

|=Überschriftenzelle|=noch eine

186

|Normale Zelle|ohne =

}}}

|=Überschriftenzelle|=noch eine

191

|Normale Zelle|ohne =

192

193

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:

{{{

(% class="noborder" %)

198

|=Überschriftenzelle|=noch eine

199

|Normale Zelle|ohne =

}}}

(% class="noborder" %)

204

|=Überschriftenzelle|=noch eine

205

|Normale Zelle|ohne =

{{{

(% class="border" %)

|=Überschriftenzelle|=noch eine

211

|Normale Zelle|ohne =

}}}

(% class="border" %)

|=Überschriftenzelle|=noch eine

217

|Normale Zelle|ohne =

{{{

(% class="border slim" %)

222

|=Überschriftenzelle|=noch eine

223

|Normale Zelle|ohne =

}}}

(% class="border slim" %)

228

|=Überschriftenzelle|=noch eine

229

|Normale Zelle|ohne =

230

231

**Beachte:** ##slim## ist kombinierbar mit ##border## und ##noborder##

== Listen ==

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.

{{{

(% class="abc" %)

1. Unteraufgabe eins

1. Unteraufgabe zwei

1. Unteraufgabe drei

}}}

(% class="abc" %)

1. Unteraufgabe eins

1. Unteraufgabe zwei

1. Unteraufgabe drei

== Tastenkombinationen ==

252

253

[Strg][Alt][Umschalt][?]

254

255

|=F|{{{{{formula}}{{/formula}}}}}

256

|=A|{{{{{aufgabe id="" afb="" kompetenzen="" quelle="" zeit="" cc="by-sa" tags=""}}{{/aufgabe}}}}}

257

|=I|{{{{{seiteninhalt/}}}}}

258

|=R|{{{{{seitenreflexion bildungsplan="" kompetenzen="" anforderungsbereiche="" kriterien="" menge=""/}}}}}

|=B|{{{[[image:]]}}}

|=L|{{{(%class=abc%)

1. }}}

|=W|{{{(%class="border slim"%)

263

|=x|0

264

|=f{{{(x)}}}|}}}

author	version	line-number	content
		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" 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	\|niveau\|"g" oder "e"\|optional
		59	\|links\|{{{[[kmap.eu]]}}}, {{{[[serlo.org]]}}}\|optional
		60
		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
		65	{{info}}
		66	{{{
		67	{{seitenreflexion bildungsplan="5" kompetenzen="3" anforderungsbereiche="1" kriterien="2" menge="1"/}}
		68	}}}
		69	{{/info}}
		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.
		72
		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
		78
		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
		117	{{info}}
		118	{{{
		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
		126	\begin{aligned}
		127	&\Rightarrow & x_{1,2} &=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2} & & \\
		128	&\Rightarrow & x_1 &=1;\: x_2=13 & &
		129	\end{aligned}
		130	{{/formula}}
		131	}}}
		132	{{/info}}
		133
		134	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.
		135
		136	{{formula}}\begin{aligned}
		137	&& g(x) &= 0 & \vert & g(x)\text{ einsetzen}\\
		138	&\Rightarrow & \frac{1}{2}(x^2-4x+3) &= 0 & \vert & \cdot 2\\
		139	&\Rightarrow & x^2-4x+3 &= 0 & \vert & \text{abc-Formel}
		140	\end{aligned}{{/formula}}
		141	{{formula}}\begin{aligned}
		142	&\Rightarrow & x_{1,2} &=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2} & & \\
		143	&\Rightarrow & x_1 &=1;\: x_2=13
		144	\end{aligned}{{/formula}}
		145
		146
		147
		148	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}##.
		149
		150	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.
		151
		152	== Wichtige Formatierungen ==
		153
		154	\|{{{(%class="abc"%)
		155	1. Punkt eins
		156	1. Punkt zwei
		157	}}}\|(((
		158	(% class="abc" %)
		159	1. Punkt eins
		160	1. Punkt zwei
		161	)))
		162	\|kursiv {{{//f//}}}\| //f//
		163	\|fett {{{L}}}\| L
		164
		165	== Bilder einbinden ==
		166
		167	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
		168
		169	{{info}}
		170	{{{
		171	[[image:name.png]]
		172
		173	[[image:rechtsvomtext.png\|\|class=right width=450]]
		174	}}}
		175	{{/info}}
		176
		177	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.
		178
		179	Je nachdem, von wo das Bild kommt, muss ein Lizenzhinweis dazugeschrieben werden. Dabei kann der [[Lizenhinweisgenerator>>https://lizenzhinweisgenerator.de]] hilfreich sein.
		180
		181	== Tabellen ==
		182
		183	{{info}}
		184	{{{
		185	\|=Überschriftenzelle\|=noch eine
		186	\|Normale Zelle\|ohne =
		187	}}}
		188	{{/info}}
		189
		190	\|=Überschriftenzelle\|=noch eine
		191	\|Normale Zelle\|ohne =
		192
		193	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:
		194
		195	{{info}}
		196	{{{
		197	(% class="noborder" %)
		198	\|=Überschriftenzelle\|=noch eine
		199	\|Normale Zelle\|ohne =
		200	}}}
		201	{{/info}}
		202
		203	(% class="noborder" %)
		204	\|=Überschriftenzelle\|=noch eine
		205	\|Normale Zelle\|ohne =
		206
		207	{{info}}
		208	{{{
		209	(% class="border" %)
		210	\|=Überschriftenzelle\|=noch eine
		211	\|Normale Zelle\|ohne =
		212	}}}
		213	{{/info}}
		214
		215	(% class="border" %)
		216	\|=Überschriftenzelle\|=noch eine
		217	\|Normale Zelle\|ohne =
		218
		219	{{info}}
		220	{{{
		221	(% class="border slim" %)
		222	\|=Überschriftenzelle\|=noch eine
		223	\|Normale Zelle\|ohne =
		224	}}}
		225	{{/info}}
		226
		227	(% class="border slim" %)
		228	\|=Überschriftenzelle\|=noch eine
		229	\|Normale Zelle\|ohne =
		230
		231	Beachte: ##slim## ist kombinierbar mit ##border## und ##noborder##
		232
		233	== Listen ==
		234
		235	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.
		236
		237	{{info}}
		238	{{{
		239	(% class="abc" %)
		240	1. Unteraufgabe eins
		241	1. Unteraufgabe zwei
		242	1. Unteraufgabe drei
		243	}}}
		244	{{/info}}
		245
		246	(% class="abc" %)
		247	1. Unteraufgabe eins
		248	1. Unteraufgabe zwei
		249	1. Unteraufgabe drei
		250
		251	== Tastenkombinationen ==
		252
		253	[Strg][Alt][Umschalt][?]
		254
		255	\|=F\|{{{{{formula}}{{/formula}}}}}
		256	\|=A\|{{{{{aufgabe id="" afb="" kompetenzen="" quelle="" zeit="" cc="by-sa" tags=""}}{{/aufgabe}}}}}
		257	\|=I\|{{{{{seiteninhalt/}}}}}
		258	\|=R\|{{{{{seitenreflexion bildungsplan="" kompetenzen="" anforderungsbereiche="" kriterien="" menge=""/}}}}}
		259	\|=B\|{{{[[image:]]}}}
		260	\|=L\|{{{(%class=abc%)
		261	1. }}}
		262	\|=W\|{{{(%class="border slim"%)
		263	\|=x\|0
		264	\|=f{{{(x)}}}\|}}}

Wiki-Quellcode von Anleitung