Änderungen von Dokument Anleitung

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

Von Version 45.1
bearbeitet von Holger Engels
am 2024/02/08 14:47
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 6.2
bearbeitet von holger
am 2023/05/10 12:55
Änderungskommentar: Update document after refactoring.

Zusammenfassung

Details

Seiteneigenschaften
Übergeordnete Seite
... ... @@ -1,1 +1,1 @@
1 -Dokumentation.WebHome
1 +Hilfe.WebHome
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.holgerengels
1 +XWiki.holger
Inhalt
... ... @@ -1,21 +1,20 @@
1 -{{seiteninhalt/}}
1 +{{box cssClass="floatinginfobox" title="**Contents**"}}
2 +{{toc start=2 depth=2 /}}
3 +{{/box}}
2 2  
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 -Eine Aufgabenseite beginnt mit dem Inhaltsverzeichnis, gefolgt von den Kompetenzen. Das leistet folgender Code:
7 +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 ...
11 +{{box cssClass="floatinginfobox" title="**Contents**"}}
12 +{{toc start=2 depth=2 /}}
13 +{{/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 ..
17 +Eine Aufgabenseite ist in Abschnitte unterteilt. Die Abschnitte werden von Überschriften der Ebene 2 angeführt. Beispielsweise ..
19 19  
20 20  {{info}}
21 21  {{{
... ... @@ -33,196 +33,82 @@
33 33  }}}
34 34  {{/info}}
35 35  
36 -Jede Aufgabe ist von einem Macro //aufgabe// umgeben. Das kann z.B. so aussehen:
35 +Jede Aufgabe wird von einer Überschrift der Ebene 3 angeführt. Das muss mit dem Macro //aufgabe// gemacht werden, damit direkt zur sung verlinkt werden kann:
37 37  
38 38  {{info}}
39 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}}
39 +{{aufgabe ref="AllgemeinesA1"}}Aufgabe 1{{/aufgabe}}
48 48  }}}
49 49  {{/info}}
50 50  
51 -Folgende Parameter werden unterstützt:
43 +"AllgemeinesA1" ist die ID, unter der die Lösung auf dersungsseite zu finden ist.
52 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
45 +Unter jeder Aufgabe wird eine Tabelle mit Metainformationen dargestellt.
62 62  
63 -Die Aufgabenseite wird von der Seitenreflexion abgeschlossen:
64 -
65 65  {{info}}
66 66  {{{
67 -{{seitenreflexion bikdungsplan="5" kompetenzen="3" anforderungsbereiche="1" kriterien="2" menge="1"/}}
49 +{{tags afb="I" kompetenzen="K6" quelle="KMap" lizenz="CC BY-SA"/}}
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.
53 +Beachte den / vor den schließenden geschweiften Klammern!
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
55 +Optional kann auf weiterführendes Material zum Thema verlinkt werden:
78 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 117  {{info}}
118 118  {{{
119 -{{formula}}
120 -\begin{align*}
121 -& g(x) & =\: & 0\\
122 -\Rightarrow\: & \frac{1}{2}(x^2-4x+3) & =\: & 0\\
123 -\Rightarrow\: & x^2-4x+3 & =\: & 0\\
124 -\end{align*}
125 -
126 -\begin{align*}
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{align*}
130 -{{/formula}}
59 +{{tags afb="I" kompetenzen="K6" quelle="KMap" lizenz="CC BY-SA"}}[[KMap Termbaum>>https://kmap.eu/app/browser/Mathematik/Tools/Termbaum]]{{/tags}}
131 131  }}}
132 132  {{/info}}
133 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.
63 +Hier hat das Macro einen Inhalt. Der / befindet sich jetzt am schliessenden Tag vorne!
135 135  
136 -{{formula}}
137 -\begin{align*}
138 -& g(x) & =\: & 0\\
139 -\Rightarrow\: & \frac{1}{2}(x^2-4x+3) & =\: & 0\\
140 -\Rightarrow\: & x^2-4x+3 & =\: & 0\\
141 -\end{align*}
65 +Eine vollständige Aufgabe sieht dann beispielsweise folgendermaßen aus:
142 142  
143 -\begin{align*}
144 -&\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}\\
145 -&\Rightarrow x_1=1;\: x_2=13
146 -\end{align*}
147 -{{/formula}}
67 +{{info}}
68 +{{{
69 +{{aufgabe ref="AllgemeinesA1"}}Aufgabe 1{{/aufgabe}}
148 148  
149 -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.
71 +Entscheide, ob es sich um eine Summe, ein Produkt oder eine Potenz handelt und begründe Deine Wahl!
150 150  
151 -== Wichtige Formatierungen ==
73 +a) {{formula}} 2 \cdot a + 3 {{/formula}}
152 152  
153 -|{{{(% style="list-style: alphastyle" %)
154 -1. Punkt eins
155 -1. Punkt zwei
156 -}}}|(((
157 -(% style="list-style: alphastyle" %)
158 -1. Punkt eins
159 -1. Punkt zwei
160 -)))
161 -|kursiv {{{//f//}}}| //f//
162 -|fett {{{**L**}}}| **L**
75 +b) {{formula}} 2 \cdot (a + 3) {{/formula}}
163 163  
164 -== Bilder einbinden ==
77 +c) {{formula}} 2 \cdot a^3 {{/formula}}
165 165  
166 -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
79 +d) {{formula}} 2^{(a + 3)} {{/formula}}
167 167  
168 -{{info}}
169 -{{{
170 - [[image:name.png]]
81 +{{tags afb="I" kompetenzen="K6" quelle="KMap" lizenz="CC BY-SA"}}[[KMap Termbaum>>https://kmap.eu/app/browser/Mathematik/Tools/Termbaum]]{{/tags}}
171 171  }}}
172 172  {{/info}}
173 173  
174 -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"}}} wir das Bild am rechten Rand positioniert und auf der linken Seite von Text umflossen.
85 +== Lösungsseite ==
175 175  
176 -Je nachdem, von wo das Bild kommt, muss ein Lizenzhinweis dazugeschrieben werden. Dabei kann der [[Lizenhinweisgenerator>>https://lizenzhinweisgenerator.de]] hilfreich sein.
87 +Eine 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.
177 177  
178 -== Tabellen ==
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:
179 179  
180 180  {{info}}
181 181  {{{
182 -|=Überschriftenzelle|=noch eine
183 -|Normale Zelle|ohne =
184 -}}}
185 -{{/info}}
93 +{{box cssClass="floatinginfobox" title="**Contents**"}}
94 +{{toc start=2 depth=2 /}}
95 +{{/box}}
186 186  
187 -|=Überschriftenzelle|=noch eine
188 -|Normale Zelle|ohne =
97 +== Allgemeines ==
189 189  
190 -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:
99 +{{lösung id="AllgemeinesA1"}}Aufgabe 1{{/lösung}}
191 191  
192 -{{info}}
193 -{{{
194 -(% class="noborder" %)
195 -|=Überschriftenzelle|=noch eine
196 -|Normale Zelle|ohne =
197 -}}}
198 -{{/info}}
101 +Handelt es sich um eine Summe, ein Produkt oder eine Potenz?
199 199  
200 -(% class="noborder" %)
201 -|=Überschriftenzelle|=noch eine
202 -|Normale Zelle|ohne =
103 +a) Es handelt sich um eine Summe. Das · bindet stärker als das +. Siehe Termbaum!
104 +[[image:Allgemeines 1a Summe.png]]
203 203  
204 -{{info}}
205 -{{{
206 -(% class="border" %)
207 -|=Überschriftenzelle|=noch eine
208 -|Normale Zelle|ohne =
209 209  }}}
210 210  {{/info}}
211 211  
212 -(% class="border" %)
213 -|=Überschriftenzelle|=noch eine
214 -|Normale Zelle|ohne =
109 +Die //id// der Lösung muss jeweils mit dem //ref// der Aufgabe übereinstimmen!
215 215  
216 -{{info}}
217 -{{{
218 -(% class="border slim" %)
219 -|=Überschriftenzelle|=noch eine
220 -|Normale Zelle|ohne =
221 -}}}
222 -{{/info}}
111 +== LaTeX ==
223 223  
224 -(% class="border slim" %)
225 -|=Überschriftenzelle|=noch eine
226 -|Normale Zelle|ohne =
227 -
228 -**Beachte:** ##slim## ist kombinierbar mit ##border## und ##noborder##
113 +[[Formeln testen>>https://katex.org/]]
XWiki.XWikiComments[0]
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!
Datum
... ... @@ -1,1 +1,0 @@
1 -2023-10-25 18:08:43.4