Справка:Изображения

This page is a translated version of the page Help:Images and the translation is 97% complete.

Outdated translations are marked like this.

Примечание: Редактируя эту страницу, вы соглашаетесь на передачу своего вклада по лицензии CC0.
Подробнее — в проекте Помощь с общественным достоянием.

На этой странице объясняются особенности синтаксиса средств размещения изображений. Прежде чем использовать изображение нужно, чтобы вы или кто-то другой загрузил его.

Изображения, хранящиеся на сервере MediaWiki, как правило можно вставить как вики-ссылку, используя префикс пространства имён «File:» (для целей совместимости с прошлыми версиями поддерживается также префикс «Image:»). Альтернативный префикс пространства имён Media:, используется для ссылки на исходный медиафайл (для отдельного предоставления или скачивания с любой страницы MediaWiki).

Необходимые условия

Перед использованием изображений на странице, системный администратор вашего вики-сайта должен разрешить закачку файлов, после чего пользователи должны загрузить нужные файлы. Системные администраторы могут также настроить вики-сайт на приём файлов из внешних хранилищ, таких как Викисклад. Для изменения размера изображения на стороне сервера используются библиотеки программ (таких как GD2, ImageMagick и пр.)

Поддерживаемые медиа-типы изображений

Следующие форматы файлов поддерживаются по умолчанию:

.jpg или .jpeg - сжатое растровое изображение в стандартном формате JPEG (формат с потерями, лучше всего подходит для фотографий).
.png - растровое изображение в формате Portable Network Graphics (специфицирован консорциумом W3).
.gif - растровое изображение в формате Graphics Interchange Format. Считается устаревшим.
.webp - Для WebP поддерживаются режимы сжатия как с потерями, так и без потерь при уменьшении размера изображения до 45%.

Другие форматы, используемые Wikimedia, и обычно включаемые в других проектах (Они могут требовать установки дополнительных модулей сверх того, что включено по умолчанию):

.svg - масштабируемое изображение в формате Standard Vector Graphics (специфицирован консорциумом W3). См. Manual:Image_Administration#SVG.
.tiff - Tagged image format (TIFF) Часто используется для архивных фотографий с высоким разрешением. Обычно используется в сочетании с расширением Extension:PagedTiffHandler .
.ogg, .oga, .ogv - Медиа-контейнер ogg (аудио или видео). Не формат изображений, но обрабатывается аналогично. Обычно используется в сочетании с расширением Расширение:TimedMediaHandler .
.pdf - многостраничный документ в формате Portable Document Format (первоначально специфицирован компанией Adobe). Часто используется в сочетании с расширением Расширение:PdfHandler .
.djvu - многостраничный растровый документ в формате DejaVu (чаще всего, сканы книг). См. также Manual:How to use DjVu with MediaWiki .
У файлов .pdf и .djvu показывается только одна страница.

Могут поддерживаться также и другие форматы медиафайлов, но их встроенное отображение может оказаться невозможным.

Отображение одного изображения

Синтаксис

Полный синтаксис для отображения изображения:

[[File:имя_файла.расширение|опции|подпись]]

где различные опции могут быть не заполнены или содержать одно или несколько из следующих слов в нижнем регистре, разделённых вертикальной чертой (|):

Опция форматирования: border, или один из frameless, frame (или framed), или thumb (или thumbnail). Note: border can be used in combination with frameless but will be ignored if used with one of the other options.
Форматирует изображение и определяет, как оно будет расположено в оставшейся части страницы.
Изменить размеры можно одной из следующих опций:
- {ширина}px — изменяет размер изображения в соответствии с заданной максимальной шириной в пикселях, не ограничивая его высоту. (Поддерживаются только целые значения размера в пикселях. Разрешается отделять «px» от числа пробелом.)
- x{высота}px — изменяет размер изображения в соответствии с заданной максимальной высотой в пикселях, не ограничивая его ширину. Поддерживаются только целые значения размера в пикселях. Разрешается отделять «px» от числа пробелом.
- {ширина}x{высота}px — изменяет размер изображения в соответствии с заданной шириной и высотой в пикселях. Поддерживаются только целые значения размера в пикселях. Разрешается отделять «px» от числа пробелом.
- upright — Корректирует размеры изображения на основе сочетания заданных пользователем в своих настройках размеров для миниатюр (или согласно размеру миниатюр по умолчанию для неавторизованных пользователей, или тех, кто не менял базовые настройки), чтобы оно соответствовало разумным значениям. Эта опция часто полезна для изображений, высота которых больше их ширины. Требуется указать thumb или frameless. С параметром |upright=1.0| отобразится изображение, ширина которого задана в пользовательских настройках. С параметром |upright=2.0| ширина изображения станет вдвое больше заданной в настройках.
При этом соотношение сторон в изображении не меняется.

Немасштабируемые форматы изображений возможно только уменьшать, но не увеличивать, т.е. растровые изображения невозможно отобразить размером больше, чем разрешение загруженных файлов.

Параметр «upright» не требует обязательного знака равенства, т.е. «|upright 2.0|» работает так же, как и «|upright=2.0|».

Указание параметра без знака равенства и значения его величины (т.е. «|upright|») равнозначно «|upright=0.75|», в то время как «|upright=|» отображается как «|upright=1.0|».

По умолчанию, максимальный размер зависит от значения format и внутренних размеров изображения (в зависимости от его типа).
Выравнивание по горизонтали — допускаются значения «left», «right», «center» и «none»; Если значение параметра задано несколько раз, учитывается только первое
Определяет горизонтальное выравнивание (и значения inline/block или floating) изображения в пределах текста. Не имеет значения по умолчанию.
Выравнивание по вертикали — допускаются значения «baseline», «sub», «super», «top», «text-top», «middle», «bottom» и «text-bottom»
Определяет вертикальное выравнивание невсплывающего изображения в блоке текста. По умолчанию вертикально выравнивается по центру (middle).
Ссылки регулируются следующими опциями:
- link={цель} — позволяет перенаправлять (на заголовок произвольной статьи или URL) ссылку, связанную с изображением; например, [[File:Example.jpg|20px|link=http://www.wikipedia.org]] отображается как (внешняя ссылка), или [[File:Example.jpg|20px|link=MediaWiki]] отображается как (внутренняя ссылка).
- link= (с пустым значением) — (MediaWiki 1.14+) показывает изображение без связанной ссылки; например, [[File:Example.jpg|20px|link=]] отображается как .
Если между «link» и знаком равенства будет пробел, конструкция будет обработана как подпись.

Также ссылка будет обработана как подпись, если в её тексте встретится мнемоника HTML, например «%22» вместо «"» (см. phabricator:T306216).

! Для MW 1.24 и ниже: Если указать |link=| (с пустым значением), то title не будет отображаться. (См. phabricator:T23454.)
Прочие опции:
- alt={альтернативный текст} — (MediaWiki 1.14+) определяет альтернативный текст (интерпретируется как HTML-атрибут alt="..." элемента ‎<img />), который будет показан вместо изображения в случае неудачи при его загрузке или попытке встроить в статью, а также в случае необходимости указывать альтернативное описание (например, при использовании читателем шрифта Брайля и других специальных возможностей, установленных в его браузере).
Если между «alt» и знаком равенства будет пробел, конструкция будет обработана как подпись.
- page={number} — Отображает страницу с указанным номером (в настоящее время применяется только при показе файлов .djvu или .pdf).
- thumbtime={number} — Выводит миниатюру в виде стоп-кадра из видео с указанной временной меткой в секундах или в формате ММ:СС или ЧЧ:ММ:СС (применимо только при показе видеофайла).
- start={number} — При запуске воспроизведения видео, оно начнётся с указанной временной метки в секундах или в формате ММ:СС или ЧЧ:ММ:СС (применимо только при показе видеофайла).
- muted — Когда начнётся воспроизведение медиафайла, звук будет отключён.
- loop — Медиафайл будет воспроизводиться непрерывно. (относится только к аудио и видео)
- lossy={false} — (PagedTiffHandler ) Для использования миниатюр в формате PNG вместо JPG для изображений в формате Tiff
- class={html class} — (MediaWiki 1.20+)Определяет классы (интерпретируется как HTML-атрибут class="..." генерируемого элемента ‎<span>...‎</span>, обрамляющего элемент ‎<img />).
  Поведение по умолчанию начиная с MediaWiki 1.40, опционально — с MediaWIKI 1.36.^[1] Ранее класс применялся непосредственно к элементу ‎<img />.^[2]
- lang={language code} — (MediaWiki 1.22+) Для файлов SVG, содержащих элементы <switch> с различными атрибутами systemLanguage, определяет язык, на котором файл будет отображаться. По умолчанию — всегда английский, даже в не-англоязычных разделах ВП.

Если параметр не соответствует ни одному из возможных, предполагается, что это подпись. Если задано больше одного значения, которое не будет распознано как параметр, в качестве подписи будет использовано последнее. Текст подписи отображается ниже изображения в форматах thumb и frame, или как текст подсказки в других форматах. Текст подписи в форматах thumb и frame может содержать вики-ссылки и другие элементы форматирования. Расширения MediaWiki могут добавлять дополнительные опции.

Если 'alt' не указан, а подпись задана, то из подписи будет автоматически создан альтернативный текст без форматирования — исключая случаи, когда используется thumb или frame, поскольку в этом случае подпись уже доступна для чтения.

Формат

Следующая таблица показывает эффект от применения всех доступных форматов.

Описание	Вы вводите	Результат
формат не определён Плавающее изображение: нет В строке: да Подпись: нет	... текст текст текст [[File:example.jpg\|подпись]] текст текст текст ...	... текст текст текст текст текст текст ...
рамка, даёт в результате тонкую серую рамку Плавающее изображение: нет В строке: да Подпись: нет	... текст текст текст [[File:example.jpg\|border\|подпись]] текст текст текст ...	... текст текст текст текст текст текст ...
без врезки, то же, что миниатюра, но с шириной, установленной в персональных настройках, без полей и без выравнивания по правому краю Плавающее изображение: нет В строке: да Подпись: нет	... текст текст текст [[File:example.jpg\|frameless\|подпись]] текст текст текст ...	... текст текст текст текст текст текст ...
без врезки, но с рамкой Плавающее изображение: нет В строке: да Подпись: нет	... текст текст текст [[File:example.jpg\|frameless\|border\|подпись]] текст текст текст ...	... текст текст текст текст текст текст ...
frame Плавающее изображение: да В строке: нет Подпись: да	... текст текст текст [[File:example.jpg\|frame\|подпись]] текст текст текст ...	... текст текст текст подпись текст текст текст ...
врезка, обеспечивает поля, рамку и отображение подписи под изображением Плавающее изображение: да В строке: нет Подпись: да	... текст текст текст [[File:example.jpg\|thumb\|подпись]] текст текст текст ...	... текст текст текст подпись текст текст текст ...

Когда высота изображения в виде миниатюры больше, чем его ширина (то есть портретная ориентация, а не альбомная), и вы найдете его слишком большим, вы можете попробовать параметр upright=N, который будет пытаться отрегулировать его размер лучше, за счет уменьшения высоты, а не ширины (N — масштаб изображения в десятичных долях, по умолчанию 0,75). В качестве альтернативы можно указать желаемую максимальную высоту (в пикселях) в прямой форме.

Обратите внимание, что написав thumb={имя файла}, вы можете использовать для миниатюры совсем другое изображение.

Размер и рамка

Среди различных форматов, параметры размера могут быть разными, как показано ниже.

О том, как отображается, если его размер не указан, см. раздел «Формат» выше.
Если формат не указан, или указан только border, размер может быть уменьшен и расширен с любым заданным размером.
В примерах ниже, оригинальный размер изображения составляет 400 × 267 пикселей.
Изображение с frame всегда игнорирует указанный размер, исходное изображение будет уменьшено, если оно превышает максимально допустимый размер определенный в пользовательских настройках, и в информации о странице будет отображаться ошибка Linter.
Размер изображения с thumb или frameless может быть уменьшен, но не может быть увеличен за пределы первоначального размера изображения.

Формат	Уменьшенный	Увеличенный
(не определено)	[[File:example.jpg\|50px]]	[[File:example.jpg\|500px]]
border	[[File:example.jpg\|border\|50px]]	[[File:example.jpg\|border\|500px]]
frame	[[File:example.jpg\|frame\|50px]]	[[File:example.jpg\|frame\|500px]]
thumb	[[File:example.jpg\|thumb\|50px]]	[[File:example.jpg\|thumb\|500px]]
frameless	[[File:example.jpg\|frameless\|50px]]	[[File:example.jpg\|frameless\|500px]]

Горизонтальное выравнивание

Заметьте, что при использовании frame или thumb[nail], по умолчанию изображение выравнивается по концу строки: то есть по правому краю для европейских языков и по левому — для языков с письмом справа-налево.

Описание	Вы вводите	Результат
выравнивание не определено, действуют значения по умолчанию Плавающее изображение: нет В строке: да	... текст текст текст [[File:example.jpg\|100px\|подпись]] текст текст текст ...	... текст текст текст текст текст текст ...
выравнивание задано как отсутствующее Плавающее изображение: нет В строке: нет	... текст текст текст [[File:example.jpg\|none\|100px\|подпись]] текст текст текст ...	... текст текст текст подпись текст текст текст ...
задано выравнивание по центру Плавающее изображение: нет В строке: нет	... текст текст текст [[File:example.jpg\|center\|100px\|подпись]] текст текст текст ...	... текст текст текст подпись текст текст текст ...
задано выравнивание по левому краю Плавающее изображение: да В строке: нет	... текст текст текст [[File:example.jpg\|left\|100px\|подпись]] текст текст текст ...	... текст текст текст подпись текст текст текст ...
задано выравнивание по правому краю Плавающее изображение: да В строке: нет	... текст текст текст [[File:example.jpg\|right\|100px\|подпись]] текст текст текст ...	... текст текст текст подпись текст текст текст ...

Вертикальное выравнивание

Параметры вертикального выравнивания вступят в силу только тогда, когда изображение будет отображено как встроенный элемент, а не плавающий. Они изменяют способ встраивания изображения по вертикали в текст, присутствующий в том же разделе до и/или после этого изображения, отображаемого в одной строке с текстом.

Обратите внимание, что отображённые строки текста, где вставляется изображение (и строки текста отображённые после) могут быть перемещены вниз (это приведет к увеличению высоты строки за счёт увеличения межстрочного интервала; таким же образом, как это может произойти с фрагментами текста, содержащего шрифт разного кегля, или верхние и нижние индексы), чтобы высота изображения была полностью отображена согласно этим ограничениям.

Показать исходный код

<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''top:''' [[File:Example.jpg|20px|top]] [[File:Example.jpg|40px|top]] [[File:Example.jpg|100px|top]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-top:''' [[File:Example.jpg|20px|text-top]] [[File:Example.jpg|40px|text-top]] [[File:Example.jpg|100px|text-top]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sup>super:</sup> [[File:Example.jpg|20px|super]] [[File:Example.jpg|40px|super]] [[File:Example.jpg|100px|super]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''baseline:''' [[File:Example.jpg|20px|baseline]] [[File:Example.jpg|40px|baseline]] [[File:Example.jpg|100px|baseline]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sub>'''sub:'''</sub> [[File:Example.jpg|20px|sub]] [[File:Example.jpg|40px|sub]] [[File:Example.jpg|100px|sub]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''default:''' [[File:Example.jpg|20px]][[File:Example.jpg|40px]] [[File:Example.jpg|100px]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''middle:''' [[File:Example.jpg|20px|middle]] [[File:Example.jpg|40px|middle]] [[File:Example.jpg|100px|middle]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-bottom:''' [[File:Example.jpg|20px|text-bottom]] [[File:Example.jpg|40px|text-bottom]] [[File:Example.jpg|100px|text-bottom]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''bottom:'' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|100px|bottom]]
<del>text</del></u></span></p>

Для того, чтобы показать результат выравнивания более чётко, фрагменты текста зачёркнуты и подчёркнуты, размер шрифта увеличен до 200%, а абзац выделен тонкой рамкой; кроме того, изображения различных размеров выровнены:

~~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~~

Замечания:

Выравнивание «по центру» (middle, задано по умолчанию) означает, что изображение будет выравнено по линии, находящейся посередине между базовой линией текста и верхним краем строчных (как правило по этой линии проходит зачёркивание текста), а не заглавных букв, в отличие от выравнивания по верхнему или нижнему краю текста (text-top или text-bottom). Высота шрифта не включает в себя:
- Избыточное пространство по умолчанию равномерно делится между двумя краям строки (в примере — по 0.5em в соответствии с высотой строки в 200%) сверху и снизу строчных букв
- дополнительный межстрочный интервал может образоваться при добавлении надстрочных и подстрочных индексов.
Однако, если высота изображения выходит за нормальную высоту текста, при выравнивании по центру будет недостающее расстояние будет добавлено к интервалу над/под строкой, чтобы туда могло вместиться изображение. Все изображения, включая более маленькие, будут выравнены с учётом увеличенных интервалов — для расчёта высоты строки берётся самый большой её элемент.
При выравнивании по верхнему и нижнему краю текста (text-top и text-bottom) не учитывается дополнительный интервал, добавленный из-за наличия верхних и нижних индексов.
При выравнивании по верхнему и нижнему краю (top и bottom) учитываются всё, что расширяет межстрочный интервал, в том числе надстрочные/подстрочные индексы. Если изображение не помещается на высоту строки, и не задана его абсолютная позиция, строка будет расширена, чтобы вместить изображение в зависимости от способа выравнивания сверху, снизу или с двух сторон.
Расположение подчёркивания, надчёркивания и перечёркивания в тексте должно соответствовать позициям изображения и могут зависеть от типа и размера используемого шрифта. Они могут учитываться в некоторых браузерах для индексов, но часто просто игнорируют, и расположение линий может не быть выровнено. Эти линии не влияют на расположение изображений по отношению к тексту.

Отключение обтекания текстом

В некоторых случаях желательно отключить обтекание текстом плавающего изображения (или других встроенных не-плавающих изображений). В зависимости от разрешения экрана в браузере и обтекание текста справа от изображения может привести к тому, что заголовок раздела (например, == Мой заголовок ==) окажется справа от изображения, а не под ним, как пользователь может ожидать. Обтекание текстом может быть отключено путем размещения <div style="clear: both"></div> перед текстом, который должен начаться ниже плавающего изображения. (Также можно обойтись без пустых строк, если обернуть секцию изображений в «<div style="overflow: hidden">…</div>», что позволит разместить все обтекаемые элементы внутри div)

Все изображения отображаются как блочные элементы (включая размещённые по центру и без обтекания; обтекаемые изображения слева и справа, а также изображения в рамках и миниатюры) неявно разрывая окружающие строки текста (текущий блок текста заканчивается до изображения, а после начинается новый параграф). Затем они располагаются вертикально вдоль левого или правого края (или вдоль центра линии между этими полями для отцентрированных изображений).

Изменение стандартной целевой ссылки

В следующей таблице показано, как изменить цель ссылки (которая по умолчанию является страницей описания изображения), или как её удалить. Изменение ссылки не изменяет формат, описанный в предыдущих разделах.

Описание	Формат	Результат
внутренняя ссылка	... текст текст текст [[File:example.jpg\|link=Main Page\|подпись]] текст текст текст ...	... текст текст текст текст текст текст ...
внешняя ссылка	... текст текст текст [[File:example.jpg\|link=http://wikipedia.org/wiki/Test\|подпись]] текст текст текст ...	... текст текст текст текст текст текст ...
без ссылки (внешней или страницы файла)	... текст текст текст [[File:example.jpg\|link=\|подпись]] текст текст текст ...	... текст текст текст текст текст текст ...

Предупреждение:

Требования по лицензированию вашего вики-сайта могут не позволять вам удалять все ссылки на страницу с описанием, на которой отображается необходимая атрибуция авторства, авторских прав, условий лицензирования, или более полное описание изображения (в том числе история изменений этого изображения и его описания).

Если вы измените или удалите целевую ссылку из изображение, вы должны предоставить на странице явную ссылку на эту страницу описания, или явно указать автора, авторские права и ссылку на применимую лицензию, если она отличается от применимой к странице, где изображение используется.

Правила вашего вики-сайта могут ограничить использование параметра альтернативной ссылки, или даже совсем запретить использование параметра альтернативной ссылки для встраиваемых медиафайлов (в этом случае параметр ссылки будет проигнорирован), или же такие ссылки могут приниматься только после их проверки уполномоченными участниками или администраторами.

Галереи изображений

Синтаксис галерей

С помощью тега ‎<gallery> можно довольно просто создать галерею миниатюр. Его синтаксис таков:

<gallery>
File:file_name.ext|caption|alt=alt language
File:file_name.ext|caption|alt=alt language
{...}
</gallery>

Заметьте, что код изображения не заключается в квадратные скобки, когда он находится внутри тега галереи.

Подписи к рисункам не обязательны, они могут содержать внутренние или внешние ссылки или иное форматирование.

Слова «center», «left» и «right», используемые в качестве подписей могут привести к ложному срабатыванию Линтера. См. также задача T275074.

Некоторые параметры, предназначенные для управления выводом миниатюр можно использовать и в галереях — те, которые изменяют файл, но не управляют положением изображения на странице. К примеру, для многостраничных файлов, например pdf, можно использовать такой код, как page=4, а для видео можно использовать thumbtime=10.

File: перед именем файла писать не обязательно. Однако, рекомендуется включать его в качестве подсказки, чтобы проще находить ссылки на изображения в викитексте (например, при необходимости выровнять страницу).

If the image links to an external site, the caption must come before the link parameter or the caption will not render.

Например:

<gallery>
File:Example.jpg|Item 1
File:Example.jpg|a link to [[Help:Contents]]
File:Example.jpg
File:Example.jpg|alt=An example image. It has flowers
File:Example.jpg|''italic caption''
File:Example.jpg|link=https://example.com|This text will not render because an external link came first
File:Example.jpg|Links to external website|link=https://example.com
File:Example.jpg|link=w:Main_Page|Internal link
Example.jpg|on page "{{PAGENAME}}"
File:Using Firefox.pdf|page=72
</gallery>

будет выглядеть так:

Item 1
a link to Help:Contents
italic caption
Links to external website
Internal link
on page "Images/ru"

Параметр mode

Версия MediaWiki:

≥ 1.22

Начиная с версии MediaWiki 1.22 введён параметр mode, имеющий следующие опции:

traditional — галереи традиционного вида с рамкой вокруг изображений и ячейками одинаковой ширины.
nolines — то же самое что и traditional, но без рамок.
packed — изображения одинаковой высоты, но ширина может быть разной; уменьшенные границы между изображениями. Ширина галереи может подстраиваться под текущее разрешение экрана. Подписи располагаются под изображениями;
packed-overlay — подписи располагаются поверх изображений в полупрозрачных белых рамках.
packed-hover — аналогично packed-overlay, но подписи появляются только при наведении курсора мыши на изображение.
slideshow — перелистывание изображений.

Примеры:

<gallery mode="packed-hover">
File:Astronotus_ocellatus.jpg|''[[commons:Astronotus ocellatus|Astronotus ocellatus]]'' (Oscar)
File:Salmonlarvakils.jpg|''[[commons:Salmo salar|Salmo salar]]'' (Salmon Larva)
File:Georgia Aquarium - Giant Grouper.jpg|''[[commons:Epinephelus lanceolatus|Epinephelus lanceolatus]]'' (Giant grouper)
File:Pterois volitans Manado-e.jpg|''[[commons:Pterois volitans|Pterois volitans]]'' (Red Lionfish)
File:Macropodus opercularis - front (aka).jpg|''[[commons:Macropodus opercularis|Macropodus opercularis]]'' (Paradise fish)
File:Canthigaster valentini 1.jpg|''[[commons:Canthigaster valentini|Canthigaster valentini]]'' (Valentinni's sharpnose puffer)
File:Flughahn.jpg|[[File:POTY ribbon 2007.svg|25px]] ''[[commons:Dactylopterus volitans|Dactylopterus volitans]]'' (Flying gurnard)
File:Fishmarket 01.jpg|''[[commons:Semicossyphus pulcher|Semicossyphus pulcher]]'' (California Sheephead)
File:Pseudorasbora parva(edited version).jpg|''[[commons:Category:Pseudorasbora parva|Pseudorasbora parva]]'' (Topmouth gudgeon)
File:MC Rotfeuerfisch.jpg|''[[commons:Category:Pterois antennata|Pterois antennata]]'' (Antennata Lionfish)
File:Cleaning station konan.jpg|''[[commons:Novaculichthys taeniourus|Novaculichthys taeniourus]]''
File:Synchiropus splendidus 2 Luc Viatour.jpg|''[[commons:Synchiropus splendidus|Synchiropus splendidus]]'' (Mandarin fish)
File:Psetta maxima Luc Viatour.jpg|''[[commons:Psetta maxima|Psetta maxima]]'' (Turbot)
File:Australian blenny.jpg|''[[commons:Category:Ecsenius|Ecsenius axelrodi]]''
</gallery>

Даст (в режиме: packed-hover):

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)
Pterois volitans (Red Lionfish)
Macropodus opercularis (Paradise fish)
Canthigaster valentini (Valentinni's sharpnose puffer)
Dactylopterus volitans (Flying gurnard)
Semicossyphus pulcher (California Sheephead)
Pseudorasbora parva (Topmouth gudgeon)
Pterois antennata (Antennata Lionfish)
Novaculichthys taeniourus
Synchiropus splendidus (Mandarin fish)
Psetta maxima (Turbot)
Ecsenius axelrodi

Примеры других режимов отображения галерей:

mode="traditional"

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)

mode="nolines"

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)

mode="packed"

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)

mode="packed-overlay"

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)

mode="packed-hover"

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)

Версия MediaWiki:

≥ 1.28

mode="slideshow"

Astronotus ocellatus (Oscar)
Salmo salar (Salmon Larva)
Epinephelus lanceolatus (Giant grouper)
Pterois volitans (Red Lionfish)
Macropodus opercularis (Paradise fish)
Canthigaster valentini (Valentinni's sharpnose puffer)
Dactylopterus volitans (Flying gurnard)
Semicossyphus pulcher (California Sheephead)
Pseudorasbora parva (Topmouth gudgeon)
Pterois antennata (Antennata Lionfish)
Novaculichthys taeniourus
Synchiropus splendidus (Mandarin fish)
Psetta maxima (Turbot)
Ecsenius axelrodi

Дополнительные атрибуты галерей

Галерее можно задать дополнительные параметры в виде «имя="значение"»:

<gallery {parameters}>
{images}
</gallery>

caption="{подпись}": (кавычки требуется ставить если подпись состоит более чем из одного слова) — устанавливает текст подписи по центру над галереей. Только обычный текст можно использовать в подписи; форматирование, шаблоны и подобное не будет работать.
widths={высота}px: максимальная высота изображений; по умолчанию — 120px. (Если выбран один из перечисленных далее режимов, эффекта не будет: packed, packed-overlay, packed-hover, slideshow) Внимание: здесь используется множественное число — widths!.
heights={ширина}px: максимальная ширина изображений; по умолчанию — 120px. (Эффекта не будет, если установлен режим slideshow)
perrow={количество}: количество изображений в одной строке. (Если выбран один из перечисленных далее режимов, эффекта не будет: packed, packed-overlay, packed-hover, slideshow) Если 0 — выбирается автоматически.
showfilename={любые символы}: показывать имена файлов для каждого изображения (1.17+).
mode={traditional|nolines|packed|packed-hover|packed-overlay|slideshow}: См. ниже (1.22+; 1.28+ для "slideshow").
showthumbnails: Полоска с миниатюрами под выбранным изображением. Работает только в режиме «slideshow» (1.29+).
Любой html-атрибут, разрешённый для тега <ul> (например, id, title, class)

For packed (and related) modes the widths parameter has no effect and the heights parameter determines the minimum height of the images. В режиме packed и производных размер картинки подстраивается так, чтобы разбивать галерею на приблизительно равные строки.

Пример 1

Синтаксис:

<gallery widths=300 heights=200>
File:Example.jpg|Lorem ipsum
File:Example.jpg|Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
</gallery>

Результат:

Lorem ipsum
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut

Пример 2

Синтаксис:

<gallery widths=60 heights=60 perrow=7 caption="подсолнухи такие классные">
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
</gallery>

Результат:

подсолнухи такие классные

Ряды изображений, которые будут переноситься при недостаточной ширине окна

Этого можно добиться, если просто разместить ряд изображений разной ширины, не используя опции «thumb», «left» или «none». Без параметра «thumb» (а значит, и без подписей) ряд изображений будет ограничен только шириной окна браузера. При необходимости переместить изображения в следующую строку — просто сузьте окно браузера.

[[File:Example.jpg|220px]]
[[File:Example.jpg|100px]]
[[File:Example.jpg|150px]]
[[File:Example.jpg|250px]]
[[File:Example.jpg|200px]]
[[File:Example.jpg|50px]]
[[File:Example.jpg|220px]]
[[File:Example.jpg|175px]]

Если нужно, чтобы на другую строку переносились изображения разной ширины, имеющие подписи, требуется использовать HTML-тег div со свойством style="display: inline-block;" в неупорядоченном списке. Более подробно ознакомиться с примерами можно по ссылке: Give Floats the Flick in CSS Layouts.

<div><ul> 
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>

Caption 1
Caption 2
Caption 3
Caption 4
Caption 5
Caption 6
Caption 7
Caption 8

Чтобы выровнять изображения по верхнему краю, следует использовать команду «vertical-align»

<div><ul> 
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>

Caption 1
Caption 2
Caption 3
Caption 4
Caption 5
Caption 6
Caption 7
Caption 8

На некоторых вики-сайтах отсутствуют некоторые опции, например «widths». Иногда также желательно, чтобы изображения в одной строке имели разную ширину. Без использования галерей или HTML-тегов div невозможно оформить ряд изображений с отдельными подписями так, чтобы те, что не помещаются по ширине окна, переносились на новую строку. Просто попробуйте и убедитесь. Прочие приёмы с вики-текстом также не будут работать корректно. Изображения будут выступать за правый край окна или приводить к появлению горизонтальной полосы прокрутки.

Использование значения («left») для некоторых изображений, означающего плавающее положение по левому краю, в сочетании с «none» для некоторых изображений, также не будет работать последовательно, особенно если есть также ряд изображений, «плавающих» по правому краю. Может возникнуть неприятное поведение элементов. При малой ширине окна изображения могут съехать далеко вниз, чтобы отображаться ниже шаблонов-карточек и выровненных по правому краю изображений.

Управление поведением ссылок

По умолчанию, изображения ссылаются на страницу описания файла. Параметр «link=» изменяет поведение, это может быть ссылка на другую страницу или сайт, или выключает изображение как «связующее звено».

Альтернативно, вы можете создать текстовую ссылку на страницу описания файла или на сам файл. См. Help:Linking to files

Ссылка на другую страницу

Используйте опцию «link=», чтобы ссылка с изображения вела на иную страницу сайта:

Кликнув по следующему изображению, вы перейдёте на страницу MediaWiki:

[[File:MediaWiki-2020-logo.svg|50px|link=MediaWiki]]

Кликнув по следующему изображению, вы перейдёте на сайт example.com:

[[File:MediaWiki-2020-logo.svg|50px|link=http://example.com]]

Изображения с отключённой ссылкой

Используйте опцию «link=» с пустым значением, чтобы вообще отключить ссылку с изображения; следующее изображение не имеет гиперссылки:

[[File:MediaWiki-2020-logo.svg|50px|link=]]

Ссылка на изображение

Добавьте символ «:» перед текстом ссылки, которую не требуется оформить в виде файла.

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

File:MediaWiki-2020-logo.svg

[[:File:MediaWiki-2020-logo.svg|Wiki]]

Wiki

Как сослаться непосредственно на изображение

Обозначенный выше способ позволяет создать ссылку на страницу описания изображения. Если же нужно сослаться на изображение напрямую, можно использовать псевдопространство Media::

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

Media:MediaWiki-2020-logo.svg

Прямые ссылки со сторонних сайтов

Другой способ сослаться на изображение — использовать страницу «Special:Redirect/file» (или «Special:Filepath» как альтернативу) В отличие от примеров выше, вы можете ссылаться на неё с внешних сайтов также, как со страниц MediaWiki.

[[Special:Redirect/file/Wikipedia.png]]

Можно добавить параметры height и width, если нужно получить изображение заданного размера. Но соотношение сторон при этом останется неизменным.

https://www.mediawiki.org/w/index.php?title=Special:Redirect/file/Wikipedia.png&width=100&height=100

Как получить полный путь к изображению

Чтобы получить полный путь к изображению (безо всяких перенаправлений, показанных выше), можно использовать Волшебные слова .

{{filepath:MediaWiki-2020-logo.svg}}

Превращается в:

//upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg

Чтобы использовать их в шаблонах, где требуется убрать префикс «File:», можно использовать {{PAGENAME}}:

{{filepath:{{PAGENAME:File:MediaWiki-2020-logo.svg}}}}

И получится:

//upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg

Файлы на других веб-сайтах

Вы можете ссылаться на внешние файлы, используя тот же самый синтаксис, что и для ссылок на внешние веб-страницы. При этом непосредственно на странице будет отображаться не само изображение, а лишь текст ссылки на него.

[http://url.for/some/image.png]

Или можно задать для этой ссылки отдельный текст описания:

[http://url.for/some/image.png текст с описанием ссылки]

В этом тексте может быть вики-разметка или теги HTML/CSS, за исключением ссылок, которые могли бы разорвать отображаемую ссылку.

[http://www.example.com/some/image.png Пример '''<del>жирный</del>''' ''<ins>текст ссылки</ins>''.]

Отобразится как: Вот пример ~~жирный~~ текст ссылки.

Вы также можете внедрять внешние изображения, если эта возможность включена в вашем вики-проекте (см. Руководство:$wgAllowExternalImages ). Для этого просто вставьте URL такого файла:

http://url.for/some/image.png

На текущий момент, у таких изображений нельзя менять размер, но можно оборачивать их вики-разметкой или HTML/CSS — тегами.

Если данная функция не включена на викисайте, ссылка на изображение будет показана как обычная ссылка, как в примере выше.

It is also possible to use InstantCommons (enabled by default) or other shared file repositories to load files from other wikis, which are treated as if they were local images.

Смотрите также

Wikipedia:Extended image syntax (англ.)
Категория:Википедия:Иллюстрирование
Википедия:Советы по размещению иллюстраций
Manual:Adding support for new filetypes
phab:T113101 - ответы на вопросы
Extension:PageImages#Can I exclude certain page images?

[1] Manual:$wgParserEnableLegacyMediaDOM

[2] Опция |class= для медиафайлов теперь применяется к оболочке

[1]

[2]

Формат	Уменьшенный	Увеличенный
(не определено)	[[File:example.jpg\|50px]]	[[File:example.jpg\|500px]]
border	[[File:example.jpg\|border\|50px]]	[[File:example.jpg\|border\|500px]]
frame	[[File:example.jpg\|frame\|50px]]	[[File:example.jpg\|frame\|500px]]
thumb	[[File:example.jpg\|thumb\|50px]]	[[File:example.jpg\|thumb\|500px]]
frameless	[[File:example.jpg\|frameless\|50px]]	[[File:example.jpg\|frameless\|500px]]