ФЭНДОМ


Эта справочная статья поможет вам разобраться с рекомендуемыми способами подключения дополнительных страниц JS и CSS.

ImportJS

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

Функционал этого метода схож с методом importArticles, который загружает страницы с других сообществ, связывая их в одну, уменьшая данные и укладывая всё в один запрос. Такой способ позволяет снизить размер файлов и сократить расход трафика, увеличивая эффективность и скорость загрузки скриптов на вики.

Плюс данного метода в том, что любое изменение страницы MediaWiki:ImportJS не требует прохождения проверки JS.

Применение

MediaWiki:ImportJS работает с простым текстом, в котором перечисляются названия страниц со скриптами. Локальные страницы должны находиться в пространстве имён MediaWiki. Это также касается и страниц с Dev Wiki. Во время заполнения MediaWiki:ImportJS, у названия страниц обязательно нужно отбросить приставку 'MediaWiki'. Пример:

Cat.js
dev:AjaxRC.js
  • первая ссылка — на локальную js-страницу по адресу MediaWiki:Cat.js
  • вторая — на скрипт с dev вики со страницы w:c:dev:MediaWiki:AjaxRC.js

Примечание: следует избегать использования комментариев через двойную черту //, т.к. они учитываются как обычный текст на странице.

Порядок загрузки

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

  1. Common.js
  2. Wikia.js
  3. Загрузка скриптов, подгружаемых с Common.js
  4. Загрузка скриптов, подгружаемых с Wikia.js
  5. ImportJS

Импорт CSS

importArticles

В данном разделе способ importArticles будет рассматриваться только для загрузки страниц CSS. Ознакомиться с принципами его действия для JS можно здесь.

Несмотря на то, что с помощью этого метода всё ещё можно импортировать страницы со стилями, любое его изменение будет тормозиться процессом проверки JS, так как метод основан на использовании JavaScript.

Пример

Загрузка локального CSS файла через importArticles:

importArticles({
    type: "style",
    article: "MediaWiki:Local.css"
});

Метод @import

Используя данный метод, вы легко сможете импортировать CSS файлы. Синтаксис метода выглядит следующим образом:

@import "путь_до_статьи_со_стилями.css"

Следуя инструкции выше, чтобы загрузить Local.css в Wikia.css, нужно разместить следующий код в самом начале Wikia.css:

@import "/index.php?title=MediaWiki:Local.css&action=raw&ctype=text/css";

Более подробно с данным методом прогрузки можно ознакомиться здесь.

Примечания

  • В целях оптимизации код из некоторых файлов при загрузке страницы может быть объединён в один файл.

См. также

Материалы сообщества доступны в соответствии с условиями лицензии CC-BY-SA , если не указано иное.