Довідка:Розширений синтаксис зображень

ВП:РСЗ

Синтаксис

Загальний синтаксис

Синтаксис зображення виглядає:

з англомовними параметрами

з україномовними параметрами

Обов'язковим параметром є лише Name / Назва. Усі інші є необов'язковими. Однак, зазвичай синтаксис для зображень виглядає як [[Файл:Назва|міні|Опис до зображення]]

Детальний синтаксис

Синтаксис зображення починається з [[, містить параметри, що розділені |, і закінчується ]].

Тип / Type

Опція дозволяє масштабувати чи застосовувати обрамлення. Для параметрів автоматичного масштабування за замовчуванням 220пкс. Зареєстровані користувачі можуть змінити це в Налаштування → Зовнішній вигляд → Файли. Це важливо для людей з проблемами зору. Проте, фіксований розмір у пікселях відміняє масштабування.

thumb (чи thumbnail): Автоматично масштабує зображення і облямовує його. Показує опис зображення frame

Зберігає оригінальний розмір зображення і облямовує його. Показує опис зображення

frameless

Автоматично масштабує зображення зверху чи знизу.

Не застосовувати

Зберігає оригінальний розмір зображення і не облямує його. Не показує опис зображення. Практично завжди використовується в шаблонах разом з параметром альтернативного тексту (alt)

Рамка / Border

border

Створює навколо зображення рамку в 1 піксель. Опція працює лише для зображень без рамки, бо |thumb і |frame завжди облямовуються.

Розташування / Location

Параметр для відображення зображення в певному положенні.

right

Розміщує зображення на правому краю сторінки. Текст обтікає його з лівого боку. За замовчуванням для параметрів thumb чи frame

left

Розміщує зображення на лівому краю сторінки. Текст обтікає його з правого боку. Можуть виникнути проблеми з форматуванням списків і тексту з відступом.

center

Розміщує зображення в центрі сторінки. Текст розміщується під зображення.

none

Розміщує зображення на лівому краю сторінки. Текст розміщується під зображення.

Не застосовувати (і без thumb чи frame)

Зображення розміщується в рядку з текстом.

Вертикальне вирівнювання / Vertical alignment

Не обов'язковий параметр, який в особливих випадках використовується для вертикального вирівнювання зображення відносно суміжного тексту.

Розмір / Size

Не обов'язковий параметр, який визначає розмір зображення. Описи зображень завжди матиме однаковий розмір і не буде збільшуватися чи зменшуватися за допомогою цього параметру. Для параметру frame опції розміру не працюють.

upright чи upright=factor

Ширинапкс / px

Наприклад, 100пкс чи 100px. Масштабує зображення відповідно до вказаної кількості пікселів у ширину, і масштабує висоту відповідно до оригінального співвідношення сторін.

xВисотапкс / px

Наприклад, х100пкс чи x100px. Масштабує зображення відповідно до вказаної кількості пікселів у висоту, і масштабує ширину відповідно до оригінального співвідношення сторін.

Ширинапкс / pxxВисотапкс / px

Наприклад, 100х150пкс чи 100x150px. Масштабує зображення відповідно до вказаної кількості пікселів у висоту і ширину.

Сторінка / Page

Зазвичай використовується для PDF- чи DjVu-файлів і відображає відповідну сторінку в мініатюрі.

Приклади

Базовий синтаксис

Базовий синтаксис зображення записують: [[Файл:Зимова фортеця.jpg|альтернативний пояснювальний текст]]. Однак, це не дозволяє масштабувати зображення й відсутнє обтікання тексту. Зазвичай базовий синтаксис не використовують у статтях.

Зображення буде розміщено без опису зображення, а пояснювальний текст з'явиться як alt-атрибут зображення (альтернативний текст для програм, що нездатні перемальовувати зображення) і title-атрибут (текст, що висвітлюється коли мишка знаходиться поверх зображення).

Вище зображення річки Темза було розміщено в окремому абзаці. Однак, це не обов'язково. Зображення може розміщуватися й всередині тексту як показано внизу.

текст текст текст текст текст
[[Файл:Зимова фортеця.jpg|150px|alt=Вид на Зимову фортецю в Кам'янець-Подільському.|Зимова фортеця]]
текст текст текст текст текст
[[Файл:tst.png|100px|alt=Tiny globe|This is a globe.]]
текст текст текст текст

дає: текст текст текст текст текст текст текст текст текст текст текст текст текст текст

Збереження оригінального розміру з описом

Синтаксис для відображення зображення в оригінальному розмірі й з описом до нього — [[Файл:Westminstpalace.jpg|frame|none|alt=Альтернативний текст|Опис зображення]].

Вирівнювання зображень до тексту

Для вирівнювання зображень найчастіше використовують синтаксис як, наприклад, [[Файл:Зимова фортеця.jpg|thumb|200px|right|Зимова фортеця]] (показано праворуч). Він є зручним, бо зображення обрамлено параметром thumb, має опис і відповідний розмір, текст обтікає навколо нього. Отже, зображення правильно інтегроване.

Інші приклади розташування зображення:

right

Зображення вирівнюється по правому краю, текст обтікає його ліворуч.
Синтаксис: [[Файл:Зимова фортеця.jpg|thumb|200px|right|Зимова фортеця]] (показано праворуч).

left

Зображення вирівнюється по лівому краю, текст обтікає його праворуч.
Синтаксис: [[Файл:Зимова фортеця.jpg|thumb|200px|left|Зимова фортеця]] (показано ліворуч).

center
Зображення центрується, і...

текст, що слідує після зображення, розміщується під ним.
Синтаксис: [[Файл:Зимова фортеця.jpg|thumb|200px|center|Зимова фортеця]] (показано зверху).

none
Зображення вирівнюється по лівому краю, і...

текст, що слідує після зображення, розміщується під ним (а не обтікає його з правого чи лівого боку). Синтаксис: [[Файл:Westminstpalace.jpg|thumb|200px|none|Зимова фортеця]] (показано зверху).

Новий синтаксис для зображень

Новий синтаксис є зворотно сумісний, тому немає необхідності переписувати наявні статті. В записі [[Файл:назва_файлу|опції]] (наприклад [[Файл:Ukraine Lutsk.jpg|thumb|100px|left|Замок Любарта]] ліворуч), можна модифікувати кілька опцій, щоб змінити спосіб форматування зображення. Розгляньмо опції, що модифікують розміщення зображення, його розмір чи форматування Файлу: right, left, center, none, розмір px, thumbnail (thumb), frame, і альтернативний пояснювальний текст.

Опції можна комбінувати. Вертикальна риска ("|") використовується як роздільник опцій. Опції можна розміщувати в довільній послідовності. Невідомі опції сприймаються за пояснювальний текст. Якщо зустрічаються кілька невідомих опцій, буде використана остання: [[Файл:Ukraine Lutsk.jpg|thumb|Замок Любарта|200px|right|З висоти пташиного польоту]] (зображення праворуч).

Нижче наведено описи інших опцій, опріч пояснювального тексту:

right: Зображення вирівняно по правому краю, і текст оминає його з лівого боку: [[Файл:Ukraine Lutsk.jpg|right|70px|]] (показано праворуч).
left: Зображення вирівняно по лівому краю, і текст оминає його з правого боку: [[Файл:Ukraine Lutsk.jpg|left|70px|]] (показано ліворуч).
center: Зображення в центрі, і …
цей текст починається під ним: [[Файл:Ukraine Lutsk.jpg|center|70px|]] (зверху).
none: Зображення вирівняно по лівому краю, і…
цей текст починається під зображенням: [[Файл:Ukraine Lutsk.jpg|none|70px|]] (зверху).

Зауваження:

Текст між останньою вертикальною рискою та другими квадратними дужками («]]»), не залежно від присутності, завжди спрацьовує як остання опція. Наприклад, якщо остання опція — right, зображення вирівняється по правому краю, і текст оминатиме його з лівого боку: [[Файл:Ukraine Lutsk.jpg|70px|right]] (праворуч).

Цей текст зображено

розмірpx: Ця опція перемальовує зображення так, що воно матиме ширину розмір зазначених пікселів (наприклад [[Файл:Ukraine Lutsk.jpg|right|50px|]] праворуч). Висота підбирається так, щоб зберегти пропорції зображення); Зауважте, що ця опція не просто змінює видимий розмір, використовуючи HTML, насправді вона на льоту ґенерує нове зображення потрібного розміру. Це відбувається незалежно від того чи використовуєте ви опцію розмір разом із thumb., чи ні.

Зауваження:

Якщо використовуються дві і більше опцій «розміру», спрацює остання: [[Файл:Ukraine Lutsk.jpg|right|50px|80px]] (праворуч).

thumbnail, thumb: Замок Любарта
Опція thumbnail (thumb) ґенерує зображення-«марочку», при цьому використання опції «розмір» не обов'язкове. Без опцій left, center, і none, зображення розміщується праворуч. Якщо зображення має пояснювальний текст, він розміститься під зображенням. Наприклад, [[Файл:Ukraine Lutsk.jpg|thumbnail|left|100px|]] (ліворуч) і [[Файл:Ukraine Lutsk.jpg|thumb|Замок Любарта]] (праворуч).

Це глобус, подивіться як він виглядає в справжньому розмірі

Іконка «збільшити» також з'явиться під «марочкою». Як саме зображення, так і його іконка посилаються на сторінку із зображенням справжнього розміру. Іконка показуватиме заголовок посилання, «Enlarge» якщо мишка знаходитиметься над нею, навіть у випадках, коли термін неправильний, тобто справжнє зображення менше, ніж масштабоване. Наприклад: [[Image:tst.png|right|thumb|100px|Це глобус, подивіться як він виглядає[[Media:tst.png|в справжньому розмірі]]]] (праворуч).

frame: Замок Любарта
Якщо використовується ця опція, зображення буде перемальоване відповідно до його справжнього розміру, та розміщене в рамці. Опції «thumb» або «size» будуть проігноровані, і пояснювальний текст, якщо він є, розміститься у рамці. Якщо опції left, center і none відсутні, зображення розміститься праворуч: [[Файл:Ukraine Lutsk.jpg|frame|thumbnail|50px|Замок Любарта]].

Опцію none можна використати, щоб отримати «марочки» без вирівнювання по лівому чи правому краю. Імовірно, ця можливість найважливіша для використання в таблицях. Див. Довідка:Таблиці. Наприклад:

Як вживати `none`
Оборонні споруди Луцька
Замок Любарта	Луцький замок	`[[Файл:Ukraine Lutsk.jpg\|thumb\|none\|100px\|Луцький замок]]`
В'їзна вежа	Ласкаво просимо	`[[Файл:Lutsk castle tower.jpg\|thumb\|none\|100px\|Ласкаво просимо]]`

«Марочки» з пояснювальним текстом знизу, що містить посилання

Починаючи із MediaWiki 1.3, можна додати посилання в пояснювальний текст, наприклад:

[[Файл:Ukraine Lutsk.jpg|right|thumbnail|Це замок Любарта в [[Луцьк|Луцьку]]]]

Обов'язково переконайтесь, що кількість відкритих і закритих квадратних дужок однакова.

Як скасувати режим «обтікання» тексту навколо зображення

Якщо Ви хочете, щоб текст, починаючи із певного моменту, розміщувався під зображенням, на всю ширину сторінки, використайте такий код:

<br style="clear:both" />

Те ж саме можна зробити, використавши шаблон {{-}} або {{clear}}.

Галереї зображень

Докладніше: Довідка:Тег Gallery

Новий синтаксис дозволяє
легко створювати
галереї зображень

З параметром для кількості зображень у рядку (<gallery perrow=3>):

Новий синтаксис дозволяє
легко створювати
галереї зображень

Використання зображень з Вікісховища

Зображення з Wikimedia Commons вставляються так само, як і звичайні (локальні) зображення. Щоб додати зображення, використовуйте ключове слово Image: [[Image:Chicago Millenium Park2.jpg]].

Якщо ви переносите зображення із іншої вікіпедії, то зверніть увагу чи знаходиться воно у тій вікіпедії, чи у Вікісховищі. Якщо зразу під описом зображення, наприклад в англійській вікі, є текст на зразок: This is a file from the Wikimedia Commons. The description on its description page there is shown below., це означає, що зображення знаходиться у ВікіСховищі, і його не потрібно додатково завантажувати в українську Вікіпедію, а якщо нема, то потрібно зберегти на свій комп'ютер, і завантажити сюди, перенісши всю необхідну ліцензійну інформацію. Якщо зображення в іншомовній Вікіпедії має вільну ліцензію, то його потрібно перезавантажити у ВікіСховище (Commons) для того, щоб його могли використовувати в статтях інших Вікіпедій.

Шаблон	Вигляд
{{Commons2\|Bosporus\|Босфор}}, де Commons2 — назва шаблону, Bosporus — назва статті у ВікіСховище, Босфор — назва, яку видно у шаблоні.	Commons Вікісховище має мультимедійні дані за темою: Босфор

Див. також