Help:Images/ru

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

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

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



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


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

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


 * - масштабируемое изображение в формате Standard Vector Graphics (специфицирован консорциумом W3). См. Manual:Image_Administration#SVG.
 * - Tagged image format (TIFF) Часто используется для архивных фотографий с высоким разрешением. Обычно используется в сочетании с расширением.
 * ,,   - Медиа-контейнер ogg (аудио или видео). Не формат изображений, но обрабатывается аналогично. Обычно используется в сочетании с расширением.
 * - многостраничный документ в формате Portable Document Format (первоначально специфицирован компанией Adobe). Часто используется в сочетании с расширением.
 * - многостраничный растровый документ в формате DejaVu (чаще всего, сканы книг). См. также.
 * У файлов  и   показывается только одна страница.

Другие форматы могут не поддерживаться в зависимости от вашей версии MediaWiki. Как правило, их можно загрузить, но не будут отображаться на странице, пока не будет установлено соответствующее расширение.



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

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


 * Format вариант: 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.
 * Форматирует изображение и определяет, как оно будет расположено в оставшейся части страницы.
 * Resizing — одно из следующих:
 * {width}px — изменяет размер изображения в соответствии с заданной максимальной шириной в пикселях, не ограничивая его высоту; (Поддерживаются только целые значения размера в пикселях. Разрешается отделять «px» от числа пробелом.)
 * x{height}px — изменяет размер изображения в соответствии с заданной максимальной высотой в пикселях, не ограничивая его ширину; Поддерживаются только целые значения размера в пикселях. Разрешается отделять «px» от числа пробелом.
 * {width}x{height}px — изменяет размер изображения в соответствии с заданной шириной и высотой в пикселях; Поддерживаются только целые значения размера в пикселях. Разрешается отделять «px» от числа пробелом.
 * upright — ** upright — корректирует размеры изображения в соответствии с предпочтениями пользователя (подходит для изображений, высота которых больше ширины). This option is often useful for images whose height is larger than their width. Requires either thumb or frameless. С параметром  отобразится изображение, ширина которого задана в пользовательских настройках. С параметром   ширина изображения станет вдвое больше заданной в настройках.
 * При этом соотношение сторон в изображении не меняется.
 * Немасштабируемые форматы изображений возможно только уменьшать, но не увеличивать, т.е. растровые изображения невозможно отобразить размером больше, чем разрешение загруженных файлов.
 * Параметр « » не требует обязательного знака равенства, т.е. « » работает так же, как и « ».
 * Указание параметра без знака равенства и значения его величины (т.е. « ») равнозначно « », в то время как « » отображается как « ».
 * По умолчанию максимальный размер зависит от значения format и внутренних размеров изображения (в зависимости от его типа).
 * Horizontal alignment — допускаются значения «left», «right», «center» и «none»; Если значение параметра задано несколько раз, учитывается только первое
 * Определяет горизонтальное выравнивание (и значения inline/block или floating) изображения в пределах текста. Не имеет значения по умолчанию.
 * Vertical alignment — допускаются значения «baseline», «sub», «super», «top», «text-top», «middle», «bottom» и «text-bottom»;
 * Определяет вертикальное выравнивание невсплывающего изображения в блоке текста. По умолчанию вертикально выравнивается по центру (middle).
 * Link — возможные варианты:
 * link={цель} — позволяет перенаправлять (на заголовок произвольной статьи или URL) ссылку, связанную с изображением; например,  отображается как Example.jpg (внешняя ссылка), или   отображается как Example.jpg (внутренняя ссылка).
 * link= (с пустым значением) — (MediaWiki 1.14+) показывает изображение без связанной ссылки; например,   отображается как Example.jpg.
 * Если между « » и знаком равенства будет пробел, конструкция будет обработана как подпись.
 * Также ссылка будет обработана как подпись, если в её тексте встретится мнемоника HTML, например « » вместо « » (см. T306216).


 * ! Для MW 1.24 и ниже: Если указать  (с пустым значением), то   не будет отображаться. (См. T23454.)
 * Особые параметры:
 * alt={альтернативный текст} — (MediaWiki 1.14+) определяет альтернативный текст (интерпретируется как HTML-атрибут  элемента  ), который будет показан вместо изображения в случае неудачи при его загрузке или попытке встроить в статью, а также в случае необходимости указывать альтернативное описание (например, при использовании читателем шрифта Брайля и других специальных возможностей, установленных в его браузере).
 * Если между « » и знаком равенства будет пробел, конструкция будет обработана как подпись.
 * page={номер} — отображает страницу с указанным номером (в настоящее время применяется только при показе файлов .djvu или .pdf).
 * thumbtime={number} — Renders a thumbnail from the video at the specified timestamp in seconds or MM:SS or HH:MM:SS format (only applicable when showing a video file).
 * start={number} — When video playback is started it will start at the specified timestamp in seconds or MM:SS or HH:MM:SS format (only applicable when showing a video file).
 * muted — When media playback is started, audio will be muted.
 * loop — Media will loop continuously. (only applies to audio and video)
 * class={html class} — (MediaWiki 1.20+) определяет классы (интерпретируется как HTML-атрибут  элемента ).
 * lang={код языка} — (MediaWiki 1.22+) для файлов SVG, содержащих элементы &lt;switch&gt; с различными атрибутами systemLanguage, определяет язык, на котором файл будет отображаться. По умолчанию — всегда английский, даже в не-англоязычных разделах ВП.

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

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

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

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

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



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


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



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



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

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



Для того, чтобы показать результат выравнивания более чётко, фрагменты текста зачёркнуты и подчёркнуты, размер шрифта увеличен до 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

Замечания:


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



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

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



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

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

<span id="Rendering_a_gallery_of_images">

Галереи изображений
<span id="Gallery_syntax">

Синтаксис галерей
Создать галерею уменьшенных изображений с помощью тега довольно легко. Его синтаксис таков:

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

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

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

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

Например:

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

<span id="mode_parameter">

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


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

Примеры:

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

<span id="Optional_gallery_attributes">

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


 * : (кавычки требуется ставить если подпись состоит более чем из одного слова) — устанавливает текст подписи по центру над галереей. Только обычный текст можно использовать в подписи; форматирование, шаблоны и подобное не будет работать.
 * : максимальная высота изображений; по умолчанию — 120px. (Если выбран один из перечисленных далее режимов, эффекта не будет: packed, packed-overlay, packed-hover, slideshow) (Внимание: widths!).
 * : максимальная ширина изображений; по умолчанию — 120px. (Эффекта не будет, если установлен режим slideshow)
 * : количество изображений в одной строке. ((Если выбран один из перечисленных далее режимов, эффекта не будет: packed, packed-overlay, packed-hover, slideshow) Если 0 — выбирается автоматически.
 * : показывать имена файлов для каждого изображения (1.17+).
 * : См. ниже (1.22+; 1.28+ для "slideshow").
 * : Полоска с миниатюрами под выбранным изображением. Работает только в режиме «slideshow» (1.29+).


 * Пример 1

Синтаксис:

Результат:

<span id="Row_of_images_that_will_wrap_to_browser_width">

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





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

<ul> <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> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> </ul>

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

<ul> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> <li style="display: inline-block; vertical-align: top;"> </li> </ul>

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

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

<span id="Link_behavior">

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

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

<span id="Display_image,_link_it_to_another_page_or_website">

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

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





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





<span id="Display_image,_turn_off_link">

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





<span id="Link_to_an_image">

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

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

<span id="Directly_linking_to_an_image">

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

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

<span id="Direct_links_from_external_sites">

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

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

<span id="Obtaining_the_full_URL_of_an_image">

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

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



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

И получится:



<span id="Files_at_other_websites">

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



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

текст с описанием ссылки

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

Пример  жирный   текст ссылки .

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

Вы также можете внедрять внешние изображения, если эта возможность включена в вашем вики-проекте (см. ). Для этого просто вставьте URL такого файла: http://url.for/some/image.png На текущий момент, у таких изображений нельзя менять размер, но можно оборачивать их вики-разметкой или HTML/CSS — тегами.

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

<span id="See_also">

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

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