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.

64

65

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.

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

== 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.

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

...

== 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/]].

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

114

\int_a^b f(x)\cdot dx

115

116

117

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

{{{

\begin{aligned}

& g(x) & =\: & 0\\

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

125

\Rightarrow\: & x^2-4x+3 & =\: & 0\\

\end{aligned}

\begin{aligned}

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

132

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

\begin{aligned}

& g(x) & =\: & 0\\

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

144

\Rightarrow\: & x^2-4x+3 & =\: & 0\\

\end{aligned}

\begin{aligned}

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

151

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

\end{aligned}

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

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

1. Punkt eins

1. Punkt zwei

}}}|(((

(% class="abc" %)

1. Punkt eins

1. Punkt zwei

)))

|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

{{{

[[image:name.png]]

}}}

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.

183

184

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

191

|Normale Zelle|ohne =

}}}

|=Ü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:

{{{

(% class="noborder" %)

203

|=Überschriftenzelle|=noch eine

204

|Normale Zelle|ohne =

}}}

(% class="noborder" %)

209

|=Überschriftenzelle|=noch eine

210

|Normale Zelle|ohne =

{{{

(% class="border" %)

|=Überschriftenzelle|=noch eine

216

|Normale Zelle|ohne =

}}}

(% class="border" %)

|=Überschriftenzelle|=noch eine

222

|Normale Zelle|ohne =

{{{

(% class="border slim" %)

227

|=Überschriftenzelle|=noch eine

228

|Normale Zelle|ohne =

}}}

(% class="border slim" %)

233

|=Überschriftenzelle|=noch eine

234

|Normale Zelle|ohne =

235

236

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

Wiki-Quellcode von Anleitung

Hauptnavigation

Suchen

Zuletzt besucht

Zuletzt geändert

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" 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{aligned}
		123	& g(x) & =\: & 0\\
		124	\Rightarrow\: & \frac{1}{2}(x^2-4x+3) & =\: & 0\\
		125	\Rightarrow\: & x^2-4x+3 & =\: & 0\\
		126	\end{aligned}
		127	{{/formula}}
		128
		129	{{formula}}
		130	\begin{aligned}
		131	&\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}\\
		132	&\Rightarrow x_1=1;\: x_2=13
		133	\end{aligned}
		134	{{/formula}}
		135	}}}
		136	{{/info}}
		137
		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.
		139
		140	{{formula}}
		141	\begin{aligned}
		142	& g(x) & =\: & 0\\
		143	\Rightarrow\: & \frac{1}{2}(x^2-4x+3) & =\: & 0\\
		144	\Rightarrow\: & x^2-4x+3 & =\: & 0\\
		145	\end{aligned}
		146	{{/formula}}
		147
		148	{{formula}}
		149	\begin{aligned}
		150	&\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}\\
		151	&\Rightarrow x_1=1;\: x_2=13
		152	\end{aligned}
		153	{{/formula}}
		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
		176	{{info}}
		177	{{{
		178	[[image:name.png]]
		179	}}}
		180	{{/info}}
		181
		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.
		183
		184	Je nachdem, von wo das Bild kommt, muss ein Lizenzhinweis dazugeschrieben werden. Dabei kann der [[Lizenhinweisgenerator>>https://lizenzhinweisgenerator.de]] hilfreich sein.
		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##
		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

unfertig	fertig
● ● ● ● ● ● ●