Zuletzt bearbeitet vor 4 Monaten
von Margit Link-Rodrigue

2.2.6 AutoDoc:PageHeader und Handbuch:Erweiterung/EmbedVideo (fork): Unterschied zwischen den Seiten

(Unterschied zwischen Seiten)
hw>Unknown user
Keine Bearbeitungszusammenfassung
 
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
 
Zeile 1: Zeile 1:
==DescriptionMsg==
<bookshelf src="Buch:Benutzerhandbuch" />
{{AutoDocDescriptionMsg
{{DISPLAYTITLE:Videos einbinden}}
|name = PageHeader
{{BSVersion|bsvFrom=4.4|bsvFeature=EmbedVideo|info=Bis BlueSpice 4.3 ist die Erweiterung [[Handbuch:Erweiterung/EmbedVideo|EmbedVideo]] gebündelt.}}
|desc = {{int:pageheader-desc
{{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=}}
}}
==License==
{{AutoDocLicense
|name = GPL-3.0-only
}}
==Requirements==
{{AutoDocRequirements
|mediawiki = {{AutoDocVersion
|name = MediaWiki
|version = 1.39.0
}}
}}
==IntegratesInto==
{{AutoDocIntegratesInto
|into = {{AutoDocListItem
|item = BlueSpiceDiscovery
}}
{{AutoDocListItem
|item = PageHeader
}}
}}


==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

EmbedVideo ist ab BlueSpice 4.4 enthalten. Bis BlueSpice 4.3 ist die Erweiterung EmbedVideo gebündelt.
Wichtig!Standardmäßig sind Video- und Audioformate nicht als erlaubte Dateiformate konfiguriert. Ein Administrator muss daher in der Konfigurationsverwaltung die entsprechenden Dateiformate erst hinzufügen, bevor Benutzer diese Dateien hochladen können


Externe Videos einbetten[Bearbeiten | Quelltext bearbeiten]

Eingebettete externe YouTube-Videos
Eingebettete externe YouTube-Videos


Hinweis:Die Anleitung zur Nutzung der Erweiterung EmbedVideo wurde aus der englischen Mediawiki-Hilfeseite übernommen und angepasst.

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: 480, 480x320, x320. 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. $wgEmbedVideoDefaultWidth kann in der Datei LocalSettings.php die Standardbreite überschreiben.

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.

frame: Umgibt den Video-Player mit einer Mediawiki Vorschaubox.

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:

Keine Kategorien vergebenBearbeiten

Diskussionen