ambox

Документация

Следната документация на шаблона е включена чрез Шаблон:Ambox/doc. (редактиране | история)

Този шаблон използва Lua:

Модул:Message box

Използва се за създаване на съобщителни карета в статии, описващи някакъв проблем като например {{Спорна неутралност}}. Шаблонът предлага разнообразие от цветове и изображения, съответстващи на естеството на проблема, посочен в създаденото съобщение.

Употреба

Прост пример за използване на шаблона:

{{ambox | text = Някакво съобщение.}}

Малко по-сложен вариант, при който картинката, стила и типа на карето се задават от редактора:

{{ambox | type  = style | image = [[Файл:Icon apps query.svg|38п]] | style = width: 400px; color: red; font-weight: bold; font-style: italic | text  = Някакво съобщение. }}

Параметри

В карето по-долу за показани всички параметри на шаблона, заедно с кратко описание или образец за попълване.

{{Ambox | name            =  | subst           = {{subst:substcheck}} | type            = serious / content / style / merge / notice / protection / stub | small           = {{{small|}}} | image           = празно / [[Файл:Някакво_изображение.svg|40п]] | imageright      = [[Файл:Някакво_изображение.svg|40п] | smallimage      = празно / [[Файл:Някакво_изображение.svg|40п]]] при малък формат | smallimageright = [[Файл:Някакво_изображение.svg|20п]] при малък формат | class           = CSS клас който ще бъде приложен върху карето | style           = CSS стойности | textstyle       = CSS стойности | sect            = {{{1|}}} | issue           = Описание на проблема | talk            = {{{talk|}}} | fix             = Насоки за разрешаване на проблема | date            = {{{date|}}} | text            = Някакво съобщение | smalltext       = Някакво съобщение при малък формат | cat             =  | all             =  | cat2            =  | all2            =  | cat3            =  | all3            =  }}

type

Параметърът type определя цвета на карето и ползваното изображение в ляво от съобщението (параметър image). Типът се избира въз основа на проблема описан в карето. Седемте основни типа съобщителни карета за статии са показани по-долу:

small

Ако в конкретен случай не е нужно съобщителното каре да заема значително място, то редакторът може да избере малък формат като добави параметъра |small=left.

Други вариации:

При шаблони (ползващи ambox) които никога не трябва да бъдат в малък формат, използвайте |small=no или въобще не го добавайте.
При шаблони (ползващи ambox) които винаги трябва да бъдат в малък формат, използвайте |small=left.
При шаблони (ползващи ambox) които по подразбиране трябва да бъдат в малък формат, използвайте |small={{{small|left}}}. По този начин редакторът може да отмени форматирането, чрез добавянето на |small=no, при извикването на шаблона в дадена статия.

image

Картинките по подразбиране са зададени за удобство, но редакторите могат да поставят и други картинки, по-подходящи за конкретния случай. Параметърът image е именно за това. При употребата му е препоръчително да се слагат размери изображението от порядъка на 40-50 пиксела. Примери за употребата на този параметър са дадени по-долу:

Шаблоните {{POV}}, {{Неутралност}} и {{Спорна неутралност}} използват |image=[Файл:Unbalanced scales.svg|40п|link=|alt=]]

Шаблонът {{Уикифициране}} използва |image=[[Файл:Ambox wikify.svg|50п40п|link=|alt=]]

Шаблонът {{Редактирам}} използва |image=[[Файл:Under_construction_icon-blue.svg|60п|link=|alt=]]

sect

Голяма част от шаблоните ползващи ambox започват с изречения от типа Настоящата статия ... или Тази статия .... Поради тази причина е желателно това да се промени в Настоящия раздел ... или Този раздел ..., в случай че шаблона се ползва за раздел. Параметърът sect помага за разрешаването на този проблем, чиято стойността по подразбиране е Настоящата статия. Думата или словосъчетанието които бъдат присвоени на параметъра автоматично заменята тази стойност:

{{Ambox | type  = style | sect  = Този раздел | issue = '''се нуждае от подобрение.''' | fix   = Ако желаете да помогнете на Уикипедия, използвайте опцията [{{fullurl:{{FULLPAGENAME}}|action=edit}} редактиране] в горното меню над статията, за да нанесете нужните корекции.  }}

В случай, че не е необходима заменка оставете параметъра sect празен. В този случай ще се ползва стойността по подразбиране.

Друг метод, с който се опростява ползването на този параметър, е използването на |small={{{1|}}}. Това позволява замяната на стойността по подразбиране с първия не наименован параметър подаден на шаблона, като например {{уикифициране|Този раздел}}:

issue и fix

Параметърът issue служи за описване на проблема в статията. Желателно е да описанието да бъде кратко и ясно (около 10-20 думи) и както и да включва препратка към съответната политика или правило.

Насоки за разрешаване на описания проблем (подобряване на статията) се задават посредством параметъра fix. Препоръчително е насоките да са с дължина не по-голяма от две изречения.

В случай, че шаблона е в малък формат то единствения текст който ще бъде изобразен в карето е присвоения на параметъра issue. Пример за това е даден по-долу:

{{Ambox | type  = stub | issue = Тази статия '''все още е мъниче'''. | fix   = Ако желаете да помогнете на Уикипедия, използвайте опцията [{{fullurl:{{FULLPAGENAME}}|action=edit}} редактиране] в горното меню над статията, за да нанесете нужните корекции.  }}

talk

Някой съобщителни карета изискват добавянето на препратка към беседата на страницата. За постигането на тази функционалност добавете параметъра talk, т.е. |talk={{{talk|}}}. Пример за такъв шаблон е {{Спорна неутралност}}.

По този начин параметърът може да бъде заменен от редкатор при поставянето на шаблона, както следва:

|talk=ИМЕТО НА РАЗДЕЛА - препратката сочи към съответния раздел в беседата на страницата, т.е. |talk=Foo
|talk=ПЪЛНОТО ИМЕ НА СТРАНИЦАТА - препратката сочи към дадената беседа (може да включва и препратки към раздел в беседата), т.е. |talk=Беседа:Спорна неутралност#НГТ, а не NPOV

Други особености:

За да сте сигурни, че винаги има препратка към страницата за беседи, използвайте |talk={{{talk|#}}}.
Ако не съществува беседа за дадена страница то и препратката към нея няма да съществува в съобщителното каре, независимо от стойността на параметъра.

date

Дава възможност на редактор (или бот) да зададе датата на която е статията е маркирана с конкретно съобщително каре. Датата се изобразява в края на съобщението в по-малък шрифт.

Ако параметър cat също е дефиниран, статиите ще бъдат категоризирани по месеци.

cat

Използва се за дефиниране на категорията за поддръжка в която ще бъде поставена статията.

Ако въведени параметрите |cat=КАТЕГОРИЯ и |date=ДАТА, статиите ше бъдат поставени в Категория:КАТЕГОРИЯ от дата ДАТА
Ако само параметъра |cat=КАТЕГОРИЯ е въведен, статиите ще бъдат поставени в Категория:КАТЕГОРИЯ

При дефинирането на параметъра не се ползват препратки или преставката Категория:, въвежда се единствено името на категорията.

all

Параметърът дефинира категорията в която всички статии ще бъдат поставени