Шаблон: Ambox

Документация по шаблону [ просмотреть ] [ изменить ] [ история ] [ очистить ]

Этот шаблон используется примерно на 1 380 000 страниц, или примерно на 3% всех страниц. Чтобы избежать серьезных сбоев и нагрузки на сервер, любые изменения следует тестировать на подстраницах / песочнице или / testcases шаблона , или на вашей собственной подстранице пользователя . Проверенные изменения могут быть добавлены на эту страницу одним редактированием. Обсудите изменения на странице обсуждения, прежде чем внедрять их.

Этот шаблон использует Lua : Модуль: окно сообщения ( песочница )

{{ Ambox }} обозначает A Статья м essage коробки , которая является metatemplate . Он используется для создания окон сообщений для шаблонов, используемых в статьях , таких как {{ underlinked }}. Он предлагает несколько разных цветов, изображений и некоторые другие функции.

Основное использование

В поле ниже показаны наиболее распространенные параметры, которые принимает {{ Ambox }}. Назначение каждого из них описано ниже.

{{Ambox| имя =| subst = <includeonly> {{subst: substcheck}} </includeonly>| small = {{{small |}}}| type =| изображение =| секта = {{{1 |}}}| проблема =| talk = {{{talk |}}}| fix =| date = {{{date |}}}| кошка =| все =}}

Полное использование

{{Ambox| имя =| subst = <includeonly> {{subst: substcheck}} </includeonly>| small = {{{small |}}}| type =| изображение =| imageright =| smallimage =| smallimageright =| class =| style =| textstyle =| секта = {{{1 |}}}| проблема =| talk = {{{talk |}}}| fix =| date = {{{date |}}}| текст =| smalltext =| plainlinks = нет| removenotice =| кошка =| все =| cat2 =| all2 =| cat3 =| all3 =}}

Общие параметры

название

Параметр name указывает имя шаблона без префикса пространства имен Template. Например, {{ Underlinked }} указывает |name=Underlinked.

Этот параметр следует обновить, если шаблон когда-либо перемещался. Этот параметр имеет двоякое назначение:

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

подстилка

Параметр subst позволяет мета-шаблону определять, был ли шаблон заменен неправильно, и выдавать соответствующее предупреждение. Он также добавит такие страницы в Категория: Страницы с неправильно подставленными шаблонами . Просто скопируйте код точно так, как он отображается в поле.

небольшой

Параметр small следует передавать через шаблон, так как это позволит редакторам использовать малый формат, указав |small=leftв статье:

Это небольшой формат Ambox с выравниванием по левому краю.

В противном случае будет создан стандартный формат:

Это стандартный формат Ambox.

Другие варианты:

• Для шаблонов, которые никогда не должны быть маленькими, укажите |small=noили вообще не передавайте параметр small.
• Для шаблонов, которые всегда должны быть небольшими, просто укажите |small=left.
• Для шаблонов, которые по умолчанию должны быть маленькими , попробуйте |small={{{small|left}}}. Это позволит редактору переопределить использование |small=noв статье.

Чтобы использовать маленькое поле, ширина которого регулируется в соответствии с текстом, используйте |style=width: auto; margin-right: 0px;и |textstyle=width: auto;вместе:

Это небольшой формат Ambox с выравниванием по левому краю и гибкой шириной.

См. § раздел ниже для получения дополнительной информации о том, как ограничить |small=отображение случаями, когда шаблон используется для раздела, а не для всей статьи (рекомендуется для предотвращения несогласованного отображения верхней части статьи).

тип

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

type = speedy - проблемы быстрого удаления, такие как {{ db-g1 }} и {{ db-g3 }}.

type = delete - проблемы с удалением, например {{ статья для удаления }} и {{ предлагаемое удаление }}.

type = content - проблемы с контентом, например {{ POV }} и {{ globalize }}.

type = style - проблемы стиля, например {{ cleanup }} и {{ underlinked }}.

type = notice - Уведомления о статьях, например {{ current }} и {{ in use }}.

type = move - объединить, разделить и транслировать предложения, например {{ split }} и {{ copy to Wiktionary }}.

type = protection - Уведомления о защите, такие как {{ pp-vandalism }} и {{ pp-protected }}.

Если параметр типа не задан, по умолчанию используется шаблон |type=notice.

изображение

Вы можете выбрать конкретное изображение для использования в шаблоне с помощью параметра image . Изображения указываются с использованием стандартного синтаксиса для вставки файлов в Википедии (см. Википедия: Руководство по стилям / изображениям # Как разместить изображение .) Ширина 40-50 пикселей является типичной. Например:

• {{ POV }} указывает |image=[[File:Unbalanced scales.svg|40px|link=|alt=]]и выглядит так:

Нейтральность этой статьи оспаривается . Соответствующее обсуждение можно найти на странице обсуждения . Не удаляйте это сообщение, пока не будут выполнены соответствующие условия . ( Май 2021 г. ) ( Узнайте, как и когда удалить этот шаблон сообщения )

• {{ underlinked }} указывает |image=[[File:Ambox wikify.svg|50x40px|link=|alt=]]и выглядит так:

Эта статья нуждается в дополнительных ссылках на другие статьи, чтобы помочь интегрировать ее в энциклопедию . Пожалуйста, помогите улучшить эту статью , добавив ссылки , соответствующие контексту в существующем тексте. ( Май 2021 г. ) ( Узнайте, как и когда удалить этот шаблон сообщения )

Пожалуйста, обрати внимание:

• Если изображение не указано, используется изображение по умолчанию, соответствующее типу . (См. #Type выше.)
• Если |image=noneуказан, то изображение не используется, а текст занимает всю область окна сообщения.
• Если значок является чисто декоративным и также находится в общественном достоянии , доступность можно улучшить, подавив ссылку на страницу файла, добавив « |link=|alt=», как показано выше.

секта

Многие шаблоны сообщений статей начинаются с текста Эта статья ... и часто желательно, чтобы эта формулировка изменилась на Этот раздел ..., если вместо этого шаблон используется в разделе. Значение этого параметра заменит слово «статья». Различные возможности для использования , включают: |sect=list, |sect=table, |sect="In popular culture" materialи т.д.

При использовании этой функции обязательно удалите первые два слова («Эта статья») из текста шаблона, иначе он будет продублирован.

Распространенный способ облегчить эту функцию - пройти |sect={{{1|}}}. Это позволит редакторам ввести section, например, первый безымянный параметр шаблона, чтобы изменить формулировку. Например, производит:{{Advert|section}}

Этот раздел содержит контент, который написан как реклама . Пожалуйста, помогите улучшить его , удалив рекламный контент и неприемлемые внешние ссылки , а также добавив энциклопедический контент, написанный с нейтральной точки зрения . ( Май 2021 г. ) ( Узнайте, как и когда удалить этот шаблон сообщения )

Другой подход - передать |sect={{{section|{{{sect|}}}}}}указанное значение. Другой - использовать для синтаксического анализа значения на положительное значение и передачи, если оно истинно.{{Yesno}}|sect=section

Эти подходы можно комбинировать , и это рекомендуется. Следующий готовый к использованию код:

позволяет следующее:

• Любое положительное значение , которое может обнаружить будет использоваться с именем параметра в Ambox на основе шаблона , чтобы получить «раздел» вместо «статьи»: , и т.д. Рекомендуется , чтобы как и так , что редакторы не должны догадаться, один будет работать. Приведенный выше пример кода сделает это за вас.{{Yesno}}|section=y|sect=True|sect=|section=
• Любое другое значение , переданное каким - либо образом, заменит «статью»: |section and its subsections, |1=list, |sect=section, |section=tableи т.д.

Также рекомендуется ограничить использование |small=параметра, чтобы он зависел от шаблона, применяемого к разделу (или чему-то еще), а не ко всей статье, чтобы предотвратить использование небольшой версии шаблона в верхней части статьи. где это было бы несовместимо с другими баннерами для очистки / оспаривания статьи:

(В этом случае любое значение |small=или |left=будет запускать небольшой левый дисплей, если |sect=в этом шаблоне также указано какое-то значение или один из его псевдонимов.) Этот код можно скопировать и использовать с приведенным выше кодом. блокировать. См., Например, Template: Trivia и его Template: Trivia / testcases для наблюдения за объединенной функциональностью.

проблема и исправить

Параметр issue используется для описания проблемы со статьей. Постарайтесь сделать его кратким и конкретным (примерно 10-20 слов) и обязательно включите ссылку на соответствующую политику или руководство .

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

Когда шаблон находится в компактной форме (при размещении внутри {{ multiple issues }}) или в малой форме (при использовании |small=left), проблема - единственный текст, который будет отображаться. Например, {{ Citation style }} определяет

• |issue=This article '''has an unclear citation style'''.
• |fix=The references used may be made clearer with a different or consistent style of [[Wikipedia:Citing sources|citation]], [[Wikipedia:Footnotes|footnoting]], or [[Wikipedia:External links|external linking]].

При автономном использовании он производит весь текст:

У этой статьи нечеткий стиль цитирования . Используемые ссылки можно сделать более ясными с помощью другого или последовательного стиля цитирования и сносок . ( Май 2021 г. ) ( Узнайте, как и когда удалить этот шаблон сообщения )

Но при использовании внутри {{ Multiple issues }} или вместе с |small=leftним отображается только проблема:

Эта статья поднимает множество проблем. Пожалуйста, помогите улучшить его или обсудите эти проблемы на странице обсуждения . ( Узнайте, как и когда удалить эти сообщения-шаблоны ) У этой статьи нечеткий стиль цитирования . Используемые ссылки можно сделать более ясными с помощью другого или последовательного стиля цитирования и сносок . ( Май 2021 г. ) ( Узнайте, как и когда удалить этот шаблон сообщения ) ( Узнайте, как и когда удалить этот шаблон сообщения )

У этой статьи нечеткий стиль цитирования . Используемые ссылки можно сделать более ясными с помощью другого или последовательного стиля цитирования и сносок . ( Май 2021 г. ) ( Узнайте, как и когда удалить этот шаблон сообщения )

говорить

Некоторые шаблоны сообщений статей включают ссылку на страницу обсуждения и позволяют редактору указать заголовок раздела, чтобы напрямую перейти к соответствующему разделу. Для достижения этой функциональности просто передайте параметр разговора , т. Е.|talk={{{talk|}}}

Затем этот параметр может использоваться редактором следующим образом:

• |talk=SECTION HEADING - ссылка будет указывать на указанный раздел на странице обсуждения статьи, например |talk=Foo
• |talk=FULL PAGE NAME- шаблон будет ссылаться на указанную страницу (которая может включать привязку раздела ), например|talk=Talk:Banana#Foo

Заметки:

• Когда этот параметр используется шаблоном, ссылка на страницу обсуждения будет отображаться в самом шаблоне (для демонстрации функциональности), но она будет отображаться в статьях только в том случае, если параметр действительно определен.
• Чтобы быть уверенным, что всегда есть ссылка на страницу обсуждения, вы можете использовать |talk={{{talk|#}}}.
• Если страница обсуждения не существует, ссылки не будет, независимо от значения параметра.

Дата

Передача параметра даты в мета-шаблон означает, что дата пометки статьи может быть указана редактором (или чаще ботом ). Это будет отображаться после сообщения более мелким шрифтом.

Передача этого параметра также включает ежемесячную категоризацию очистки, если также определен параметр cat .

Информация

Этот параметр предназначен для указания дополнительной информации. Все, что вы добавляете сюда, будет отображаться после указанной даты и не будет отображаться, если шаблон заключен в {{ multiple issues }}.

уведомление об удалении

Если вы укажете |removalnotice=yes, то после даты и после информационного текста будет отображаться следующее уведомление :

• Узнайте, как и когда удалить этот шаблон сообщения .

Это не будет отображаться, если шаблон заключен в {{ multiple issues }}.

Кот

Этот параметр определяет категорию ежемесячной очистки. Если |cat=CATEGORYтогда:

• статьи будут помещены в Категория: КАТЕГОРИЯ с ДАТЫ, если |date=DATEуказано.
• статьи будут помещены в Категория: КАТЕГОРИЯ, если дата не указана.

Например, {{ Без сносок }} указывает, |cat=Articles lacking in-text citationsи поэтому статья с шаблоном будет помещена в Категория: Статьи без ссылок в тексте с июня 2010 года .{{No footnotes|date=June 2010}}

Параметр cat не должен быть связан, и префикс не Category:должен использоваться.

все

Параметр all определяет категорию, в которую должны быть помещены все статьи.

Параметр all не должен быть связан, и префикс не Category:должен использоваться.

Дополнительные параметры

Imageright

С помощью этого параметра можно указать изображение в правой части окна сообщения. Синтаксис такой же, как и для параметра изображения , за исключением того, что по умолчанию изображение отсутствует.

smallimage и smallimageright

С помощью этих параметров можно указать изображения для коробки малого формата. Они не будут иметь эффекта, если |small=leftне указано иное.

класс

Настраиваемые классы CSS для применения к блоку. При добавлении нескольких классов их следует разделять пробелами.

стиль и стиль текста

Необязательные значения CSS могут быть определены без кавычек, " "но с конечной точкой с запятой ;.

• style определяет стиль, используемый для всей таблицы окна сообщения. Это можно использовать для таких вещей, как изменение ширины поля.
• textstyle относится к текстовой ячейке.

текст и мелкий текст

Вместо указания проблемы и исправления можно использовать текстовый параметр.

Пользовательский текст для малого формата может быть определен с помощью smalltext .

простые ссылки

Обычно в Википедии рядом с внешними ссылками отображается значок стрелки, например: Example.com . Однако в окнах сообщений значок стрелки по умолчанию подавлен, например: Example.com . Чтобы получить обычный стиль внешней ссылки со значком стрелки, используйте |plainlinks=no.

cat2 , cat3 , all2 и all3

• cat2 и cat3 предусматривают дополнительные ежемесячные категории; см. # кот .
• all2 и All3 предусматривают дополнительные категории , в которую все статьи размещаются, как #All .

Технические примечания

• Этот мета-шаблон использует классы CSS ambox в MediaWiki: Common.css . Классы также можно использовать непосредственно в вики-таблице, если требуется особая функциональность. См. Руководство по этому поводу .
• Если вам нужно использовать специальные символы в текстовом параметре, вам нужно экранировать их следующим образом:

{{Ambox| текст = <div>Знак равенства =, а также начальная и конечная фигурная скобка {} работают нормально, как есть.Но вот труба & # 124; и две концевые скобки <nowiki>}} </nowiki>.А теперь трубка и концевые скобки <nowiki> |}} </nowiki>.</div>}}

Знак равенства =, а также начальная и конечная фигурная скобка {} работают нормально, как есть. Но вот трубка | и две концевые скобки}}. А теперь труба и концевые скобки |}}.

• Эти <div>метки , которые окружают текст в приведенном выше примере, как правило , не требуется. Но если текст содержит разрывы строк, иногда мы получаем странный межстрочный интервал. Особенно это происходит при использовании вертикальных пунктирных списков. Затем используйте теги div, чтобы исправить это.
• Этот шаблон использует классы CSS в MediaWiki: Common.css для большей части своего внешнего вида, поэтому для него можно полностью изменить скин .
• Внутренне этот мета-шаблон использует разметку HTML вместо вики-разметки для кода таблицы. Это обычный способ создания мета-шаблонов, поскольку вики-разметка имеет ряд недостатков. Например, это затрудняет использование функций синтаксического анализатора и некоторых специальных символов в параметрах.
• Изображения по умолчанию для этого мета-шаблона имеют формат png, а не формат svg. Основная причина в том, что в некоторых старых браузерах возникают проблемы с прозрачным фоном, который MediaWiki отображает для изображений svg. У изображений png здесь есть оптимизированный вручную прозрачный цвет фона, поэтому они хорошо выглядят во всех браузерах. Обратите внимание, что значки svg выглядят плохо только в старых браузерах, поэтому такая ручная оптимизация стоит проблем только для очень широко используемых значков.
• Для получения дополнительных технических сведений см. Страницу обсуждения и ссылки «См. Также» ниже. Поскольку этот шаблон работает почти так же, как {{ Tmbox }}, {{ Imbox }}, {{ Cmbox }} и {{ Ombox }}, их страницы обсуждения и связанные страницы могут также содержать более подробную информацию.

TemplateData

Семья Mbox

• {{ Ambox }} для ящиков сообщений на страницах статей.
• {{ Cmbox }} для ящиков сообщений на страницах категорий.
• {{ Imbox }} для ящиков сообщений на страницах файлов (изображений).
• {{ Tmbox }} для ящиков сообщений на страницах обсуждения.
• {{ Fmbox }} для окон сообщений верхнего и нижнего колонтитула.
• {{ Ombox }} для ящиков сообщений на других типах страниц.
• {{ Mbox }} для ящиков сообщений, которые используются в разных пространствах имен, и соответствующим образом изменяют их представление.

Тесно связанные метатемплиты:

• {{ Asbox }} для ящиков сообщений в корешках статей.
• {{ Dmbox }} для ящиков сообщений на страницах с определением неоднозначности или на страницах с индексом набора.
• {{ Ivmbox }}, простое полноразмерное поле с фоном цвета слоновой кости по умолчанию, предназначенное для размещения важных сообщений или уведомлений.

Шаблоны, предназначенные для использования вместе с Mboxes:

• {{ Ombox / shortcut }}, альтернатива {{ Shortcut }} для использования в шаблонах Mbox

Смотрите также

• Википедия: Классы в Ambox - Описывает, как использовать классы CSS Ambox непосредственно в вики- таблицах и HTML-таблицах .
• Википедия: Руководство по окнам сообщений стиля / статьи - Руководство по стилю создания окон сообщений статьи.
• Обсуждение шаблона: Ambox - для обсуждения этих вопросов.