Help:Images/pl

Ta strona objaśnia składnię dotyczącą wstawiania zdjęć podczas edycji wiki. Ty lub inny użytkownik musi najpierw przesłać obraz, zanim będzie można go użyć na stronie.

Zdjęcia przechowywane na serwerze MediaWiki są renderowane poprzez użycie prefiksu przestrzeni nazw  (ale można też użyć przestarzałego prefiksu przestrzeni nazw   jako synonim) jako elementu docelowego linku MediaWiki. Alternatywna przestrzeń nazw  może służyć do odwołania się do oryginalnej zawartości pliku multimedialnego (do wyświetlenia lub oddzielnego pobrania z dowolnej strony MediaWiki).

Obsługiwane typy plików obrazów
Poniższe formaty plików są domyślnie obsługiwane:


 * lub  - obraz bitmapowy skompresowany w standardowym formacie JPEG (ten stratny format jest najbardziej odpowiedni do fotografii).
 * - obraz bitmapowy w formacie Portable Network Graphics (zdefiniowany przez Konsorcjum W3).
 * - obraz bitmapowy w formacie Graphics Interchange Format.

Inne formaty stosowane w serwisie Wikimedia i powszechnie używane (w odróżnieniu od tych włączonych domyślnie, te mogą wymagać dodatkowych ustawień):


 * - Scalable Vector Graphics - format dwuwymiarowej grafiki wektorowej (autorstwa W3C). Zobacz Manual:Image Administration#SVG.
 * - Tagged Image File Format. Często używany do przechowywania zdjęć o wysokiej rozdzielczości. Zazwyczaj używany z.
 * ,,   - Pliki multimedialne Ogg (dźwięk lub wideo). Nie jest to format obrazu, lecz traktowany podobnie. Często używany z
 * - wielostronicowy dokument w formacie Portable Document Format (zapoczątkowany przez Adobe). Często używany w połączeniu z
 * - wielostronicowe dokumenty bitmapowe w formacie DejaVu (najczęściej skany książek). Zobacz
 * Tylko jedna strona pliku  lub   jest wyświetlana naraz.

Inne typy mediów mogą być obsługiwane, ale może nie być możliwe wyświetlanie ich bezpośrednio w treści.

Składnia
Pełna składnia wyświetlania obrazu ma postać:

gdzie options można pominąć, lub użyć jeden lub kilka z poniższych, oddzielonych kreską pionową (|):

Note: border can be used in combination with frameless but will be ignored if used with one of the other options.
 * Format – jeden z parametrów: border i/lub frameless, frame, thumb (lub thumbnail).
 * Definiuje sposób formatowania i osadzenia obrazu w pozostałej części strony.
 * Resizing – jeden z:
 * {szerokość}px – Zmienia rozmiar obrazu, aby pasował do zadanej maksymalnej szerokości w pikselach, bez ograniczania wysokości; ( Only whole-number pixel values are supported. A space character between the width value and "px" is permitted. )
 * x{wysokość}px – Zmienia rozmiar obrazu, aby pasował do zadanej maksymalnej wysokości w pikselach, bez ograniczania szerokości; Only whole-number pixel values are supported. A space character between the height value and "px" is permitted.
 * {szerokość}x{wysokość}px – Zmienia rozmiar obrazu tak, aby pasował do danej szerokości i wysokości w pikselach; Only whole-number pixel values are supported. A space character between the width value and "px" is permitted.
 * upright – Zmienia rozmiar obrazu tak, aby dopasować do rozsądnych wymiarów, stosownie do preferencji użytkownika (odpowiedni dla obrazów, których wysokość jest większa niż szerokość). Setting  will display the image at the user's default image width.  will display the image at double the user's default width.
 * The image will always retain its aspect ratio.
 * Images in non-scalable media types can be reduced in size, but not increased; e.g., bitmap images cannot be scaled up.
 * The  setting does not require an equals sign, i.e.   works the same as.
 * When used without a value or an equals sign (e.g., ), defaults to   (although   is the same as  )
 * Domyślny rozmiar maksymalny zależy od formatu i wewnętrznych wymiarów obrazu (w zależności od typu mediów).
 * Wyrównanie w poziomie – jeden z: left, right, center, none; If multiple of these options are present, only the first one will be used
 * Kontroluje wyrównanie poziome (oraz styl inline/block/floating) obrazu w tekście (brak wartości domyślnej).
 * Wyrównanie w pionie – jeden z: baseline, sub, super, top, text-top, middle, bottom, text-bottom;
 * Kontroluje wyrównanie pionowe nie pływającego (non-floating) obrazu w wierszu z tekstem przed lub za obrazem i w tym samym bloku (domyślne wyrównanie w pionie jest do środka).
 * Link – jeden z:
 * link={cel} – Umożliwia zmianę celu (do dowolnego tytułu strony lub adresu URL) wygenerowanego łącza, aktywowanego na renderowanej powierzchni obrazu; np.  przedstawi Example.jpg (odnośnik zewnętrzny), a   wyświetli Example.jpg (odnośnik wewnętrzny).
 * link= (bez wartości) – (MediaWiki 1.14+) Wyświetla obraz bez aktywnego łącza; np.  wygeneruje Example.jpg.
 * If there is a space character between  and the equals sign, the link statement will be treated as a caption.
 * Including some HTML character equivalents, like  for , can cause the link statement to be treated as a caption (see T306216).


 * ! dla MW 1.24 i niżej: Jeśli ustawisz  (pusty), wtedy   zostanie wyświetlony. (Zobacz T23454.)
 * Inne specyficzne opcje:
 * alt={tekst alternatywny} – (MediaWiki 1.14+) Definiuje alternatywny tekst (odwzorowuje atrybut HTML  generowanego elementu  ) obrazu, który zostanie wyświetlony, jeśli nie można pobrać i osadzić obrazu docelowego, lub jeśli musi używać alternatywnego opisu (na przykład podczas korzystania z czytnika brajlowskiego lub z ustawionymi przez użytkownika ułatwieniami dostępu w swojej przeglądarce).
 * If there is a space character between  and the equals sign, the alt statement will be treated as a caption.
 * page={numer} — Wyświetla określony numer strony (obecnie obowiązuje tylko przy wyświetlaniu pliku .djvu lub .pdf).
 * class={html class} — (MediaWiki 1.20+) Definiuje klasy (odwzorowuje atrybut HTML  generowanego elementu ).
 * lang={kod języka} — (MediaWiki 1.22+) Dla plików SVG zawierających deklarację &lt;switch&gt; przechowującą atrybut systemLanguage, wybiera język do renderowania pliku. Domyślnie jest zawsze język angielski, nawet w przypadku nie anglojęzycznych wiki.

Jeśli parametr nie pasuje do innych możliwości, przyjmuje się, że jest to tekst podpisu. If more than one non-parameter string is present, the final non-parameter string will be used as the caption. Tekst podpisu znajduje się pod obrazem w przypadku formatu thumb i frame formats, lub jako tekst podpowiedzi w przypadku pozostałych formatów. Tekst podpisy wyświetlony w formacie thumb i frame może zawierać łącza wiki i inne formatowanie. Rozszerzenia MediaWiki mogą dodawać dodatkowe opcje.

Jeśli nie podano parametru 'alt' i zostanie dodany podpis, automatycznie zostanie utworzony alternatywny tekst z podpisu, pozbawiony formatowania, chyba że obraz jest w trybie thumb lub frame, ponieważ podpis jest już widoczny dla czytających w tym przypadku.

Format
Poniższa tabela pokazuje efekty wszystkich dostępnych sposobów formatowania.

Gdy wysokość zdjęcia w miniaturze jest większa niż jego szerokość (tj. w orientacji pionowej zamiast poziomej) i uważasz, że jest zbyt duża, możesz wypróbować opcję ,gdzie N jest współczynnikiem kształtu obrazu (szerokość podzielona przez jego wysokość, domyślnie 0,75). Alternatywą jest precyzyjne określenie pożądanej maksymalnej wysokości (w pikselach).

Zauważ, że pisząc, możesz użyć innego obrazu dla miniatury.

Rozmiar i obramowanie
Wśród innych formatów, efekt parametru rozmiaru może być różny niż pokazany poniżej.


 * Jak wygląda, gdy jego rozmiar nie jest określony, zobacz powyższą sekcję formatu.
 * Gdy format nie jest określony lub tylko ed, rozmiar można zmniejszyć i powiększyć do dowolnego określonego rozmiaru.
 * W przykładach poniżej oryginalny rozmiar obrazu wynosi 400 x 267 pikseli.
 * Obraz z  zawsze ignoruje specyfikację rozmiaru, oryginalny obraz zostanie zredukowany, jeśli będzie przekraczać maksymalny rozmiar podany w preferencjach użytkownika.
 * Rozmiar obrazu z  ou   może być zredukowany, ale nie powiększony powyżej oryginalny rozmiar tego obrazu.

Wyrównanie w poziomie
Zauważ, że przy użyciu formatów  lub , standardowe wyrównanie w poziomie będzie.

Wyrównanie w pionie
Opcje wyrównania w pionie są stosowane tylko wtedy, gdy obraz jest renderowany jako element wstawiany i nie jest zmienny. Zmieniają one sposób, w jaki wstawiony obraz będzie wyrównany w pionie z tekstem znajdującym się w tym samym bloku przed i/lub po tym obrazie w tym samym renderowanym wierszu.

Zwróć uwagę, że renderowany wiersz tekstu, w którym wstawiane są obrazy (oraz linie tekstu renderowanego po bieżącym) może zostać przesunięty w dół (to spowoduje zwiększenie linii o określoną odległość poprzez dodatkowe odstępy między wierszami, tak jak to może wystąpić w przypadku rozpiętości tekstu ze zmiennymi rozmiarami czcionek lub z indeksami górnymi i dolnymi), aby umożliwić pełne wyświetlanie wysokości obrazu za pomocą tego ograniczenia wyrównania.



Aby wyraźniej pokazać wynik wyrównania, zakresy tekstu są powiększone i podkreślone, rozmiar czcionki zostaje zwiększony do 200%, a blok akapitu jest obrysowany cienką ramką; dodatkowo obrazy o różnych rozmiarach są wyrównane:

 text top: text

 text text-top: text

 text super: text

 text baseline: text

 text sub: text

 text default: text

 text middle: text

 text text-bottom: text

 text bottom: text

Uwagi:


 * 1) "Środkowa" pionowa pozycja wyrównania obrazu (która również jest domyślna) zazwyczaj odnosi się do środka między x-heigh a linią bazową tekstu (na którym wyrównany zostanie pionowy środek obrazu, i na którym zazwyczaj tekst może być nadpisywany), ale nie w środku linii wysokości font-height, która odnosi się do przestrzeni między pozycjami "tekst-góra" i "tekst-dół"; wysokość font-height nie obejmuje:
 * 2) * dodatkowy odstęp separacji linii zwykle podzielony równo na dwa marginesy linii (tutaj 0.5em, zgodnie z line-height ustawionej na 200%) powyżej i poniżej wysokości czcionki).
 * 3) * dodatkowe odstępy między wierszami, które mogą być dodawane przez indeksy górne i dolne.
 * 4) Jeśli jednak wysokość obrazu powoduje, że jego górna lub dolna pozycja przekracza normalną pełną wysokość linii tekstu, położenie środkowe zostanie dostosowane po zwiększeniu marginesów górnego i/lub dolnego wiersza, aby obraz mógł dopasuj i wyrównaj poprawnie, a wszystkie obrazy (w tym te o mniejszych wysokościach) będą wyśrodkowane w pionie na ustawionej środkowej pozycji (w celu obliczenia efektywnej wysokości linii uwzględniony zostanie tekst każdego renderowanego wiersza z większą wysokością czcionki).
 * 5) Pozycje wyrównania "tekst-góra" i "tekst-dół" również wykluczają dodatkowy odstęp między wierszami dodany przez indeks górny i indeks dolny, ale nie dodatkowy odstęp między liniami zdefiniowany przez wysokość linii/line-height.
 * 6) Pozycje wyrównania "góra" i "dół" uwzględniają wszystkie te dodatkowe odstępy między wierszami (w tym indeksy górne i dolne, jeśli występują w renderowanym przedziale wierszy). Kiedy wyrównanie obrazu ogranicza obraz do wzrostu powyżej lub poniżej normalnego odstępu między wierszami, a obraz nie jest w pełni umiejscowiony, obraz spowoduje zmianę pozycji "górny" i "dolny" (podobnie jak indeks górny i dolny), więc efektywna wysokość linii między renderowanymi liniami tekstu będzie wyższa.
 * 7) Pozycje do dekoracji tekstu "podkreśl/underline", "overline" i "overstrike" powinny znajdować się gdzieś w obrębie tych dwóch limitów i "może" zależą od rodzaju i wysokości użytych czcionek (można uwzględnić style górnego i dolnego indeksu w niektórych przeglądarkach, ale zazwyczaj te style są ignorowane, a pozycja tych dekoracji może nie być dostosowywana); więc dekoracje te zwykle nie wpływają na pionową pozycję obrazów, w stosunku do tekstu.

Zatrzymywanie przepływu tekstu
Czasami pożądane jest zatrzymanie tekstu (lub innych niewypływających obrazów w linii) wokół ruchomego obrazu. W zależności od rozdzielczości ekranu przeglądarki internetowej i tak, przepływ tekstu po prawej stronie obrazu może powodować nagłówek sekcji (na przykład == Mój nagłówek == ) pojawia się po prawej stronie obrazu, zamiast pod nim, jak można byłoby oczekiwać. Przepływ tekstu można zatrzymać, umieszczając   (lub jeśli wolisz, ) przed tekstem, który powinien rozpocząć się pod obrazem ruchomym. (Można to zrobić również bez pustej linii, owijając sekcję ruchomymi obrazami za pomocą, który usuwa wszystkie elementy pływające wewnątrz elementu  .)

Wszystkie obrazy renderowane jako bloki (w tym niepływające środkowe obrazy, lewe- lub prawe-pływające obrazy, a także framed or thumbnail floating images) niejawnie łamie otaczające linie tekstu (kończy bieżący blok tekstu przed obrazem i tworzy nowy akapit dla tekstu za nimi). Następnie będą układać stos w pionie wzdłuż lewego lub prawego marginesu wyrównania (lub wzdłuż linii środkowej między tymi marginesami dla obrazów "środkowych").

Zastępowanie domyślnego miejsca docelowego linku
Poniższa tabela pokazuje, jak zmienić cel łącza (którego domyślną stroną jest strona opisu obrazu) lub jak go usunąć. Zmiana linku nie zmienia formatu opisanego w poprzednich sekcjach.

Ostrzeżenie:
 * Wymagania licencyjne na wiki mogą nie zezwalać na usunięcie wszystkich linków do strony opisu, która wyświetla wymagane atrybuty autorów, oświadczenia dotyczące praw autorskich, odpowiednie warunki licencjonowania lub dokładniejszy opis renderowanego obrazu (w tym historię modyfikacji).
 * Jeśli zmienisz lub usuniesz docelowy link obrazu, będziesz musiał podać gdzieś na swojej stronie wyraźny link do tej strony opisu lub wyświetlić oświadczenie o prawach autorskich i autorze oraz link do odpowiedniej licencji, jeśli są one różni się od elementów mających zastosowanie do samej strony osadzania.
 * Twoje zasady wiki mogą ograniczać użycie alternatywnego parametru łącza, a nawet mogą wymuszać zakaz alternatywnych parametrów łącza dla osadzonych plików multimedialnych (w takim przypadku parametr łącza zostanie zignorowany) lub mogą je zaakceptować tylko po zatwierdzeniu przez upoważnionych użytkowników lub administratorzy.

Składnia galerii
Łatwo zrobić galerię miniatur z tagiem. Składnia jest następująca:

Zwróć uwagę, że kod obrazu nie jest ujęty w nawiasy, gdy jest zawarty w tagach galerii.

Napisy są opcjonalne i mogą zawierać linki do wiki lub inne formatowanie.

Niektóre parametry kontrolujące wyjście thumb również mogą być użyte tutaj, w szczególności te, które modyfikują plik (w przeciwieństwie do tych, które kontrolują, gdzie na stronie ląduje obraz). Na przykład w przypadku multimediów wielostronnych, takich jak pliki PDF, można użyć kodu takiego jak.

Prefiks  można pominąć. However, it is helpful to include it as an aid for quickly locating image specifiers in the wikitext (for example, when cleaning up page layout).

Na przykład:

jest sformatowany jako:

Parametr trybu
Począwszy od wersji 1.22 dostępny jest tryb $mode, który przyjmuje następujące opcje:

Wiersze w tym trybie responsive organizują się zgodnie z szerokością ekranu.
 * $traditional jest oryginalnym typem galerii używanym przez MediaWiki.
 * $nolines jest podobny do tradycyjnego/$traditional, ale bez linii granicznych.
 * $packed powoduje, że obrazy mają taką samą wysokość, ale różne szerokości, z niewielką przestrzenią pomiędzy obrazami.
 * $overlay pokazuje podpis nałożony na obraz, w półprzezroczyste białe pudełko.
 * $hover jest podobny do $overlay, ale z podpisem i polem wyświetlanym tylko po najechaniu myszą.
 * $slideshow tworzy pokaz slajdów z obrazów.

Na przykład:

Daje (tryb: ):

Opcjonalne atrybuty galerii
Sam tag galerii pobiera kilka dodatkowych parametrów, określonych jako atrybut nazwa-wartość/name-value pary:


 * : (tekst podpisu między podwójnymi cudzysłowami dla więcej niż jednego słowa) ustawia napis wyśrodkowany na galerii. W podpisie można używać wyłącznie zwykłego tekstu; formatowanie, szablony itp. nie będą działać.
 * : ustawia (max) szerokości obrazów; default value to 120px. Zwróć uwagę na liczbę mnogą: widths/szerokości.
 * : ustawia (max) wysokości obrazów; domyślna wartość to 120 pikseli.
 * : ustawia liczbę obrazów w rzędzie. 0 oznacza automatyczną regulację na podstawie szerokości ekranu.
 * : Pokaż nazwy plików obrazów w poszczególnych napisach dla każdego obrazu (1,17+).
 * : Zobacz sekcję powyżej (1.22+, 1.28+ dla "pokazu slajdów/slideshow").
 * : For "slideshow" mode only, display the strip with image thumbnails below the slideshow by default (1.29+).


 * Example 1

Syntax:

Result:

Row of images that will wrap to browser width
One way that works for a row of images with varying widths is not to use "thumb" or "left" or "none". If "thumb" is not used (and thus no captions) a row of images will wrap to the browser width. If necessary, narrow the browser window to see the images wrap to the next row.





To wrap images of varying widths with captions it is necessary to use div HTML for an unordered list. Along with. For more info and ideas see: Give Floats the Flick in CSS Layouts.

        </li>  </li>  </li>  </li>  </li> </ul>

To align the top edge of images add the vertical-align command

<ul>  </li>  </li>  </li>  </li>  </li>  </li>  </li>  </li> </ul>

Some wiki farms do not have all gallery options (such as "widths"). Also, sometimes one wants varying widths for images in a row. Outside of a gallery, or the div HTML, it is impossible to have individual captions for images in a row of images that will wrap to the browser width. Try it and see. Nothing else using wikitext works correctly. Images will either overlap stuff on the right, or force a horizontal scroll bar.

Using a left float ("left") for some images, combined with "none" for some of the images, will not work consistently either, especially if there is also a right sidebar of images. Weird things will occur. At narrower browser or screen widths an image out of the row may appear far down the page after the end of the right sidebar of images.

Link behavior
By default an image links to its file description page. The "link=" option modifies this behavior to link to another page or website, or to turn off the image's linking behavior.

Alternatively, you can create a text link to a file description page or to the file itself. Zobacz.

Display image, link it to another page or website
Use "link=" option to link image to another page or website:

Clicking on the below image will take you to MediaWiki:





Clicking on the below image will take you to example.com:





Display image, turn off link
Use "link=" option with no value assigned to turn link off entirely; the below image is not a link:





Link to an image
Add  as a prefix to the link you need to create.

File:MediaWiki-2020-logo.svg File:MediaWiki-2020-logo.svg Wiki Wiki

Directly linking to an image
The above examples link to the image's description page. To directly link to an image, the pseudo-namespace  can be used on MediaWiki pages:

[[Media:MediaWiki-2020-logo.svg]]

Direct links from external sites
Another possibility is to use the Special:Redirect/file page (or its alias Special:Filepath). Unlike the above example, you can link to it from external websites as well as from MediaWiki pages.

The parameters  and   can also be added to return a specific size of the image. The image aspect ratio is always preserved.

Obtaining the full URL of an image
To obtain the full path of an image (without going through redirects as shown above), some can be used.

Becomes:



In the event that this is used from a template where the  namespace needs to be removed,   can do so:

Becomes:



Wymagania
Before using images in your page, the system administrator of your wiki must have enabled file uploads and a user has to upload the file. System administrators may also set the wiki to accept files from foreign repositories, such as the Wikimedia Commons. For server side image resizing it is necessary to have a scaler configured (such as GD2, ImageMagick, etc.).

Files at other websites
You can link to an external file available online using the same syntax used for linking to an external web page. With these syntaxes, the image will not be rendered, but only the text of the link to this image will be displayed.



Or with a different displayed text:

link text here

Additional MediaWiki markup or HTML/CSS formatting (for inline elements) is permitted in this displayed text (except for embedded links that would break the surrounding link):

Example  rich   link text  here.

which renders as: [http://www.example.com/some/image.png Example  rich   link text  here. ]

If it is enabled on your wiki (see ), you can also embed external images. To do that, simply insert the image's URL: http://url.for/some/image.png Embedded images can be resized by the CSS  property. They also may be formatted by surrounding MediaWiki markup or HTML/CSS code.

If this wiki option is not enabled, the image will not be embedded but rendered as a textual link to the external site, just like above, unless the site's has a value.

Zobacz też

 * Wikipedia:Extended image syntax
 * Category:Wikipedia image help
 * Wikipedia:Picture tutorial
 * w:Help:Gallery tag
 * T113101 - responsive issues
 * Extension:PageImages
 * Extension:PageImages