Wiki-Quellcode von Medien einbinden

Version 192.1 von Carina Enke am 20.10.2023

Zeige letzte Bearbeiter
1 {{sv-translation language="de"}}
2 {{layout}}
3 {{layout-section ac:type="single"}}
4 {{layout-cell}}
5 \\
6
7 {{details}}
8 (% class="wrapped" %)
9 |=(((
10 Verantwortlicher
11 )))|(((
12 \\
13 )))
14 |=(% colspan="1" %)(% colspan="1" %)
15 (((
16 Status
17 )))|(% class="highlight-yellow" colspan="1" data-highlight-colour="yellow" %)(% class="highlight-yellow" colspan="1" data-highlight-colour="yellow" %)
18 (((
19 (% class="content-wrapper" %)
20 (((
21 {{sv-metadata type="workflow-status"/}}
22
23 {{status colour="Green" title="Fertig"/}}
24 )))
25 )))
26 |=(% colspan="1" %)(% colspan="1" %)
27 (((
28 Varianten
29 )))|(% colspan="1" %)(% colspan="1" %)
30 (((
31 (% class="content-wrapper" %)
32 (((
33 {{sv-metadata type="variants"/}}
34 )))
35 )))
36 |=(% colspan="1" %)(% colspan="1" %)
37 (((
38 Attribute
39 )))|(% colspan="1" %)(% colspan="1" %)
40 (((
41 (% class="content-wrapper" %)
42 (((
43 {{sv-metadata type="attributes"/}}
44 )))
45 )))
46 |=(% colspan="1" %)(% colspan="1" %)
47 (((
48 Pagekey
49 )))|(% colspan="1" %)(% colspan="1" %)
50 (((
51 (% class="content-wrapper" %)
52 (((
53 {{sv-metadata type="pagekey"/}}
54 )))
55 )))
56 |=(% colspan="1" %)(% colspan="1" %)
57 (((
58 Übersetzung
59 )))|(% colspan="1" %)(% colspan="1" %)
60 (((
61 (% class="content-wrapper" %)
62 (((
63 Integrate media 
64
65 {{status colour="Green" title="fertig"/}}
66 )))
67 )))
68 |=(% colspan="1" %)(% colspan="1" %)
69 (((
70 TODOs
71 )))|(% colspan="1" %)(% colspan="1" %)
72 (((
73 (% class="content-wrapper" %)
74 (((
75 (% class="task-list" %)
76 (((
77 {{task reference="/Tasks/Task_8" status="Done"}}
78 carina: Anpassung durch ONYX-4150
79 {{/task}}
80
81 {{task reference="/Tasks/Task_11" status="Done"}}
82 carina {{mention reference="XWiki.0a49950f5c0f19a8015c101b60e10001" style="FULL_NAME" anchor="XWiki-0a49950f5c0f19a8015c101b60e10001-xjstp"/}} Kleine Textänderung beim Abschnitt Grafiken/ Bilder einfügen {{date value="2020-10-31" format="yyyy-MM-dd"/}}
83
84 {{/task}}
85 )))
86 )))
87 )))
88 {{/details}}
89 {{/layout-cell}}
90 {{/layout-section}}
91
92 {{layout-section ac:type="two_right_sidebar"}}
93 {{layout-cell}}
94 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.
95 {{/layout-cell}}
96
97 {{layout-cell}}
98 {{scroll-ignore}}
99 {{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Inhalt"}}
100
101
102 {{toc/}}
103 {{/panel}}
104 {{/scroll-ignore}}
105 {{/layout-cell}}
106 {{/layout-section}}
107
108 {{layout-section ac:type="single"}}
109 {{layout-cell}}
110 == HTML-Editor ==
111
112 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.
113
114 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size confluence-embedded-file-wrapper confluence-embedded-manual-size" %)[[image:attach:Editor - Aufgabe editieren_de.png]]
115
116 (% 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.
117
118
119 == Grafiken und Bilder ==
120
121 Es werden alle gängigen Bild-Formate (JPEG / JPG, GIF, PNG) und Vektorgrafiken (SVG) unterstützt.
122
123 [[image:attach:Testansicht - Bilder in einer Aufgabe_de.png]]
124
125 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 einfügen/bearbeiten" Dialog. Hier kann eine Bildressource ausgewählt und es können notwendige Einstellungen zur Anzeige der gewählten Ressource getroffen werden.
126
127 [[image:attach:Editor - Dialog Bild einfügen_de.png]]
128
129 Wählen Sie "Durchsuchen", um ein Bild hochzuladen (1). Geben Sie einen Alternativtext ein, welcher angezeigt wird, wenn das Bild nicht geladen werden kann oder soll (2). Der Alternativtext ist ein wichtiges Kriterium für barrierefreie Inhalte. Bilder können einfach hinsichtlich der Größe durch Angabe der Dimension (Breite / Höhe) angepasst werden (3). Das gewählte Bild ist im Dialog als Vorschau sichtbar.
130
131 Bestätigen Sie die Eingaben mit "Fertig". Das eingefügte Bild wird direkt im HTML-Editor und ebenso in der Vorschau angezeigt.
132
133 == Audio ==
134
135 (% 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.
136
137 (% 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"]].
138
139 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size confluence-embedded-file-wrapper confluence-embedded-manual-size" %)[[image:attach:Testansicht - Aufgabe mit Audio.png]]
140
141 == Video ==
142
143 Videos können integriert oder als Referenz eingebunden werden.
144
145 Aus Performance-Grü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).
146
147 ==== Referenzieren von Videos mit YouTube ====
148
149 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.
150
151 [[image:attach:Youtube - Video einbetten_de.png]]
152
153 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.
154
155 [[image:attach:Editor - Quellcodeansicht der Aufgabe öffnen_de.png]]
156
157 [[image:attach:Editor - Beispielquellcode einer Aufgabe.png]]
158
159 Mit Bestätigung durch OK wird das Quellcode-Fenster geschlossen und das Video in den Inhalt integriert.
160
161 [[image:attach:Editor - Aufgabenstellung mit eingebettetem Video.png]]
162
163 Über die Vorschau-Funktion können Sie den Inhalt ausprobieren.
164
165 [[image:attach:Testvorschau - Beispielaufgabe mit eingebettetem Video.png]]
166 {{/layout-cell}}
167 {{/layout-section}}
168 {{/layout}}
169 {{/sv-translation}}
170
171 {{sv-translation language="en"}}
172 {{layout}}
173 {{layout-section ac:type="two_right_sidebar"}}
174 {{layout-cell}}
175 The ONYX Testsuite provides extensive media support. Besides, all question content can be formatted in HTML (IMS QTI only offers a restricted HTML subset). The following overview shows which types of media and formats are supported.
176 {{/layout-cell}}
177
178 {{layout-cell}}
179 {{scroll-ignore}}
180 {{panel title="Content"}}
181
182
183 {{toc/}}
184 {{/panel}}
185 {{/scroll-ignore}}
186 {{/layout-cell}}
187 {{/layout-section}}
188
189 {{layout-section ac:type="single"}}
190 {{layout-cell}}
191 == HTML editor ==
192
193 The 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 designs. For example, content in the question text, answer alternatives, or feedback can be highlighted in bold or italics, arranged in tables, or formatted in a list.
194
195 [[image:attach:Editor - Aufgabe editieren_de.png]]
196
197 With [[image:attach:Onyx Icons und Buttons@Icon_HTML Ansicht öffnen.png]], you can edit content directly in an HTML view, where you can also use other markup languages.
198
199 == Graphics and images ==
200
201 All common image formats (JPEG / JPG, GIF, PNG) and vector graphics (SVG) are supported.
202
203 [[image:attach:Testansicht - Bilder in einer Aufgabe_de.png]]
204
205 (((
206 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). This will open the "Edit image" dialogue. In the dialogue, an image resource can be selected and necessary settings for the display of the selected resource can be configured.
207
208 [[image:attach:Editor - Dialog Bild einfügen_de.png]]
209
210 Click on "Browse" to upload an image (1). Enter an alternative text to be displayed if the image cannot or should not be loaded (2). The alternative text is an important criterion for barrier-free content. Images can be easily adjusted in size by specifying the dimensions (width/height) (3). The dialogue also shows a preview of the selected image.
211
212 Confirm your entries with **OK**. The inserted image will be directly displayed in the HTML editor and in the preview.
213
214 == Audio ==
215
216 Audio can be added in the HTML editor using the function [[image:attach:Onyx Icons und Buttons@Icon_Audio einfügen.png]] (insert audio). You can decide how the audio should be integrated into your test content. In the "Insert audio file" dialogue, you can select the desired audio file with **Browse** and **Upload**. Once you have added the audio file, you can choose in the dialogue how the audio files should be integrated into your test content.
217
218 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). For more information on browser support, see for example the research conducted by [[W3Schools>>url:https://www.w3schools.com/html/html5_audio.asp||shape="rect"]].
219
220 [[image:attach:Testansicht - Aufgabe mit Audio.png]]
221
222 == Video ==
223
224 Videos can be integrated or embedded as a reference.
225
226 For performance reasons, the direct integration of videos is not recommended, especially for large test scenarios. Instead, reference videos from a public or private video streaming system (e. g. YouTube, Magma).
227
228 **Referencing videos with YouTube**
229
230 YouTube provides a simple function to embed videos in other websites. This embedding function can also be used to integrate videos into ONYX.
231
232 [[image:attach:Youtube - Video einbetten_de.png]]
233 )))
234
235 (((
236 Videos can be integrated into all test and question components (e. g. question texts, answer elements, and feedback). To integrate a video, copy the displayed iframe link to your test content. In the ONYX Editor, switch to the source code view, e. g. of the question text, with [[image:attach:Onyx Icons und Buttons@Icon_HTML Ansicht öffnen.png]] and add the iframe link from the clipboard.
237
238 [[image:attach:Editor - Quellcodeansicht der Aufgabe öffnen_de.png]]
239 )))
240
241 (((
242 [[image:attach:Editor - Beispielquellcode einer Aufgabe.png]]
243 )))
244
245 (((
246 Confirm with **OK** to close the source code window and integrate the video into the content.
247
248 [[image:attach:Editor - Aufgabenstellung mit eingebettetem Video.png]]
249
250 Use the preview function to test the content.
251
252 [[image:attach:Testvorschau - Beispielaufgabe mit eingebettetem Video.png]]
253 )))
254 {{/layout-cell}}
255 {{/layout-section}}
256 {{/layout}}
257 {{/sv-translation}}