Template:Doc/doc/ru
Эта страница нуждается в обновлении.
Вы можете помочь, обновив перевод.
Кроме того, убедитесь, что статья соотвествует рекомендациям руководства об альтернативных языках.
Дополнительно, воспользуйтесь русским словарём переводчика.
Шаблон {{doc}} предназначен для добавления блока документации на различные страницы (в основном, на страницы шаблонов). От языка интерфейса пользователя, зависит какая подстраница будет загружаться в блок документации. В случае с русским языком, документация будет браться с подстраницы /doc/ru
. Однако, только в случае с английским языком, документация будет браться с подстраницы /doc
.
Contents
Инструменты
Справа сверху, прямо из блока документации, выступает основной инструментарий:
Создать
— открывает создание страницы документации. Появляется только в случае, если страница документации не существует.
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.Просмотр
— открывает страницу документации.Править
— открывает редактирование страницы документации.История
— открывает историю изменений страницы документации.
Также, в правом верхнем углу есть кнопка помеченная многоточием [ … ]. Она разворачивает/сворачивает дополнительные инструменты:
Песочница
— открывает создание подстраницы/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 → «О пользователе».
- Во всех других случаях будет «Документация».
User
, то текст документации будет взят с подстраницы /about
, а не с /doc
.- {{{tools}}}: определяет, какие кнопки инструментов должны отображаться:
- 0 – никаких кнопок.
- 1 – Только кнопки «Создать», «Просмотр», «Править» и «История».
- При других значениях будут отображаться все кнопки.
- {{{examples}}}: сюда вписываются примеры которые можно скопировать и использовать на других страницах. При использовании, появляется кнопка «Примеры», слева прямо под заголовком блока документации.
- {{{noscroll}}}: если Вы используете параметр {{{examples}}} с малым количеством примеров, этот параметр отключит правое доп. заполнение (scrollbar-gutter), необходимое для полосы прокрутки.
Создание документации
|
.Чтобы начать создание документации, нажмите на кнопку «Создать» справа сверху. В самом начале документации, добавьте шаблон
и впишите 0 в параметр {{{1}}}. После этого у вас появится сообщение о том, что это подстраница документации. А чтобы это сообщение не появлялось в блоке документации, оно должно записываться таким образом:
{{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)
20240513111614
11.727 kilobytes
0.011727 megabytes