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

Шаблон {{документація}} використовується для вмісту документальної інформації та інструкцій конкретних шаблонів, зазвичай з підсторінки /документація. Він також може бути сконфігурований для підвантаження контенту з інших сторінок, або безпосередньо з тексту.

Задля детальної інформації щодо того як і коли його використовувати, див. Вікіпедія:Документація шаблонів (скор.: ВП:ДОК).

Цей шаблон складається з двох частин: великого «контейнера документації» з документацією всередині з вбудованою панеллю інструментів (посилання [перегляд][редагувати][історія][очистити кеш]), та меншого «контейнера посилань», який показує метадані щодо документації разом із посиланнями пісочниць й тестів.

Використання шаблонів дозволяє їм бути захищеними, де це потрібно, одночасно дозволяючи будь-кому редагувати документацію та категорії.

Основний синтаксис

Зазвичай, шаблон використовується без параметрів та розташовується всередині <noinclude>...</noinclude> внизу сторінки шаблона (задля подробиць див. #Розміщення та теги):

<!--Останній рядок коду вашого шаблона--><noinclude>
{{документація}}
<!-- Додавайте категорії на підсторінку /документація -->
</noinclude>

Включення іншої сторінки

Для включення сторінки відмінної від підсторінки /документація, просто введіть |1= наступним чином:

<!--Останній рядок коду вашого шаблона--><noinclude>
{{документація|Шаблон:Інша сторіка/документація}}
</noinclude>

Зауважте, що якщо ви включаєте документацію зі сторінки відмінної від підсторінки /документація, стає складніше керувати категоріями.

Використання параметра |content=

Також документація може бути внесена безпосередньо текстом, з використанням параметра |content=:

<!--Останній рядок коду вашого шаблона--><noinclude>
{{документація
 | content =
<!-- документація шаблона -->
}}</noinclude>

При використанні цього параметра панель інструментів не відображатиметься. Зауважте, що підсторінка /документація у полі посилання все одно відображатиметься, якщо вона існує.

Також зауважте, що коли визначені |1= та |content=, |content= має пріоритет і завжди відображається у контейнері документації.

Розширений синтаксис

Налаштування заголовка

Заголовок у полі документації змінюється залежно від простору назв. Перегляньте наведений нижче перелік тексту за замовчуванням у кожному просторі назв:

• Простір шаблонів: Документація шаблону
• Простір модулів: Документація модуля
• Інші простори назв: Документація

Щоб налаштувати заголовок, просто встановіть параметр |heading= до будь чого, наприклад |heading=Документація картки.

Зауважте, якщо параметр заголовка порожній, але визначений (як |heading=) заголовок поруч із панеллю інструментів не відображатиметься.

Параметром |heading-style= можна вказати за бажанням значення CSS, як |heading-style=font-size:150%;color:red;. Зауважте, що ви повинні опускати лапки " " і додавати кінцеву крапку з комою ;.

Налаштування вікна посилання

Щоб налаштувати поле посилання, просто встановіть |link box= до іншого значення, like |link box=Наведена вище документація автоматично створюється з Шаблон:Foo.

Щоб приховати поле посилання, просто встановіть |link box= до off.

Тестування

Ви можете змоделювати вихід для певної сторінки за допомогою параметра |page=. Наприклад, якщо ви використовуєте код |page=Шаблон:Edit protected, шаблон поводитиметься так само, як якщо б він був на сторінці Шаблон:Edit protected, в тому числі показ документації з Шаблон:Edit protected/документація, посилаюченої до Шаблон:Edit protected/пісочниця, і т. д. Цей параметр корисний для тестування та широко використовується на сторінці тестів модуля.

Розміщення та теги

Наступний код слід додати внизу кодової сторінки шаблону без пробілу перед ним <noinclude> (що призводить до появи додаткових пробілів на сторінках, де включено шаблон):

<!--Останній рядок коду вашого шаблона--><noinclude>
{{документація}}
<!-- Додавайте категорії на підсторінку /документація -->
</noinclude>

Щоб автоматично вставити наведений вище текст, ви також можете скористатися підстановкою скорочення коду {{subst:doc-code}}.

Категорії та інтервікі

Залежно від того, де розміщено документацію, може бути складно працювати з категоріями та інтервікі. Задля отримання інформації про їх додавання див. Вікіпедія:Документація шаблонів#Категорії та інтервікі-посилання § Зауваження .

Технічні подробиці

Автоматичні функції

Якщо сторінка документації не існує, панель інструментів замінюється на посилання [створити]. Воно автоматично створює сторінку з передзавантаженим текстом з базовим синтаксисом документації. Предзавантажений текст також використовується для посилань [створити] на підсторінках /пісочниця та /тести.

Передзавантажувальна сторінка для посилання [створити] /документація розташована в Шаблон:Документація/preload. Передзавантажувальні сторінки для посилань /пісочниця та /тести Шаблон:Документація/preload-sandbox та Шаблон:Документація/preload-testcases. Передзавантажувальна сторінка для посилання [скопіювати] підсторінки /пасочниця Шаблон:Документація/mirror.

Шаблон також автоматично додає {{pp-template}} на захищені сторінки шаблонів, й таким чином не потрібно робити це вручну.

Коли шаблон розташований на підсторінці /пісочниця він автоматично додає шаблон {{Пісочниця шаблону}}.

Функції вікна посилань

В залежності від простору назв, контейнер посилань може мати менше функцій, або може не показувати усі. Наступна таблиця це відображає:

Простір назв	Функціонал
Шаблон	Повний функціонал
Модуль	Повний функціонал, з додаванням посилання «створити документацію» коли сторінка не існує
Користувач	Повний функціонал
Інші простори	Приховано, за виключенням коли |1= визначено (що буде показувати «Подана документація включена з {{{1}}}»)

На додачу до цього, якщо |1= або |content= визначені, рядок «Додавайте категорії на підсторінку /документація» не буде відображатися.

Предметні простори назв vs. простори назв обговорень

Цей шаблон зазвичай розташовується в предметних просторах. Але у деяких випадках цей шаблон може бути потрібно використати у просторах Обговорення:

• У просторі MediaWiki, оскільки <noinclude> часто не працює у системних повідомленнях, та оскільки простір MediaWiki потрібно тримати чистим задля продуктивності.

Коли розташований на сторінці обговорення, цей шаблон зазвичай розташовується біля початку сторінки та без тегів <noinclude>...</noinclude>.

Сторінки /документація, /пісочниця та /тести зазвичай повинні розташовуватися у предметному просторі, за виключенням коли простір назв не має активованої властивості підсторінки MediaWiki: Основний, Файл, та MediaWiki. (Категорії можуть мати підсторінки, але документація створюється в просторі обговорення Категорій задля уникнення створення порожніх категорій. Також є багато інших технічних причин, чому сторінка /документація повинна зберігатися під сторінкою обговорення для цих (але не тільки) просторів назв.

Цей шаблон автоматично пов'язує його посилання [створити] для /документація, /пісочниця та /тести до відповідного простору назв.

Повний синтаксис

{{документація}}

або

{{документація
 | [шлях до сторінки документації]
}}

{{документація
 | content =
}}

або

{{документація
| [шлях до сторінки документації]
| heading-style = 
| heading = 
| link box = 
}}

або 

{{документація
| [шлях до сторінки документації]
| content = 
| heading-style = 
| heading = 
| link box = 
| page =
}}

Кольорова схема

Фонові кольори Вікіпедії для {{documentation}} (Довідка:Кольори)

	RGB	HSV	Колір	Загальне використання	Зауваження
A	#ECFCF4	150°, 6 %, 99 %		Sample	Current documentation background
B	#00FF80	Hue=150° (41.7%; 106/255dec) 100%, 100%		Basic hue	What we'd call the color
1	#A3BFB1	150°, 15 %, 75 %		Header border only
2	#CEF2E0	150°, 15 %, 95 %		Main border; header background
3	#E6FFF2	150°, 10 %, 100 %		2nd header, accent colour
4	#F5FFFA	150°, 4 %, 100 %		Main background	So saturation in A is a bit off

Кольори для навігаційного контейнера документації

Як пропозицію, тут подано кольори для navbox-ів призначених тільки для сторінок документації. Вони дотримуються затінення звичайного синього кольору navbox-а: | titlestyle = background:#ccffe5 | basestyle = background:#ddffee <!-- basestyle= sets groupstyle, abovestyle, belowstyle together --> For subgroups, in child navboxes: {{Navbox|child | groupstyle = background:#e6fff2 ... Приклад:Шаблон:Template link expanded

Див. також

• {{Підсторінка документації}}
• {{Поліпшити документацію}}
• {{Без документації}}