Перегляд вихідного коду сторінки Шаблон:Rating/документація

{{Documentation subpage}}
{{Intricate template}}

Цей шаблон створено для вказування оцінок (рейтингу) за допомогою зображень. Стандартно використовуються зображення зірок. Шабло має можливість відтворення до десяти таких зірок, при чому починаючи з шести зірок їх розмір стає меншим із технічних причин.

== Коли варто використовувати цей шаблон ==
Цей шаблон працює з цілими й половинними числами (наприклад, 0, 0.5, 1, 1.5 тощо). Інші десяткові дроби (такі як 3.2, 7.25) заокруглюються, а сторінка з цим шаблоном потрапляє до категорії спостереження — [[:Категорія:Сторінки з неправильним використанням шаблону Rating]]. Використовуйте {{para|score}}, щоб додавати пояснювальний текст до оцінки, яку не можна виразити цілими чи половинними числами, або замість цього шаблону використовуйте просто цифри (наприклад, 3.2/5, 7.25/10 тощо).

Будь ласка, використовуйте цей шаблон лише якщо в оригінальному джерелі оцінка чи рейтинг були виражені за допомогою саме зображень, а не чисел. Наприклад, якщо оглядач оцінює якийсь твір, даючи йому оцінку «4» (виражену саме у формі цифри, а не чотирьох зірок) із п'яти, такий рейтинг у відповідній статті слід записати просто як «4» або «4/5», залежно від того, як його подано в джерелі. '''Не використовуйте''' формат <nowiki>{{rating|4|5}}</nowiki> там, де джерело не використовує зірок чи інших зображень, оскільки такий рейтинг є неточним і потенційно збиватиме з пантелику. Зверніть увагу також на те, що оцінки на десятизначній шкалі може бути важко прочитати, якщо їх візуально виразити через зображення.

== Параметри ==

=== Стандартно ===
Лише ці два параметри необхідні, щоб показати оцінку у формі зірок — стандартних символів, що використовуються в цьому шаблоні.
* ''Перший'' безіменний параметр — це числове значення отриманої оцінки.
* ''Другий'' безіменний параметр — необов'язковий, і є максимальним значенням системи, використаної для оцінювання. Його заповнення дозволить показати порожні елементи, що відповідатимуть залишку за межами поставленої оцінки, а також до тексту в спливному тексті-підказці буде додано «/''x''».

;Приклади
{|
| {{rating|4|5}} || {{tnull|rating|4|5}}
|-
| {{rating|0|3}} || {{tnull|rating|0|3}}
|-
| {{rating|3.5|6}} || {{tnull|rating|3.5|6}}
|-
| {{rating|8|8}} || {{tnull|rating|8|8}}
|-
| {{rating|5|10}} || {{tnull|rating|5|10}}
|-
| {{rating|3}} || {{tnull|rating|3}}
|}

=== Необов'язкові ===
Ці параметри є необов'язковими, і можуть змінити вигляд самої оцінки чи спливної підказки до неї.
* {{para|score}} використовується для вказування альтернативного тексту, який спливає при наведенні миші на зображення оцінки — у тих випадках, коли оцінка «x/x» неточна, або коли можна додати більше інформації.
* {{para|full}}, {{para|half}} та {{para|empty}} використовуються для зміни зображень зі стандартних зірок на будь-які інші зображення, вказані користувачем. Вам не треба заповнювати ці параметри для тих зображень, які Ви не будете використовувати, але пропускаючи ці параметри, Ви автоматично дозволяєте шаблону використовувати стандартні зображення зірок, заміну для яких Ви в цьому параметрі не вказали (наприклад, {{tnull|1=rating|2=2|3=5|4=full=Disc Plain red.svg}} у результаті дає  {{rating|2|5|full=Disc Plain red.svg}}). Заповнюючи ці параметри, слід вказувати назву файлу, без префіксів «Файл:» чи «Зображення:».
*: '''Важливо: використовувати можна лише зображення, що перебувають у суспільному надбанні, оскільки шаблон не дозволяє посилатися на їхні сторінки опису.'''
* {{para|rating}} слід використовувати для найменування нового символу оцінювання, якщо Ви змінюєте зображення.
* {{para|rating-plural}} приймає значення множини у спливній підказці.
* {{para|size}} можна використовувати для налаштування розміру графічних символів оцінювання. Стандартними значеннями шаблону є 11 пікселів ширини, якщо він містить до п'яти зірок чи інших зображень, 7 пікселів ширини, якщо шкала оцінювання має більш як 5 позицій (зірок чи інших зображень). Вказуйте кількість пікселів, додаючи до них позначення, власне, пікселів — «px» (наприклад, «15px», а не просто «15»).

;Приклади
{|
| {{rating|3|5|score=Три зірки з п'яти}}
| {{tnull|1=rating|2=3|3=5|4={{hilite|score}}=Три зірки з п'яти}}
|-
| {{rating|3|5|size=15px}}
| {{tnull|1=rating|2=3|3=5|4={{hilite|size}}=15px}}
|-
| {{rating|4|5|full=Gold medal icon blank.svg|empty=Silver medal icon blank.svg|rating=медаль|rating-plural=медалі}}
| {{tnull|1=rating|2=4|3=5|4={{hilite|full}}=Gold medal icon blank.svg|5={{hilite|empty}}=Silver medal icon blank.svg|6={{hilite|rating}}=медаль|rating-plural=медалей}}
|-
| {{rating|3.5|5|full=U+25CF.svg|half=U+25D0.svg|empty=U+25CB.svg|rating-plural=значків}}
| {{tnull|1=rating|2=3.5|3=5|4={{hilite|full}}=U+25CF.svg|5={{hilite|half}}=U+25D0.svg|6={{hilite|empty}}=U+25CB.svg|7={{hilite|rating-plural}}=значків}}
|-
| {{rating|2.5|5|full=Disc Plain red.svg|half=Cercle rouge 100%.svg|empty=Plain Disc 20% grey.svg|rating-plural=значків}}
| {{tnull|1=rating|2=2.5|3=5|4={{hilite|full}}=Disc Plain red.svg|5={{hilite|half}}=Cercle rouge 100&nbsp;%.svg|6={{hilite|empty}}=Plain Disc 20&nbsp;% grey.svg|7={{hilite|rating-plural}}=значків}}
|-
| {{rating|2|full=Symbol thumbs up.svg|rating=палець вгору|rating-plural=пальці вгору}}
| {{tnull|1=rating|2=2|3={{hilite|full}}=Symbol thumbs up.svg|4={{hilite|rating}}=палець вгору|5={{hilite|rating-plural}}=пальці вгору}}
|-
| {{rating|2|6|full=Symbol thumbs up.svg|empty=Symbol thumbs down.svg|rating=палець вгору|rating-plural=пальці вгору|score=2 пальці вгору, але 4 пальці вниз, що дає оцінку у 2/6|size=12px}}
| {{tnull|1=rating|2=2|3=6|4={{hilite|full}}=Symbol thumbs up.svg|5={{hilite|empty}}=Symbol thumbs down.svg|6={{hilite|rating}}=палець вгору|7={{hilite|rating-plural}}=пальці вгору|8={{hilite|score}}=2 пальці вгору, але 4 пальці вниз, що дає оцінку у 2/6|9={{hilite|size}}=12px}}
|}

== TemplateData ==
{{TemplateDataHeader}}
<templatedata>
{
        "description": "Шаблон для зазначення оцінки (рейтингу)",
        "params": {
                "1": {
                        "label": "Отримана",
                        "description": "Кількість отриманих зірок (чи інших зображень)",
                        "type": "number",
                        "required": true
                },
                "2": {
                        "label": "Можлива",
                        "description": "Кількість можливих зірок (чи інших зображень; стандартне значення — 1)",
                        "type": "number",
                        "required": false
                },
                "score": {
                        "label": "Оцінка",
                        "description": "Текст, який з'являється при наведенні миші на зображення",
                        "type": "string",
                        "required": false
                },
                "full": {
                        "label": "Повне альтернативне зображення",
                        "description": "Альтернативне зображення повної зірки, без префіксу Файл:",
                        "type": "string",
                        "default": "Star full.svg",
                        "required": false
                },
                "half": {
                        "label": "Альтернативне зображення половини",
                        "description": "Альтернативне зображення для половини зірки, без префіксу Файл:",
                        "type": "string",
                        "default": "Star half.svg",
                        "required": false
                },
                "empty": {
                        "label": "Альтернативне порожнє зображення",
                        "description": "Альтернативне зображення порожньої зірки, без префіксу Файл:",
                        "type": "string",
                        "default": "Star empty.svg",
                        "required": false
                },
                "rating": {
                        "label": "Символ оцінювання",
                        "description": "Параметр для альтернативних зображень, що відтворюють оцінку (замість зірок)",
                        "type": "string",
                        "default": "star",
                        "required": false
                },
                "rating-plural": {
                        "label": "Форма множини",
                        "description": "Форма множини в параметрі «rating»",
                        "type": "string",
                        "required": false
                },
                "size": {
                        "label": "Розмір зображень",
                        "description": "Розмір зображень, у пікселях",
                        "type": "string",
                        "default": "11px",
                        "required": false
                }
        }
}
</templatedata>

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Категорія:Шаблони:Музика]]
}}</includeonly>