Template:Doc
Нужно сделать: Exclude Sandbox subpage and other from this template. Also do some code cleanup.
Документация шаблона
Please follow the format on this subpage(s) to add translations.
Эта страница нуждается в обновлении.
Вы можете помочь, обновив перевод.
Кроме того, убедитесь, что статья соотвествует рекомендациям руководства об альтернативных языках.
Дополнительно, воспользуйтесь русским словарём переводчика.
Шаблон {{doc}} предназначен для добавления блока документации на различные страницы (в основном, на страницы шаблонов). От языка интерфейса пользователя, зависит какая подстраница будет загружаться в блок документации. В случае с русским языком, документация будет браться с подстраницы /doc/ru. Однако, только в случае с английским языком, документация будет браться с подстраницы /doc.
Инструменты
Справа сверху, прямо из блока документации, выступает основной инструментарий:
Создать— открывает создание страницы документации. Появляется только в случае, если страница документации не существует.
Примечание:If there are none of any documentations, the button will load a preload documentation, Template:Doc/preload or Template:Doc/preload/<lang code> (if the UI language isn't in English and the translations of the preload page exist), as the content of the new page and open the editing page. If there is a English documentation, the button will preload the English documentation as the content.Просмотр— открывает страницу документации.Править— открывает редактирование страницы документации.История— открывает историю изменений страницы документации.
Примечание:если нет ни одного вышеперечисленного инструмента, то текст документации был записан через параметр {{{content}}} или параметр {{{tools}}} был выставлен на 0.Также, в правом верхнем углу есть кнопка помеченная многоточием [ … ]. Она разворачивает/сворачивает дополнительные инструменты:
Песочница— открывает создание подстраницы/sandboxи копирует код оригинальной страницы, или, если данная страница существует, просто открывает её.Тестирование— открывает создание подстраницы/testcases. Полезно для тестирования шаблона в разных ситуациях.Подстраницы— открывает Special:PrefixIndex и вставляет название страницы для поиска всех подстраниц.Очистить кэш— открывает окно с сообщением об очистке кэша страницы.
Языковая строка
Справа сверху, под инструментами, находятся флаги, переключающие документацию на другой язык. Переключение реализовано путём вставки &uselang=<код языка> в ссылку страницы, поэтому если Вы нажмёте на другой язык, то вместе с документацией, поменяется язык интерфейса.
Если документации на необходимом языке нет, будет отображено сообщение «Страница документации <страница> не существует». Eсли {{{pagespace}}} или само пространство страницы — User, то будет показано другое сообщение «Пользователь <ник_пользователя> не предоставил(а) информацию о себе на данном языке (<страница>).» с учётом выставленного пола в настройках пользователя.
Параметры
- {{{1}}}: параметр для переключения назначения шаблона:
- Если нужен стандартный блок документации, ничего не вписывайте в этот параметр.
- 0 — отобразит сообщение «Это подстраница документации для <страница>».
- 1 — отобразит сообщение «Это подстраница песочницы для <страница>».
- 2 — отобразит сообщение «Эта страница не является песочницей».
- 3 — отобразит сообщение «Это подстраница c информацией о пользователе <страница>».
- 4 — отобразит сообщение «Это подстраница документации для использования на нескольких страницах». Если используется параметр {{{list}}}, то текст будет дополнен, в зависимости от пространства указанной страницы:
- Category → «Это подстраница документации для использования на нескольких страницах указанных в категории <list страница>».
- Во всех других случаях будет «Это подстраница документации для использования на нескольких страницах указанных на странице <list страница>».
- {{{list}}}: указывает страницу или категорию, в которой перечислены страницы, использующие определённую страницу документации. Используется только когда {{{1}}} выставлен на 4.
- {{{docpage}}}: страница которая будет использоваться в качестве документации.
- {{{content</код языка>}}}: контент который будет использоваться в качестве документации, вместо отдельной страницы. При использовании, основные инструменты скрываются.
- {{{pagespace}}}: пространство страницы, определяется автоматически, но можно вписать свой вариант. От этого параметра зависит текст в заголовке:
- Template → «Документация шаблона».
- File → «Описание».
- User → «О пользователе».
- Во всех других случаях будет «Документация».
Примечание:Eсли {{{pagespace}}} или само пространство страницы — User, то текст документации будет взят с подстраницы /about, а не с /doc.- {{{tools}}}: определяет, какие кнопки инструментов должны отображаться:
- 0 – никаких кнопок.
- 1 – Только кнопки «Создать», «Просмотр», «Править» и «История».
- При других значениях будут отображаться все кнопки.
- {{{examples}}}: сюда вписываются примеры которые можно скопировать и использовать на других страницах. При использовании, появляется кнопка «Примеры», слева прямо под заголовком блока документации.
- {{{noscroll}}}: если Вы используете параметр {{{examples}}} с малым количеством примеров, этот параметр отключит правое доп. заполнение (scrollbar-gutter), необходимое для полосы прокрутки.
Создание документации
Предупреждение:Если вы хотите добавить символ «|» где-то в тексте (шаблонов и других MediaWiki элементов не касается), используйте |.Чтобы начать создание документации, нажмите на кнопку «Создать» справа сверху. В самом начале документации, добавьте шаблон {{doc}}
<noinclude>{{doc|0}}</noinclude>
Далее записывается текст самой документации. Сперва идёт краткое описание, а после — в зависимости от того, на что пишется документация.
Подстраницы
There are some subpages and sub-templates on {{Doc}}. They are created to make the things easier.
{{Doc/subpage}}
This template is the replacement of <noinclude>{{doc|0}}</noinclude>. It can be instead of <noinclude>{{doc|0}}</noinclude>.
Its purpose is the same as {{Documentation subpage}}.
It can avoid the problem that preload page won't load <noinclude>{{doc|0}}</noinclude>.
{{Doc/Sandbox other}}
This template adds content separately to the main template and its subpages (documents). It is useful for adding categories.
Its purpose is the same as {{Sandbox other}}.
Template:Doc/preload
This is the preload page when you click the create button. You can add translations for it.
{{Doc/PreviewBlock}}
Устарело. Используйте {{Capsule}} вместо него.
(22 August 2022)
20240514171614
14.581 kilobytes
0.014581 megabytes
Указанная здесь документация была взята из Template:Doc/doc/ru. (edit | history)
Редакторы могут экспериментировать с этим шаблоном в песочнице (править) и testcases (создать) страницах.
Добавить категории для подстраницы /doc. Подстраницы этой страницы.
