Справка:Создание навигационных шаблонов

Материал из Terraria Wiki
Перейти к: навигация, поиск

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

В качестве примера мы будем рассматривать шаблон {{драгоценные камни}}.

Основа шаблона[править код]

Ниже данный краткий вариант для работы навигационного шаблона:

{{navbox|key=<название_шаблона>|purge=<noinclude>y</noinclude>
|$collapsed$ = {{#if:{{{collapsed|}}}|mw-collapsed|}}
|$show-potion$ = {{#if:{{{show-potion|}}}||mw-collapsed}}
}}<noinclude>{{i18n-ready}}{{doc}}<noinclude>

Пояснение бозначений:

  • Значение <название_шаблона> обозначает место расположения навигационного шаблона, обычно совпадающее с названием текущего шаблона (без «Шаблон:»). Например, в шаблоне «драгоценные камни» это значение должно быть записано как драгоценные_камни. Первая буква значения автоматически примет вид заглавной буквы.
  • Значение |purge=<noinclude>y</noinclude> используется для очистки кэша при посещении самого шаблона. Шаблон {{navbox}} использует LuaCache для увеличения производительности; именно поэтому, мы сможем увидеть самое последнее обновление шаблона.
  • Значения, выглядящие $вот_так$, используются для задания параметров, контролирующих возможность сворачиваемости/разворачиваемости навигационного шаблона на странице или в её разделах.

К примеру, исходный код шаблона «драгоценные камни» должен выглядеть так:

{{navbox|key=драгоценные_камни|purge=<noinclude>y</noinclude>}}<noinclude>{{i18n-ready}}{{doc}}<noinclude>

Структура навигационного шаблона на этом завершена. Теперь он готов к интернационализации (i18n) и имеет упрощённый механизм кэширования данных.

Далее необходимо создать само содержимое шаблона, т.е. контент.

Стандартное содержимое (для русскоязычного раздела)[править код]

Содержимое навигационного шаблона должно располагаться на подстранице /content. Например, для шаблона «драгоценные камни» такая подстраница носит название «драгоценные камни/content».

Основной контент должен быть задан исключительно на русском языке. Он будет использоваться тогда, когда язык интерфейса вики по умолчанию является русским, в противном случае, если отсутствует локализованная версия (l10n) для текущего вики-проекта. (данный пункт неактуален для русскоязычного раздела вики)

Вы можете использовать |class = $placeholder$ в шаблоне {{navbox/start}} для того, чтобы сам {{navbox}} принял свёрнутое состояние.

Локализация шаблона на другие языки[править код]

В англоязычном разделе Terraria Wiki есть возможность создавать локализованные версии шаблонов на другие языки (L10n) посредством создания отдельной подстраницы с кодом языка. См. подробнее англоязычный справочный раздел Making a Navigational Template.