FANDOM


Глобальний метод JavaScript importArticles () надає загальний інтерфейс для включення статей, які містять скрипти або стилі на вікі. Функціональність аналогічна існуючим методам importScriptPage і importStylesheetPage. Тим не менш, в importArticles () можна імпортувати статті із зовнішніх вікі, пов'язувати кілька статей в одну, зменшувати їх і служити їм в якості одного запиту. Це зменшує і розміри файлів і веб-трафіку, збільшуючи швидкість завантаження сторінок на вікі з великою кількістю додаткових файлів.

ImportJS Редагувати

Цей метод додає нову сторінку MediaWiki:ImportJS разом з інтерфейсом, що дозволяє підключати як локальні сторінки скриптами, так і сторінки з Dev Wiki.

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

Плюс даного методу в тому, що будь-яка зміна сторінки MediaWiki:ImportJS не вимагає проходження перевірки JS.

Застосування Редагувати

MediaWiki:ImportJS працює з простим текстом, в якому перераховуються назви сторінок зі скриптами. Локальні сторінки повинні перебувати в просторі імен MediaWiki. Це також стосується і сторінок з Dev Wiki (підтримка завантаження буде реалізована найближчим часом). Під час заповнення MediaWiki:ImportJS, у назви сторінок обов'язково потрібно відкинути приставку 'MediaWiki'. Приклад:

Cat.js        //локальна JS сторінка (оригінал: MediaWiki:Cat.js)
dev:AjaxRC.js // Dev Wiki скрипт (оригінал: dev:MediaWiki:AjaxRC.js)

Порядок завантаження Редагувати

При використанні даного методу варто врахувати, що всі сторінки з ImportJS будуть провантажені в останню чергу! Порядок провантаження:

  1. Common.js
  2. Wikia.js
  3. Загрузка скриптів, що підвантажуються з Common.js
  4. Загрузка скриптів, що підвантажуються з Wikia.js
  5. ImportJS

Імпорт CSS Редагувати

Метод ImportArticles () заснований на визначенні модуля для завантаження статей. Наступні властивості необхідні в кожному модулі:

  • Type-позначає тип вмісту сторінки. Підтримуються наступні типи:
  • Articles- статті, які Ви хочете імпортувати.

Будь-яка кількість модулів може бути передано в importArticles (). Тим не менш,всі статті в модулі повинні бути того ж типу.

Доступ до статей Редагувати

Для того, щоб ми могли знайти статті, які Ви намагаєтеся імпортувати, ми надаємо простий синтаксис для розміщення статей. Цей синтаксис дуже схожий і сумісний з посиланнями міжвікі:

(Prefix:<НазваніеВікі>:)<Article>

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

Місцеві статті Редагувати

Статті з місцевої вікі можуть бути розташовані за назвою таким же чином, яким Ви зв'язуєтеся з ними нормально. Вони не вимагають префікса або імені вікі, хоча, для зручності є місцевий префікс (або «L» (local) для стислості). Наприклад, якщо Ви хочете імпортувати статті MediaWiki:Common.js, будь-який з наступних кодів буде працювати:

MediaWiki:Common.js
l:MediaWiki:Common.js
local:MediaWiki:Common.js

Зовнішні статті Редагувати

Статті від зовнішніх вікі можуть бути розташовані так само, як якщо б Ви посилалися на них зазвичай. Однак, на відміну від місцевих статей, зовнішні статті вимагають використання префікса та імені вікі, щоб визначити, з якої вики Ви будете їх імпортувати і як Ви будете визначати, що це за вікі. В даний час ми підтримуємо вікі їх ім'я бази даних, зазвичай англійська назва Вікі, і його URL. Пошук в базі даних виконується для зовнішнього префікса (або «remote» або «W» для стислості) та URL виконання пошуку по URL префікс (або «U» для стислості). Наприклад, якщо Ви хочете, імпортувати {{#NewWindowLink:http://dev.wikia.com/index.php? Title=Highlight/code.css|Highlight/code.css}} від {{#NewWindowLink:http://dev.wikia.com%7CDev}} вики, будь-який з наступних кодів буде працювати:

w:dev:Highlight/code.css
remote:dev:Highlight/code.css
external:dev:Highlight/code.css
u:dev:Highlight/code.css
url:dev:Highlight/code.css
u:dev.wikia.com:Highlight/code.css
url:dev.wikia.com:Highlight/code.css

Цей синтаксис також працюватиме на вікіпроектах інших мов. Наприклад, якщо Ви хочете імпортувати статті MediaWiki:Common.js італійської One Piece Wiki:

u:it.onepiece:MediaWiki:Common.js
url:it.onepiece:MediaWiki:Common.js
url:it.onepiece.wikia.com:MediaWiki:Common.js

Розширене використання Редагувати

«За лаштунками» метод importArticles () виконує три необхідні завдання: створення правильно відформатований URL для використання з ResourceLoader, виконуючи санітарні перевірки на модулі і забезпечення зворотного зв'язку з користувачем в разі помилки. Тим не менше, використання методу не є строго обов'язковим, щоб отримати переваги об'єднання і minifying в декількох статтях. Якщо Ви хочете, то Ви можете генерувати URL вручну і завантажити активи, використовуючи інші засоби, такі як [1] в CSS або jQuery.getScript в JavaScript.

Хоча є багато параметрів, які можна включити в URL. Наступні є найбільш корисними:

Параметр Опис параметра
mode ПовідомляєResourceLoader, що ми завантажуємо статті. Повинен бути встановлений на «статті» (articles).
articles У списку статей. Якщо передбачено кілька статей, вони повинні бути відокремлені один від одного «|».
only Тип статті для імпорту. Повинен бути встановлений на «скрипти» (scripts) або «стилі» (styles).
debug Цей параметр не є необхідним за замовчуванням, але може бути встановлений на «true», щоб відключити мінімізацію для спрощення налагодження проблем в імпортованих статтях.

Зрештою, Ви повинні закінчити з URL, і це має виглядати приблизно так:

/load.php? Mode=articles & articles=One.css|Two.css & only=styles

Який може бути використаний в поєднанні з import, ось так:

@ import url("/load.php? Mode=articles & articles=One.css|Two.css & only=styles");

Приклади Редагувати

Імпорт декількох статей, один з місцевої вікі (локальної, своєї) і один з зовнішньої вікі:

importArticles({
    type: "script",
    articles: [
        "MediaWiki:MyCustomJavaScript.js",
        "External:dev:MediaWiki:External_include.js"
    ]
});

Імпорт декількох статей стилю, один з місцевої вікі (локальної, своєї) і один з зовнішньої вікі:

importArticles({
    type: "style",
    articles: [
        "MediaWiki:Common.css",
        "External:starwars:MediaWiki:External_include.css"
    ]
});

Імпорт також можна реалізувати наступним чином:

importScriptPage('назва статті', 'префікс (dev, lost ..)');

Приміром,

importScriptPage('PurgeButton/code.js', 'dev');

дасть вам клавішу «Оновити» в меню редагування.

Імпорт декількох модулів одним методом:

importArticles({
    type: "script",
    articles: [
        "MediaWiki:MyCustomJavaScript.js",
        "External:dev:MediaWiki:External_include.js"
    ]
}, {
    type: "style",
    article: "MediaWiki:Common.css"
});

Альтернативний приклад синтаксису Редагувати

ImportArticles () також підтримує спрощений, альтернативний синтаксис для загальних випадків використання.

В тому числі один файл з локальної вікі, використовуючи визначення модуля:

importArticle({
    type: "style",
    article: "MediaWiki:Common.css"
});

Див. Також Редагувати

Community content is available under CC-BY-SA unless otherwise noted.