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:


 * .jpg lub .jpeg: obraz bitmapowy skompresowany w standardowym formacie JPEG (ten stratny format jest najbardziej odpowiedni do fotografii).
 * .png: obraz bitmapowy w formacie Portable Network Graphics (zdefiniowany przez Konsorcjum W3).
 * .gif: 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ń):


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


 * 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;
 * x{wysokość}px – Zmienia rozmiar obrazu, aby pasował do zadanej maksymalnej wysokości w pikselach, bez ograniczania szerokości;
 * {szerokość}x{wysokość}px – Zmienia rozmiar obrazu tak, aby pasował do danej szerokości i wysokości w pikselach;
 * 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ść).
 * Należy pamiętać, że obraz zawsze będzie zachowywał współczynnik proporcji i jego rozmiar może być tylko zmniejszony (nie zwiększony), chyba że jest to skalowalny typ mediów (obrazy bitmapowe nie mogą być powiększone).
 * 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;
 * 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) – Wyświetla obraz bez aktywnego łącza; np.   wygeneruje Example.jpg.


 * ! dla MW 1.24 i niżej: Jeśli ustawisz  (pusty), wtedy   zostanie wyświetlony. (Zobacz T23454.)
 * Inne specyficzne opcje:
 * alt={tekst alternatywny} – 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).
 * 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. 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.

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  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ć. The text flow can be stopped by placing   (or if you prefer,  ) before the text that should start below the floating image. (This may also be done without an empty line by wrapping the section with the floating images with …, which clears all floats inside the   element.)

All images rendered as blocks (including non-floating centered images, left- or right-floating images, as well as framed or thumbnailed floating images) are implicitly breaking the surrounding lines of text (terminating the current block of text before the image, and creating a new paragraph for the text after them). They will then stack vertically along their left or right alignment margin (or along the center line between these margins for centered images).

Zastępowanie domyślnego miejsca docelowego linku
The following table shows how to alter the link target (whose default is the image description page) or how to remove it. Changing the link does not alter the format described in the previous sections.

Ostrzeżenie:
 * The licencing requirements on your wiki may not allow you to remove all links to the description page that displays the required authors attributions, the copyrights statements, the applicable licencing terms, or a more complete description of the rendered image (including its history of modifications).
 * If you change or remove the target link of an image, you will then have to provide somewhere else on your page an explicit link to this description page, or to display the copyright and author statement and a link to the applicable licence, if they are different from the elements applicable to the embedding page itself.
 * Your wiki policy may restrict the use of the alternate link parameter, or may even enforce a prohibition of alternate link parameters for embedded media files (in which case, the link parameter will be ignored), or may only accept them after validation by authorized users or administrators.

Składnia galerii
It's easy to make a gallery of thumbnails with the  tag. The syntax is:

Mode parameter
Starting in 1.22 a  parameter is available, taking options as follows:


 * is the original gallery type used by MediaWiki.
 * is similar to, but with no border lines.
 * causes images to have the same height but different widths, with little space between the images. The rows in this responsive mode organize themselves according to the width of the screen.
 * shows the caption overlaid on the image, in a semi-transparent white box.
 * is similar to, but with the caption and box only showing up on hover.
 * creates a slideshow of the images.

Na przykład:

Gives (mode: packed-hover):

Optional gallery attributes
The gallery tag itself takes several additional parameters, specified as attribute name-value pairs:

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 style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </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:Wiki.png File:Wiki.png Wiki Wiki

Obtain a direct link to an image
To get a direct link to an image (bypassing the image's description page), some magic words 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 (with the exception of embedded links that would break the surrounding link): Example  rich   link text  here.

which renders as: 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 Currently, embedded images cannot be resized, but they 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.

Zobacz też

 * Wikipedia:Extended image syntax
 * Category:Wikipedia image help
 * Wikipedia:Picture tutorial
 * Wikipedia:Help:Gallery tag