Шаблон:Skin
Статус релиза: неизвестно |
|||
|---|---|---|---|
| Описание | {{{description}}} | ||
| Автор(ы) | SomeAuthor | ||
| Последняя версия | {{{version}}} ({{{update}}}) | ||
| Последняя предварительная версия | {{{version preview}}} ({{{update preview}}}) | ||
| Политика совместимости | недействительно | ||
| MediaWiki | {{{mediawiki}}} | ||
| PHP | {{{php}}} | ||
| Composer | {{{composer}}} | ||
| Лицензия | {{{license}}} | ||
| Скачать | {{{download}}} {{{readme}}} {{{changelog}}} |
||
| Пример | {{{example}}} | ||
|
|||
| {{{compatibility}}} | |||
| Переведите тему оформления Skin, если он доступен на translatewiki.net | |||
| Роль Vagrant | {{{vagrant-role}}} | ||
| Проблемы | [[phab:tag/{{{phabricator}}}|Открытые задачи]] · Сообщить об ошибке | ||
Этот шаблон должен быть добавлен на все страницы тем оформления в этой вики (но только на главную страницу), чтобы отобразить информационное окно (инфобокс) и категоризировать тему оформления.
Использование
Скопируйте и вставьте:
{{Skin|templatemode = |name = |localised name = |status = |hook1 = |hook2 = |newhook1 = |newhook2 = |username = |author = |description = |image = |imagesize = |version = |update = |version preview = |update preview = |compatibility policy = |mediawiki = |php = |composer = |license = |download = |readme = |changelog = |example = |parameters = |compatibility = |bugzilla = |phabricator = |vagrant-role = }}
Для получения помощи по значениям параметров см. ниже.
Параметры содержимого
В этом разделе описываются параметры, которые определяют содержимое информационного блока (карточки).
Для получения помощи по templatemode и другим управляющим параметрам, пожалуйста, см. Управляющие параметры.
| Параметр | Описание |
|---|---|
| name | название темы оформления |
| localised name | исходный текст для локализации названия темы оформления
Укажите то же значение, что и в |
| status | текущий статус релиза
Один из:
Если статус отличается от указанных выше, он будет проигнорирован, и вместо него в шаблоне будет отображаться значение по умолчанию — «Неизвестно». |
| hook1 hook2 hook3 hook4 ... hook90 |
название каждого хука, используемого расширением
Ввод значений в это поле — отличный способ привлечь внимание к вашему расширению и помочь другим разработчикам. Каждый задокументированный хук автоматически добавит расширение в категорию со списком расширений, использующих этот хук. Эта категория автоматически привязывается к странице каждого хука, чтобы программисты могли легко находить примеры расширений, использующих конкретный хук. Для встроенных хуков:
Для пользовательских хуков, определённых расширениями:
|
| newhook1 newhook2 newhook3 newhook4 ... newhook90 |
название каждого хука, предоставляемого расширением
|
| username | Имя пользователя автора на MediaWiki.org (если оно есть). Может быть опущено, но если этот параметр указан, он будет использован для ссылки на страницу участника и страницу обсуждения автора. Оно должно быть указано без пространства имён и без символов [[]]. |
| Имя автора темы оформления, если оно отличается от его имени пользователя на MediaWiki.org. Свободный текст. Если этот параметр опущен, будет использовано поле «username» (если оно присутствует). | |
| description | краткое описание |
| image | скриншот или логотип темы оформления. Оно должно быть указано без пространства имён и без символов [[]]. |
| imagesize | «необязательно», размер изображения (размер по умолчанию — 220px) |
| version | последняя версия |
| update | дата последнего обновления |
| compatibility policy | политика совместимости (допустимые значения: master, rel и ltsrel). (backlog ) |
| mediawiki | требуемая версия MediaWiki. |
| php | требуемая версия PHP |
| license | лицензия(и), регулирующая(ие) использование этой темы оформления, например, GPL. |
| download | ссылка на загрузку: Use {{WikimediaDownloadSkin }} or {{GithubDownload }}. |
| readme | внешняя ссылка на файл readme |
| changelog | внешняя ссылка на файл со списком изменений |
| parameters | доступные параметры для LocalSettings.php |
| example | пример, веб-сайт или скриншот работающей темы оформления |
| compatibility | таблица совместимости |
| bugzilla | название компонента темы оформления MediaWiki в Bugzilla |
Параметры управления
| Параметр | Описание |
|---|---|
| templatemode | Управляет автокатегоризацией основной страницы.
Обычно оставляется пустым. Альтернативные значения:
Если это поле оставлено пустым, данный шаблон добавит основную страницу в Категория:Все темы оформления и в одну или несколько дополнительных категорий, в зависимости от значений, присвоенных параметрам содержимого. подстраница; она не находится в пространстве имён «Skin:»; или если категоризация подавлена с помощью «templatemode=nocats». |
Добавленные категории
Этот шаблон автоматически добавит страницы, на которых он используется, в категорию Category:All skins.
Кроме того, страница будет классифицирована по категориям в зависимости от значения параметра «status»:
- unstable: Category:Unstable skins
- experimental: Category:Experimental skins
- stable: Category:Stable skins
- beta: Category:Beta status skins
- unmaintained: Category:Unmaintained skins
- otherwise: Category:Skins with unknown status
Использование инфобокса
Существующие страницы тем оформления
Если вы хотите добавить инфобокс на существующую страницу, скопируйте и вставьте код, расположенный в верхней части этой страницы.
Создание новой страницы темы оформления
Если вы хотите создать новую страницу темы оформления, введите название ниже и нажмите кнопку. Будет создана новая страница с уже вставленным шаблоном инфобокса.
Please replace "TheSkin" with your skin's name:
MediaWiki is an open-source project and users are encouraged to make any MediaWiki skins under an Open Source Initiative (OSI) approved GPLv2 compatible license (including MIT, BSD, PD). For skins that have a compatible license, you can request commit access to the MediaWiki source repository for skins.
A developer sharing their code in the code repository should expect:
- Feedback / Criticism / Code reviews
- Review and comments by other developers on things like framework use, security, efficiency and usability.
- Developer tweaking
- Other developers modifying your submission to improve or clean-up your code to meet new framework classes and methods, coding conventions and translations.
- Future versions by other developers
- New branches of your code being created by other developers as new versions of MediaWiki are released.
- Credit
- Credit for your work being preserved in future versions
- Similarly, you should credit the developers of any skins whose code you borrow from.
Any developer who is uncomfortable with any of these actions occurring should not host their code in the code repository. You are still encouraged to create a summary page for your skin on the wiki to let people know about the skin, and where to download it.
Улучшение этого шаблона
Если вы хотите улучшить этот шаблон — спасибо! Это сложный шаблон, поэтому вот небольшая помощь:
Кроме того, Template:Skin/Sample содержит шаблон-заготовку, который предварительно загружается в новые созданные страницы и включает базовую документацию по заполнению параметров шаблона. Его необходимо синхронизировать с документацией.
Кнопка создания темы оформления
Для улучшения работы кнопки создания темы оформления:
- Template:Skin/Sample — Шаблон-заготовка темы оформления, который предварительно загружается в новые созданные страницы.
- Template:Skin/CreateSkinInputBox — Поле ввода, которое можно вставить в любом месте, где вы хотите дать пользователям возможность легко создавать темы оформления. Для получения документации по тегу
<inputbox>, пожалуйста, ознакомьтесь с Расширение:InputBox . - Skin:TheSkin: — Определяет заполнитель (placeholder) на случай, если пользователь случайно нажмёт кнопку создания, не изменив название темы оформления.
Параметры инфобокса
В общем:
- Чтобы сделать этот шаблон удобным в использовании, каждая метка в инфобоксе связана с документацией по параметрам шаблона, которые она отображает. Если вы добавляете параметр, пожалуйста, убедитесь, что вы также добавили его в документацию по параметрам контента и связали его метку с этой документацией.
To change the behavior of the hook parameters:
- Template:Extension/HookInUse : Adds links and categories for a hook in use. Multiple hooks in use are implemented by calling this template with Template:Foreach .
- Template:Extension/HookInUseNoCats : Used instead of Template:Extension/HookInUse when this template is used in
templatemode=nocats.
Templates used with Template:Foreach can only take one parameter so we need to wrap the call to Template:Extension/HookInUse with another template that sets the mode.
Тестовые примеры
Проверьте, всё ли в порядке со следующими страницами после редактирования этого шаблона.
Посмотреть все подстраницы этого шаблона.