Szablon:Listen

Z Wikipedii, wolnej encyklopedii
Skocz do: nawigacja, szukaj
Template-info.png Dokumentacja szablonu [zobacz] [edytuj] [historia] [odśwież]

Szablon {{Listen}} (ang. słuchaj) służy do osadzania w treści artykułów plików dźwiękowych i wideo.

Użycie[edytuj]

Ze względu na to, że pierwsza wersja szablonu została przekopiowana do polskojęzycznej Wikipedii w 2008 roku i od początku wykorzystywała angielskie nazwy parametrów, w nowszej wersji opartej o lua zachowano angielskie nazwy.

Najprostszy przykład[edytuj]

{{Listen
| filename    =
| title       =
| description =
| pos         =
}}
  • filename (wymagane): nazwa pliku, bez przedrostka Plik:
  • title (wymagane): tytuł pod jakim ma zostać wyświetlony utwór. Nie używaj cudzysłowów ani linków (pierwsze wykrzaczą szablon, drugie zwyczajnie się nie wyświetlą)
  • description: opis/podpis pliku
  • pos: pozycja szablonu (left lub right; domyślnie: right)

Wiele plików[edytuj]

Dodając cyfry do kolejnych parametrów można wywołać więcej niż jeden plik w tej samej ramce.

{{Listen
| filename     =
| title        =
| alt          =
| description  =
| filename2    =
| title2       =
| alt2         =
| description2 =
| filename3    =
| title3       =
| alt3         =
| description3 =
}}
  • alt: tekst alternatywny, dla osób z zaburzeniami widzenia, niewidomych, słabowidzących itp. Wymagany przy plikach wideo. Tekst powinien opisywać nieruchome zdjęcie widoczne przed kliknięciem przycisku uruchamiającego odtwarzanie, nie całe wideo.

Dodatkowe parametry[edytuj]

Wyglądem szablonu można sterować za pomocą dodatkowych parametrów opisanych poniżej:

  • type: zmienia ikonę widoczną po lewej stronie. Domyślnie jest to sound (dosł. dźwięk), dopuszczalne są także parametry speech (dla tekstu mówionego) oraz music (dla muzyki)
  • header: pozwala na dodanie nagłówka do szablonu
  • help: jeśli podany w formie help=no, nie wyświetli się link do pomocy dot. plików multimedialnych, widoczny na dole.
  • image: pozwala na określenie innego obrazu niż wskazany jako plik. Na przykład |image=[[Plik:Example.jpg|50px]] wyświetli Plik:Example.jpg zamiast miniaturki podanego wideo. Można również ustawić |image=none, wtedy miniaturka nie wyświetli się w ogóle.
  • style: Pozwala na podawanie dodatkowych parametrów stylu. Choćby float:none, float:none; clear:none (by dwa wywołania szablonu mogły występować obok siebie na stronie) itd.
  • play: niektóre pliki multimedialne nie dają się wyświetlić w miniaturze na stronie. W takiej sytuacji użyj parametru play=no
  • plain: wyłącza większość stylu w szablonie. Jeśli podasz parametr w formie plain=yes, szablon wyświetli się bez ramki, ikony i linków do pomocy, a także bez osadzenia po lewej lub prawej (przydatne, jeśli chcesz osadzić szablon w konkretnym miejscu zdefiniowanym w polu "style" (na przykład style=float:right).
  • embed: w formie embed=yes służy dla łatwiejszego osadzenia go w innym szablonie, na przykład w infoboksie. Patrz przykłady poniżej.
  • format (przestarzały): dawniej służył do podawania rozszerzenia pliku w formie linku do hasła o danym formacie. Obecnie nie wyświetla się, choć podanie go nie skutkuje wysypaniem się szablonu.

Przykłady użycia[edytuj]

prosty
{{Listen
| filename    = Accordion chords-01.ogg
| title       = Accordion chords
| description = Chords being played on an accordion
}}


wideo
{{Listen
| image       = [[File:Video Camera Icon.png|50px]]
| help        = no
| filename    = Barack Obama inaugural address.ogv
| alt         = A black man in a black coat gestures and talks at a lecturn surrounded by teleprompters. Behind him, in the background, are about a dozen warmly-dressed onlookers.
| title       = Inaugural address of Barack Obama
| description = Barack Obama's [[First inauguration of Barack Obama|first inaugural address]], January 20, 2009<br />(Duration: 21 minutes, 21 seconds)
}}


Z nagłówkiem
{{Listen
| header      = Recordings of this phrase:
| type        = speech
| filename    = Frase de Neil Armstrong.ogg
| title       = "One small step for a man..."
| description = First words spoken on the [[Moon]].
}}


Osadzanie

Szablon:Infobox person

{{Infobox person
| name = Dr. Accordion
| occupation = Accordion player
| module =
{{Listen
| filename = Accordion chords-01.ogg
| title    = Accordion chords
| embed    = yes
}}
}}


Czysty
{{Listen
| filename = Accordion chords-01.ogg
| title    = Accordion chords
| plain    = yes
| style    = float:left
}}


Wiele plików
{{Listen
| type         = music
| filename     = Accordion chords-01.ogg
| title        = Accordion chords
| description  = Chords being played on an accordion
| filename2    = Moonlight.ogg
| title2       = ''Moonlight Sonata''
| description2 = [[Ludwig van Beethoven|Beethoven]]'s [[Piano Sonata No. 14 (Beethoven)|Sonata in C-sharp minor]]
| filename3    = Brahms-waltz15.ogg
| title3       = Waltz No. 15
| description3 = From [[Sixteen Waltzes, Op. 39 (Brahms)|Sixteen Waltzes, Op. 39]] by [[Johannes Brahms|Brahms]]
}}


Parametry szablonu (strukturyzacja VE)[edytuj]

Szablon służy do osadzania w treści artykułów plików dźwiękowych i wideo.

Parametry szablonu

Ten szablon ma niestandardowe formatowanie.

Parametr Opis Typ Status
Plik filename

Nazwa pliku, bez przedrostka Plik:

Domyślne
puste
Przykład
Chopin-Etiuda Ges-dur-Greiss.ogg
Wartość automatyczna
puste
Plik wymagany
Tytuł title

Tytuł pod jakim ma zostać wyświetlony utwór. Nie używaj cudzysłowów ani linków.

Domyślne
puste
Przykład
Pieśń Legionów w wykonaniu Kiepury
Wartość automatyczna
puste
Treść wymagany
Opis description

Opis/podpis pliku

Domyślne
puste
Przykład
Pierwsze słowa wypowiedziane na [[Księżyc]]u
Wartość automatyczna
puste
Treść sugerowany
Pozycja pos

Domyślnie right, akceptuje również left

Domyślne
right
Przykład
left
Wartość automatyczna
left
Wartość logiczna opcjonalny
Alt alt

tekst alternatywny, dla osób z zaburzeniami widzenia, niewidomych, słabowidzących itp. Wymagany przy plikach wideo. Tekst powinien opisywać nieruchome zdjęcie widoczne przed kliknięciem przycisku uruchamiającego odtwarzanie, nie całe wideo.

Domyślne
puste
Przykład
Widok Ziemi z Księżyca, widoczne obie Ameryki i część Afryki, Europa schowana za chmurami.
Wartość automatyczna
Treść opcjonalny
Plik 2 filename2

Nazwa drugiego pliku, bez przedrostka Plik:

Domyślne
puste
Przykład
Frederic Chopin - Opus 25 - Twelve Grand Etudes - G Flat Major.ogg
Wartość automatyczna
puste
Plik opcjonalny
Title2 title2

brak opisu

Domyślne
puste
Przykład
puste
Wartość automatyczna
puste
Nieznany opcjonalny
Alt2 alt2

brak opisu

Domyślne
puste
Przykład
puste
Wartość automatyczna
puste
Nieznany opcjonalny
Description2 description2

brak opisu

Domyślne
puste
Przykład
puste
Wartość automatyczna
puste
Nieznany opcjonalny
Plik 3 filename3

Nazwa trzeciego pliku, bez przedrostka Plik:

Domyślne
puste
Przykład
Przykład.wmv
Wartość automatyczna
puste
Plik opcjonalny
Alt3 alt3

brak opisu

Domyślne
puste
Przykład
puste
Wartość automatyczna
puste
Nieznany opcjonalny
Title3 title3

brak opisu

Domyślne
puste
Przykład
puste
Wartość automatyczna
puste
Nieznany opcjonalny
Description3 description3

brak opisu

Domyślne
puste
Przykład
puste
Wartość automatyczna
puste
Nieznany opcjonalny
Ikona type

zmienia ikonę widoczną po lewej stronie. Domyślnie jest to sound (dosł. dźwięk), dopuszczalne są także parametry speech (dla tekstu mówionego) oraz music (dla muzyki)

Domyślne
sound
Przykład
music
Wartość automatyczna
puste
Treść opcjonalny
Nagłówek header

pozwala na dodanie nagłówka do szablonu

Domyślne
puste
Przykład
Suity Chopina
Wartość automatyczna
puste
Treść opcjonalny
Pomoc help

jeśli podany w formie help=no, nie wyświetli się link do pomocy dot. plików multimedialnych, widoczny na dole

Domyślne
yes
Przykład
no
Wartość automatyczna
no
Wartość logiczna opcjonalny
Miniatura image

pozwala na określenie innego obrazu niż wskazany jako plik. Na przykład image=[[Plik:Example.jpg|50px]] wyświetli Plik:Example.jpg zamiast miniaturki podanego wideo. Można również ustawić none, wtedy miniaturka nie wyświetli się w ogóle.

Domyślne
puste
Przykład
Example.jpg
Wartość automatyczna
puste
Treść opcjonalny
Style style

Pozwala na podawanie dodatkowych parametrów stylu. Choćby float:none, float:none; clear:none (by dwa wywołania szablonu mogły występować obok siebie na stronie) itd.

Domyślne
puste
Przykład
float:none
Wartość automatyczna
Treść opcjonalny
Play play

niektóre pliki multimedialne nie dają się wyświetlić w miniaturze na stronie. W takiej sytuacji użyj parametru play=no

Domyślne
yes
Przykład
no
Wartość automatyczna
no
Wartość logiczna opcjonalny
Czysty plain

wyłącza większość stylu w szablonie. Jeśli podasz parametr w formie plain=yes, szablon wyświetli się bez ramki, ikony i linków do pomocy, a także bez osadzenia po lewej lub prawej (przydatne, jeśli chcesz osadzić szablon w konkretnym miejscu zdefiniowanym w polu "style" (na przykład style=float:right).

Domyślne
puste
Przykład
yes
Wartość automatyczna
Wartość logiczna opcjonalny
Osadź embed

w formie embed=yes służy dla łatwiejszego osadzenia go w innym szablonie, na przykład w infoboksie. Patrz przykłady poniżej.

Domyślne
no
Przykład
yes
Wartość automatyczna
yes
Wartość logiczna opcjonalny
Format pliku format

dawniej służył do podawania rozszerzenia pliku w formie linku do hasła o danym formacie. Obecnie nie wyświetla się, choć podanie go nie skutkuje wysypaniem się szablonu.

Domyślne
puste
Przykład
ogg
Wartość automatyczna
Treść przestarzały