Änderungen von Dokument Anleitung

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

Von Version 1.1
bearbeitet von VBS
am 2022/10/28 12:33
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 19.2
bearbeitet von VBS
am 2023/09/11 12:27
Änderungskommentar: Update document after refactoring.

Zusammenfassung

Details

Seiteneigenschaften
Übergeordnete Seite
... ... @@ -1,1 +1,1 @@
1 -Main.WebHome
1 +Dokumentation.WebHome
Inhalt
... ... @@ -2,6 +2,10 @@
2 2  {{toc start=2 depth=2 /}}
3 3  {{/box}}
4 4  
5 +[[XWikiSyntax>>https://mathe-arbeitsheft.zsl-bw.de/xwiki/bin/view/XWiki/XWikiSyntax?syntax=2.1&category=1]]
6 +
7 +== Aufgabenseite ==
8 +
5 5  Auf jeder Seite sollte ganz oben das Inhaltsverzeichnis eingebunden werden. Das leistet folgender Code:
6 6  
7 7  {{info}}
... ... @@ -18,7 +18,7 @@
18 18  {{{
19 19  == Allgemeines ==
20 20  ... Aufgaben zu Allgemeines ...
21 -
25 +
22 22  == Potenzen ==
23 23  ... Aufgaben zu Potenzen ...
24 24  
... ... @@ -30,55 +30,118 @@
30 30  }}}
31 31  {{/info}}
32 32  
33 -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 +Jede Aufgabe ist von einem Macro //aufgabe// umgeben. Das kann z.B. so aussehen:
34 34  
35 35  {{info}}
36 36  {{{
37 -{{aufgabe ref="AllgemeinesA1"}}Aufgabe 1{{/aufgabe}}
38 -}}}
41 +{{aufgabe afb="I" kompetenzen="K5,K6" quelle="Martina Wagner" cc="BY-SA" niveau="e"}}
42 +Berechne jeweils die Nullstellen!
43 +
44 +* {{formula}}f(x) = \frac{1}{2}(x-1)(x-3){{/formula}}
45 +* {{formula}}g(x) = \frac{1}{2}(x^2-4x+3){{/formula}}
46 +* {{formula}}h(x) = \frac{1}{2}(x-2)^2-\frac{1}{2}{{/formula}}
47 +
48 +{{/aufgabe}}
49 + }}}
39 39  {{/info}}
40 40  
41 -"AllgemeinesA1" ist die ID, unter der die Lösung auf dersungsseite zu finden ist.
52 +Folgende Parameter werden unterstützt:
42 42  
43 -Unter jeder Aufgabe wird eine Tabelle mit Metainformationen dargestellt.
54 +|afb|entweder "I" oder "II" oder "III"|erforderlich
55 +|kompetenzen|eine "K1" oder mehrere "K4,K5"|erforderlich
56 +|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
59 +|niveau|"g" oder "e"|optional
60 +|links|{{{[[kmap.eu]]}}}, {{{[[serlo.org]]}}}|optional
44 44  
62 +== Lösungsseite ==
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 +
45 45  {{info}}
46 46  {{{
47 -{{tags afb="I" kompetenzen="K6" quelle="KMap" lizenz="CC BY-SA"/}}
70 +{{box cssClass="floatinginfobox" title="**Contents**"}}
71 +{{toc start=2 depth=2 /}}
72 +{{/box}}
73 +
74 +== Allgemeines ==
75 +
76 +... Lösungen zu Allgemeines ...
48 48  }}}
49 49  {{/info}}
50 50  
51 -Beachte den / vor den schließenden geschweiften Klammern!
80 +Jede Lösung ist von einem Macro //lösung// umgeben. Das kann z.B. so aussehen:
52 52  
53 -Optional kann auf weiterführendes Material zum Thema verlinkt werden:
54 -
55 55  {{info}}
56 56  {{{
57 -{{tags afb="I" kompetenzen="K6" quelle="KMap" lizenz="CC BY-SA"}}[[KMap Termbaum>>https://kmap.eu/app/browser/Mathematik/Tools/Termbaum]]{{/tags}}
84 +{{lösung}}
85 +* {{formula}}
86 +\begin{equation*}
87 +
88 +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
95 +
96 +\end{equation*}
97 +{{/formula}}
98 +* {{formula}}
99 +\begin{equation*}
100 +
101 +g(x) = 0
102 +
103 +\Rightarrow \frac{1}{2}(x^2-4x+3) = 0
104 +
105 +\Rightarrow x^2-4x+3=0
106 +
107 +\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
108 +
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}}
120 +...
121 +{{/lösung}}
58 58  }}}
59 59  {{/info}}
60 60  
61 -Hier hat das Macro einen Inhalt. Der / befindet sich jetzt am schliessenden Tag vorne!
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 einesung geben. Denn nur dann funktionieren die Links von //Aufgabe X// zur //Lösung X// korrekt.
62 62  
63 -Eine vollständige Aufgabe sieht dann beispielsweise folgendermaßen aus:
127 +== LaTeX ==
64 64  
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:
130 +
65 65  {{info}}
66 66  {{{
67 -{{aufgabe ref="AllgemeinesA1"}}
68 -Aufgabe 1
69 -{{/aufgabe}}
133 +{{formula}}
134 +\begin{equation*}
70 70  
71 -Entscheide, ob es sich um eine Summe, ein Produkt oder eine Potenz handelt und begründe Deine Wahl!
136 +g(x) = 0
72 72  
73 -a) {{formula}} 2 \cdot a + 3 {{/formula}}
138 +\Rightarrow \frac{1}{2}(x^2-4x+3) = 0
74 74  
75 -b) {{formula}} 2 \cdot (a + 3) {{/formula}}
140 +\Rightarrow x^2-4x+3=0
76 76  
77 -c) {{formula}} 2 \cdot a^3 {{/formula}}
142 +\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
78 78  
79 -d) {{formula}} 2^{(a + 3)} {{/formula}}
144 +\Rightarrow x_1=1; x_2=3
80 80  
81 -{{tags afb="I" kompetenzen="K6" quelle="KMap" lizenz="CC BY-SA"}}[[KMap Termbaum>>https://kmap.eu/app/browser/Mathematik/Tools/Termbaum]]{{/tags}}
146 +\end{equation*}
147 +{{/formula}}
82 82  }}}
83 83  {{/info}}
84 84  
151 +Die Leerzeilen sind entscheidend!