close
Jump to content

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

From mediawiki.org
This page is a translated version of the page Help:Images and the translation is 89% complete.
Outdated translations are marked like this.
Languages:

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

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

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

Перед использованием изображений на странице, системный администратор вашего вики-сайта должен разрешить закачку файлов, после чего пользователи должны загрузить нужные файлы. Системные администраторы могут также настроить вики-сайт на приём файлов из внешних хранилищ, таких как Викисклад. Для изменения размера изображения на стороне сервера используются библиотеки программ (таких как 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). Заметка Заметка: border можно использовать вместе с frameless, но не с каким-либо из прочих — тогда она будет проигнорирована.
    *: Определяет, как изображение будет размещено на странице и как будет при этом выглядеть.
  • * Указать размер можно одним из способов:
    • ** {ширина}px — позволяет задать ширину изображения, не указывая высоту, которая будет подогнана автоматически для сохранения пропорций. (Поддерживаются только целые значения размера в пикселях. Разрешается отделять «px» от числа пробелом.)
    • ** x{высота}px — позволяет задать высоту изображения в пикселях, не указывая ширину, которая будет подогнана автоматически для сохранения пропорций. Поддерживаются только целые значения размера в пикселях. Разрешается отделять «px» от числа пробелом.
    • ** {ширина}x{высота}px — позволяет вписать изображение по размеру в прямоугольник заданной ширины и высоты (в пикселях). Поддерживаются только целые значения размера в пикселях. Разрешается отделять «px» от числа пробелом.
    • upright – Позволяет задать размер изображения относительно предпочтительного размера миниатюры в пользовательских настройках (см. $wgThumbLimits ), или стандартного размера миниатюры (для незалогиненных пользователей). Эта опция часто полезна для слишком узких или наоборот слишком широких изображений. Работает, если выбран способ отображения thumb или frameless. При значении |upright=1.0| отобразится изображение, ширина которого задана в пользовательских настройках. При значении |upright=2.0| ширина изображения станет вдвое больше заданной в настройках.
    *: При этом соотношение сторон в изображении не меняется.
    *: Немасштабируемые форматы изображений возможно только уменьшать, но не увеличивать, т.е. растровые изображения невозможно отобразить размером больше, чем разрешение загруженных файлов.
    *: Параметр «upright» не требует обязательного знака равенства, т.е. «|upright 2.0|» работает так же, как и «|upright=2.0|».
    *: Указание параметра без знака равенства и значения его величины (т.е. «|upright|») равнозначно «|upright=0.75|», в то время как «|upright=|» отображается как «|upright=1.0|».
    *: По умолчанию, максимальный размер зависит от выбранного способа форматирования и собственных размеров изображения (в зависимости от его типа).
  • * Выравнивание по горизонтали — допускаются значения «left», «right», «center» и «none»; Если значение параметра задано несколько раз, учитывается только первое
    *: Позволяет указать, с какой стороны будет размещено изображение по отношению к тексту. В вариантах «left» и «right» текст будет обтекать изображение, в вариантах «center» и «none» — начинаться с новой строки, если не задано — изображение вставляется внутрь текста.
  • * Выравнивание по вертикали — допускаются значения «baseline», «sub», «super», «top», «text-top», «middle», «bottom» и «text-bottom»
    *: Определяет вертикальное выравнивание для изображения, вставленного внутрь текста. По умолчанию — по центру (middle).
  • * Параметр Link может принимать одно из значений:
    • ** link={цель} — позволяет сделать изображение ссылкой на произвольную страницу, а не на страницу описания изображения. Это может быть как викиссылка, так и URL. [[File:Example.jpg|20px|link=http://www.wikipedia.org]] превращается в BERJAYA (ссылку на внешнюю страницу), [[File:Example.jpg|20px|link=MediaWiki]] — в BERJAYA (внутреннюю викиссылку).
    • ** link= (с пустым значением) — (MediaWiki 1.14+) Позволяет убрать ссылку на страницу описания изображения: [[File:Example.jpg|20px|link=]] превратится в BERJAYA.
    *: Между «link» и знаком равенства не должно быть пробела, иначе конструкция будет обработана как подпись.
    *: Также ссылка будет обработана как подпись, если в её тексте встретится мнемоника HTML, например «%22» вместо «"» (см. phabricator:T306216).
    ! Для MW 1.24 и ниже: Если указать |link=| (с пустым значением), то title не будет отображаться. (См. phabricator:T23454.)
  • * Прочие возможные опции:
    • ** alt={альтернативный текст} — (MediaWiki 1.14+) Позволяет вписать произвольный текст в качестве атрибута 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, поскольку в этом случае подпись уже доступна для чтения.

Размеры миниатюр

Миниатюры хранятся в виде отдельных файлов одного из стандартных размеров. Если изображение на странице не соответствует одному из размеров, входящих в стандартную линейку (20, 40, 60, 12, 250, 330, 500, 960), MediaWiki будет использовать ближайшее по размеру следующее изображение в линейке (например, 250 пикселей вместо 130), которое уже браузер уменьшит до нужного размера. Для читателя визуально заметных изменений не будет, просто будет загружено изображение чуть большего размера. Если конечный размер изображения не имеет значения, лучше выбрать один из размеров стандартной линейки, чтобы исключить дополнительные преобразования в браузере.

Опции форматирования

В таблицы приведены примеры всех доступных опций форматирования.

Описание Код Результат
Опции форматирования отсутствуют
Плавающее изображение: нет
В строке: да
Подпись: нет 
... текст текст текст
[[File:example.jpg|подпись]]
текст текст текст ...
... текст текст текст

подпись текст текст текст ...

рамка, обводит изображение тонкой серой рамкой
Плавающее изображение: нет
В строке: да
Подпись: нет 
... текст текст текст
[[File:example.jpg|border|подпись]]
текст текст текст ...
... текст текст текст

подпись текст текст текст ...

frameless — размер аналогичный размеру изображения на миниатюре, но без рамки и обтекания
Плавающее изображение: нет
В строке: да
Подпись: нет 
... текст текст текст
[[File:example.jpg|frameless|подпись]]
текст текст текст ...
... текст текст текст

подпись текст текст текст ...

frameless и border вместе
Плавающее изображение: нет
В строке: да
Подпись: нет 
... текст текст текст
[[File:example.jpg|frameless|border|подпись]]
текст текст текст ...
... текст текст текст

подпись текст текст текст ...

frame
Плавающее изображение: да
В строке: нет
Подпись: да 
... текст текст текст
[[File:example.jpg|frame|подпись]]
текст текст текст ...
... текст текст текст
BERJAYA
подпись

текст текст текст ...

thumb или thumbnail
Плавающее изображение: да
В строке: нет
Подпись: да 
... текст текст текст
[[File:example.jpg|thumb|подпись]]
текст текст текст ...
... текст текст текст
BERJAYA
подпись

текст текст текст ...

Если из-за того, что высота изображения заметно больше, чем его ширина, миниатюра получается слишком большой, попробуйте использовать параметр upright=N, чтобы изменить размер изображения относительно исходного размера миниатюры. upright без числового значения по умолчанию аналогичен значению 0.75 Также можно задать высоту изображения в пикселах.

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

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

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

  • О том, как отображается, если его размер не указан, см. раздел «Опции форматирования» выше.
  • Если ни одна опция форматирования не задана, или задан только border, можно увеличить или уменьшить размер до любого значения.
  • В примерах ниже, оригинальный размер изображения составляет 400 × 267 пикселей.
  • Изображение с опцией «frame» всегда игнорирует заданный размер. Изображение будет уменьшено только если оно превышает максимально допустимый размер из пользовательских настроек, а в информации о странице будет отображаться ошибка Linter.
  • При выборе опции thumb или frameless, размер изображения можно только уменьшить относительно его исходного размера, но не увеличить.
Опция форматирования Уменьшение Увеличение
(не определено) 
[[File:example.jpg|50px]]

BERJAYA 

[[File:example.jpg|500px]]

BERJAYA


border 
[[File:example.jpg|border|50px]]

BERJAYA 

[[File:example.jpg|border|500px]]

BERJAYA


frame 
[[File:example.jpg|frame|50px]]
BERJAYA
 
[[File:example.jpg|frame|500px]]
BERJAYA


thumb 
[[File:example.jpg|thumb|50px]]
BERJAYA
 
[[File:example.jpg|thumb|500px]]
BERJAYA


frameless 
[[File:example.jpg|frameless|50px]]

BERJAYA 

[[File:example.jpg|frameless|500px]]

BERJAYA

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

Заметьте, что при использовании 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: BERJAYA BERJAYA BERJAYA text

text text-top: BERJAYA BERJAYA BERJAYA text

text super: BERJAYA BERJAYA BERJAYA text

text baseline: BERJAYA BERJAYA BERJAYA text

text sub: BERJAYA BERJAYA BERJAYA text

text default: BERJAYA BERJAYA BERJAYA text

text middle: BERJAYA BERJAYA BERJAYA text

text text-bottom: BERJAYA BERJAYA BERJAYA text

text bottom: BERJAYA BERJAYA BERJAYA text

Замечания:

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

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

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

Если ссылка с изображения ведёт на внешний сайт, подпись должна располагаться перед параметром link, иначе она не отобразится.

Например: 

<gallery>
File:Example.jpg|Пример 1
File:Example.jpg|Ссылка на [[Help:Contents]]
File:Example.jpg
File:Example.jpg|alt=Пример изображения. Поле с цветами
File:Example.jpg|''подпись курсивом''
File:Example.jpg|link=https://example.com|Текст не отобразится потому что перед ним расположена ссылка на сайт
File:Example.jpg|Ссылка на сайт|link=https://example.com
File:Example.jpg|link=w:Main_Page|Внутренняя ссылка
Example.jpg|on page "{{PAGENAME}}"
File:Using Firefox.pdf|page=72
</gallery>

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

  • Пример 1
    Пример 1
  • Ссылка на Help:Contents
    Ссылка на Help:Contents
  • BERJAYA
  • Пример изображения. Поле с цветами
  • подпись курсивом
    подпись курсивом
  • BERJAYA
  • Ссылка на сайт
    Ссылка на сайт
  • Внутренняя ссылка
    Внутренняя ссылка
  • on page "Images/ru"
    on page "Images/ru"
  • BERJAYA

Параметр 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):

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

mode="traditional"

mode="nolines"

mode="packed"

mode="packed-overlay"

mode="packed-hover"

Версия MediaWiki:
≥ 1.28

mode="slideshow"

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

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

<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) По умолчанию — perrow=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)
В режиме «packed» (и аналогичных), параметр «width» не работает, а параметр «heights» задаёт минимальную высоту изображения. В режиме 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
  • Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
    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>

Результат:

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

You can also use {{#tag:gallery}} magic word (tag) for generating gallery. This is especially useful if you are going to templatize the gallery. Example: 

{{#tag:gallery|
File:{{{File1}}}{{!}}{{{Desc1}}}
}}

or, more advanced: 

{{#tag:gallery|
File:{{{File1}}}{{!}}{{{Desc1}}}
File:{{{File2}}}{{!}}{{{Desc2}}}
|widths={{{Widths}}}
|perrow={{{Perrow}}}
}}

(by Hamilton Abreu)

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

Этого можно добиться, если просто разместить ряд изображений разной ширины, не используя опции «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]]

BERJAYA BERJAYA BERJAYA BERJAYA BERJAYA BERJAYA BERJAYA BERJAYA

Если нужно, чтобы на другую строку переносились изображения разной ширины, имеющие подписи, требуется использовать 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>
  • BERJAYA
    Caption 1
  • BERJAYA
    Caption 2
  • BERJAYA
    Caption 3
  • BERJAYA
    Caption 4
  • BERJAYA
    Caption 5
  • BERJAYA
    Caption 6
  • BERJAYA
    Caption 7
  • BERJAYA
    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>
  • BERJAYA
    Caption 1
  • BERJAYA
    Caption 2
  • BERJAYA
    Caption 3
  • BERJAYA
    Caption 4
  • BERJAYA
    Caption 5
  • BERJAYA
    Caption 6
  • BERJAYA
    Caption 7
  • BERJAYA
    Caption 8

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

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

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

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

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

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

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

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

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

BERJAYA

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

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

BERJAYA

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

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

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

BERJAYA

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

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

[[: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?utm_source=www.mediawiki.org&utm_campaign=index&utm_content=original

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

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

И получится:

//upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg?utm_source=www.mediawiki.org&utm_campaign=index&utm_content=original

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

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

[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 — тегами.

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

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

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

References

  1. ↑ Manual:$wgParserEnableLegacyMediaDOM
  2. ↑ Теперь |class= применяется к обрамлению.
Retrieved from "https://www.mediawiki.org/w/index.php?title=Help:Images/ru&oldid=8346014"