Pomoc:EmbedVideo

Rozszerzenie jest domyślnie włączone na Fandomie.

EmbedVideo jest narzędziem umożliwiającym dodawanie plików dźwiękowych oraz filmów do artykułów.

W przeciwieństwie do „przesyłania” filmów za pomocą Video Embed Tool pozwala ona na bezpośrednie osadzanie treści na stronach, eliminując potrzebę utrzymywania stron plików dla każdego wideo na stronie.

Krok po kroku

  1. Sprawdź, czy wybrany film lub plik audio pochodzi z jednego z obsługiwanych serwisów — jest ich ponad 30.
  2. W tabeli usług znajdź nazwę serwisu oraz ID filmu. Poza SoundCloud, ID filmu to fragment adresu URL, wskazujący na konkretny plik wideo.
  3. Mając nazwę serwisu i ID, użyj tej składni, aby osadzić film bez dodatkowego formatowania: {{#ev:service|id}}

Aby dodać wideo z przykładu, użyj {{#ev:youtube|Vois0RMtPHE}}, to da następujący wynik:

Wyjątek: SoundCloud

W przypadku SoundCloud całym ID jest pełny adres URL. Aby osadzić utwór, użyj: 

{{#ev:soundcloud|https://soundcloud.com/madeon/technicolor-original}}

Uwaga: wcześniejsze wersje Fandomu korzystały z rozszerzenia SoundCloud, które używało znacznika <soundcloud /> zamiast funkcji parsera #ev z rozszerzenia EmbedVideo. Z tego powodu na wielu starszych stronach wiki częściej spotkasz właśnie ten znacznik. Szczegółowe instrukcje użycia znajdują się na stronie Pomoc:Pliki dźwiękowe.
Znacznik <soundcloud /> jest częścią rozszerzenia EmbedVideo od wersji 2.7.0, więc uzyskasz identyczny efekt osadzenia niezależnie od użytej metody.

Formatowanie wideo

Funkcja parsera #ev

Wszystkie opcje formatowania dostępne za pomocą Video Embed Tool działają także w EmbedVideo z użyciem poniższej składni: 

{{#ev:id_serwisu|id_treści|wymiary|wyrównanie|podpis}}
  • parametr wymiary określa wymiary osadzonej miniatury — przykładowo {{#ev:youtube|Te3_VlimRw0|200}} wyświetli miniaturę o szerokości 200px, a {{#ev:youtube|Te3_VlimRw0|200x400}} - o wymiarach 200x400px

  • parametr alignment określa wyrównanie miniatury względem reszty strony. Przykład: {{#ev:youtube|Te3_VlimRw0||center}}
    • brak parametru: wyrównana do lewej bez opływania tekstu wokół niej;
    • left: wyrównana do lewej z opływaniem tekstu wokół niej;
    • right: wyrównana do prawej z opływaniem tekstu wokół niej;
    • center: wyśrodkowana
    • inline: osadzona treść traktowana jest w ten sam sposób co treść;

  • parametr podpis odpowiada za podpis pod obrazkiem (i obsługuje formatowanie za pomocą wikitekstu). Przykład: {{#ev:youtube|Te3_VlimRw0|||'''Sharks''' autorstwa ''Imagine Dragons''}}

Sharks autorstwa Imagine Dragons

Argumenty opcjonalne mogą pozostać puste: {{#ev:nazwa serwisu|id|||podpis}}

Znacznik <embedvideo>

Innym sposobem osadzanie wideo z użyciem EmbedVideo jest użycie znacznika <embedvideo> <embedvideo service="nazwa serwisu">id</embedvideo>

Atrybut Wymagane Domyślne Opis
service="nazwa" tak Usługa wideo, z której ma zostać osadzony materiał (np. YouTube, Vimeo itd.).
id="[id|url]" tak Surowe ID filmu lub pełny adres URL strony odtwarzacza.
dimensions="[width|widthxheight|xheight]" nie 640 Wymiary osadzonego materiału w pikselach. Standardowy format to szerokość x wysokość – jeden z wymiarów można pominąć, ale jeśli podajesz wysokość, musi ją poprzedzać x.

Przykłady: 480, 480x320, x320. Jeśli wysokość nie jest podana, zostanie automatycznie obliczona na podstawie szerokości i domyślnego proporcji danej usługi.

Niektóre usługi (np. Gfycat) nie mają stałych proporcji i wymagają podania wysokości ręcznie.

alignment="[left|center|right|inline]" nie brak Wyrównanie wideo na stronie: do lewej, środka, prawej lub inline.

Ustawienie inline pozwala na wyświetlenie kilku filmów obok siebie bez wymuszania nowych linii.

description="[wikitext]" nie brak Tekst opisu wyświetlany pod osadzonym filmem. Aby wymusić znak nowej linii w opisie, użyj &#10;.
container="[frame]" nie brak Określa typ ramki, w której wyświetlane będzie wideo.
frame — umieszcza odtwarzacz w standardowej ramce miniatur MediaWiki.
urlargs="modestbranding=1&version=3" nie brak Pozwala dopisać dodatkowe parametry do adresu URL tworzonego osadzenia.

Przydatne w przypadku specyficznych opcji dostępnych tylko w wybranych usługach.

autoresize="false" nie true Automatyczne zmniejszanie filmów, jeśli ich rozmiar powodowałby „wychodzenie” poza obszar dostępny w szablonie lub układzie strony.
valignment="[top|middle|bottom|baseline]" nie brak Wyrównanie osadzonego filmu w pionie w ramach elementu nadrzędnego (góra, środek, dół lub linia bazowa).

Użycie tego parametru wymusza ustawienie parametru aligment na inline.

Zaawansowane

Pełna dokumentacja znajduje się tutaj. Znajdziesz tam informacje o:

  • funkcji #evt — do wykorzystania EmbedVideo w szablonach
  • funkcji #evu — automatyczne rozpoznanie serwisu
  • parametrze urlargs pozwalającym na np. ustawienie startu filmu
  • alternatywnych składniach tagów, np.:
    • <embedvideo service="youtube">ID</embedvideo>
    • <soundcloud url=""/>
  • obsłudze tagów porzuconego rozszerzenia VideoLink, oryginalnie przygotowanego i używanego przez angielską Wowpedię.

Zobacz też

Dalsze wsparcie

Szukasz dalszego wsparcia lub masz pytanie? Sprawdź poniższe linki, aby dowiedzieć się więcej.