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

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

Скорочення

{{Xref}}
{{Crossref}}

Цей шаблон використовує Lua:

Module:Hatnote inline (пісочниця)

Цей шаблон використовує TemplateStyles:

Шаблон:Crossreference/styles.css

Шаблон {{Crossreference}} (a.k.a. {{crossref}} або {{xref}}) форматує текст в стандартизованому стилі для рядкового (а не блокового) перехресного посилання Вікіпедії (англ. Wikipedia crossreference) типу «(Див. також ...)» в круглих дужках на інший матеріал Вікіпедії. Коли він на іншій сторінці, то такі посилання є самопосиланнями Вікіпедії, що непридатні для друку. Коли матеріал перехресного посилання на тій же сторінці, що і саме перехресне посилання, та такі посилання не є самопосиланнями. Для блокових перехресних посилань, дивіться меташаблон {{Hatnote}} та його різні похідні шаблони ({{Див. також}} тощо). Результат зрештою формується модулем Модуль:Hatnote inline. Він насправді підтримує режим блокового рівня, однак, для особливих випадків (дивіться нижче розділ документації про параметри шаблону).

Дивіться Категорія:Шаблони крос-посилань щодо інших шаблонів, що пішли від цього шаблону або подібні до цього шаблону.

Використання

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

Просте перехресне посилання на іншу сторінку:

Розмітка	Рендериться як
{{Crossreference\|(Див. також [[Віги (партія)]].)}}	(Див. також Віги (партія).)

Просте перехресне посилання на цю ж сторінку:

Розмітка	Рендериться як
{{Crossreference\|selfref=no\|(дивіться [[#Параметри]])}}	(дивіться #Параметри)

Усі параметри:

Розмітка	Рендериться як
{{Crossreference\|class=class1 class2\|selfref=no\|inline=no\|Blargh: * Foo * Bar * Baz }}	Blargh: Foo Bar Baz

Параметри

Цей шаблон підтримує наступні параметри:

|1=, |text= або |content= — текст перехресного посилання (обов'язковий параметр). Хоча явне вказування назви цього параметра через |1=, |text= або |content= не є обов'язковими, але це завжди безпечніше робити так, бо будь-який символ = в текст зламає шаблон, якщо параметр є неназваним.
|class= або |extraclasses= — додає будь-які допоміжні класи CSS. Зазвичай, цей параметр не повинен використовуватися.
|selfref=no — Якщо встановити no (або n, false, 0 тощо), то видалить стандартний клас CSS selfref. Його використано, щоб вказати самопосилання на Вікіпедію, що не придатне для друку, . Ця опція не повинна використовуватися для посилань між статтями, лише для посилань в межах однієї статті (для цієї мети можна використовувати укорочені шаблони {{See above}} і {{See below}}). Псевдоніми параметра |printworthy=yes або |pw=yes (також з будь-яким іншим значенням такими, як y, true, 1 тощо) та |unprintworthy=no (або n, false, 0) мають такий самий результат як і |selfref=no. Параметр також можна використати для перехресного посилання між внутрішніми статтями Вікіпедії, такими як настанови й політики; у цьому випадку не має раціональних причин для приховування посилань при друці. Зверніть увагу: Ці параметри ще не є розумними, а тому не виявляють протилежні значення; такі, як |printworthy=no та |unprintworthy=yes не матимуть бажаного результату (та будуть в будь-якому разі зайвими, бо значення «непридатності до друку» є стандартними значенням).
|inline= — стандартне значення yes. Якщо встановити no (або n, false, 0 тощо), то шаблон використає елемент <div> замість <span>, щоб ви могли використати в середині елементи блокового рівня, такі як список. Різницею між {{crossreference|inline=no|...}} та {{Hatnote|...}} є те, що перший не має відступу на відміну від останнього. Видалення відступу здійснено стилями шаблону, а саме в Шаблон:Crossreference/styles.css.

CSS

Цей шаблон завжди додає клас CSS crossreference, тому ви можете використати Довідка:Персональне оформлення, щоб зробити те, що ви бажаєте з цим класом. Вам буде потрібно використати !important скоріше лише для випадку, коли захочете перезаписати дію шаблону про недодавання відступу, коли він у блоковому режимі (тобто, коли ви хочете, щоб він додавав відступ так, як це робить шаблон {{Hatnote}}), і тоді ви це робитимете через власні стилі користувача, такі як Спеціальна:Моя Сторінка/common.css. Це тому, що TemplateStyles насправді завантажуються вже після завантаження власних стилів користувача, тому ви маєте перезаписати TemplateStyle, використавши прапорець пріоритетності !important.

Перенаправлення

Нижче наведено альтернативні назви, що перенаправляють на цей шаблон:

{{xref}}
{{crossref}}
{{cross-ref}}
{{cross-reference}}

Див. також

{{Hatnote inline}} — меташаблон, який використовується цим та іншими шаблоном
{{See above}} і {{See below}} — деякі специфічні шаблони, що є похідними від {{Crossreference}} з вартим для друку параметром
Шаблон:Hatnote templates — документація для всіх верхніх приміток блокового формату

Template data

Це документація TemplateData для шаблону Crossreference, яка використовується Візуальним редактором та іншими інструментами.

Форматує текст в стандартизованому стилі для рядкового (а не блокового) перехресного посилання Вікіпедії (англ. Wikipedia crossreference) типу «(Див. також ...)» в круглих дужках на інший матеріал Вікіпедії.

Параметри шаблону
Для цього шаблону краще внутрішнє форматування параметрів.
Параметр		Опис	Тип	Статус
Текст	`text` `1` `content`	Текст перехресного посилання. Хоча явне вказування назви цього параметра через \|1=, \|text= або \|content= не є обов'язковими, але це завжди безпечніше робити так, бо будь-який символ = в текст зламає шаблон, якщо параметр є неназваним. Приклад (Див. також [[Віги (партія)]].)	Рядок	обов'язковий
Вартий для друку, чи ні?	`printworthy` `selfref` `pw` `unprintworthy`	Якщо встановити no (або n, false, 0 тощо), то видалить стандартний клас CSS selfref. Його використано, щоб вказати самопосилання на Вікіпедію, що не придатне для друку, (детальніше дивіться Шаблон:Selfref). Ця опція не повинна використовуватися для посилань між статтями, лише для посилань в межах однієї статті (для цієї мети можна використовувати укорочені шаблони {{See above}} і {{See below}}). Псевдоніми параметра \|printworthy=yes або \|pw=yes (також з будь-яким іншим значенням такими, як y, true, 1 тощо) та \|unprintworthy=no (або n, false, 0) мають такий самий результат як і \|selfref=no. Параметр також можна використати для перехресного посилання між внутрішніми статтями Вікіпедії, такими як настанови й політики; у цьому випадку не має раціональних причин для приховування посилань при друці. Зверніть увагу: Ці параметри ще не є розумними, а тому не виявляють протилежні значення; такі, як \|printworthy=no та \|unprintworthy=yes не матимуть бажаного результату (та будуть в будь-якому разі зайвими, бо значення «непридатності до друку» є стандартними значенням). Приклад \|selfref=no	Логічне значення	необов'язковий
Класи CSS	`class` `extraclasses`	Додає будь-які допоміжні класи CSS. Зазвичай, цей параметр не повинен використовуватися.	Короткий текст	необов'язковий
Як рядком, чи ні?	`inline`	Стандартне значення yes. Якщо встановити no (або n, false, 0 тощо), то шаблон використає елемент <div> замість <span>, щоб ви могли використати в середині елементи блокового рівня, такі як список. Різницею між {{crossreference\|inline=no\|...}} та {{Hatnote\|...}} є те, що перший не має відступу на відміну від останнього. Видалення відступу здійснено стилями шаблону, а саме в Шаблон:Crossreference/styles.css. Приклад \|inline=no	Логічне значення	необов'язковий