hw>Unknown user Keine Bearbeitungszusammenfassung |
Keine Bearbeitungszusammenfassung Markierung: 2017-Quelltext-Bearbeitung |
||
Zeile 1: | Zeile 1: | ||
= | <bookshelf src="Buch:Benutzerhandbuch" /> | ||
{{ | {{DISPLAYTITLE:Videos einbinden}} | ||
{{BSVersion|bsvFrom=4.4|bsvFeature=EmbedVideo|info=Bis BlueSpice 4.3 ist die Erweiterung [[Handbuch:Erweiterung/EmbedVideo|EmbedVideo]] gebündelt.}} | |||
{{Hinweisbox|boxtype=Wichtig|icon=|Note text=Standardmäßig sind Video- und Audioformate nicht als erlaubte Dateiformate konfiguriert. | |||
}} | Ein Administrator muss daher in der [[Handbuch:Erweiterung/BlueSpiceConfigManager|Konfigurationsverwaltung]] die entsprechenden Dateiformate erst hinzufügen, bevor Benutzer diese Dateien hochladen können|bgcolor=}} | ||
{{ | |||
| | |||
| | |||
| | |||
| | |||
}} | |||
{{ | |||
| | |||
| | |||
| | |||
}} | |||
==Externe Videos einbetten== | |||
[[Datei:750px-video-extern-einbetten.png|alternativtext=Eingebettete externe YouTube-Videos|zentriert|mini|750x750px|Eingebettete externe YouTube-Videos]] | |||
{{Hinweisbox|boxtype=note|Note text=Die Anleitung zur Nutzung der Erweiterung EmbedVideo wurde aus der englischen [https://www.mediawiki.org/wiki/Extension:EmbedVideo_(fork) Mediawiki-Hilfeseite] übernommen und angepasst.}} | |||
===Syntax=== | |||
Ein einzelnes externes Video wird über folgendes Parser-Tag im Quelltext eingefügt: | |||
<syntaxhighlight lang="text"> | |||
{{#ev:service|id|dimensions|alignment|description|container|urlargs|autoresize}} | |||
</syntaxhighlight>Platzhalter für nicht genutzte Argumente zwischen zwei Argumenten müssen leer gelassen werden und dürfen nicht entfernt werden:<syntaxhighlight lang="text"> | |||
{{#ev:service|id|||description}} | |||
<syntaxhighlight lang="text">Die kürzeste Einbindung erfolgt über den erforderlichen Service-Namen und die Video-ID:<syntaxhighlight> | |||
{{#ev:youtube|MLIE2642neg}} | |||
</syntaxhighlight>Beispiel mit Video-Beschreibung (- in die Beschreibung kann über das <code><nowiki><br /></nowiki></code> Tag ein Zeilenumbruch eingefügt werden): | |||
<syntaxhighlight lang="text"> | |||
{{#ev:youtube|MLIE2642neg|||ISS - Leben auf der Weltraumstation <br/> 1:04:27}} | |||
</syntaxhighlight> | |||
====Parameter==== | |||
{| class="contenttable-blue" style="width:100%;" | |||
! Attribut | |||
! erforderlich | |||
! Standard-wert | |||
! Beschreibung | |||
|- | |||
| <code>service="(Siehe unterstützte Services unten)"</code> | |||
| ja | |||
| | |||
|Der Video-Service, der aufgerufen wird. | |||
|- | |||
| <code><nowiki>id="[id|url]"</nowiki></code> | |||
| ja | |||
| | |||
|Die Video-ID oder die ganze URL des externen Videos. | |||
|- | |||
|<code><nowiki>dimensions="[BREITE|BREITExHÖHE|xHÖHE]"</nowiki></code> | |||
|nein | |||
| 640 | |||
| Maße in Pixels, um die Größe des Einbindungs-Containers festzulegen. Das Standardformat ist Breite x Höhe, wobei jeweils eine Größenangabe ausgelassen werden kann. Das <code>x</code> muss der Höhe immer vorangestellt sein. | |||
Beispiele: <code>480</code>, <code>480x320</code>, <code>x320</code>. Wenn die Höhe nicht angegeben ist, wird sie automatisch über die Breite und das standardmäßige Seitenverhältnis des Video-Services berechnet. | |||
Manche Video-Services haben keine Standardhöhe. Daher sollte die Höhe bei jeder Einbindung angegeben werden. <code>$wgEmbedVideoDefaultWidth</code> kann in der Datei <code>LocalSettings.php</code> die Standardbreite überschreiben. | |||
|- | |||
|<code><nowiki>alignment="[left|center|right|inline]"</nowiki></code> | |||
|nein | |||
|keiner | |||
|Das Video kann links, mittig, rechts oder inline plaziert werden. Inline erlaubt es, mehrere Videos nebeneinander zu plazieren. In mobiler Ansicht werden die Videos automatisch untereinander angezeigt. | |||
|- | |||
|<code>description="[wiki text]"</code> | |||
|nein | |||
|keiner | |||
|Zeigt eine Beschreibung unter dem Einbettungs-Container an. | |||
|- | |||
|<code>container="[frame]"</code> | |||
|nein | |||
|keiner | |||
|Legt den Container-Typ für das Einbetten fest. | |||
<code>frame</code>: Umgibt den Video-Player mit einer Mediawiki Vorschaubox. | |||
|- | |||
|<code>urlargs="modestbranding=1&version=3"</code> | |||
|nein | |||
|keiner | |||
|Ermöglicht es, der generierten Einbettungs-URL extra URL-Argumente hinzuzufügen. Dies ist nützlich, wenn ein unterstützter Video-Service besondere Optionen anbietet, die nur von diesem Service unterstützt werden. | |||
|- | |||
|<code>autoresize="false"</code> | |||
|nein | |||
|wahr | |||
|Passt die Video-Größe automatisch an, wenn die Größe des Videos den Container sprengen würde. | |||
|- | |||
|<code><nowiki>valignment="[top|middle|bottom|baseline]"</nowiki></code> | |||
|nein | |||
|keiner | |||
|Das Video wird im Bezug auf das Parent-Element oben, mittig, unten oder auf der Grundlinie plaziert. Die Benutzung dieses Parameters forciert den Alignment-Parameter. | |||
|- | |||
|<code><nowiki>width</nowiki></code> | |||
| | |||
| | |||
|Breite des Videos. Die Höhe wird automatisch berechnet. | |||
|- | |||
|<code><nowiki>height</nowiki></code> | |||
| | |||
| | |||
|Höhe des Videos. Die Breite wird automatisch berechnet. | |||
|- | |||
|<code><nowiki>poster</nowiki></code> / <code><nowiki>cover</nowiki></code> | |||
| | |||
| | |||
|Wird nur berücksichtigt, wenn eine Zustimmung zum Laden des Videos erforderlich ist ($wgEmbedVideoRequireConsent=true). | |||
|- | |||
|<code><nowiki>title</nowiki></code> | |||
| | |||
| | |||
|Wird nur berücksichtigt, wenn eine Zustimmung zum Laden des Videos erforderlich ist ($wgEmbedVideoRequireConsent=true). | |||
|} | |||
==Lokale Videos einbetten== | |||
=== Mediendialog === | |||
Videos können wie [[Handbuch:Erweiterung/VisualEditor/Bilder|Bilder]] direkt über den Mediendialog auf einer Seite eingefügt werden. Das Wiki erkennt die Dateiendung und generiert automatisch den nötigen HTML-Player. | |||
=== BlueSpicePlayer oder EmbedVideo === | |||
Videos, die direkt im Wiki gespeichert sind, können ebenso in der Quelltextbearbeitung eingebunden werden. Dies ist auch über die BlueSpice-spezifische Erweiterung [[Handbuch:Erweiterung/BlueSpicePlayer|BlueSpicePlayer]] möglich. BlueSpicePlayer hat keine Funktion zur Einbindung von externen Videos. Die Verwendung unterscheidet sich wie folgt: |
Version vom 8. Dezember 2023, 15:08 Uhr
Externe Videos einbetten[Bearbeiten | Quelltext bearbeiten]
Syntax[Bearbeiten | Quelltext bearbeiten]
Ein einzelnes externes Video wird über folgendes Parser-Tag im Quelltext eingefügt:
{{#ev:service|id|dimensions|alignment|description|container|urlargs|autoresize}}
Platzhalter für nicht genutzte Argumente zwischen zwei Argumenten müssen leer gelassen werden und dürfen nicht entfernt werden:
{{#ev:service|id|||description}}
<syntaxhighlight lang="text">Die kürzeste Einbindung erfolgt über den erforderlichen Service-Namen und die Video-ID:<syntaxhighlight>
{{#ev:youtube|MLIE2642neg}}
Beispiel mit Video-Beschreibung (- in die Beschreibung kann über das <br />
Tag ein Zeilenumbruch eingefügt werden):
{{#ev:youtube|MLIE2642neg|||ISS - Leben auf der Weltraumstation <br/> 1:04:27}}
Parameter[Bearbeiten | Quelltext bearbeiten]
Attribut | erforderlich | Standard-wert | Beschreibung |
---|---|---|---|
service="(Siehe unterstützte Services unten)"
|
ja | Der Video-Service, der aufgerufen wird. | |
id="[id|url]"
|
ja | Die Video-ID oder die ganze URL des externen Videos. | |
dimensions="[BREITE|BREITExHÖHE|xHÖHE]"
|
nein | 640 | Maße in Pixels, um die Größe des Einbindungs-Containers festzulegen. Das Standardformat ist Breite x Höhe, wobei jeweils eine Größenangabe ausgelassen werden kann. Das x muss der Höhe immer vorangestellt sein.
Beispiele: Manche Video-Services haben keine Standardhöhe. Daher sollte die Höhe bei jeder Einbindung angegeben werden. |
alignment="[left|center|right|inline]"
|
nein | keiner | Das Video kann links, mittig, rechts oder inline plaziert werden. Inline erlaubt es, mehrere Videos nebeneinander zu plazieren. In mobiler Ansicht werden die Videos automatisch untereinander angezeigt. |
description="[wiki text]"
|
nein | keiner | Zeigt eine Beschreibung unter dem Einbettungs-Container an. |
container="[frame]"
|
nein | keiner | Legt den Container-Typ für das Einbetten fest.
|
urlargs="modestbranding=1&version=3"
|
nein | keiner | Ermöglicht es, der generierten Einbettungs-URL extra URL-Argumente hinzuzufügen. Dies ist nützlich, wenn ein unterstützter Video-Service besondere Optionen anbietet, die nur von diesem Service unterstützt werden. |
autoresize="false"
|
nein | wahr | Passt die Video-Größe automatisch an, wenn die Größe des Videos den Container sprengen würde. |
valignment="[top|middle|bottom|baseline]"
|
nein | keiner | Das Video wird im Bezug auf das Parent-Element oben, mittig, unten oder auf der Grundlinie plaziert. Die Benutzung dieses Parameters forciert den Alignment-Parameter. |
width
|
Breite des Videos. Die Höhe wird automatisch berechnet. | ||
height
|
Höhe des Videos. Die Breite wird automatisch berechnet. | ||
poster / cover
|
Wird nur berücksichtigt, wenn eine Zustimmung zum Laden des Videos erforderlich ist ($wgEmbedVideoRequireConsent=true). | ||
title
|
Wird nur berücksichtigt, wenn eine Zustimmung zum Laden des Videos erforderlich ist ($wgEmbedVideoRequireConsent=true). |
Lokale Videos einbetten[Bearbeiten | Quelltext bearbeiten]
Mediendialog[Bearbeiten | Quelltext bearbeiten]
Videos können wie Bilder direkt über den Mediendialog auf einer Seite eingefügt werden. Das Wiki erkennt die Dateiendung und generiert automatisch den nötigen HTML-Player.
BlueSpicePlayer oder EmbedVideo[Bearbeiten | Quelltext bearbeiten]
Videos, die direkt im Wiki gespeichert sind, können ebenso in der Quelltextbearbeitung eingebunden werden. Dies ist auch über die BlueSpice-spezifische Erweiterung BlueSpicePlayer möglich. BlueSpicePlayer hat keine Funktion zur Einbindung von externen Videos. Die Verwendung unterscheidet sich wie folgt: