Шаблон: Инфобокс

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

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

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

Этот шаблон задуман как мета-шаблон: шаблон, используемый для создания других шаблонов. Примечание . Как правило, он не предназначен для использования непосредственно в статье, но при необходимости может использоваться разово. Справка: информационное окно содержит вводную информацию о рекомендуемом содержании и дизайне информационных ящиков; Википедия: Руководство по стилю / инфобоксу содержит дополнительные рекомендации по стилю. См. WP: Список инфобоксов и Категория: шаблоны инфобоксов для получения списков подготовленных информационных боксов по конкретным темам.

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

{{Infobox}} - это мета-шаблон: используется для организации фактического шаблона {{Infobox sometopic}} (например, {{ Infobox building }}).

В этом случае [[Template:Infobox sometopic]]код шаблона выглядит так в упрощенном виде:

{{Инфобокс| name = {{{имя | {{PAGENAME}}}}}| изображение = {{{изображение |}}}| caption1 = {{{caption |}}}| label1 = Прежние имена| data1 = {{{previous_names |}}}| header2 = Общая информация| label3 = Статус| data3 = {{{status |}}}... <! - и т. д. ->}}

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

имя

Если этот параметр присутствует, ссылки «просмотр / обсуждение / редактирование» будут добавлены в нижнюю часть информационного окна, указывающего на указанную страницу. Вы можете использовать значение {{subst: PAGENAME}}; однако это редко бывает тем, что вам нужно, потому что при нажатии на эти ссылки в информационном окне пользователи будут обращаться к коду шаблона, а не к данным в информационном окне, которые они, вероятно, захотят изменить.

ребенок

См. Подробности в разделе « Встраивание ». Если установлено «да», это дочернее информационное окно должно иметь заголовок, но не иметь параметра имени. По умолчанию этот параметр пуст, установите для него значение «да», чтобы активировать его.

вложенный ящик

См. Подробности в разделе « Подписки ». Если установлено «да», это вложенное поле должно иметь заголовок, но не иметь параметра имени. По умолчанию этот параметр пуст, установите «да», чтобы активировать его. Это не имеет никакого эффекта, если для дочернего параметра также установлено значение «да».

декат

Если установлено «да», текущая страница не будет автоматически отнесена к категории обслуживания, если в сгенерированном информационном окне есть проблемы или нет видимого раздела данных. Оставьте поле пустым по умолчанию или установите «да», чтобы активировать его.

автозаголовки

Если установлено любое непустое значение, заголовки, за которыми не следуют поля данных, подавляются. Дополнительные сведения см. В разделе « Скрытие заголовков, когда все его поля данных пусты ».

Параметры содержимого

Заголовок

Есть два разных способа добавить заголовок в информационное окно. Один содержит заголовок внутри границы информационного окна в самой верхней ячейке таблицы, а другой помещает его как заголовок поверх таблицы. Вы можете использовать их оба вместе, или только один, или другой, или ни то, ни другое (хотя это не рекомендуется):

заглавие

Текст для заголовка поверх таблицы (или как заголовок раздела перед всем содержимым этой таблицы, если это дочернее информационное окно). По причинам доступности это наиболее рекомендуемая альтернатива.

над

Текст, который нужно поместить в самую верхнюю ячейку таблицы.

подзаголовок (сущ.)

дополнительные поля заголовка, которые помещаются под {{{title}}} и {{{выше}}}, но перед изображениями.

Примеры:

{{Инфобокс | name = {{subst: PAGENAME}} | title = Текст в заголовке над информационным окном | subheader = Подзаголовок информационного окна | header = (остальная часть информационного окна находится здесь)}}

{{Инфобокс | name = {{subst: PAGENAME}} | выше = Текст в самой верхней ячейке информационного окна | subheader = Подзаголовок информационного окна | subheader2 = Второй подзаголовок информационного окна | header = (остальная часть информационного окна находится здесь)}}

Изображения иллюстраций

изображение (n)

изображения для отображения в верхней части шаблона. Используйте полный синтаксис изображения, например [[File: example.png | 200px | alt = Пример альтернативного текста]]. По умолчанию изображение центрируется. См. WP: ALT для получения дополнительной информации об альтернативном тексте.

подпись (n)

Текст для размещения под изображениями.

Основные данные

заголовок (n)

Текст для использования в качестве заголовка в строке n.

метка (n)

Текст для использования в качестве метки в строке n.

данные (n)

Текст для отображения в виде данных в строке n.

Примечание: для любого заданного значения для (n) разрешены не все комбинации параметров. Присутствие a приведет к игнорированию соответствующего (и , см. Ниже); отсутствие a приведет к игнорированию соответствующего. Допустимые комбинации для любой отдельной строки:|header(n)=|data(n)=|rowclass(n)= |label(n)=|data(n)=|label(n)=

• |class(n)= |header(n)=
• |rowclass(n)= |class(n)= |data(n)=
• |rowclass(n)= |label(n)= |class(n)= |data(n)=

См. Рендеринг header4, label4 и data4 в разделе " Примеры" ниже.

Числовые диапазоны

Чтобы обеспечить гибкость при изменении макета информационного окна, при разработке информационного окна может быть полезно использовать несмежные числа для строк заголовка и меток / данных. В дальнейшем параметры для новых строк можно будет вставлять без изменения нумерации существующих параметров. Например:

| header3 = Раздел 1 | label5 = Метка A | data5 = Данные A | label7 = Метка C | data7 = Данные C | header10 = Раздел 2 | label12 = Метка D | data12 = Данные D

Также можно автоматически изменить нумерацию имен параметров с помощью User: Frietjes / infoboxgap.js или Module: IncrementParams .

Сделать поля данных необязательными

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

| label5 = Население | data5 = {{{население |}}}

Таким образом, если статья не определяет параметр численности в своем информационном окне, строка не будет отображаться.

Для более сложных полей с предварительно отформатированным содержимым, которое все еще будет присутствовать, даже если параметр не был установлен, вы можете обернуть все это оператором «#if», чтобы все это исчезло, когда параметр не используется. Например, выражение «#if» в следующем примере читается как «#if: параметр масса был предоставлен | затем отобразить его с последующим« кг »»:

| label6 = Масса | data6 = {{#if: {{{mass |}}} | {{{масса}}} кг}}

Подробнее о #if см. Здесь .

Скрытие заголовков, когда все его поля данных пусты

Вы также можете сделать так, чтобы заголовки автоматически скрывались, когда их раздел пуст (не отображается строка данных).

Рассмотрим эту ситуацию:

{{Инфобокс | title = Пример: заголовок с данными и без данных | headerstyle = background: светло-серый | header1 = Header1 с пустым разделом | label2 = label2 текст | данные2 = | label3 = label3 текст | data3 = | label4 = label4 текст | data4 = | header5 = Header5 с данными ниже | label6 = label6 текст | data6 = Некоторое значение}}

Если вы хотите скрыть заголовок при отсутствии значений, используйте :|dataN=|autoheaders=y

{{Инфобокс | title = Пример: заголовок с данными и без данных | autoheaders = y | headerstyle = background: светло-серый | header1 = Header1 с пустым разделом | label2 = label2 текст | данные2 = | label3 = label3 текст | data3 = | label4 = label4 текст | data4 = | header5 = Header5 с данными ниже | label6 = label6 текст | data6 = Некоторое значение}}

Итак, header1 будет отображаться, если определен какой-либо из item1, item2 или item3. Если ни один из трех параметров не определен, заголовок не будет отображаться, и перед следующим видимым содержимым не появится пустая строка.

Примечание: если в данных есть пустые элементы css, например |data=<span style="background:yellow;"></span>, они будут рассматриваться как непустые (имеющие данные).

Если |autoheaders=yесть элементы, которые не должны вызывать заголовок, разместите |headerX=_BLANK_. Он будет служить пустым заголовком и отделить его от последующих элементов.

{{Инфобокс | title = Пример: заголовок с данными и без данных | autoheaders = y | headerstyle = background: светло-серый | header1 = Header1 с пустым разделом | label2 = label2 текст | данные2 = | label3 = label3 текст | data3 = | label4 = label4 текст | data4 = | header5 = _BLANK_ | label6 = label6 текст | data6 = Некоторое значение, но не запускает header1 и не показывает header5}}

Нижний колонтитул

ниже

Текст для ввода в нижнюю ячейку. Нижняя ячейка предназначена для сносок, см. Также и другой подобной информации.

Параметры презентации

Заголовки курсивом

Заголовки статей с информационными блоками можно сделать курсивом в соответствии с WP: ITALICTITLE , передав italic titleпараметр.

• Включите курсивное начертание заголовков, передавая |italic title={{{italic title|}}}из информационного окна.
• Отключено по умолчанию (особенно потому, что в этом стиле можно безопасно отображать только латинский алфавит, а курсив может потребоваться, чтобы отличить иностранный язык от местного английского языка только в этом скрипте, но его будет трудно читать для других скриптов), но разрешить некоторым экземплярам быть выделенным курсивом путем передачи |italic title={{{italic title|no}}}
• Не выделяйте заголовки курсивом, вообще не передавая параметр.

CSS стили

HTML-классы и микроформаты

Этот шаблон поддерживает добавление информации о микроформате. Это делается путем добавления атрибутов «класс» к различным ячейкам данных, указывающих, какая информация содержится в них. Можно указать несколько имен классов, разделенных пробелами, некоторые из которых используются в качестве селекторов для настраиваемого стиля в соответствии с политикой проекта или оболочкой, выбранной в пользовательских настройках, другие используются для микроформатов.

Чтобы пометить информационное окно как содержащее информацию hCard , например, добавьте следующий параметр:

| bodyclass = vcard

И для каждой строки, содержащей ячейку данных, которая является частью vcard, добавьте соответствующий параметр класса:

| class1 = fn | class2 = org | class3 = тел.

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

См. Википедию: Микроформаты WikiProject для получения дополнительной информации о добавлении информации о микроформате в Википедию и микроформат для получения дополнительной информации о микроформатах в целом.

Примеры

Обратите внимание, как строка не отображается в отображаемом информационном окне, когда метка определена без сопутствующей ячейки данных , и как все они отображаются, когда заголовок определен в той же строке, что и ячейка данных . Также обратите внимание, что подзаголовки по умолчанию не выделяются жирным шрифтом, как заголовки, используемые для разделения основного раздела данных, потому что эта роль предназначена для указанной выше ячейки:

{{ Infobox  | name  =  {{ subst : PAGENAME }}  | bodystyle  =  | titlestyle  =  | abovestyle  =  background : #cfc ;  | subheaderstyle =  | заглавие  =  Test  Infobox  | выше  =  Над  текстом  | подзаголовок  =  подзаголовок  выше  изображения  | subheader2  =  Второй  подзаголовок | образный стиль  =  | captionstyle =  | image  = [[ Файл : Пример-серьезный . jpg | 200 пикселей | alt = Пример альтернативного текста ]] | caption  = Подпись отображается ниже Пример-серьезный . jpg           | headerstyle  =  фон : #ccf ;  | labelstyle  =  фон : #ddf ;  | стиль данных  =  | header1 =  Заголовок  определен  отдельно  | label1 = | data1 = | header2 = | label2 = Этикетка определяется одна ли не отображать ( потребности данных , или является подавление ) | data2 = | header3 = | label3 = | data3 = Данные определены отдельно | header4 = Все три определены (                                заголовок ,  метка ,  данные ,  все  с  одинаковым  номером )  | label4 = вовсе не отображать ( тот же номер , как в заголовке ) | Data4 = вовсе не отображать ( тот же номер , как в заголовке ) | header5 = | label5 = Метка и данные определены ( метка ) | data5 =                              Метка  и  данные  определены  ( данные ) | belowstyle =  background : #ddf ;  | ниже  =  Под  текстом }}

Для этого примера, что |bodystyle=и |labelstyle=параметры используются для регулировки ширины и определяют Википедию ширину по умолчанию для столбца меток:

{{ Infobox  | name  =  {{ subst : PAGENAME }} | bodystyle  = width : 20 em | titlestyle  = | title  = Тестовое информационное окно       | headerstyle =  | labelstyle  = width : 33 % | datastyle  =     | header1 =  | label1 = Этикетка 1 | data1 = Данные 1 | header2 = | label2 = Этикетка 2 | data2 = Данные 2 | header3 = | label3 = Этикетка 3 | data3 = Данные 3 | header4 = Заголовок 4 | label4 = | data4 = | header5 = | label5 = Метка                                     5  | данные 5 = Data 5 : Lorem Ipsum боль сидеть Амет , consectetur adipisicing Элиты , SED сделать eiusmod TEMPOR incididunt ет Лабор и др Dolore магна aliqua .                       | belowstyle =  | below =  Под  текстом }}

Встраивание

Один шаблон информационного окна можно встроить в другой с помощью |child=параметра. Эта функция может использоваться для создания модульного информационного окна или для создания более определенных логических разделов. Давным-давно было необходимо использовать встраивание для создания информационных ящиков с более чем 99 строками; но в настоящее время нет ограничений на количество строк, которые могут быть определены в одном экземпляре {{infobox}}.

{{Инфобокс | title = Заголовок верхнего уровня | data1 = {{Инфобокс | decat = да | ребенок = да | title = Первый подраздел | label1 = Метка 1.1 | data1 = Данные 1.1 }} | data2 = {{Инфобокс | decat = да | ребенок = да | title = Второй подраздел | label1 = Метка 2.1 | data1 = Данные 2.1 }} | нижестиль = | внизу = Под текстом}}

Обратите внимание, что в приведенных выше примерах дочернее информационное окно помещается в dataполе, а не в headerполе. Обратите внимание, что подзаголовки разделов не выделяются полужирным шрифтом, если полужирный шрифт не указан явно. Чтобы получить заголовки разделов жирным шрифтом, поместите дочернее информационное окно в поле заголовка (но не в поле метки, потому что оно не будет отображаться!), Либо используя

{{Инфобокс | title = Заголовок верхнего уровня | header1 = {{Инфобокс | decat = да | ребенок = да | title = Первый подраздел | label1 = Метка 1.1 | data1 = Данные 1.1 }} | header2 = {{Инфобокс | decat = да | ребенок = да | title = Второй подраздел | label1 = Метка 2.1 | data1 = Данные 2.1 }} | нижестиль = | внизу = Под текстом}}

или же,

{{Инфобокс | title = Заголовок верхнего уровня | header1 = Первый подраздел {{Инфобокс | decat = да | ребенок = да | label1 = Метка 1.1 | data1 = Данные 1.1 }} | header2 = Второй подраздел {{Инфобокс | decat = да | ребенок = да | label1 = Метка 2.1 | data1 = Данные 2.1 }} | нижестиль = | внизу = Под текстом}}

Обратите внимание, что пропуск |title=параметра и исключение любого текста, предшествующего встроенному информационному блоку, может привести к появлению ложных пустых строк таблицы, создавая пробелы в визуальном представлении. Вывод мусора можно подавить с помощью |rowstyleN=display: none, заменив N номером данных / заголовка.

Википедия: WikiProject Infoboxes / embed включает некоторые ссылки на статьи Википедии, которые включают информационные блоки, встроенные в другие информационные блоки.

Подбоксы

Альтернативный метод встраивания - использовать |subbox=yes, удаляя внешнюю границу информационного окна, но сохраняя внутреннюю структуру. Одной из особенностей этого подхода является то, что родительский и дочерний блоки не обязательно должны иметь одинаковую структуру, а поля метки и данных не выровнены между родительским и дочерним блоками, поскольку они не находятся в одной родительской таблице.

{{ Инфобокс  | headerstyle = цвет фона : #eee ; | labelstyle  = цвет фона : #eee ; | header1 = Главный 1 | header2 = Главный 2 | data3 = {{ Инфобокс | subbox = да | headerstyle = цвет фона : #ccc ; | labelstyle  = цвет фона : #ddd ;                           | header1 = Sub 3-1 | header2 = Sub 3-2 | label3 = Этикетка 3-3 | data3 = Данные 3-3 }} | data4 = {{ Инфобокс | subbox = да | labelstyle  = цвет фона : #ccc ; | label1 = Этикетка 4-1 | data1 = Данные 4-1 }} | label5 = Метка                                         5  |  data5  =  Данные  5  | header6 = Главный 6 }}   

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

{{ Боковая панель  | navbar = off | стиль заголовка = цвет фона : #eee ; | heading1 = Заголовок 1 | heading2 = Заголовок 2 | content3 = {{ Infobox | subbox = да | headerstyle = цвет фона : #ccc ; | labelstyle = цвет фона : #ddd ; | header1 =                             Sub  3-1  | header2 = Sub 3-2 | label3 = Этикетка 3-3 | data3 = Данные 3-3 }} | content4 = {{ Infobox | subbox = да | labelstyle = цвет фона : #ccc ; | label1 = Этикетка 4-1 | data1 = Данные 4-1 }} | heading5 = Заголовок 5 }}                                     

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

Управление переносом строк во встроенных списках без маркировки

Шаблон может использоваться с и для управления переносом строк в безбуквенных списках, встроенных в информационные блоки (например, приведенный список ), чтобы предотвратить путаницу обернутых длинных записей с множественными записями. Подробности см . В шаблоне: Wbr / doc # Управление переносом строк в информационные поля .{{nbsp}}{{wbr}}{{nowrap}}{{Infobox film}}

Полный пустой синтаксис

(Примечание: количество возможных строк не ограничено; ниже приведены только 20, поскольку информационные блоки большего размера будут относительно редкими. Просто увеличьте нумерацию по мере необходимости. Параметры "класса" микроформата также опускаются, поскольку они обычно не используются использовал.)

{{Инфобокс| name = {{subst: PAGENAME}}| ребенок = {{{ребенок |}}}| subbox = {{{subbox |}}}| курсивный заголовок = {{{italic title | no}}}| стиль тела =| titlestyle =| вышестиль =| subheaderstyle =| title =| выше =| подзаголовок =| образный стиль =| captionstyle =| изображение =| caption =| image2 =| caption2 =| headerstyle =| labelstyle =| стиль данных =| header1 =| label1 =| data1 =| header2 =| label2 =| данные2 =| header3 =| label3 =| data3 =| header4 =| label4 =| data4 =| header5 =| label5 =| data5 =| header6 =| label6 =| data6 =| header7 =| label7 =| data7 =| header8 =| label8 =| data8 =| header9 =| label9 =| data9 =| header10 =| label10 =| data10 =| header11 =| label11 =| data11 =| header12 =| label12 =| data12 =| header13 =| label13 =| data13 =| header14 =| label14 =| data14 =| header15 =| label15 =| data15 =| header16 =| label16 =| data16 =| header17 =| label17 =| data17 =| header18 =| label18 =| data18 =| header19 =| label19 =| data19 =| header20 =| label20 =| data20 =| нижестиль =| ниже =}}

Инфобоксы и пользовательский стиль

Пользователи могут иметь пользовательский CSS, который скрывает любые информационные поля в их собственных браузерах.

Чтобы скрыть все информационные окна, добавьте следующее в Special: MyPage / common.css (для всех скинов или Special: MyPage / skin.css только для текущего скина) в отдельной строке:

. инфобокс  {  дисплей :  нет ;  }

В качестве альтернативы вы можете добавить следующий код в свой common.js или в пользовательский скрипт браузера, который выполняется таким расширением, как Greasemonkey :

$ ( '.infobox' ). скрыть ();

Имейте в виду, что хотя, согласно WP: Руководство по стилям / информационным блокам , вся информация в информационном блоке в идеале также должна быть найдена в основной части статьи, это руководство не соответствует полностью. Например, полная таксономическая иерархия в {{ Taxobox }}, а также коды OMIM и других медицинских баз данных для {{ болезни Infobox }} часто не встречаются в основном содержании статьи. Информационное окно также часто является местом расположения наиболее значимого, даже единственного изображения в статье.

Перенос на другие MediaWikis

Для шаблона информационного окна требуется расширение Scribunto . WikiProject Transwiki имеет версию этого шаблона, которая была изменена для работы с другими MediaWikis.

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

• Модуль: Infobox , модуль Lua, на котором основан этот шаблон.
• Модуль: проверка неизвестных параметров
• {{ Infobox3cols }}
• {{ Navbox }} и {{ Боковая панель }}
• Список инфобоксов
• Модуль: InfoboxImage
• Категории обслуживания:
  • Категория: Статьи, в которых используются шаблоны инфобоксов без строк данных (14 050)
  • Категория: страницы, на которых используются встроенные шаблоны инфобоксов с параметром заголовка (2,527).

Категории отслеживания

• Категория: Статьи с отсутствующей информацией Викиданных  (42)