Это руководство по редактированию документирует синтаксис, используемый для вставки изображений и других медиафайлов на страницы Википедии. Один и тот же синтаксис используется независимо от того, находится ли файл в Википедии или на Wikimedia Commons . Новым редакторам рекомендуется также ознакомиться с руководством по изображениям и простым руководством для начинающих .
Вкратце синтаксис отображения изображения следующий:
[[File:Name|Type|Border|Location|Alignment|Size|link=Link|alt=Alt|page=Page|lang=Langtag|Caption]] .Plain typeозначает, что вы всегда вводите именно то, что видите. Bold italicsпредставляет собой переменную, которую вы заменяете ее фактическим значением.
Из показанных параметров только Name является существенным. Большинство изображений должны использовать , а не указывать размер.[[File:Name|thumb|alt=Alt|Caption]]
Другие подробности:
thumb(или thumbnail; за любым из них может следовать ), (или ), или . Отображает изображение с определенным форматированием (см. ниже).=filenameframeframedframelessborder. Добавьте небольшую рамку вокруг изображения.right, left, centerили none. Определите горизонтальное расположение изображения на странице. Это значение по умолчанию rightдля миниатюр и изображений в рамке.baseline, middle, sub, super, text-top, text-bottom, top, или bottom. Вертикальное выравнивание изображения относительно смежного текста. По умолчанию middle.uprightили . Масштабировать миниатюру от ее размера по умолчанию с использованием заданного коэффициента (по умолчанию 0,75), округляя результат до ближайшего значения, кратного 10 пикселям. Опция должна использоваться вместе с параметром или . В качестве альтернативы и только в случае крайней необходимости предпочтения пользователя могут быть проигнорированы, а размер изображения зафиксирован путем указания размера в пикселях: или или . Масштабировать изображение так, чтобы оно не превышало заданную ширину или высоту, сохраняя его соотношение сторон. Увеличение масштаба (т. е. растяжение изображения до большего размера) отключено, когда изображение заключено в рамку.upright=factoruprightthumbframelessWidth pxx Height pxWidth x Height pxswitch-translated файлов SVG (масштабируемая векторная графика). Некоторые файлы SVG являются многоязычными; этот параметр указывает, какой язык использовать. Тег языка должен быть полностью строчными буквами (например, zh-hansвместо zh-Hans). По умолчанию используется текущий язык Википедии в пространстве имен статей или enв других пространствах имен. См {{Translate}}. .thumbили , но может отображаться при наведении мыши в других случаях.frameСинтаксис изображения начинается с [[, содержит компоненты, разделенные |, и заканчивается ]]. [[И первый |(или, если нет |, завершающий ]]) должны быть на одной строке; другие пробелы и переносы строк <br>(или <br />) игнорируются, если они находятся рядом с |символами или просто внутри скобок. Пробелы или переносы строк не допускаются непосредственно перед =в следующих параметрах и могут иметь нежелательные побочные эффекты, если они появляются сразу после =.
Не завершайте кодом |]]; он будет воспринят как пустой заголовок и переопределит любой реальный заголовок перед ним.
Один из этих параметров может быть указан для управления масштабированием изображения и/или указанием границы. Для параметров, которые автоматически масштабируют изображение, обычно это 220 пикселей; вошедшие в систему пользователи могут изменить это (в разделе «Размер миниатюры» в разделе «Настройки» → «Внешний вид » → «Файлы» ). Это важно для пользователей с (например) ограниченным зрением. Если это слишком много или мало, можно использовать атрибут «вертикальный». Указание фиксированного размера в пикселях переопределяет все это, но недружелюбно для пользователей, которым нужно изображение большего размера.
thumb(или thumbnail)thumb=Example.png, операнд называет изображение, которое используется в качестве миниатюры, игнорируя любые спецификации размера.frameframelessborder|thumbи |frame), так как изображения с рамкой всегда имеют рамки.Один из этих параметров может быть указан для управления положением изображения. Примеры того, как все это работает, см. в разделе Примеры параметра местоположения.
rightthumbили .frameleftcenternonethumb, ни другоеframe
так.Один из этих параметров может быть дополнительно указан для управления вертикальным выравниванием изображения относительно соседнего текста.
Эти параметры вертикального выравнивания применяются только к простым изображениям, которые не вызывают разрывов и не являются плавающими (то есть они не работают с изображениями, которым требуется обтекание текста. Чтобы текст обтекал изображение, поместите изображение перед текстом и используйте параметр thumb).
В следующем списке пояснению каждой опции предшествует то, как выглядит файл File:Flag of Hungary vertical.svg при выравнивании с использованием указанной опции, используя
разметку [[File:Flag of Hungary vertical.svg|option|frameless|upright=0.1|link=|alt=]]
middle:
(Это значение по умолчанию.) Выровняйте вертикальную середину изображения с базовой линией текста плюс половина x-высоты текста, чтобы изображение было вертикально отцентрировано вокруг строчной буквы «x» в тексте.
baseline:
Выровняйте нижнюю часть изображения по базовой линии текста.
sub:
Выровняйте нижнюю часть изображения по тому же уровню, что и нижняя часть нижнего индекса, например, нижняя часть цифры «2» в «X 2 ».
super:
Выровняйте нижнюю часть изображения по тому же уровню, что и нижняя часть надстрочного индекса, например, нижняя часть цифры «2» в «X 2 ».
text-top:
Выровняйте верх изображения по верху текста. Часто это немного выше верха заглавной буквы из-за выносных элементов в таких буквах, как строчная «h».
text-bottom:
Выровнять низ изображения по низу текста. Это немного ниже базовой линии из-за выносных элементов в буквах, таких как строчная "y".
top:
Выровняйте верх изображения по верху строки, содержащей текст. Обычно это немного выше верха текста, чтобы оставить место между строками текста.
bottom:
Выровнять нижнюю часть изображения по нижней части строки, содержащей текст. Обычно это немного ниже нижней части текста.
Для управления размером изображения можно указать любой или ни один из этих параметров. В случае изображений с подписями, если изображение уже меньше запрошенного размера, то изображение сохраняет свой исходный размер (оно не увеличивается). В случае изображений без подписей изображение будет увеличено или уменьшено для соответствия запрошенному размеру. Изменение размера отключено, если используется тип «frame», а параметры размера помечаются как фиктивные параметры файла в Special:LintErrors .
Ширина миниатюры по умолчанию может быть установлена в настройках, поэтому указывать ее в пикселях не рекомендуется , чтобы уважать предпочтения пользователей, которые могут быть важны для доступности. Исключения, конечно, могут быть сделаны, но постарайтесь использовать uprightили значение по умолчанию, если это возможно.
upright или upright=факторupright=1.5увеличивает изображение, что полезно для карт или схем, которые должны быть больше для удобства чтения. Параметр upright=1возвращает тот же размер, что и ширина миниатюры, и upright=0.75функционально идентичен параметру в uprightодиночку. Если вы установите Factor равным соотношению сторон изображения (ширина, деленная на высоту), результат будет эквивалентен масштабированию высоты до обычной ширины миниатюры.uprightработает только с параметром thumbили frameless(см. Тип).px100px ) Масштабируйте изображение, чтобы сделать его ширину равной указанному количеству пикселей, и масштабируйте высоту, чтобы сохранить исходное соотношение сторон.xВысотаpxx150px) Масштабируйте изображение, чтобы сделать его высоту заданным числом пикселей, и масштабируйте ширину, чтобы сохранить исходное соотношение сторон.xВысотаpx100x150px ) Масштабируйте изображение так, чтобы оно не было шире и не было выше указанного количества пикселей. Изображение сохранит исходное соотношение сторон.|link=Page|link=(один)|link=влияет только на то, что происходит при щелчке по самому изображению|thumb ; изображения имеют маленький значок прямоугольник-прямоугольник 
в области подписи, и щелчок по нему всегда ведет на страницу описания изображения. За исключением изображений, находящихся в открытом доступе, читатель всегда должен иметь возможность попасть на страницу описания изображения, поэтому |link=его следует использовать только с |thumbизображениями.
|link=нельзя использовать с |frame.
Чтобы отключить все ссылки и описания чисто декоративного изображения (чтобы программы чтения с экрана его игнорировали), используйте « |link=|alt=» без аргументов для любого из параметров.
Ноль или более из этих параметров могут быть указаны для управления alt text , link title и caption для изображения. Подписи могут содержать встроенную вики-разметку, такую как ссылки или форматирование. См. Wikipedia:Captions для обсуждения соответствующего текста подписи. См. Wikipedia:Alternative text for images для обсуждения соответствующего alt text. Internet Explorer отображает заголовок ссылки как подсказку, но другие браузеры могут этого не делать. [ требуется обновление ]
Совет: чтобы подпись была написана (под изображением), а не просто отображалась как «текст при наведении», даже если вы хотите изменить размер изображения, укажите « thumb». Если указать « frame», подпись отображается, но любые изменения размера (например, « 125px») игнорируются.
alt=Альтthumbnail", " thumb", " frame" или " framed"), то этот текст отображается как подпись под изображением. В противном случае (если тип изображения не указан или это " frameless"), этот текст используется для заголовка ссылки, если ссылка не была подавлена с помощью " |link=", а также для альтернативного текста, если явный alt=Alt не был указан.Фактический альтернативный текст для отображаемого изображения будет одним из следующих (в порядке предпочтения):
Можно указать текст заголовка ссылки только для изображений без видимой подписи (как описано выше). Однако, поскольку не все браузеры отображают этот текст, и он игнорируется программами чтения с экрана, в этом нет особого смысла.
Примечание: alt поддерживается только для изображений. Аудио и видео файлы должны использовать синхронизированный текст .
class=class=notpageimageисключит изображение из выбора алгоритмом Page Images. (phab:T301588)class=skin-invertприведет к инвертированию цветов изображения в темном режиме. class=skin-invert-imageинвертирует только изображение, но не подпись.Обычно для создания миниатюры используется страница 1 из файла PDF или DjVu. Можно использовать другую страницу с параметром |page=: :[[File:IMSLP01578-Ravel - Bolero Full Score Durand 1929.pdf|thumb|page=2|''Boléro'': page 2 from the score]]
Самый простой пример использует синтаксис . Это не масштабирует изображение и не позволяет тексту обтекать его. Обычно это не подходит для статьи.[[File:Westminstpalace.jpg|Alt text]]
Это отображается в строке, и указанный текст используется как атрибут alt изображения (альтернативный текст для программ, которые не могут отображать изображения, например, программы чтения с экрана ) и как атрибут title (дополнительный текст, часто отображаемый как всплывающая подсказка при наведении мыши на изображение). См. Wikipedia:Captions для обсуждения соответствующего текста подписи. См. Wikipedia:Alternative text for images для обсуждения соответствующего текста alt.
Выше изображение Темзы было помещено в отдельный абзац. Это не обязательно; изображения могут располагаться в тексте, как показано ниже.
текст текст текст текст текст текст [[ Файл : Westminstpalace.jpg | 150px | alt = Большая часовая башня и другие здания вдоль большой реки. | Вестминстерский дворец ]]текст текст текст текст текст[[ Файл : tst.png | 100px | alt = Маленький глобус | Это глобус. ]]текст текст текст текстдает
текст текст текст текст текст текст
текст текст текст текст текст текст текст текст текст текст
Чтобы отобразить загруженное изображение с подписью, используйте [[File:Westminstpalace.jpg|frame|none|alt=Alt text|Caption text]].
Это наиболее знакомый читателям стиль. Как показано на примере изображения, изображение заключено в рамку, имеет подходящий размер и текст, который может его обтекать. Подпись правильно интегрирована.
Важная часть этого — thumbпараметр: (как показано слева). Подробности этих опций см. в предыдущих разделах.[[File:Westminstpalace.jpg|thumb|upright=0.4|left|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster]]
Примеры параметра местоположения приведены ниже:
[[File:Westminstpalace.jpg|thumb|alt=A large clock tower and other buildings line a great river.|right|upright=0.35]][[File:Westminstpalace.jpg|thumb|alt=A large clock tower and other buildings line a great river.|left|upright=0.35]]В HTML/CSS есть проблема с плаванием, которая не позволяет некоторым изображениям (или другим плавающим объектам) плавать над другими. Это происходит только если:
Первый плавающий объект на последней стороне страницы не будет плавать над последним плавающим объектом на первой (см. примеры ниже). Решения включают в себя чередование левого и правого выравнивания изображений или других плавающих объектов (не показано); установку значения «none» для выравнивания того, который не будет плавать над другими (как показано «вживую» в таблице населения здесь ); и использование тега галереи для большого количества изображений в одном разделе. Согласно MOS:ACCESS#FLOAT , изображения должны быть вставлены так, чтобы их разметка находилась в правильном разделе, даже если это может привести к их перемещению в следующий раздел.
Проблемный код:
==Раздел 1== [[ Файл : Westminstpalace.jpg | большой палец | 70 пикселей | справа | Рисунок 1.1 ( '''справа'' ' ) ]] [[ Файл : Westminstpalace.jpg | большой палец | 70 пикселей | справа | Рисунок 1.2 ( '''справа''' ) ]] [[ Файл : Westminstpalace.jpg | большой палец | 70 пикселей | справа | Рисунок 1.3 ( '''справа''' ) ]] [[ Файл : Westminstpalace.jpg | большой палец | 70 пикселей | справа | Рисунок 1.4 ( '''справа''' ) ]]Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut Labore et dolore magna aliqua.==Раздел 2== [[ Файл : Westminstpalace.jpg | большой палец | 70 пикселей | слева | Рисунок 2.1 ( '''слева''' ) ]]Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut Labore et dolore magna aliqua.Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut Labore et dolore magna aliqua.
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut Labore et dolore magna aliqua.
Дополнительную информацию о теге галереи см. в разделе Справка:Тег галереи .
upright» занимает около 75% ширины миниатюры.upright=1.5"Параметр uprightработает в сочетании с параметром thumbnailили thumbдля изменения размера изображения примерно до 75% ширины обычного изображения thumbnail. Это полезно для отображения изображений в «портретной» ориентации , поскольку такие высокие и узкие изображения, как правило, выглядят слишком большими при масштабировании до той же ширины, что и изображения в «альбомной» ориентации. Параметр uprightмасштабирует больше или меньше в соответствии с разрешением экрана пользователя. Относительный размер можно определить с помощью множителя, например . Если x = 1, то изображение имеет стандартную ширину миниатюры. Например , <lang="wikitext" inline>upright=x
upright» занимает около 75% ширины миниатюры.</syntaxhighlight> (показано слева) и [[File:Westminstpalace.jpg|thumb|upright=1.5|right|alt=A large clock tower and other buildings line a great river.|The "<code>upright=1.5</code>" option]](показано справа).
С этой опцией встроенное изображение отображается с его фактическим размером, заключенным в рамку, независимо от атрибута "thumb" или "size", а подпись, если таковая имеется, видна в рамке. Без опций left, center, и noneизображение обычно находится справа: [[File:Westminstpalace.jpg|frame|alt=A large clock tower and other buildings line a great river.|The Palace of Westminster]].
При отсутствии других параметров, кроме sizepxи alternate (caption) text, встроенное изображение отображается в строке.
Опцию noneможно использовать для создания миниатюр без выравнивания по левому или правому краю. Это, вероятно, наиболее полезно для таблиц . Вот пример:
Вы можете разместить ссылки в тексте подписи, как показано на этом изображении:
[[ Файл : Westminstpalace.jpg | справа | миниатюра | alt = Большая часовая башня и другие здания выстроились вдоль большой реки. | Это [[ Вестминстерский дворец ]] в Лондоне ]]Просто убедитесь, что количество открывающих и закрывающих квадратных скобок верное. Одна лишняя или отсутствующая будет означать, что вся строка синтаксиса изображения не будет работать.
Возможны дополнительные параметры форматирования подписей; все обычное форматирование должно работать.
[[ Файл : Westminstpalace.jpg | справа | миниатюра | alt = Большая часовая башня и другие здания выстроились вдоль большой реки. | <div style = " text-align: center">Это < span style = "color: green" > </span> <br /> [ [ Вестминстерский дворец ]]<br /> ' ' ' в < span style = " color : red" > Лондоне </span> ''' </ div >]] Маркеры и номера списков иногда могут перекрывать плавающие слева изображения, а отступы могут отображаться неправильно рядом с плавающими слева изображениями. Например:
Шаблон {{ flowlist }} позволяет спискам избегать этих плавающих слева объектов:
[[ Файл : Westminstpalace.jpg | слева | большой палец | 100px ]] {{ flowlist }} < ol > <li> элемент списка A1 <ol> <li> элемент списка B1 </ li > < li > элемент списка B2 </ li > </ ol > продолжающийся элемент списка A1 < / li > < li > элемент списка A2 </ li > / ol > {{ endflowlist }} {{ flowlist }}Первая линия: Вторая строка :: Третья строка ::: Четвертая строка {{ endflowlist }}Отображается как:
Первая линия
Этот метод не будет работать внутри таблицы, и если ваш список длиннее плавающего элемента, то список не будет обтекать изображение, как обычно, а вместо этого будет представлять собой один блок, оставляя пустое пространство под плавающим элементом.
В некоторых случаях может быть желательно добавить кликабельные аннотации к изображению. Для этой цели существуют шаблоны Template:Annotated image и Template:Annotated image 4 .
Эти шаблоны позволяют включать викитекст (например, обычный текст, викиссылки, разрешенный HTML-код, ссылки и другие шаблоны) в само изображение. Их также можно использовать для обрезки изображения, чтобы сфокусироваться на определенной его части, или, в качестве альтернативы, для расширения белой области вокруг изображения для лучшего размещения викитекста.
Также есть шаблон {{ Overlay }} :
Здесь ссылка только на пункт 7.
Изображения можно накладывать друг на друга с помощью {{ Superimpose }} , {{ Superimpose2 }} или {{ Overlaid images }} .
Изображения можно обрезать с помощью {{ CSS image crop }} или {{ Annotated image }} .
После размещения изображения рядом с текстом, размещение дополнительного текста под ним и снова использование полной ширины можно сделать с помощью следующей разметки. Это блокирует появление изображения рядом с материалом, следующим за этой разметкой, возможно, по эстетическим причинам или из-за смены тем.
Это можно сделать с помощью шаблона {{ clear }} или {{ Clr }} или {{ - }} в определенных пространствах имен ( en , meta ).
Для отображения фотографий виртуальной реальности ( также известных как 360-градусные панорамы или фотосферы) используйте {{ PanoViewer }} .
Если вы не хотите показывать или отображать изображение, а просто хотите сделать ссылку на страницу описания изображения, используйте двоеточие перед «Файл:» во внутренней вики-ссылке, например: , [[:File:STS-32 crew.jpg|STS-32 crew]]что даст: Экипаж STS-32 .
Часто звуковые файлы представлены на страницах Википедии с использованием {{ Listen }} или связанных с ним шаблонов. Однако также возможно представить аудиофайл без использования какого-либо шаблона. Аналогичный синтаксис для изображений может использоваться для включения аудио- или видеофайлов на страницы.
Обратите внимание, что ни один из этих примеров не содержит ссылок на Wikipedia:Media help , а пример 2 не содержит ссылок для навигации по самому файлу. Следовательно, всякий раз, когда используется этот метод, на этой странице должен отображаться шаблон {{ Inline audio }} , а представление кнопок воспроизведения должно сопровождаться кликабельными ссылками на сам звуковой файл. Примеры:
Обратите внимание, что вертикальное выравнивание кнопки воспроизведения не работает, а также невозможно разместить кнопку воспроизведения в тексте; следовательно, наиболее привлекательное расположение достигается с помощью примеров 1 или 3.
Также имеется параметр, позволяющий предварительно настроить плеер на запуск в другое время, отличное от 0:00.
С июня 2019 года файлы MIDI можно воспроизводить так же, как и другие звуковые файлы. См.: Help:Score .
[[ Файл : Бетховен, соч. 33 нет. 1.мид | большой палец |[[ Багатели, соч. 33 (Бетховен) | «Багатели» , соч. 33 ]] , нет. 1 ]]Чтобы отобразить видео в том виде, в котором оно было загружено, с подписью, используйте [[File:First flights in aviation history.ogg|frame|none|Caption text]].
" ". Использовать кадр из видео в указанное время в качестве начального неподвижного изображения. Время — это либо количество секунд, либо часы, минуты и секунды, разделенные двоеточиями. Без параметра thumbtime по умолчанию используется кадр из середины видео. Например, используя тот же видеофайл, что и ранее:|thumbtime=Time
Этот синтаксис позволяет вам воспроизводить сегмент видеопотока или устанавливать время начала. Наведите курсор на плеер, чтобы увидеть время начала, указанное как 5 секунд, нажмите воспроизведение и обратите внимание, что воспроизведение останавливается на 7 секундах.
[[File:Weeding.ogv|thumb|upright=1.3|start=5|end=7|Starts at 5 seconds and ends playback at 7 seconds]]Примечание: эта функция пока не поддерживается Safari и Internet Explorer.
Чтобы отобразить видео большего размера, чем загруженный, используйте " |thumb" и " ". Это может быть полезно, если исходное видео очень маленькое, но показывает некоторые важные, но мелкие детали, но учтите, что масштабирование может создать неожиданные артефакты масштабирования. Например, код|numberpx
[[File:cal16x16check_vdnocnoafr1len2.avi.q10.ogv|inline|left]] [[File:cal16x16check_vdnocnoafr1len2.avi.q10.ogv|right|thumb|128px]]
Параметр thumbtime также можно использовать внутри галереи (с тегами <gallery> или шаблоном {{ Gallery }} ):
Вот викикод, который его создал:
<галерея>Файл:Первые полеты в истории авиации.ogg|thumbtime=21|Мужчина в костюме, галстуке и шляпе на 21 секунде.Файл:Первые полеты в истории авиации.ogg|thumbtime=0:23|Моноплан виден на 23 секунде.</галерея>
lossyпараметр для tiff-файлов