Szablon:Listen

Z Wikipedii, wolnej encyklopedii
Przejdź do nawigacji Przejdź do wyszukiwania
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 kod]

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 kod]

{{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 kod]

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 kod]

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 kod]

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 kod]

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.

ParametrOpisTypStatus
Plikfilename

Nazwa pliku, bez przedrostka Plik:

Domyślne
puste
Przykład
Chopin-Etiuda Ges-dur-Greiss.ogg
Wartość automatyczna
puste
Plikwymagany
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
Opisdescription

Opis/podpis pliku

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

Domyślnie right, akceptuje również left

Domyślne
right
Przykład
left
Wartość automatyczna
left
Wartość logicznaopcjonalny
Altalt

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 2filename2

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
Plikopcjonalny
Title2title2

brak opisu

Domyślne
puste
Przykład
puste
Wartość automatyczna
puste
Nieznanyopcjonalny
Alt2alt2

brak opisu

Domyślne
puste
Przykład
puste
Wartość automatyczna
puste
Nieznanyopcjonalny
Description2description2

brak opisu

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

Nazwa trzeciego pliku, bez przedrostka Plik:

Domyślne
puste
Przykład
Przykład.wmv
Wartość automatyczna
puste
Plikopcjonalny
Alt3alt3

brak opisu

Domyślne
puste
Przykład
puste
Wartość automatyczna
puste
Nieznanyopcjonalny
Title3title3

brak opisu

Domyślne
puste
Przykład
puste
Wartość automatyczna
puste
Nieznanyopcjonalny
Description3description3

brak opisu

Domyślne
puste
Przykład
puste
Wartość automatyczna
puste
Nieznanyopcjonalny
Ikonatype

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łówekheader

pozwala na dodanie nagłówka do szablonu

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

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ść logicznaopcjonalny
Miniaturaimage

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
Stylestyle

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
Playplay

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ść logicznaopcjonalny
Czystyplain

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ść logicznaopcjonalny
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ść logicznaopcjonalny
Format plikuformat

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