Help:Images/ru

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

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

Поддерживаемые медиа-типы изображений
Расширение имени файла (обозначаемое строчными буквами) используется для определения поддерживаемых медиа-типов изображений и получения его внутренних предпочитаемых размеров:
 * .svg: масштабируемое изображение в формате Standard Vector Graphics (специфицирован консорциумом W3).
 * .jpg или.jpeg: сжатое растровое изображение в стандартном формате JPEG (формат с потерями, лучше всего подходит для фотографий).
 * .png: растровое изображение в формате Portable Network Graphics (специфицирован консорциумом W3).
 * .gif: растровое изображение в унаследованном формате Graphics Interchange Format.
 * Обратите внимание, что многокадровая GIF-анимация поддерживаются только если изображение не было уменьшенно до миниатюры, в противном случае будет показан только первый кадр.
 * .pdf: многостраничный документ в формате Portable Document Format (первоначально специфицирован компанией Adobe).
 * .djvu: многостраничный растровый документ в формате DejaVut (чаще всего, сканы книг).
 * По умолчанию будут показаны лишь первые страницы .PDF и .DjVu файлов.

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

Синтаксис
Полный синтаксис для отображения изображений: раздел «параметры» может отсутствовать или содержать следующие значения, разделенные символом «|»:
 * Параметр формата: один из border and/or frameless, frame, thumb (или thumbnail);
 * Управляют форматированием и встраиванием изображения в остальную часть страницы.
 * Параметр размера: один из
 * {ширина}px — Изменяет размер изображения в соответствии максимальной шириной в пикселях, не ограничивая его высоту;
 * x{высота}px — Изменяет размер изображения в соответствии максимальной высотой в пикселях, не ограничивая его ширину;
 * {ширина}x{высота}px — Изменяет размер изображения в соответствии в заданной шириной и высотой в пикселях;
 * upright — Изменяет размер изображения в соответствии с разумными размерами, в зависимости от предпочтений пользователя (подходит для изображений, высота которых больше ширины).
 * Обратите внимание, что изображение всегда будет сохранять свои пропорции, и может быть уменьшено (не увеличено) в размере, только если находится в масштабируемом медиа-типе (растровые изображения не могут быть масштабированы).
 * Стандартный максимальный размер зависит от формата, и внутренних размеров изображения (в зависимости от его медиа-типа).
 * Параметр горизонтального выравнивания: один из left, right, center, none;
 * Управляют горизонтальным выравниванием (встроенными/блочными или плавающими стилями) изображения в тексте (по умолчанию пусто).
 * Параметр вертикального выравнивания: один из baseline, sub, super, top, text-top, middle, bottom, text-bottom;
 * Управляют вертикальным выравниванием без плавающих встроенных изображений в тексте, до или после изображения, и в том же блоке (по умолчанию middle).
 * Параметр ссылки: один из
 * link={цель} — Позволяет изменять цель (к произвольной странице или URL) генерируемых ссылок, доступных для отображаемых изображений;
 * link= (без значения) —  Отображение изображения без каких-либо ссылок, например,   отобразиться как Example.jpg.
 * Обратите внимание, что параметр link не может быть использован в сочетании с thumb или thumbnail, так как thumb всегда ссылается на большую версию изображения.
 * Вдобавок, параметр link не может быть использован в сочетании с frame.
 * Другие конкретные параметры:
 * alt={альтернативный текст} — Определяет альтернативный текст (отображается на HTML-атрибут   генерируемого кода  ) изображения, который будут выведен, если указанное изображение не может быть загружено и встроенные, или, если необходимо использовать альтернативный текст описания (например, при использовании шрифта Брайля).
 * page={число} — Отображает указанный номер страницы (в настоящее время применяется только при показе .DjVu или .PDF файлов).

Параметры могут быть указаны в любом порядке. Если параметры конфликтуют друг с другом, применяется последний, за исключением параметров формата, в которых параметры принимают приоритет по порядку frame, thumb, и frameless и/илиborder.

If a given option does not match any of the other possibilities, it is assumed to be the caption text. Caption text can contain wiki links or other formatting. If no caption text is supplied a caption is automatically created showing the file name; to completely remove the caption, set it to. For example,  →.

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

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

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

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

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

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

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

 текст top: текст  текст text-top: текст  текст super: текст  text baseline: текст  текст sub: текст  текст default: текст  текст middle: текст  текст text-bottom: текст  текст 'bottom: текст

в результате получится следующее:

 текст top: текст

 текст text-top: текст

 текст super: текст

 текст baseline: текст

 текст sub: текст

 текст default: текст

 текст middle: текст

<p style="border:1px solid #AAA;background:#FF0;padding:0;font-size:150%;line-height:2"> текст text-bottom: текст

<p style="border:1px solid #AAA;background:#FF0;padding:0;font-size:150%;line-height:2"> текст bottom: текст

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

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

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

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

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

Параметры
Тег галереи имеет несколько дополнительных параметров:

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



даст результат



Ссылка на другую страницу
Показанный ниже код позволяет создать изображение шириной 50px ссылка с которого ведёт на страницу MediaWiki/ru:





Прямая ссылка на файл
Вы можете использовать псевдо-пространство имён «   » для прямых ссылок на файлы, минуя их страницы описания.



даст результат



Вы также можете использовать:

/

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

для генерации корректных внешних URL на файлы, который будет обработан следующим образом:

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

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