Help:Images/ru

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

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

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


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

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


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

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

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

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


 * Format: border, frameless, frame, thumb (или thumbnail); If multiple of these options are present, image rendering may be unexpected.
 * Форматирует изображение и определяет, как оно будет расположено в оставшейся части страницы.


 * Resizing — одно из следующих:
 * {width}px — изменяет размер изображения в соответствии с заданной максимальной шириной в пикселях, не ограничивая его высоту; (A space character between the width value and "px" is permitted.)
 * x{height}px — изменяет размер изображения в соответствии с заданной максимальной высотой в пикселях, не ограничивая его ширину;
 * {width}x{height}px — изменяет размер изображения в соответствии с заданной шириной и высотой в пикселях;
 * upright — корректирует размеры изображения в соответствии с предпочтениями пользователя (подходит для изображений, высота которых больше ширины). 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  )
 * If both  and   are present, the first   will be ignored. See  for details.
 * If there is a space character between "upright" and the equals sign (e.g. ), or if the "upright" value contains non-numeric characters, the   value will be ignored. See  for details.
 * По умолчанию максимальный размер зависит от значения format и внутренних размеров изображения (в зависимости от его типа).
 * Horizontal alignment — одно из: left, right, center, none; If multiple of these options are present, only the first one will be used
 * Определяет горизонтальное выравнивание (и inline/block или floating styles) изображения в пределах текста. Не имеет значения по умолчанию.
 * 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.
 * 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 T216003).


 * ! Для MW 1.24 и ниже: Если указать  (с пустым значением), то   не будет отображаться. (См. T23454.)
 * Особые параметры:
 * alt={альтернативный текст} — (MediaWiki 1.14+) определяет альтернативный текст (интерпретируется как HTML-атрибут  элемента   ), который будет показан вместо изображения в случае неудачи при его загрузке или попытке встроить в статью, а также в случае необходимости указывать альтернативное описание (например, при использовании читателем шрифта Брайля и других специальных возможностей, установленных в его браузере).
 * If there is a space character between  and the equals sign, the alt statement will be treated as a caption.
 * page={номер} — отображает страницу с указанным номером (в настоящее время применяется только при показе файлов .djvu или .pdf).
 * class={html class} — (MediaWiki 1.20+) определяет классы (интерпретируется как HTML-атрибут  элемента  ).
 * lang={код языка} — (MediaWiki 1.22+) для файлов SVG, содержащих элементы &lt;switch&gt; с различными атрибутами systemLanguage, определяет язык, на котором файл будет отображаться. По умолчанию — всегда английский, даже в не-англоязычных разделах ВП.

Если параметр не соответствует ни одному из возможных, предполагается, что это подпись. If more than one non-parameter string is present, the final non-parameter string will be used as the caption. Текст подписи отображается ниже изображения в форматах thumb и frame, или как текст подсказки в других форматах. Текст подписи в форматах thumb и frame может содержать вики-ссылки и другие элементы форматирования. Расширения MediaWiki могут иметь дополнительные параметры.

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

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

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

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

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


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

Горизонтальное выравнивание
Заметьте, что при использовании  или , по умолчанию действует выравнивание по правому краю.

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

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



Для того, чтобы показать результат выравнивания более чётко, фрагменты текста зачёркнуты и подчёркнуты, размер шрифта увеличен до 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) * the additional line separation spacing normally divided equally into two line-margins (here 0.5em, according to line-height set to 200%) above and below the font-height).
 * 3) * дополнительный межстрочный интервал, который может образоваться при добавлении надстрочных и подстрочных индексов.
 * 4) Однако, если высота изображения выходит за нормальную высоту текста, при выравнивании по центру будет недостающее расстояние будет добавлено к интервалу над/под строкой, чтобы туда могло вместиться изображение. Все изображения, включая более маленькие, будут выравнены с учётом увеличенных интервалов — для расчёта высоты строки берётся самый большой её элемент.
 * 5) При выравнивании по верхнему и нижнему краю текста (text-top и text-bottom) не учитывается дополнительный интервал, добавленный из-за наличия верхних и нижних индексов.
 * 6) При выравнивании по верхнему и нижнему краю (top и bottom) учитываются всё, что расширяет межстрочный интервал, в том числе надстрочные/подстрочные индексы. Если изображение не помещается на высоту строки, и не задана его абсолютная позиция, строка будет расширена, чтобы вместить изображение в зависимости от способа выравнивания сверху, снизу или с двух сторон.
 * 7) Расположение подчёркивания, надчёркивания и перечёркивания в тексте должно соответствовать позициям изображения и могут зависеть от типа и размера используемого шрифта. Они могут учитываться в некоторых браузерах для индексов, но часто просто игнорируют, и расположение линий может не быть выровнено. Эти линии не влияют на расположение изображений по отношению к тексту.

Прекращение обтекания текстом
В некоторых случаях желательно останавливать обтекание текстом плавающего изображения (или других встроенных не-плавающих изображений). В зависимости от разрешения экрана в браузере и обтекание текста справа от изображения может привести к тому, что заголовок раздела (например, == Мой заголовок == ) окажется справа от изображения, а не под ним, как пользователь может ожидать. Обтекание текстом может быть остановлено путем размещения   (или , на ваш выбор) перед текстом, который должен начаться ниже плавающего изображения. (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.)

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

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

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

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

Способы отображения
Начиная с версии MediaWiki 1.22 введён параметр. Опции выглядят следующим образом:


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

Примеры:

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

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

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





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>

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

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

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

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

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

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





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





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





Ссылка на изображение
Add  as a prefix to the link you need to create.

File:Wiki.png File:Wiki.png 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:Wiki.png]]

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.

Становится:



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

Становится:



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

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



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

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

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

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

which renders as: Вот пример  жирный   текст ссылки .

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

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

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

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