Änderungen von Dokument Anleitung

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

Von Version 29.1
bearbeitet von VBS
am 2023/10/13 14:27
Ä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.vbs
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,114 +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 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 -|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
55 +Optional kann auf weiterführendes Material zum Thema verlinkt werden:
77 77  
78 -== Lösungsseite ==
57 +{{info}}
58 +{{{
59 +{{tags afb="I" kompetenzen="K6" quelle="KMap" lizenz="CC BY-SA"}}[[KMap Termbaum>>https://kmap.eu/app/browser/Mathematik/Tools/Termbaum]]{{/tags}}
60 +}}}
61 +{{/info}}
79 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.
63 +Hier hat das Macro einen Inhalt. Der / befindet sich jetzt am schliessenden Tag vorne!
81 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.
65 +Eine vollsndige Aufgabe sieht dann beispielsweise folgendermen aus:
83 83  
84 -(% style="list-style: alphastyle" %)
85 -1. {{formula}}\begin{equation*}
86 -f(x) = 0
67 +{{info}}
68 +{{{
69 +{{aufgabe ref="AllgemeinesA1"}}Aufgabe 1{{/aufgabe}}
87 87  
88 -\Rightarrow \frac12\left(x-1\right)\left(x-3\right)=0
71 +Entscheide, ob es sich um eine Summe, ein Produkt oder eine Potenz handelt und begründe Deine Wahl!
89 89  
90 -\Rightarrow x-1=0\vee x-3=0
73 +a) {{formula}} 2 \cdot a + 3 {{/formula}}
91 91  
92 -\Rightarrow x_1=1; x_2=3
93 -\end{equation*}{{/formula}}
94 -1. {{formula}}\begin{equation*}
95 -g(x) = 0
75 +b) {{formula}} 2 \cdot (a + 3) {{/formula}}
96 96  
97 -\Rightarrow \frac{1}{2}(x^2-4x+3) = 0
77 +c) {{formula}} 2 \cdot a^3 {{/formula}}
98 98  
99 -\Rightarrow x^2-4x+3=0
79 +d) {{formula}} 2^{(a + 3)} {{/formula}}
100 100  
101 -\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
81 +{{tags afb="I" kompetenzen="K6" quelle="KMap" lizenz="CC BY-SA"}}[[KMap Termbaum>>https://kmap.eu/app/browser/Mathematik/Tools/Termbaum]]{{/tags}}
82 +}}}
83 +{{/info}}
102 102  
103 -\Rightarrow x_1=1; x_2=3
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}}
108 -...
85 +== Lösungsseite ==
109 109  
110 -== LaTeX ==
87 +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.
111 111  
112 -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:
89 +Der Aufbau einer Lösungsseite ist analog zur Aufgabenseite. Oben das Inhaltsverzeichnis, dann die gleichen Abschnitte, dann jeweils eine Lösung, angehrt vom Macro //lösung//. Beispiel:
113 113  
114 114  {{info}}
115 115  {{{
116 -{{formula}}
117 -\begin{equation*}
93 +{{box cssClass="floatinginfobox" title="**Contents**"}}
94 +{{toc start=2 depth=2 /}}
95 +{{/box}}
118 118  
119 -g(x) = 0
97 +== Allgemeines ==
120 120  
121 -\Rightarrow \frac{1}{2}(x^2-4x+3) = 0
99 +{{lösung id="AllgemeinesA1"}}Aufgabe 1{{/lösung}}
122 122  
123 -\Rightarrow x^2-4x+3=0
101 +Handelt es sich um eine Summe, ein Produkt oder eine Potenz?
124 124  
125 -\Rightarrow x_{1,2}=\frac{4\pm\sqrt{4^2-4\cdot3}}{2}=\frac{4\pm2}{2}
103 +a) Es handelt sich um eine Summe. Das · bindet stärker als das +. Siehe Termbaum!
104 +[[image:Allgemeines 1a Summe.png]]
126 126  
127 -\Rightarrow x_1=1; x_2=3
128 -
129 -\end{equation*}
130 -{{/formula}}
131 131  }}}
132 132  {{/info}}
133 133  
134 -Die Leerzeilen sind entscheidend!
109 +Die //id// der Lösung muss jeweils mit dem //ref// der Aufgabe übereinstimmen!
135 135  
136 -== Bilder einbinden ==
111 +== LaTeX ==
137 137  
138 -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
139 -
140 -{{info}}
141 -{{{
142 - [[image:name.png]]
143 -}}}
144 -{{/info}}
145 -
146 -einbinden.
113 +[[Formeln testen>>https://katex.org/]]