Редактирование: Модуль:Надстрочное предупреждение/doc

<noinclude>{{К улучшению|2024-02-25}}</noinclude>{{Docpage}}{{#ifeq: {{NAMESPACENUMBER}} | 10 |
{{Ambox|type=serious|text=Шаблон не предназначен для непосредственного использования в статьях. Для этих целей используйте шаблон {{Tl|Исправить}}.}}
{{Устаревший шаблон|'''[[Модуль:Надстрочное предупреждение]]'''|deprecated=1}}
}}
{{TOC right}}
Модуль [[Модуль:Надстрочное предупреждение|«Надстрочное предупреждение»]] основан на более неиспользуемом шаблоне {{Tl|Надстрочное предупреждение}} и предназначен для вывода на страницах [[Категория:Шаблоны:Надстрочные предупреждения|надстрочных шаблонов-предупреждений]] (например, подозрительный текст{{#invoke:Надстрочное предупреждение|main|day = {{CURRENTDAY}}|month = {{CURRENTMONTH}}|year = {{CURRENTYEAR}}|text = некая претензия|link = РуСказки:К улучшению|comment = все очень плохо}}), таких как {{Tl|Нет АИ}}, {{Tl|Уточнить}} или {{Tl|Неопределённость}}. Единственный обязательный параметр — {{Code|text}}.

Часть шаблонов также могут оборачивать предшествующий предупреждению текст в теги {{Tago|span}} (например, {{#invoke:Надстрочное предупреждение|main|day = {{CURRENTDAY}}|month = {{CURRENTMONTH}}|year = {{CURRENTYEAR}}|span-text = непонятный текст|text = некая претензия|link = РуСказки:К улучшению|comment = я не понимаю!}}), а также учитывать дату установки. В шаблонах с заполнением даты рекомендуется использовать модуль [[Модуль:Unsubst|Unsubst]] (см. [[#Для шаблонов с указанием даты установки|ниже]]), чтобы при подстановке шаблона в него автоматически добавлялась текущая дата, например: <br> {{Tcl|subst:нет АИ}} → {{Tcl|нет АИ|{{CURRENTDAY}}|{{CURRENTMONTH}}|{{CURRENTYEAR}}}}.

Все шаблоны на основе модуля поддерживают подстановку вида {{Tcl|subst:когда}} → {{Tcl|когда}} для отсутствия в статьях ошибочного кода из шаблонов.

При неправильном заполнении даты шаблоны, написанные на базе этого модуля, добавляют категорию {{Cl|РуСказки:Надстрочные предупреждения с некорректно заданной датой|1}} ({{PAGESINCATEGORY:РуСказки:Надстрочные предупреждения с некорректно заданной датой}}).

== Использование ==
{| class="wikitable"
|+ Параметры шаблона
! scope="col" | Параметр
! scope="col" | Описание
|-
| {{Code|day}}<br>{{Code|month}}<br>{{Code|year}}<br>{{Code|errorcat}}
| Параметры для указания даты установки шаблона. Дата указывается только цифрами. В параметре {{Code|errorcat}} можно задать категорию, в которую будут помещаться статьи с неправильно заданной датой.

{{Якорь|Дата установки}}Если вы видите предупреждение «<strong class=error><small>Ошибка: некорректно задана дата установки</small></strong>», то, скорее всего, вы не указали дату простановки шаблона, для этого замените {{Tc|''название шаблона''|''параметры''}} на {{Tc|subst:''название шаблона''|''параметры''}}.
|-
| {{Code|span-text}}
| Параметр {{Code|span-text}} задает текст, выделяемый шаблоном. По умолчанию выделяется {{Нет АИ 2|таким образом|{{CURRENTDAY}}|{{CURRENTMONTH}}|{{CURRENTYEAR}}}}, однако стили текста можно изменить на любой желаемый при помощи параметра {{Code|templatestyles}}, загружающего [[ВП:TemplateStyles|стили для определённого шаблона]] (для работы необходимо добавить параметр {{Code|name}} с названием шаблона}}). Предназначен для шаблонов, подобных {{Tl|нет АИ 2}}.
|-
| {{Code|comment}}<br>{{Code|comment-default}}
| Комментарий к шаблону для указания сути претензии к тексту. В параметре {{Code|comment-default}} желательно задать текст комментария по умолчанию с возможностью указания причины при каждой установке шаблона, иначе в качестве оного будет выводиться ссылка, заданная в параметре {{Code|link}}. Также вместе с комментарием выводится дата установки шаблона (если она задана).

Рекомендуется использовать в локальных шаблонах также более краткие названия параметра — {{Code|c}} и {{Code|комм}} (вот так: {{Code|<nowiki>{{{comment|{{{c|{{{комм|}}}}}}}}}</nowiki>}}) для удобства быстрого набора с клавиатуры.
|-
| {{Code|text}}
| Текст надстрочного предупреждения (например: {{Code|источник?}} → {{Исправить|text=источник?}}). Единственный обязательный параметр, при отсутствии которого выводится ошибка «<small><strong class="error">Ошибка: не задан параметр <code>text</code></strong></small>».
|-
| {{Code|link}}
| Название страницы с соответствующим руководством к действию в случае обнаружения шаблона (например, {{Code|РуСказки:Ссылки на источники}} → {{Нет АИ|{{CURRENTDAY}}|{{CURRENTMONTH}}|{{CURRENTYEAR}}|якорь=Пример}}). Ссылка задается '''без''' квадратных скобок.
|-
| {{Code|talk}}
| Ссылка на раздел страницы, где ведется обсуждение текста, к которому поставлено предупреждение. В локальных шаблонах следует задавать два названия для параметра: {{Code|обс}} и {{Code|talk}} (вот так: {{Code|<nowiki>{{{talk|{{{обс|}}}}}}</nowiki>}}).
|-
| {{Code|anchor}}
| Якорь на предупреждение для возможности создать ссылку из обсуждения. В локальных шаблонах параметру рекомендуется задать два названия: {{Code|anchor}} и {{Code|якорь}} (вот так: {{Code|<nowiki>{{{anchor|{{{якорь|}}}}}}</nowiki>}}.
|-
| {{Code|cat}}<br><code>cat''N''</code><br><code>cat-date''N''</code><br>{{Code|nocat}}
| Параметры для задания категорий. Параметр {{Code|cat}} — для категории, не зависящей от наличия или отсутствия даты в шаблоне. Для параметров <code>cat''N''</code> статья с попадает в категорию только в случае выполнения условия, заданного в параметре <code>cat-date''N''</code> с соответствующим индексом (от 1 до 3), содержимое которого может состоять из оператора (знака сравнения) и числа (по умолчанию — <code>>= 0</code>; например: <code><nowiki>cat-date2 >= 100</nowiki></code> будет означать, что начиная с 100 дня после момента установки статья будет попадать в категорию «cat2»). Ссылка на категорию задается с квадратными скобками, либо соответствующим шаблоном. Категоризация работает только в основном пространстве имен. Параметр {{Code|nocat}} подавляет категоризацию.
|-
| {{Code|noprint}}
| Не отображать предупреждение в печатной версии (следует указывать для большинства малозначительных проблем с шаблонами, не касающихся источников и т. д.).
|}

== Локальные параметры ==
* ''обс'' (''talk'') — ссылка на раздел страницы, где ведется обсуждение текста, к которому поставлено предупреждение (на странице обсуждения или форуме). Если необходимо сослаться на раздел на странице обсуждения, достаточно указать только названия раздела, то бишь если в ссылке отсутствует или находится в начале символ решетки ({{Code|#}}), то ссылка ведет в соответствующий раздел на странице обсуждения. В противном случае — на раздел другой страницы. Ссылка задается без квадратных скобок. Например:
** {{Пример|Нет АИ|{{CURRENTDAY}}|{{CURRENTMONTH}}|{{CURRENTYEAR}}|обс=Предложения}}
** {{Пример|Нет АИ|{{CURRENTDAY}}|{{CURRENTMONTH}}|{{CURRENTYEAR}}|обс=РуСказки:Форум/Архив/Вниманию участников/2016/01#Спам или не спам?}}
* ''комм'' (''c'', ''comment'') — комментарий к шаблону для указания сути претензии к тексту; задаётся с целью её конкретизации. Если комментарий задан в статье, то текст предупреждения подчеркивается пунктиром. Например:
** {{Пример|Нет АИ|{{CURRENTDAY}}|{{CURRENTMONTH}}|{{CURRENTYEAR}}|комм=бла-бла-бла}}
* ''якорь'' (''anchor'') — якорь на предупреждение для возможности создать ссылку из обсуждения. Принцип работы аналогичен шаблону {{t|якорь2}}. Например:
** на шаблон с кодом {{Tc|Нет АИ|{{CURRENTDAY}}|{{CURRENTMONTH}}|{{CURRENTYEAR}}|якорь=Пример}} в графе «link» раздела «Использование» ведет ссылка {{Code|<nowiki>[[Шаблон:Надстрочное предупреждение#Пример|ссылка]]</nowiki>}} → [[Шаблон:Надстрочное предупреждение#Пример|ссылка]].

== Заготовка для копирования ==

=== Для шаблонов с указанием даты установки ===
С выделением предшествующего текста и обязательным заполнением даты:
<syntaxhighlight lang="wikitext">{{safesubst:<noinclude/>#invoke:Надстрочное предупреждение|main|2={{safesubst:<noinclude/>CURRENTDAY}} |3={{safesubst:<noinclude/>CURRENTMONTH}} |4={{safesubst:<noinclude/>CURRENTYEAR}}
  | day = {{{2}}}
  | month = {{{3}}}
  | year = {{{4}}}
  | span-text = {{{1|}}}
  | text = 
  | link = 
  | talk = {{{talk|{{{обс|}}}}}}
  | comment = {{{comment|{{{c|{{{комм|}}}}}}}}}
  | comment-default = 
  | anchor = {{{anchor|{{{якорь|}}}}}}
  | cat1 = 
  | cat-date1 = 
  | cat2 =
  | cat-date2 = 
  | cat3 = 
  | cat-date3 = 
  | errorcat =
  | nocat = {{{nocat|}}}
}}</syntaxhighlight>

Без выделения предшествующего текста и обязательного заполнения даты:
<syntaxhighlight lang="wikitext">{{safesubst:<noinclude/>#invoke:Надстрочное предупреждение|main|1={{safesubst:<noinclude/>CURRENTDAY}} |2={{safesubst:<noinclude/>CURRENTMONTH}} |3={{safesubst:<noinclude/>CURRENTYEAR}}
  | day = {{{1|}}}
  | month = {{{2|}}}
  | year = {{{3|}}}
  | text = 
  | link = 
  | talk = {{{talk|{{{обс|}}}}}}
  | comment = {{{comment|{{{c|{{{комм|}}}}}}}}}
  | comment-default = 
  | anchor = {{{anchor|{{{якорь|}}}}}}
  | cat1 = 
  | cat-date1 = 
  | cat2 =
  | cat-date2 = 
  | cat3 = 
  | cat-date3 = 
  | nocat = {{{nocat|}}}
  | errorcat =
}}</syntaxhighlight>

=== Для шаблонов без указания даты установки ===
<syntaxhighlight lang="wikitext">{{safesubst:<noinclude/>#invoke:Надстрочное предупреждение|main
  | span-text = {{{1|}}}
  | text = 
  | link = 
  | comment = {{{comment|{{{c|{{{комм|}}}}}}}}}
  | comment-default = 
  | anchor = {{{anchor|{{{якорь|}}}}}}
  | cat = 
  | nocat = {{{nocat|}}}
}}</syntaxhighlight>

== Пример использования ==
Для шаблона {{Tl|Нет АИ 2}}:
<syntaxhighlight lang="wikitext">{{safesubst:<noinclude/>#invoke:Надстрочное предупреждение|main|2={{safesubst:<noinclude/>CURRENTDAY}} |3={{safesubst:<noinclude/>CURRENTMONTH}} |4={{safesubst:<noinclude/>CURRENTYEAR}}
  | day = {{{2}}}
  | month = {{{3}}}
  | year = {{{4}}}
  | span-text = {{{1|}}}
  | text = {{#ifexpr: {{Прошло дней|{{{2}}}|{{{3}}}|{{{4}}}}} <= 14 
            | источник? 
            | источник не указан {{Прошло дней|{{{2}}}|{{{3}}}|{{{4}}}}}&nbsp;{{Plural:{{Прошло дней|{{{2}}}|{{{3}}}|{{{4}}}}}|день|дня|дней}}
           }}
  | link = РуСказки:Ссылки на источники
  | talk = {{{talk|{{{обс|}}}}}}
  | comment = {{{comment|{{{c|{{{комм|}}}}}}}}}
  | comment-default = не указан источник на утверждение
  | anchor = {{{anchor|{{{якорь|}}}}}}
  | cat1 = [[Категория:РуСказки:Нет источников с {{#time:xg Y|{{{4}}}-{{{3}}}-{{{2}}}}}]]
  | cat2 = {{Нет источника (сортировка по типу)}}
  | cat-date3 = > 14
  | cat3 = [[Категория:РуСказки:Статьи с утверждениями без источников более 14 дней]]
  | nocat = {{{nocat|}}}
  | errorcat = [[Категория:РуСказки:Страницы с ошибками параметров в шаблоне Нет АИ]]
}}</syntaxhighlight>
<includeonly>
[[Категория:Шаблоны:Мета-шаблоны]]
[[Категория:Шаблоны:Надстрочные предупреждения|*]]
</includeonly>