Przejdź do zawartości

Szablon:Plik/opis

Z Wikibooks, biblioteki wolnych podręczników.

Użycie

[edytuj]

Szablon służy do wyświetlania plików multimedialnych różnego rodzaju. Przy podanym rozmiarze rysunek w tym szablonie jest responsywny.

Opis parametrów

[edytuj]
Pełny zestaw parametrów szablonu
  • rys - wywołanie pliku ma być użyte bez opakowań (bezpośrednio),
  • plik lub 1 - nazwa pliku multimedialnego,
  • ramka - możliwości: mały = thumb, duży = frame i bezramki = frameless, przykład: | ramka = mały, | ramka = duży lub | ramka = bezramki,
  • rozmiar - rozmiar podawany w pikselach, przykład: | rozmiar = 20px, | rozmiar = x20px lub | rozmiar = 30x20px,
  • pozycja - możliwości: lewo = left, prawo = right, centruj = center, przykład: | pozycja = lewo, | pozycja = prawo lub | pozycja = centruj,
  • auto - | auto = tak (gdy wartość tego parametru nie jest liczbą) w wywołaniu {{Plik|...|auto=tak|...}} jest równoważne {{Plik|...|ramka=mały|rozmiar=260px|pozycja=prawo|...}}, parametr ten przyjmujący wartość tak oznacza, że rozmiar pliku jest 260px,
    • Główne elementy tej zmiennej są oddzielone średnikami, a w ramach pierwszej wartości poboczne elementy są oddzielone przecinkami, tych wartości jest aż trzy, tzn.: pierwszy to numer rozmiaru, czyli x, a następne możemy nie podawać, a jak to zrobimy, to drugi to współczynnik kierunkowy a i trzeci to wartość początkowa prostej b, te wartości są do liczenia szerokości pliku y, domyślnymi wartościami są: a=20 i b=80, jeżeli ich nie podamy, lub któreś z nich, a jeżeli drugi element ma być nie ustalony, to piszemy go jako w formie auto, a trzeci w formie liczby,
      • Np.: | auto = 12 (Gdy wartość tego parametru jest liczbą), wtedy rozmiar pliku (w pikselach) jest liczony według wzoru: y=a*x+b, czyli ta wartość to jest nic innego, jak inna definicja parametru | rozmiar = ,
        • Numer rozmiaru, nie jako liczba, jeżeli podajemy tylko wysokość albo szerokość, bądż szerokość i wysokość, to to podajemy to w formie, np. 7x8, gdzie tam pierwsza liczba to szerokość, a druga wysokość, można tez podać: x8 lub też 7x (to tutaj to samo znaczy, co 7), lub możemy podać go w formie, np.: tak, wtedy jego wartością domyślną jest 9,
        • Szerokość i wysokość liczymy według tego samego wzoru, tak samo jak, gdy liczba ta jest tylko pojedyńcza liczbą,
      • Jeżeli chcemy podać podstawę liczenia szerokości i wysokości, tzn.: a i b, to podajemy dodatkowe wartości oddzielone przecinkami, oddzielone od tego głównego też nim, to mniej więcej wygląda w formie: 7,10,80, 7x6,10,80, 7,auto,80 (tutaj drugą wartością domyślną jest 20), 7x6,10 (lub 7x6,20,auto) (tutaj trzecią wartością domyślną jest 80),
    • Gdy wartość parametru ma dodatkowy po średniku element, czyli to jest, z tym, wartość parametru | auto = , ma on format: | auto = tak;-1, czy: | auto = 12;-1, to drugi parametr opisuje pozycję obrazka, tzn.: < 0 (np. -1) - to lewo, 0 - to centruj, a > 0 (np. 1) - to prawo (tej wartości nie trzeba podawać do listy wartości jako druga wartość tego parametru tego szablonu, ta wartość jest opcjonalna), czyli to jest nic innego, jak inna definicja parametru: | pozycja = ,
    • Przykładowymi wartościami tego parametru są: | auto = tak;-1, auto, | auto = 5;-1, | auto = 5,20,80;-1, | auto = 5,20,auto;-1, | auto = 5,auto,80;-1, | auto = 5x8,20,80;-1, | auto = x8,20,80;-1, | auto = 5x,20,80;-1,
    • Zawsze ten parametr dodaje domyślnie do parametrów szablonu parametr, o wartości: | ramka = mały,
  • skala - wielkość skali obrazka, a < 1 to zmniejszenie, a > 1 powiększenie, ale za to może być a = 1, to tożsamość, nie może być podawana z przecinkiem, tylko z kropką, w przypadku ułamków dziesiętnych, przykład: | skala = 0.6, | skala = 1.2 lub | skala = 1.0,
  • alt - tekst wyświetlany zamiast rysunku, jeżeli z jakiś powodów nie został on wyświetlony, przykład: | alt = Tekst zamiast obrazka,
  • link - po najechaniu na plik można przejść do strony wskazywaną przez ta zmienną po naciśnięciu na niego, przykład: | link = Szablon:Plik,
  • opis - opis pliku w ramce thumb (| ramka = mały), ale nie z frame, (| ramka = duży), lub opis w postaci dymku nad rysunkiem, jeżeli nie podano niepuste ramka, przykład | opis = Opis obrazka,
  • id - unikalny identyfikator ramki pliku,
  • styl - style kaskadowych arkuszy stylów CSS o niepustej zawartości, jeśli podany,
  • klasa - klasy reguł styli kaskadowych arkuszy stylów CSS o niepustej zawartości, jeśli podany.

Przykład

[edytuj]
Przykład
  • {{Plik|plik=Cyanocitta-cristata-004.jpg|ramka=mały|rozmiar=260px|pozycja=prawo|opis=Modrosójka błękitna}}
Modrosójka błękitna
Wywołanie równoważne do poprzedniego
  • {{Plik|plik=Cyanocitta-cristata-004.jpg|auto=tak|opis=Modrosójka błękitna}}
Modrosójka błękitna
  • {{Plik|plik=Cyanocitta-cristata-004.jpg|auto=9;1|opis=Modrosójka błękitna}}
Modrosójka błękitna
  • {{Plik|plik=Cyanocitta-cristata-004.jpg|auto=9,20,80;1|opis=Modrosójka błękitna}}
Modrosójka błękitna

Błędy

[edytuj]

Błędy należy zgłaszać na stronie Wikibooks:Kwestie techniczne.

Brak opisu.

Parametry szablonu[Zarządzaj danymi szablonu]

ParametrOpisTypStatus
plikplik 1

Nazwa pliku multimedialnego

Plikwymagany
ramkaramka

Możliwości: mały = thumb, duży = frame

Ciąg znakówopcjonalny
pozycjapozycja

Możliwości: lewo = left, prawo = right, centruj = center,

Ciąg znakówopcjonalny
rozmiarrozmiar

Rozmiar podawany w pikselach

Ciąg znakówopcjonalny
wielkośćwielkość

Wielkość skali pliku, a <1 to zmniejszenie, a >1 powiększenie, nie może być podawana z przecinkiem, tylko z kropką

Liczbaopcjonalny
linklink

Po najechaniu na plik można przejść do strony wskazywaną przez tą zmienną

Nazwa stronyopcjonalny
opisopis

Opis pliku w ramce thumb, ale nie z frame

Treśćopcjonalny

Zobacz też

[edytuj]
  • {{MapaObrazu}} - szablon tworzący mapę obrazu,
  • {{Rysunek}} - szablon stronicowy do wyświetlania rysunków z formatowanym opisem.