Änderungen von Dokument Anleitung

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

Von Version 19.2
bearbeitet von VBS
am 2023/09/11 12:27
Änderungskommentar: Update document after refactoring.
Auf Version 30.1
bearbeitet von VBS
am 2023/10/13 14:34
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,22 +1,21 @@
1 -{{box cssClass="floatinginfobox" title="**Contents**"}}
2 -{{toc start=2 depth=2 /}}
3 -{{/box}}
1 +{{seiteninhalt/}}
4 4  
5 5  [[XWikiSyntax>>https://mathe-arbeitsheft.zsl-bw.de/xwiki/bin/view/XWiki/XWikiSyntax?syntax=2.1&category=1]]
6 6  
7 7  == Aufgabenseite ==
8 8  
9 -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:
10 10  
11 11  {{info}}
12 12  {{{
13 -{{box cssClass="floatinginfobox" title="**Contents**"}}
14 -{{toc start=2 depth=2 /}}
15 -{{/box}}
11 +{{seiteninhalt/}}
12 +
13 +[[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
14 +[[Kompetenzen.K1]] [[Kompetenzen.K4]] Ich kann ...
16 16  }}}
17 17  {{/info}}
18 18  
19 -Eine Aufgabenseite ist in Abschnitte unterteilt. Die Abschnitte werden von Überschriften der Ebene 2 angeführt. Beispielsweise ..
18 +Eine Aufgabenseite kann in Abschnitte unterteilt sein. Die Abschnitte werden von Überschriften der Ebene 2 angeführt. Beispielsweise ..
20 20  
21 21  {{info}}
22 22  {{{
... ... @@ -38,21 +38,23 @@
38 38  
39 39  {{info}}
40 40  {{{
41 -{{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"}}
42 42  Berechne jeweils die Nullstellen!
43 -
42 +
44 44  * {{formula}}f(x) = \frac{1}{2}(x-1)(x-3){{/formula}}
45 45  * {{formula}}g(x) = \frac{1}{2}(x^2-4x+3){{/formula}}
46 46  * {{formula}}h(x) = \frac{1}{2}(x-2)^2-\frac{1}{2}{{/formula}}
47 -
46 +
48 48  {{/aufgabe}}
49 - }}}
48 +}}}
50 50  {{/info}}
51 51  
52 52  Folgende Parameter werden unterstützt:
53 53  
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
56 56  |quelle|Text oder Link, z.B. "Holger Engels" oder "{{{[[serlo.org]]}}}"|erforderlich
57 57  |cc|Creative Commons Lizenzen in der aktuellen Version, z.B. "BY-SA"|cc oder lizenz erforderlich
58 58  |lizenz|z.B. {{{[[CC BY-SA>>https://creativecommons.org/licenses/by-sa/3.0/deed.en]]}}}|cc oder lizenz erforderlich
... ... @@ -59,32 +59,29 @@
59 59  |niveau|"g" oder "e"|optional
60 60  |links|{{{[[kmap.eu]]}}}, {{{[[serlo.org]]}}}|optional
61 61  
62 -== Lösungsseite ==
63 +Die Aufgabenseite wird von der Seitenreflexion abgeschlossen:
63 63  
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.
65 -
66 -Der Aufbau einer Lösungsseite ist analog zur Aufgabenseite. Oben das Inhaltsverzeichnis, dann die gleichen Abschnitte:
67 -
68 68  {{info}}
69 69  {{{
70 -{{box cssClass="floatinginfobox" title="**Contents**"}}
71 -{{toc start=2 depth=2 /}}
72 -{{/box}}
73 -
74 -== Allgemeines ==
75 -
76 -... Lösungen zu Allgemeines ...
67 +{{seitenreflexion kompetenzen="3" anforderungsbereiche="1" kriterien="2" menge="1"/}}
77 77  }}}
78 78  {{/info}}
79 79  
80 -Jede Lösung ist von einem Macro //lösung// umgeben. Das kann z.B. so aussehen:
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.
81 81  
82 -{{info}}
83 -{{{
84 -{{lösung}}
85 -* {{formula}}
86 -\begin{equation*}
73 +|kompetenzen|Ganze Zahl von 1 .. 5|erforderlich
74 +|anforderungsbereiche|Ganze Zahl von 1 .. 5|erforderlich
75 +|kriterien|Ganze Zahl von 1 .. 5|erforderlich
76 +|menge|Ganze Zahl von 1 .. 5|erforderlich
87 87  
78 +== Lösungsseite ==
79 +
80 +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.
81 +
82 +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.
83 +
84 +(% style="list-style: alphastyle" %)
85 +1. {{formula}}\begin{equation*}
88 88  f(x) = 0
89 89  
90 90  \Rightarrow \frac12\left(x-1\right)\left(x-3\right)=0
... ... @@ -92,12 +92,8 @@
92 92  \Rightarrow x-1=0\vee x-3=0
93 93  
94 94  \Rightarrow x_1=1; x_2=3
95 -
96 -\end{equation*}
97 -{{/formula}}
98 -* {{formula}}
99 -\begin{equation*}
100 -
93 +\end{equation*}{{/formula}}
94 +1. {{formula}}\begin{equation*}
101 101  g(x) = 0
102 102  
103 103  \Rightarrow \frac{1}{2}(x^2-4x+3) = 0
... ... @@ -107,23 +107,12 @@
107 107  \Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
108 108  
109 109  \Rightarrow x_1=1; x_2=3
110 -
111 -\end{equation*}
112 -{{/formula}}
113 -* {{formula}}
114 -\begin{equation*}
115 -
116 -h(x) = \frac{1}{2} \left(x-2\right)^2-\frac{1}{2}
117 -
118 -\end{equation*}
119 -{{/formula}}
104 +\end{equation*}{{/formula}}
105 +1. {{formula}}\begin{equation*}
106 +h(x) = \frac{1}{2} \cdot \left(x-2\right)^2 - \frac{1}{2}
107 +\end{equation*}{{/formula}}
120 120  ...
121 -{{/lösung}}
122 -}}}
123 -{{/info}}
124 124  
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.
126 -
127 127  == LaTeX ==
128 128  
129 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:
... ... @@ -132,20 +132,36 @@
132 132  {{{
133 133  {{formula}}
134 134  \begin{equation*}
135 -
136 136  g(x) = 0
137 -
138 138  \Rightarrow \frac{1}{2}(x^2-4x+3) = 0
139 -
140 140  \Rightarrow x^2-4x+3=0
141 -
142 142  \Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
143 -
144 144  \Rightarrow x_1=1; x_2=3
145 -
146 146  \end{equation*}
147 147  {{/formula}}
148 148  }}}
149 149  {{/info}}
150 150  
151 -Die Leerzeilen sind entscheidend!
128 +== Wichtige Formatierungen ==
129 +
130 +|{{{(% style="list-style: alphastyle" %)
131 +1. Punkt eins
132 +1. Punkt zwei
133 +}}}|(((
134 +(% style="list-style: alphastyle" %)
135 +1. Punkt eins
136 +1. Punkt zwei
137 +)))
138 +|{{{//f//}}}| //f//
139 +
140 +== Bilder einbinden ==
141 +
142 +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
143 +
144 +{{info}}
145 +{{{
146 + [[image:name.png]]
147 +}}}
148 +{{/info}}
149 +
150 +einbinden.