Änderungen von Dokument Anleitung

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

Von Version 22.1
bearbeitet von VBS
am 2023/09/19 14:41
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 50.1
bearbeitet von Holger Engels
am 2024/11/06 09:21
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.vbs
1 +XWiki.holgerengels
Inhalt
... ... @@ -4,20 +4,14 @@
4 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 11  {{seiteninhalt/}}
12 -}}}
13 -{{/info}}
14 14  
15 -Danach kommen die Kompetenzen:
16 -
17 -{{info}}
18 -{{{
19 -[[Kompetenzen.K1]], [[Kompetenzen.K4]] Ich kann ...
20 -[[Kompetenzen.K1]], [[Kompetenzen.K4]] Ich kann ...
13 +[[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
14 +[[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
21 21  }}}
22 22  {{/info}}
23 23  
... ... @@ -43,21 +43,23 @@
43 43  
44 44  {{info}}
45 45  {{{
46 -{{aufgabe afb="I" kompetenzen="K5,K6" quelle="Martina Wagner" cc="BY-SA" niveau="e"}}
40 +{{aufgabe id="Eindeutiger Name" afb="I" kompetenzen="K5,K6" quelle="Martina Wagner" cc="BY-SA" niveau="e" zeit="7"}}
47 47  Berechne jeweils die Nullstellen!
48 -
42 +
49 49  * {{formula}}f(x) = \frac{1}{2}(x-1)(x-3){{/formula}}
50 50  * {{formula}}g(x) = \frac{1}{2}(x^2-4x+3){{/formula}}
51 51  * {{formula}}h(x) = \frac{1}{2}(x-2)^2-\frac{1}{2}{{/formula}}
52 -
46 +
53 53  {{/aufgabe}}
54 - }}}
48 +}}}
55 55  {{/info}}
56 56  
57 57  Folgende Parameter werden unterstützt:
58 58  
53 +|id|Ein (innerhalb der Seite) eindeutiger Name|erforderlich
59 59  |afb|entweder "I" oder "II" oder "III"|erforderlich
60 60  |kompetenzen|eine "K1" oder mehrere "K4,K5"|erforderlich
56 +|zeit|Bearbeitungszeit in Minuten|erforderlich
61 61  |quelle|Text oder Link, z.B. "Holger Engels" oder "{{{[[serlo.org]]}}}"|erforderlich
62 62  |cc|Creative Commons Lizenzen in der aktuellen Version, z.B. "BY-SA"|cc oder lizenz erforderlich
63 63  |lizenz|z.B. {{{[[CC BY-SA>>https://creativecommons.org/licenses/by-sa/3.0/deed.en]]}}}|cc oder lizenz erforderlich
... ... @@ -64,109 +64,191 @@
64 64  |niveau|"g" oder "e"|optional
65 65  |links|{{{[[kmap.eu]]}}}, {{{[[serlo.org]]}}}|optional
66 66  
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 +
67 67  Die Aufgabenseite wird von der Seitenreflexion abgeschlossen:
68 68  
69 69  {{info}}
70 70  {{{
71 -{{seitenreflexion kompetenzen="3" anforderungsbereiche="1" kriterien="2" menge="1"/}}
69 +{{seitenreflexion bildungsplan="5" kompetenzen="3" anforderungsbereiche="1" kriterien="2" menge="1"/}}
72 72  }}}
73 73  {{/info}}
74 74  
75 75  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.
76 76  
75 +|bildungsplan|Ganze Zahl von 1 .. 5|erforderlich
77 77  |kompetenzen|Ganze Zahl von 1 .. 5|erforderlich
78 78  |anforderungsbereiche|Ganze Zahl von 1 .. 5|erforderlich
79 79  |kriterien|Ganze Zahl von 1 .. 5|erforderlich
80 80  |menge|Ganze Zahl von 1 .. 5|erforderlich
81 81  
82 -
83 83  == Lösungsseite ==
84 84  
85 -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.
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.
86 86  
87 -Der Aufbau einer Lösungsseite ist analog zur Aufgabenseite. Oben das Inhaltsverzeichnis, dann die gleichen Abschnitte:
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.
88 88  
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 +
89 89  {{info}}
90 90  {{{
91 -{{box cssClass="floatinginfobox" title="**Contents**"}}
92 -{{toc start=2 depth=2 /}}
93 -{{/box}}
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*}
94 94  
95 -== Allgemeines ==
96 -
97 -... Lösungen zu Allgemeines ...
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}}
98 98  }}}
99 99  {{/info}}
100 100  
101 -Jede Lösung ist von einem Macro //lösung// umgeben. Das kann z.B. so aussehen:
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.
102 102  
103 -{{info}}
104 -{{{
105 -{{lösung}}
106 -* {{formula}}
107 -\begin{equation*}
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*}
108 108  
109 -f(x) = 0
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}}
110 110  
111 -\Rightarrow \frac12\left(x-1\right)\left(x-3\right)=0
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}##.
112 112  
113 -\Rightarrow x-1=0\vee x-3=0
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.
114 114  
115 -\Rightarrow x_1=1; x_2=3
155 +== Wichtige Formatierungen ==
116 116  
117 -\end{equation*}
118 -{{/formula}}
119 -* {{formula}}
120 -\begin{equation*}
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**
121 121  
122 -g(x) = 0
168 +== Bilder einbinden ==
123 123  
124 -\Rightarrow \frac{1}{2}(x^2-4x+3) = 0
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
125 125  
126 -\Rightarrow x^2-4x+3=0
172 +{{info}}
173 +{{{
174 + [[image:name.png]]
175 +}}}
176 +{{/info}}
127 127  
128 -\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
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.
129 129  
130 -\Rightarrow x_1=1; x_2=3
180 +Je nachdem, von wo das Bild kommt, muss ein Lizenzhinweis dazugeschrieben werden. Dabei kann der [[Lizenhinweisgenerator>>https://lizenzhinweisgenerator.de]] hilfreich sein.
131 131  
132 -\end{equation*}
133 -{{/formula}}
134 -* {{formula}}
135 -\begin{equation*}
182 +== Tabellen ==
136 136  
137 -h(x) = \frac{1}{2} \left(x-2\right)^2-\frac{1}{2}
138 -
139 -\end{equation*}
140 -{{/formula}}
141 -...
142 -{{/lösung}}
184 +{{info}}
185 +{{{
186 +|=Überschriftenzelle|=noch eine
187 +|Normale Zelle|ohne =
143 143  }}}
144 144  {{/info}}
145 145  
146 -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.
191 +|=Überschriftenzelle|=noch eine
192 +|Normale Zelle|ohne =
147 147  
148 -== LaTeX ==
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:
149 149  
150 -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:
196 +{{info}}
197 +{{{
198 +(% class="noborder" %)
199 +|=Überschriftenzelle|=noch eine
200 +|Normale Zelle|ohne =
201 +}}}
202 +{{/info}}
151 151  
204 +(% class="noborder" %)
205 +|=Überschriftenzelle|=noch eine
206 +|Normale Zelle|ohne =
207 +
152 152  {{info}}
153 153  {{{
154 -{{formula}}
155 -\begin{equation*}
210 +(% class="border" %)
211 +|=Überschriftenzelle|=noch eine
212 +|Normale Zelle|ohne =
213 +}}}
214 +{{/info}}
156 156  
157 -g(x) = 0
216 +(% class="border" %)
217 +|=Überschriftenzelle|=noch eine
218 +|Normale Zelle|ohne =
158 158  
159 -\Rightarrow \frac{1}{2}(x^2-4x+3) = 0
220 +{{info}}
221 +{{{
222 +(% class="border slim" %)
223 +|=Überschriftenzelle|=noch eine
224 +|Normale Zelle|ohne =
225 +}}}
226 +{{/info}}
160 160  
161 -\Rightarrow x^2-4x+3=0
228 +(% class="border slim" %)
229 +|=Überschriftenzelle|=noch eine
230 +|Normale Zelle|ohne =
162 162  
163 -\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
232 +**Beachte:** ##slim## ist kombinierbar mit ##border## und ##noborder##
164 164  
165 -\Rightarrow x_1=1; x_2=3
234 +== Listen ==
166 166  
167 -\end{equation*}
168 -{{/formula}}
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
169 169  }}}
170 170  {{/info}}
171 171  
172 -Die Leerzeilen sind entscheidend!
247 +(% class="abc" %)
248 +1. Unteraufgabe eins
249 +1. Unteraufgabe zwei
250 +1. Unteraufgabe drei
XWiki.XWikiComments[0]
Datum
... ... @@ -1,0 +1,1 @@
1 +2023-10-25 18:08:43.4
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!
XWiki.XWikiComments[1]
Datum
... ... @@ -1,0 +1,1 @@
1 +2024-07-11 13:36:25.122
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.