Wiki-Quellcode von Medien einbinden

Version 291.1 von Carina Enke am 19.05.2020

Verstecke letzte Bearbeiter
Carina Enke 177.1 1 {{sv-translation language="de"}}
2 {{layout}}
3 {{layout-section ac:type="single"}}
4 {{layout-cell}}
5 \\
Carina Enke 237.1 6
Carina Enke 291.1 7 {{details}}(% class="wrapped" %)
8 |=(((
9 Verantwortlicher
10 )))|(((
11 \\
12 )))
13 |=(% colspan="1" %)(% colspan="1" %)
14 (((
15 Status
16 )))|(% class="highlight-yellow" colspan="1" data-highlight-colour="yellow" %)(% class="highlight-yellow" colspan="1" data-highlight-colour="yellow" %)
17 (((
18 (% class="content-wrapper" %)
19 (((
20 {{sv-metadata type="workflow-status"/}}
Carina Enke 239.1 21
Carina Enke 291.1 22 {{status colour="Green" title="Fertig"/}}
23 )))
24 )))
25 |=(% colspan="1" %)(% colspan="1" %)
26 (((
27 Varianten
28 )))|(% colspan="1" %)(% colspan="1" %)
29 (((
30 (% class="content-wrapper" %)
31 (((
32 {{sv-metadata type="variants"/}}
33 )))
34 )))
35 |=(% colspan="1" %)(% colspan="1" %)
36 (((
37 Attribute
38 )))|(% colspan="1" %)(% colspan="1" %)
39 (((
40 (% class="content-wrapper" %)
41 (((
42 {{sv-metadata type="attributes"/}}
43 )))
44 )))
45 |=(% colspan="1" %)(% colspan="1" %)
46 (((
47 Pagekey
48 )))|(% colspan="1" %)(% colspan="1" %)
49 (((
50 (% class="content-wrapper" %)
51 (((
52 {{sv-metadata type="pagekey"/}}
53 )))
54 )))
55 |=(% colspan="1" %)(% colspan="1" %)
56 (((
57 Übersetzung
58 )))|(% colspan="1" %)(% colspan="1" %)
59 (((
60 (% class="content-wrapper" %)
61 (((
62 Integrating Media 
63
64 {{status colour="Green" title="fertig"/}}
65 )))
66 )))
67 |=(% colspan="1" %)(% colspan="1" %)
68 (((
69 TODOs
70 )))|(% colspan="1" %)(% colspan="1" %)
71 (((
72 (% class="content-wrapper" %)
73 (((
74 (% class="task-list" %)
75 (((
76 {{task reference="/Tasks/Task_2" status="Done"}}
77 carina: MARKETING-143 Versionstypen angepasst
78 {{/task}}
79
80 {{task reference="/Tasks/Task_3" status="Done"}}
81 carina: Flash aus Abschnit Audio entfernt (vgl. ONYX-2930)
82 {{/task}}
83
84 {{task reference="/Tasks/Task_7" status="Done"}}
85 carina: Bilder aufgeräumt Teil1\\
86 {{/task}}
87
88 {{task reference="/Tasks/Task_8" status="Done"}}
89 {{mention reference="XWiki.carina" style="FULL_NAME" anchor="XWiki-carina-hiJio"/}} : Bilder aufgeräumt Teil2: Icons neu verlinken und dann löschen
90
91 {{/task}}
92 )))
93 )))
94 ))){{/details}} \\
95
Carina Enke 237.1 96 \\
Carina Enke 177.1 97 {{/layout-cell}}
98 {{/layout-section}}
99
100 {{layout-section ac:type="two_right_sidebar"}}
101 {{layout-cell}}
102 Die ONYX Testsuite bietet eine umfangreiche Medienunterstützung. Darüber hinaus können alle Aufgabeninhalte HTML-formatiert werden (IMS QTI bietet nur ein eingeschränktes HTML-Subset). Folgender Überblick zeigt, welche Medien und Formate unterstützt werden.
103 {{/layout-cell}}
104
105 {{layout-cell}}
106 {{scroll-ignore}}
107 {{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Inhalt"}}
108
109
110 {{toc/}}
111 {{/panel}}
112 {{/scroll-ignore}}
113 {{/layout-cell}}
114 {{/layout-section}}
115
116 {{layout-section ac:type="single"}}
117 {{layout-cell}}
118 == HTML-Editor ==
119
120 Der ONYX Editor bietet für alle Autoreneingaben einen WYSIWYG HTML-Editor. Hierfür wird die etablierte Systemkomponente [[TinyMCE>>url:https://www.tinymce.com/||shape="rect"]] genutzt. Über den integrierten Editor können Einstellungen zur Schriftart, Schriftgröße und sonstigen Test- und Schriftgestaltung vorgenommen werden. Inhalte in der Aufgabenstellung, den Antwortalternativen oder im Feedback können somit beispielsweise fett oder kursiv gestaltet, in Tabellen angeordnet oder in einer Liste formatiert werden.
121
122 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size confluence-embedded-file-wrapper confluence-embedded-manual-size" %)[[image:attach:Editor - Aufgabe editieren_de.png]]
123
124 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size confluence-embedded-file-wrapper confluence-embedded-manual-size" %)Mit [[image:attach:Onyx Icons und Buttons@Icon_HTML Ansicht öffnen.png]] ist es weiterhin möglich, die Inhalte direkt in einer HTML-Ansicht zu bearbeiten, um weitere Auszeichnungen zu nutzen.
125
126
127 == Grafiken und Bilder ==
128
129 Es werden alle gängigen Bild-Formate (JPEG / JPG, GIF, PNG) und Vektorgrafiken (SVG) unterstützt.
130
131 [[image:attach:Testansicht - Bilder in einer Aufgabe_de.png]]
132
Carina Enke 267.1 133 Bilder können Sie im HTML-Editor über die Funktion [[image:attach:Onyx Icons und Buttons@Icon_Bilder einfügen.png]] (Bild einfügen/bearbeiten) hinzufügen. Es öffnet sich der "Bild bearbeiten" Dialog. Hier kann eine Bildressource ausgewählt und notwendige Einstellungen zur Anzeige der gewählten Ressource getroffen werden.
Carina Enke 177.1 134
135 [[image:attach:Editor - Dialog Bild einfügen_de.png]]
136
Carina Enke 267.1 137 Wählen Sie [[image:attach:Onyx Icons und Buttons@Icon_Durchsuchen.png]], um ein Bild aus der Dateiablage des Tests auszuwählen oder neu hochzuladen. Bilder können hinsichtlich der Größe durch Angabe der Dimension (Breite / Höhe) einfach angepasst werden. Geben Sie einen Alternativtext ein, welcher angezeigt wird, wenn das Bild nicht geladen werden kann oder soll. Der Alternativtext ist ein wichtiges Kriterium für barrierefreie Inhalte.
Carina Enke 177.1 138
Carina Enke 267.1 139 Bestätigen Sie die Eingaben mit "OK". Die Bilder werden nach dem erfolgreichen Einfügen direkt im HTML Editor und ebenso in der Vorschau angezeigt.
Carina Enke 177.1 140
141 == Audio ==
142
Carina Enke 239.1 143 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size confluence-embedded-file-wrapper confluence-embedded-manual-size" %)Audios können Sie im HTML Editor über die Funkion [[image:attach:Onyx Icons und Buttons@Icon_Audio einfügen.png]](Audio einfügen) hinzufügen. Sie können wählen, wie die Audios in Ihren Testinhalt integriert werden sollen.(% class="confluence-embedded-file-wrapper confluence-embedded-manual-size" %) (%%)Im Dialog "Audio-Datei einfügen" wählen Sie mit dem Button "Durchsuchen" und anschließend der Funktion "Hochladen" die gewünschte Audio-Datei aus. Haben Sie die Audio-Datei hinzugefügt, können Sie im Dialog wählen wie die Audio-Dateien in Ihren Testinhalt integriert werden sollen.
Carina Enke 177.1 144
145 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size confluence-embedded-file-wrapper confluence-embedded-manual-size" %)Die ONYX Testsuite basiert vollständig auf **HTML5**. Eine Integration der Audios ist daher über das HTML5 Audio-Tag und mit der entsprechenden Browserunterstützung möglich. Die meisten modernen Browser (Firefox, Chrome) unterstützen die gängigsten Audio-Formate (MP3, Ogg, Wav). Informationen zur Browserunterstützung bieten beispielsweise Untersuchungen von [[W3Schools>>url:http://www.w3schools.com/html/html5_audio.asp||rel="nofollow" shape="rect" class="external-link"]].
146
Carina Enke 239.1 147 \\
148
Carina Enke 177.1 149 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size confluence-embedded-file-wrapper confluence-embedded-manual-size" %)[[image:attach:Testansicht - Aufgabe mit Audio.png]]
150
Carina Enke 229.1 151 == Video/Flash ==
Carina Enke 177.1 152
153 Videos können integriert oder als Referenz eingebunden werden.
154
Carina Enke 239.1 155 Aus Performancegründen, wird insbesondere für große Testszenarien die direkte Integration von Videos nicht empfohlen. Referenzieren Sie Videos von einem öffentlichen oder privaten Video-Streaming-System (bspw. YouTube, Magma).
Carina Enke 177.1 156
157 ==== Referenzieren von Videos mit YouTube ====
158
159 YouTube bietet eine einfache Funktion zum Einbetten von Videos in andere Webseiten. Diese Einbetten-Funktion kann auch für die Video-Integration in ONYX genutzt werden.
160
161 [[image:attach:Youtube - Video einbetten_de.png]]
162
Carina Enke 239.1 163 Videos können in alle Test- und Aufgabenbestandteile (bspw. Aufgabenstellung, Antwortelemente, Feedback) integriert werden. Um ein Video zu integrieren, kopieren Sie den angezeigten iFrame-Link in Ihren Testinhalt. Wechseln Sie im ONYX Editor mit [[image:attach:Onyx Icons und Buttons@Icon_HTML Ansicht öffnen.png]] in die Quellcode-Ansicht bspw. die Aufgabenstellung und fügen Sie den iFrame-Link aus dem Zwischenspeicher ein.
Carina Enke 177.1 164
165 [[image:attach:Editor - Quellcodeansicht der Aufgabe öffnen_de.png]]
166
167 [[image:attach:Editor - Beispielquellcode einer Aufgabe.png]]
168
169 Mit Bestätigung durch OK wird das Quellcode-Fenster geschlossen und das Video in den Inhalt integriert.
170
171 [[image:attach:Editor - Aufgabenstellung mit eingebettetem Video.png]]
172
173 Über die Vorschau-Funktion können Sie den Inhalt ausprobieren.
174
175 [[image:attach:Testvorschau - Beispielaufgabe mit eingebettetem Video.png]]
176 {{/layout-cell}}
177 {{/layout-section}}
178 {{/layout}}
179 {{/sv-translation}}
180
181 {{sv-translation language="en"}}
182 {{layout}}
183 {{layout-section ac:type="two_right_sidebar"}}
184 {{layout-cell}}
Carina Enke 239.1 185 The ONYX Testsuite provides extensive media support. In addition, all task content can be formatted in HTML (IMS QTI offers only a restricted HTML subset). The following overview shows which media and formats are supported.
Carina Enke 177.1 186 {{/layout-cell}}
187
188 {{layout-cell}}
189 {{scroll-ignore}}
190 {{panel title="Content"}}
191
192
193 {{toc/}}
194 {{/panel}}
195 {{/scroll-ignore}}
196 {{/layout-cell}}
197 {{/layout-section}}
198
199 {{layout-section ac:type="single"}}
200 {{layout-cell}}
201 == HTML editor ==
202
Carina Enke 239.1 203 ONYX Editor provides a WYSIWYG HTML editor for all author inputs, using the established system component [[TinyMCE>>url:https://www.tinymce.com/||shape="rect"]]. The built-in editor allows you to configure settings for font, font size, and other test and font styles. Content in the task text, answer alternatives, or in the feedback can, for example, be highlighted in bold or italics, arranged in tables, or formatted in a list.
Carina Enke 177.1 204
205 [[image:attach:Editor - Aufgabe editieren_de.png]]
206
Carina Enke 239.1 207 With [[image:attach:Onyx Icons und Buttons@Icon_HTML Ansicht öffnen.png]], it is also possible to edit content directly in an HTML view in order to be able to use other markup languages.
Carina Enke 177.1 208
209 == Graphics and images ==
210
211 All common image formats (JPEG / JPG, GIF, PNG) and vector graphics (SVG) are supported.
212
Carina Enke 239.1 213 \\
214
215 (((
Carina Enke 177.1 216 [[image:attach:Testansicht - Bilder in einer Aufgabe_de.png]]
Carina Enke 239.1 217 )))
Carina Enke 177.1 218
219 (((
Carina Enke 239.1 220 You can add images in the HTML editor using the function [[image:attach:Onyx Icons und Buttons@Icon_Bilder einfügen.png]] (insert/edit image). The "Edit image" dialogue opens. In the dialogue, an image resource can be selected and necessary settings for the display of the selected resource can be configured.
Carina Enke 177.1 221
222 [[image:attach:Editor - Dialog Bild einfügen_de.png]]
223
Carina Enke 239.1 224 Click on[[image:attach:Onyx Icons und Buttons@Icon_Durchsuchen.png]] to select or upload an image from the file storage of the test. Images can be easily adjusted in size by specifying the dimensions (width/height). Enter an alternative text to be displayed if the image cannot or should not be loaded. The alternative text is an important criterion for barrier-free content.
Carina Enke 177.1 225
Carina Enke 239.1 226 Confirm your entries with //**OK**//. After successful insertion, the images will be directly displayed in the HTML editor and in the preview.
Carina Enke 177.1 227
228 == Audio ==
229
Carina Enke 239.1 230 Audio can be added in the HTML using the editor function [[image:attach:Onyx Icons und Buttons@Icon_Audio einfügen.png]] (insert audio). You can choose how to integrate the audio into your test content. In the dialogue "Insert audio file", you can select the desired audio file with //**Browse** //and **//Upload//**. Once you add the audio file, you can choose in the dialogue how to integrate the audio files into your test content.
Carina Enke 177.1 231
Carina Enke 239.1 232 The ONYX Testsuite is completely based on **HTML5**. Audio integration is therefore possible via the HTML5 audio tag and with the appropriate browser support. Most modern browsers (Firefox, Chrome) support the most common audio formats (MP3, OGG, WAV). Information about browser support is for example provided by [[W3Schools>>url:https://www.w3schools.com/html/html5_audio.asp||shape="rect"]].
Carina Enke 177.1 233
Carina Enke 239.1 234
Carina Enke 177.1 235 [[image:attach:Testansicht - Aufgabe mit Audio.png]]
236
Carina Enke 227.1 237 == Video/Flash ==
Carina Enke 177.1 238
239 Videos can be integrated or embedded as a reference.
240
Carina Enke 239.1 241 For performance reasons, the direct integration of videos is not recommended, especially for large test scenarios. Instead, we recommend referencing videos from a public or private video streaming system (e.g. YouTube, Magma).
Carina Enke 177.1 242
243 **Referencing videos with YouTube**
244
Carina Enke 239.1 245 YouTube provides a simple function to embed videos in other websites. This embedding function can also be used for the integration of videos into ONYX.
Carina Enke 177.1 246
Carina Enke 239.1 247 \\
248 )))
249
250 (((
Carina Enke 177.1 251 [[image:attach:Youtube - Video einbetten_de.png]]
252 )))
253
254 (((
Carina Enke 239.1 255 Videos can be integrated into all test and task components (e.g. task texts, answer elements, feedback). In order to integrate a video, you need to copy the displayed iframe link to your test content. In the ONYX Editor, switch to the source code view, e.g. of the task text, with [[image:attach:Onyx Icons und Buttons@Icon_HTML Ansicht öffnen.png]] and add the iframe link from the clipboard.
Carina Enke 177.1 256
Carina Enke 239.1 257 \\
258 )))
259
260 (((
Carina Enke 177.1 261 [[image:attach:Editor - Quellcodeansicht der Aufgabe öffnen_de.png]]
262 )))
263
264 (((
265 [[image:attach:Editor - Beispielquellcode einer Aufgabe.png]]
266 )))
267
268 (((
Carina Enke 239.1 269 \\
Carina Enke 177.1 270
Carina Enke 239.1 271 Confirm with //**OK** //to close the source code window and to integrate the video into the content.
272
Carina Enke 177.1 273 [[image:attach:Editor - Aufgabenstellung mit eingebettetem Video.png]]
274
275 Use the preview function to test the content.
276
277 [[image:attach:Testvorschau - Beispielaufgabe mit eingebettetem Video.png]]
278 )))
279 {{/layout-cell}}
280 {{/layout-section}}
281 {{/layout}}
282 {{/sv-translation}}