Zum Inhalt springen

Änderungen von Dokument Anleitung

Zuletzt geändert von Holger Engels am 2025/11/18 09:48
Von Version 52.2
bearbeitet von Holger Engels
am 2025/11/18 09:48
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 19.2
bearbeitet von VBS
am 2023/09/11 10:27
Änderungskommentar: Update document after refactoring.

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.holgerengels
1 +XWiki.vbs
Inhalt
... ... @@ -1,21 +1,22 @@
1 -{{seiteninhalt/}}
1 +{{box cssClass="floatinginfobox" title="**Contents**"}}
2 +{{toc start=2 depth=2 /}}
3 +{{/box}}
2 2  
3 3  [[XWikiSyntax>>https://mathe-arbeitsheft.zsl-bw.de/xwiki/bin/view/XWiki/XWikiSyntax?syntax=2.1&category=1]]
4 4  
5 5  == Aufgabenseite ==
6 6  
7 -Eine Aufgabenseite beginnt mit dem Inhaltsverzeichnis, gefolgt von den Kompetenzen. Das leistet folgender Code:
9 +Auf jeder Seite sollte ganz oben das Inhaltsverzeichnis eingebunden werden. Das leistet folgender Code:
8 8  
9 9  {{info}}
10 10  {{{
11 -{{seiteninhalt/}}
12 -
13 -[[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
14 -[[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
13 +{{box cssClass="floatinginfobox" title="**Contents**"}}
14 +{{toc start=2 depth=2 /}}
15 +{{/box}}
15 15  }}}
16 16  {{/info}}
17 17  
18 -Eine Aufgabenseite kann in Abschnitte unterteilt sein. Die Abschnitte werden von Überschriften der Ebene 2 angeführt. Beispielsweise ..
19 +Eine Aufgabenseite ist in Abschnitte unterteilt. Die Abschnitte werden von Überschriften der Ebene 2 angeführt. Beispielsweise ..
19 19  
20 20  {{info}}
21 21  {{{
... ... @@ -37,61 +37,68 @@
37 37  
38 38  {{info}}
39 39  {{{
40 -{{aufgabe id="Eindeutiger Name" afb="I" kompetenzen="K5,K6" quelle="Martina Wagner" niveau="e" zeit="7"}}
41 +{{aufgabe afb="I" kompetenzen="K5,K6" quelle="Martina Wagner" cc="BY-SA" niveau="e"}}
41 41  Berechne jeweils die Nullstellen!
42 -
43 +
43 43  * {{formula}}f(x) = \frac{1}{2}(x-1)(x-3){{/formula}}
44 44  * {{formula}}g(x) = \frac{1}{2}(x^2-4x+3){{/formula}}
45 45  * {{formula}}h(x) = \frac{1}{2}(x-2)^2-\frac{1}{2}{{/formula}}
46 -
47 +
47 47  {{/aufgabe}}
48 -}}}
49 + }}}
49 49  {{/info}}
50 50  
51 51  Folgende Parameter werden unterstützt:
52 52  
53 -|id|Ein (innerhalb der Seite) eindeutiger Name|erforderlich
54 54  |afb|entweder "I" oder "II" oder "III"|erforderlich
55 55  |kompetenzen|eine "K1" oder mehrere "K4,K5"|erforderlich
56 -|zeit|Bearbeitungszeit in Minuten|erforderlich
57 57  |quelle|Text oder Link, z.B. "Holger Engels" oder "{{{[[serlo.org]]}}}"|erforderlich
57 +|cc|Creative Commons Lizenzen in der aktuellen Version, z.B. "BY-SA"|cc oder lizenz erforderlich
58 +|lizenz|z.B. {{{[[CC BY-SA>>https://creativecommons.org/licenses/by-sa/3.0/deed.en]]}}}|cc oder lizenz erforderlich
58 58  |niveau|"g" oder "e"|optional
59 59  |links|{{{[[kmap.eu]]}}}, {{{[[serlo.org]]}}}|optional
60 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 +== Lösungsseite ==
62 62  
63 -Die Aufgabenseite wird von der Seitenreflexion abgeschlossen:
64 +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.
64 64  
66 +Der Aufbau einer Lösungsseite ist analog zur Aufgabenseite. Oben das Inhaltsverzeichnis, dann die gleichen Abschnitte:
67 +
65 65  {{info}}
66 66  {{{
67 -{{seitenreflexion bildungsplan="5" kompetenzen="3" anforderungsbereiche="1" kriterien="2" menge="1"/}}
70 +{{box cssClass="floatinginfobox" title="**Contents**"}}
71 +{{toc start=2 depth=2 /}}
72 +{{/box}}
73 +
74 +== Allgemeines ==
75 +
76 +... Lösungen zu Allgemeines ...
68 68  }}}
69 69  {{/info}}
70 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.
80 +Jede Lösung ist von einem Macro //lösung// umgeben. Das kann z.B. so aussehen:
72 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
82 +{{info}}
83 +{{{
84 +{{lösung}}
85 +* {{formula}}
86 +\begin{equation*}
78 78  
79 -== Lösungsseite ==
88 +f(x) = 0
80 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 88  \Rightarrow \frac12\left(x-1\right)\left(x-3\right)=0
89 89  
90 90  \Rightarrow x-1=0\vee x-3=0
91 91  
92 -\Rightarrow x_1=1; x_2=3{{/formula}}
93 -1. {{formula}}g(x) = 0
94 +\Rightarrow x_1=1; x_2=3
94 94  
96 +\end{equation*}
97 +{{/formula}}
98 +* {{formula}}
99 +\begin{equation*}
100 +
101 +g(x) = 0
102 +
95 95  \Rightarrow \frac{1}{2}(x^2-4x+3) = 0
96 96  
97 97  \Rightarrow x^2-4x+3=0
... ... @@ -98,170 +98,46 @@
98 98  
99 99  \Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
100 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 -...
109 +\Rightarrow x_1=1; x_2=3
104 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
111 +\end{equation*}
113 113  {{/formula}}
113 +* {{formula}}
114 +\begin{equation*}
114 114  
115 -Für mehrzeilige Lösungswege hat sich folgende Formatierung bewährt:
116 +h(x) = \frac{1}{2} \left(x-2\right)^2-\frac{1}{2}
116 116  
117 -{{info}}
118 -{{{
119 -{{formula}}
120 -\begin{aligned}
121 -& g(x) & =\: & 0\\
122 -\Rightarrow\: & \frac{1}{2}(x^2-4x+3) & =\: & 0\\
123 -\Rightarrow\: & x^2-4x+3 & =\: & 0\\
124 -\end{aligned}
118 +\end{equation*}
125 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}}
120 +...
121 +{{/lösung}}
133 133  }}}
134 134  {{/info}}
135 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.
125 +Die Aufgaben auf der Aufgabenseite und die Lösungen auf der Lösungsseite müssen in der gleichen Reihenfolge sein und es muss zu **jeder** Aufgabe auch eine Lösung geben. Denn nur dann funktionieren die Links von //Aufgabe X// zur //Lösung X// korrekt.
137 137  
138 -{{formula}}
139 -\begin{aligned}
140 -& g(x) & =\: & 0\\
141 -\Rightarrow\: & \frac{1}{2}(x^2-4x+3) & =\: & 0\\
142 -\Rightarrow\: & x^2-4x+3 & =\: & 0\\
143 -\end{aligned}
144 -{{/formula}}
127 +== LaTeX ==
145 145  
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}}
129 +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/]]. Für mehrzeilige Lösungswege hat sich folgende Formatierung bewährt:
152 152  
153 -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}##.
154 -
155 -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.
156 -
157 -== Wichtige Formatierungen ==
158 -
159 -|{{{(%class="abc"%)
160 -1. Punkt eins
161 -1. Punkt zwei
162 -}}}|(((
163 -(% class="abc" %)
164 -1. Punkt eins
165 -1. Punkt zwei
166 -)))
167 -|kursiv {{{//f//}}}| //f//
168 -|fett {{{**L**}}}| **L**
169 -
170 -== Bilder einbinden ==
171 -
172 -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
173 -
174 174  {{info}}
175 175  {{{
176 - [[image:name.png]]
177 -}}}
178 -{{/info}}
133 +{{formula}}
134 +\begin{equation*}
179 179  
180 -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.
136 +g(x) = 0
181 181  
182 -Je nachdem, von wo das Bild kommt, muss ein Lizenzhinweis dazugeschrieben werden. Dabei kann der [[Lizenhinweisgenerator>>https://lizenzhinweisgenerator.de]] hilfreich sein.
138 +\Rightarrow \frac{1}{2}(x^2-4x+3) = 0
183 183  
184 -== Tabellen ==
140 +\Rightarrow x^2-4x+3=0
185 185  
186 -{{info}}
187 -{{{
188 -|=Überschriftenzelle|=noch eine
189 -|Normale Zelle|ohne =
190 -}}}
191 -{{/info}}
142 +\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
192 192  
193 -|=Überschriftenzelle|=noch eine
194 -|Normale Zelle|ohne =
144 +\Rightarrow x_1=1; x_2=3
195 195  
196 -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:
197 -
198 -{{info}}
199 -{{{
200 -(% class="noborder" %)
201 -|=Überschriftenzelle|=noch eine
202 -|Normale Zelle|ohne =
146 +\end{equation*}
147 +{{/formula}}
203 203  }}}
204 204  {{/info}}
205 205  
206 -(% class="noborder" %)
207 -|=Überschriftenzelle|=noch eine
208 -|Normale Zelle|ohne =
209 -
210 -{{info}}
211 -{{{
212 -(% class="border" %)
213 -|=Überschriftenzelle|=noch eine
214 -|Normale Zelle|ohne =
215 -}}}
216 -{{/info}}
217 -
218 -(% class="border" %)
219 -|=Überschriftenzelle|=noch eine
220 -|Normale Zelle|ohne =
221 -
222 -{{info}}
223 -{{{
224 -(% class="border slim" %)
225 -|=Überschriftenzelle|=noch eine
226 -|Normale Zelle|ohne =
227 -}}}
228 -{{/info}}
229 -
230 -(% class="border slim" %)
231 -|=Überschriftenzelle|=noch eine
232 -|Normale Zelle|ohne =
233 -
234 -**Beachte:** ##slim## ist kombinierbar mit ##border## und ##noborder##
235 -
236 -== Listen ==
237 -
238 -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.
239 -
240 -{{info}}
241 -{{{
242 -(% class="abc" %)
243 -1. Unteraufgabe eins
244 -1. Unteraufgabe zwei
245 -1. Unteraufgabe drei
246 -}}}
247 -{{/info}}
248 -
249 -(% class="abc" %)
250 -1. Unteraufgabe eins
251 -1. Unteraufgabe zwei
252 -1. Unteraufgabe drei
253 -
254 -== Tastenkombinationen ==
255 -
256 -[Strg][Alt][Umschalt][?]
257 -
258 -|=F|{{{{{formula}}{{/formula}}}}}
259 -|=A|{{{{{aufgabe id="" afb="" kompetenzen="" quelle="" zeit="" cc="by-sa" tags=""}}{{/aufgabe}}}}}
260 -|=I|{{{{{seiteninhalt/}}}}}
261 -|=R|{{{{{seitenreflexion bildungsplan="" kompetenzen="" anforderungsbereiche="" kriterien="" menge=""/}}}}}
262 -|=B|{{{[[image:]]}}}
263 -|=L|{{{(%class=abc%)
264 -1. }}}
265 -|=W|{{{(%class="border slim"%)
266 -|=x|0
267 -|=f{{{(x)}}}|}}}
151 +Die Leerzeilen sind entscheidend!
XWiki.XWikiComments[0]
Datum
... ... @@ -1,1 +1,0 @@
1 -2023-10-25 18:08:43.4
Autor
... ... @@ -1,1 +1,0 @@
1 -XWiki.fujan
Kommentar
... ... @@ -1,1 +1,0 @@
1 -Wie kann man denn Abbildungen im Wiki skalieren? Danke schon mal!
XWiki.XWikiComments[1]
Datum
... ... @@ -1,1 +1,0 @@
1 -2024-07-11 13:36:25.122
Autor
... ... @@ -1,1 +1,0 @@
1 -XWiki.holgerengels
Kommentar
... ... @@ -1,1 +1,0 @@
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.