Шаблон:Annotation/документація

Це підсторінка документації шаблону {{Annotation}} (обг. · викор. · ред.).
Вона містить інформацію про використання, категорії та інші дані, які не є частиною шаблону.

Створює нотатку для {{annotated image}}:

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

Застосування

Цей шаблон збоїтиме при застосуванні за межами шаблонів {{annotated image}} та {{annotated image 4}}.

{{Annotation| зліва (у пікселях)| згори (у пікселях) | текст | text-align=left | font-size=12 | font-weight=bold | font-family=Times New Roman | background-color=#ffcccee | color=blue}}
де:

Немає ключових слів для параметрів зліва, згори та текст, що є обов'язковими, і мусять бути присутніми в наведеному вище порядку. Решта параметрів є необов'язковими, мусять ідентифікуватися своїми ключовими словами (наприклад, font-size=...), та можуть з'являтися у довільному порядку.
зліва та згори встановлюють положення нотатки відносно верхнього лівого кута рамки, що містить зображення. Тобто, верхній лівий кут цієї рамки є 0,0. Ця рамка зазвичай буде більшою за саме зображення, щоби забезпечити місце для нотаток.
текст є текстом, що відображатиметься.
text-align (вирівнювання тексту) може бути встановлено у left (ліворуч), center (по центру) або right (праворуч), і має значення лише тоді, коли нотатка простягається на кілька рядків.
font-size (розмір шрифту) задається в пікселях — відносні розміри CSS не підтримуються.
font-weight (насиченість шрифту) є bold (жирним) або normal (нормальним).
font-family (сімейство шрифту) є назвою CSS шрифта, наприклад, Times New Roman або Verdana
background-color (колір тла) стандартно є прозорим.
color (колір) є кольором тексту та стандартно є чорним, що є стандартним кольором тексту в більшості таблиць стилів Вікіпедії. Зокрема, синій найкраще застосовувати лише для посилань.

Назви розширених параметрів для застосування в інших шаблонах

Деякі з параметрів мають альтернативні назви, що застосовуються шаблонами, що включають Шаблон:Annotation, для його виклику. Альтернативні назви надаються на випадок того, що шаблони, які викликають цей, викликають й інші шаблони, що використовують схожі параметри.

Ці альтернативні назви надаються так, що шаблони, які включають цей, можуть надавати стандартні значення для відповідних параметрів у Шаблон:Annotation, і не повинні застосовуватися для будь-якої іншої мети. Значення, вказані із застосуванням основних назв параметрів, перелічених вище, матимуть перевагу над альтернативними назвами, застосованими шаблонами, які включають цей.

Ось альтернативні назви та основні параметри шаблону Annotation, для яких вони встановлюють стандартні значення:

Альтернативна назва	Основна назва
annot-text-align	text-align
annot-font-size	font-size
annot-font-weight	font-weight
annot-font-family	font-family
annot-background-color	background-color
annot-color	color