From 218934fa2ed1c702a6d3923d2aa2cc6b43c48684 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:43:23 -0500 Subject: initial commit --- files/uk/mdn/structures/index.html | 14 ++ .../index.html" | 46 ++++ .../index.html" | 233 +++++++++++++++++++++ 3 files changed, 293 insertions(+) create mode 100644 files/uk/mdn/structures/index.html create mode 100644 "files/uk/mdn/structures/\321\210\320\260\320\261\320\273\320\276\320\275\320\270/index.html" create mode 100644 "files/uk/mdn/structures/\321\210\320\260\320\261\320\273\320\276\320\275\320\270/\320\267\320\260\320\263\320\260\320\273\321\214\320\275\320\276\320\262\320\266\320\270\320\262\320\260\320\275\321\226_\321\210\320\260\320\261\320\273\320\276\320\275\320\270/index.html" (limited to 'files/uk/mdn/structures') diff --git a/files/uk/mdn/structures/index.html b/files/uk/mdn/structures/index.html new file mode 100644 index 0000000000..021aba74ea --- /dev/null +++ b/files/uk/mdn/structures/index.html @@ -0,0 +1,14 @@ +--- +title: Документові структури +slug: MDN/Structures +tags: + - Landing + - MDN Meta + - Structures +translation_of: MDN/Structures +--- +
{{MDNSidebar}}
{{IncludeSubnav("/uk/docs/MDN")}}
+ +

На сторінках MDN можна знайти чимало різних повторюваних структур, що призначені для послідовного й упорядкованого викладення інформації у статтях MDN. Тут наведено статті, що описують ці структури, тож ви, як автор MDN, можете їх впізнавати, вживати й змінювати відповідним чином для документів, які ви створюєте, редагуєте чи перекладаєте.

+ +

{{LandingPageListSubPages()}}

diff --git "a/files/uk/mdn/structures/\321\210\320\260\320\261\320\273\320\276\320\275\320\270/index.html" "b/files/uk/mdn/structures/\321\210\320\260\320\261\320\273\320\276\320\275\320\270/index.html" new file mode 100644 index 0000000000..41c1461950 --- /dev/null +++ "b/files/uk/mdn/structures/\321\210\320\260\320\261\320\273\320\276\320\275\320\270/index.html" @@ -0,0 +1,46 @@ +--- +title: Шаблони +slug: MDN/Structures/Шаблони +tags: + - Kuma + - KumaScript + - MDN Meta + - Structures + - Путівник +translation_of: MDN/Structures/Macros +--- +
{{MDNSidebar}}

Платформа Kuma, що на ній працює MDN, має потужний механізм шаблонів (макросів), KumaScript, який уможливлює автоматизацію чималої кількості речей. Ця сторінка надає інформацію про вжиток шаблонів MDN всередині статей.

+ +

Путівник з KumaScript пропонує поглиблені знання з ужитку шаблонів на MDN, тож ця стаття є радше оглядовою.

+ +

Як працюють шаблони

+ +

Шаблони MDN написані мовою JavaScript та виконуються у серверному середовищі Node.js. Задля уможливлення взаємодії шаблонів із вікі-платформою та її вмістом ми створили низку бібліотек, що надають відповідні можливості та служби. Як хочете дізнатись більше, зверніться до Путівника з KumaScript.

+ +

Вжиток шаблонів

+ +

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

+ +
\{{macroname(перелік-параметрів)}}
+ +

Кілька зауважень щодо викликів шаблонів:

+ + + +

Для шаблонів діє окремий кеш: для кожної множини вхідних даних (вказаних параметрів та значень з середовища, як-от адреса сторінки, де ужито шаблон) результат одноразово обчислюється та зберігається для подальшого використання. Отже шаблон насправді викликається лише тоді, коли змінюються вхідні дані.

+ +
+

Заувага: Ви можете здійснити примусове обчислення всіх шаблонів на сторінці, перезавантаживши сторінку у веб-переглядачі зі скиданням кешів (зазвичай Ctrl + F5 або Shift + F5).

+
+ +

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

+ +

Про найпоширеніші шаблони ви можете довідатись на сторінці Загальновживані шаблони. Також є і повний їх перелік. Багато шаблонів має вбудовану документацію (коментарі у коді на початку файлу).

+ +

{{EditorGuideQuicklinks}}

diff --git "a/files/uk/mdn/structures/\321\210\320\260\320\261\320\273\320\276\320\275\320\270/\320\267\320\260\320\263\320\260\320\273\321\214\320\275\320\276\320\262\320\266\320\270\320\262\320\260\320\275\321\226_\321\210\320\260\320\261\320\273\320\276\320\275\320\270/index.html" "b/files/uk/mdn/structures/\321\210\320\260\320\261\320\273\320\276\320\275\320\270/\320\267\320\260\320\263\320\260\320\273\321\214\320\275\320\276\320\262\320\266\320\270\320\262\320\260\320\275\321\226_\321\210\320\260\320\261\320\273\320\276\320\275\320\270/index.html" new file mode 100644 index 0000000000..da18bfcaa1 --- /dev/null +++ "b/files/uk/mdn/structures/\321\210\320\260\320\261\320\273\320\276\320\275\320\270/\320\267\320\260\320\263\320\260\320\273\321\214\320\275\320\276\320\262\320\266\320\270\320\262\320\260\320\275\321\226_\321\210\320\260\320\261\320\273\320\276\320\275\320\270/index.html" @@ -0,0 +1,233 @@ +--- +title: Загальновживані шаблони +slug: MDN/Structures/Шаблони/Загальновживані_шаблони +tags: + - Structures + - Довідка + - Макрос +translation_of: MDN/Structures/Macros/Commonly-used_macros +--- +
{{MDNSidebar}}
+ +
+ +

На цій сторінці подано багато макросів загального призначення, які створені для використання на платформі MDN. Інформацію про використання цих макросів дивіться в розділі Використання макросів, а також Використання посилань макросів. Подивіться Інші макроси для інформації про макроси, які рідко використовуються, використовуються тільки в особливих контекстах або важаються застарілими. Також є повний список всіх макросів для MDN. 

+ +

Див. також CSS посібник стилів для стилів, які можуть бути доступні для вашого використання.

+ +

Посилання

+ +

Створення єдиного гіперпосилання

+ +

Зазвичай немає необхідності використовувати макроси для створення посилань довільної форми. Для створення посилань використовуйте кнопку Link (Вставити / Редагувати посилання) в інтерфейсі редактора.

+ + + +

Посилання на сторінки в довіднику

+ +

Існують різноманітні макроси для з'єднання зі сторінками в певних довідкових областях MDN.

+ + + +

Посилання на помилки і IRC

+ + + +

Навігаційні інструменти для багатосторінкових довідників

+ +

{{TemplateLink("Previous")}}, {{TemplateLink("Next")}}, або {{TemplateLink("PreviousNext")}} забезпечує управління навігацією для елементів, що входять в послідовність. Для односпрямованих шаблонів єдиним необхідним параметром є розташування wiki попередньої і наступної статті в послідовності. Для {{TemplateLink("PreviousNext")}}, два параметра, які потрібні, - це розташування відповідних статей в wiki-каталозі. Перший параметр відноситься до попередньої статті, а другий - до наступної.

+ +

Зразки коду

+ +

Зразки наживо

+ + + +

Файли з прикріпленими прикладами

+ + + +

Створення бічної панелі

+ +

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

+ + + +

Загальне форматування

+ +

Вбудовані індикатори для документації API

+ +

{{TemplateLink("optional_inline")}} та {{TemplateLink("ReadOnlyInline")}} використовуються в документації API, зазвичай при описі списку властивостей об'єкта або параметрів функції.

+ +

Використання: \{{optional_inline()}} або \{{ReadOnlyInline()}}. Наприклад: 

+ +
+
isCustomObject {{ReadOnlyInline()}}
+
Вказує, якщо true, що об'єкт є призначеним для користувача.
+
parameterX {{ optional_inline() }}
+
Бла-бла-бла...
+
+ +

Позначки про статус та сумісність

+ +

Вбудовані індикатори без додаткових параметрів

+ +

Нетипові

+ +

{{TemplateLink("non-standard_inline")}} вставляє в рядок мітку, яка вказує на те, що API ні стандартизований і не перебуває на стандартній платформі.

+ +
Синтаксис
+ +

\{{non-standard_inline}}

+ +
Приклади
+ + + +

Експериментальний

+ +

{{TemplateLink("experimental_inline")}} вставляє позначку в рядку, що вказує на те, що API застосовується недостатньо широко і може змінитися в майбутньому.

+ +
Синтаксис
+ +

\{{Experimental_Inline}}

+ +
Приклади
+ + + +

Вбудовані індикатори, що підтримують вказівку технології

+ +

У таких макросах параметром (при зазначенні) повинен бути будь-який з рядків "html", "js", "css" або "gecko" з подальшим номером версії.

+ +

Вилучені елементи

+ +

{{TemplateLink("deprecated_inline")}} поміщає в рядок маркування вилучений, щоб запобігти використанню офіційно застарілого API. Зауваження: "Deprecated" означає, що елемент більше не повинен використовуватися, але все одно повинен функціонувати. Якщо ви маєте на увазі, що він більше не працює, використовуйте термін "obsolete."

+ +

Не використовуйте параметр в будь-якій незалежній від браузера області (HTML, API, JS, CSS, ...).

+ +
Синтаксис
+ +

\{{deprecated_inline}} or \{{deprecated_inline("gecko5")}}

+ +
Приклади
+ + + +

Застарілі елементи

+ +

{{TemplateLink("obsolete_inline")}} поміщає в рядок маркування застарілий, щоб запобігти використанню, наприклад, функції, методу чи властивості, які офіційно застаріли.

+ +

Не використовуйте параметр в будь-якій незалежній від браузера області (HTML, API, JS, CSS, ...).

+ +
Синтаксис
+ +

\{{obsolete_inline}} or \{{obsolete_inline("js1.8.5")}}

+ +
Приклади
+ + + +

Шаблонні значки

+ +

Ці макроси в переважно застосовуються на WebAPI сторінках. Перегляньте {{anch("Creating new badges")}} для інформації про створення нового значка.

+ +

Індикатори заголовків сторінок або розділів

+ +

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

+ + + +

Зазначення того, що функція доступна у web workers

+ +

The {{TemplateLink("AvailableInWorkers")}} макрос вставляє відповідне поле для приміток, що вказує на те, що функція є доступною у Web worker контекст.

+ +

Інформація про версії макросів

+ +

Ці макроси використовуються для зазначення того, що вміст стосується тільки певних версій продукту.

+ + + +

Ці макроси не відображаються, якщо зазначена версія нижче поточної gecko версії.

+ + + +
    +
+ +
    +
-- cgit v1.2.3-54-g00ecf