Handbuch:Erweiterung/EmbedVideo (fork) und Vorlagen: Unterschied zwischen den Seiten

Aktuelle Version vom 12. Dezember 2023, 18:17 Uhr

Weiterleitung nach:

Handbuch:Vorlagen

Was ist eine Vorlage?[Bearbeiten | Quelltext bearbeiten]

Eine Vorlage ist eine Art von wiederverwendbarem Inhalt, der in andere Seiten des Wikis integriert werden kann. Die Vorlage kann inhaltsbasiert (Textvorlage) oder strukturbasiert (Layoutvorlage) oder eine Kombination aus beiden sein.

Ein einfaches Beispiel ist eine Infobox, die auf allen Seiten identisch aussieht, jedoch auf jeder Seite, auf der sie verwendet wird, unterschiedliche Inhalte enthält (Layoutvorlage).

typische Infobox

Eigenschaften einer Vorlage[Bearbeiten | Quelltext bearbeiten]

Merkmale einer Vorlage:

Einfache Vorlage

ermöglicht das Einfügen von wiederverwendbaren Inhalten auf einer Seite (Transklusion)
befindet sich normalerweise im Namensraum "Vorlage"
kann Parameter haben
enthält oft Logik
wird verwendet, um ein "Look and Feel" beizubehalten

Eine Vorlage erstellen und einbinden[Bearbeiten | Quelltext bearbeiten]

Eine neue Vorlage wird wie eine normale Seite erstellt, jedoch im Namensraum Vorlage.

Beispiel:Einfache Vorlage für Infoboxen

Eine Vorlage wird in eine Seite eingefügt, indem der Name der Vorlage (d.h. der Titel der Vorlagenseite ohne das Namespace-Präfix "Vorlage:") in zwei geschweifte Klammern gesetzt wird: {{NotificationBox}}

Hinweis:Vorlagennamen unterscheiden zwischen Groß- und Kleinschreibung.

Eine Vorlage bearbeiten[Bearbeiten | Quelltext bearbeiten]

Änderungen an einer Vorlage wirken sich auf alle Seiten aus, die diese Vorlage enthalten. Bevor Sie vorhandene Vorlagen ändern, sollten Sie überprüfen, auf welchen Seiten die Vorlage verwendet wird. Um diese Seiten zu finden, klicken Sie in der Seitenwerkzeugleiste auf Seiteninformationen > Eigenschaften.

Parameter über TemplateData beschreiben[Bearbeiten | Quelltext bearbeiten]

Die MediaWiki-Erweiterung TemplateData erlaubt es, die Vorlagen-Parameter so zu beschreiben, dass sie von Benutzern im Visual Editor leicht über ein Formular bearbeitet werden können.

Vorlage formatieren[Bearbeiten | Quelltext bearbeiten]

Wenn eine Vorlage besonders formatiert werden soll, z.B. mit Hintergrundfarbe, Textabstand oder besonderer Schriftformatierung, kann dies über MediaWiki:Common.css erreicht werden. Die Formatierungen sind somit für andere Vorlagen mehrfach verwendbar. Sind die Formatierungen speziell auf diese Vorlage beschränkt, werden sie über eine Unterseite der Vorlage über TemplateStyles angelegt. Dies hat zum Vorteil, dass die Stilvorgaben zusammen mit der Vorlage leicht exportiert und in ein anderes Wiki importiert werden können.

Weitere Hinweise[Bearbeiten | Quelltext bearbeiten]

Die Verwendung einer Vorlage ist im Grunde eine Transklusion.
Vorlagen können auch verwendet werden, um die Ausgabe von semantic query zu definieren. Weitere Informationen finden Sie unter Semantic MediaWiki.
Die vollständige Liste aller Seiten des Wikis, die sich in diesem Namensraum befinden, finden Sie auf der Seite Spezial:Vorlagen. Diese ist über den Menüpunkt Globale Aktionen > Werkzeuge > Vorlagen zu erreichen.

Eingebaute Variablen[Bearbeiten | Quelltext bearbeiten]

Jedes MediaWiki hat eine Reihe von eingebauten Variablen, die keine Seiten im Namensraum "Vorlage" sind, aber dennoch als Vorlagen verwendet werden.

Beispielsweise gibt die Variable {{CURRENTTIME}} die aktuelle UTC-Zeit zurück.

Weiterführende Links

Technische Referenz: EmbedVideo (fork)

Feedback zur Dokumentation ist im Community-Forum möglich.

@@ Zeile 1: / Zeile 1: @@
-<bookshelf src="Buch:Benutzerhandbuch" />
+#WEITERLEITUNG [[Handbuch:Vorlagen]]
-{{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==
+==Was ist eine Vorlage?==
-[[Datei:750px-video-extern-einbetten.png|alternativtext=Eingebettete externe YouTube-Videos|zentriert|mini|750x750px|Eingebettete externe YouTube-Videos]]
+Eine Vorlage ist eine Art von wiederverwendbarem Inhalt, der in andere Seiten des Wikis integriert werden kann. Die Vorlage kann inhaltsbasiert (Textvorlage) oder strukturbasiert (Layoutvorlage) oder eine Kombination aus beiden sein.
+Ein einfaches Beispiel ist eine Infobox, die auf allen Seiten identisch aussieht, jedoch auf jeder Seite, auf der sie verwendet wird, unterschiedliche Inhalte enthält (Layoutvorlage).
+[[Datei:Infobox 1662642182390.png|alternativtext=typische Infobox|mini|typische Infobox|ohne]]
-{{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.}}
+==Eigenschaften einer Vorlage==
-===Syntax===
+Merkmale einer Vorlage:<!-- Übertragen in Schulungsunterlagen! -->
-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.
+<section begin="training" />[[Datei:vorlage-beispiel.png|alternativtext=Einfache Vorlage|mini|400x400px|Einfache Vorlage]]
-|-
-|<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 ===
+*ermöglicht das Einfügen von wiederverwendbaren Inhalten auf einer Seite (Transklusion)
-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.
+*befindet sich normalerweise im Namensraum "Vorlage"
+*kann Parameter haben
+*enthält oft Logik
+*wird verwendet, um ein "Look and Feel" beizubehalten
+<section end="training" />
+==Eine Vorlage erstellen und einbinden==
+Eine neue Vorlage wird wie eine normale Seite erstellt, jedoch im Namensraum '''Vorlage'''.
-=== BlueSpicePlayer oder EmbedVideo ===
+{{Hinweisbox|boxtype=example|Note text=[[Vorlagen/Beispiel/Infobox|Einfache Vorlage für Infoboxen]]}}
-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:
+Eine Vorlage wird in eine Seite eingefügt, indem der Name der Vorlage (d.h. der Titel der Vorlagenseite ohne das Namespace-Präfix "Vorlage:") in zwei geschweifte Klammern gesetzt wird: <code><nowiki>{{NotificationBox}}</nowiki></code>
+{{Hinweisbox|boxtype=Hinweis|Note text=Vorlagennamen unterscheiden zwischen Groß- und Kleinschreibung.}}
+== Eine Vorlage bearbeiten==
+Änderungen an einer Vorlage wirken sich auf alle Seiten aus, die diese Vorlage enthalten. Bevor Sie vorhandene Vorlagen ändern, sollten Sie überprüfen, auf welchen Seiten die Vorlage verwendet wird. Um diese Seiten zu finden, klicken Sie in der Seitenwerkzeugleiste auf <code>Seiteninformationen > Eigenschaften</code>.
+==Parameter über TemplateData beschreiben==
+Die MediaWiki-Erweiterung [[Handbuch:Erweiterung/TemplateData|TemplateData]] erlaubt es, die Vorlagen-Parameter so zu beschreiben, dass sie von Benutzern im Visual Editor leicht über ein Formular bearbeitet werden können.
+==Vorlage formatieren==
+Wenn eine Vorlage besonders formatiert werden soll, z.B. mit Hintergrundfarbe, Textabstand oder besonderer Schriftformatierung, kann dies über MediaWiki:Common.css erreicht werden. Die Formatierungen sind somit für andere Vorlagen mehrfach verwendbar. Sind die Formatierungen speziell auf diese Vorlage beschränkt, werden sie über eine Unterseite der Vorlage über [[Handbuch:Erweiterung/TemplateStyles|TemplateStyles]] angelegt. Dies hat zum Vorteil, dass die Stilvorgaben zusammen mit der Vorlage leicht exportiert und in ein anderes Wiki importiert werden können.
+==Weitere Hinweise==
+*Die Verwendung einer Vorlage ist im Grunde eine [[mediawikiwiki:Transclusion/de|Transklusion]].
+*Vorlagen können auch verwendet werden, um die Ausgabe von [https://www.semantic-mediawiki.org/wiki/Help:embedded_query semantic query] zu definieren. Weitere Informationen finden Sie unter [https://www.semantic-mediawiki.org/wiki/Help:Template_format Semantic MediaWiki].
+*Die vollständige Liste aller Seiten des Wikis, die sich in diesem Namensraum befinden, finden Sie auf der Seite <code>Spezial:Vorlagen</code>. Diese ist über den Menüpunkt ''Globale Aktionen > Werkzeuge > Vorlagen'' zu erreichen.
+==Eingebaute Variablen==
+Jedes MediaWiki hat eine Reihe von [[Handbuch:Magische Wörter|eingebauten Variablen]], die keine Seiten im Namensraum "Vorlage" sind, aber dennoch als Vorlagen verwendet werden.
+Beispielsweise gibt die Variable <code><nowiki>{{CURRENTTIME}}</nowiki></code> die aktuelle UTC-Zeit zurück.{{Box_Links | Thema1 = https://meta.wikimedia.org/wiki/Help:Template| Thema2 = https://www.mediawiki.org/wiki/Help:Templates/de| Thema 3= https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions | Thema4 = }}