Википедия: Руководство по стилям / Инфобоксы

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

Ярлыки MOS: IBX МОС: ИНФОБОКС

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

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

Цель [ править ]

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

Как и в случае любого руководства, будут исключения, когда часть ключевой специализированной информации трудно интегрировать в основной текст, но где эта информация может быть помещена в информационное окно. Яркие примеры включают коды ISO 639 в {{ Infobox language }} и большинство параметров в {{ Chembox }}.

Использование информационного окна также делает данные в нем доступными для сторонних повторных пользователей, таких как DBpedia, в детализированном машиночитаемом формате, часто с использованием микроформатов .

Принципы дизайна [ править ]

Общий подход [ править ]

Рекомендуемый процесс создания шаблона информационного окна - это просто начать и собрать как можно больше требований. Сначала протестируйте базовый формат для нового шаблона как статическую таблицу, а затем, когда будет достигнут консенсус, перенесите его в формат шаблона. Шаблон следует пересмотреть, прежде чем широко использовать в статьях, если шаблон или определенные параметры нуждаются в модификации, чтобы свести к минимуму повторные работы. Если добавляются новые поля и параметры, статьи необходимо обновить, чтобы отразить новые требования. Если параметры будут переименованы или удалены, многие статьи, скорее всего, останутся без изменений, поскольку посторонние параметры игнорируются.

Стиль, цвет и форматирование [ править ]

Следует стремиться к общей согласованности статей, использующих одно и то же информационное окно. Хороший совет - не добавлять постороннее форматирование стиля поверх стандартного информационного окна без уважительной причины. Инфобоксы могут иметь тенденцию к большему сокращению, чем обычно используется в теле статей. Общие рекомендации WP: NBSP (использование неразрывных пробелов), WP: MOSNUM (числа и даты) и WP: COLOR (использование цвета), вероятно, будут особенно актуальными. Как и в случае с шаблонами навигации , цель информационного окна - его полезность, а не внешний вид; поэтому информационные боксы не должны быть произвольно декоративными.

Изображения [ редактировать ]

При добавлении изображения в информационное окно НЕ следует использовать эскизы. Шаблоны Infobox должны реализовывать модуль InfoboxImage, чтобы помочь с форматированием изображений, поэтому простое указание имени файла будет работать. Например, чтобы использовать File: Image PlaceHolder.png , вы можете просто использовать |image=Image PlaceHolder.png. Подписи следует указывать с |caption=опцией. Все информационные окна отличаются друг от друга, и для выбора правильных параметров, соответствующих изображению и подписи, следует обращаться к документации по данному информационному окну. Если InfoboxImage еще не в полной мере реализован в Infobox вы используете, то же самое alt=, upright=, title=и т.д., варианты могут быть вызваны с помощью расширенного синтаксиса изображения , вызова frameless, неthumb. (Вы можете добавить запрос на страницу обсуждения информационного окна о добавлении недостающих параметров.)

Согласованность между информационными блоками [ править ]

Для единообразия применяются следующие рекомендации:

• Перед созданием нового шаблона информационного окна сначала проверьте, существует ли уже подходящий информационный блок.
• Назовите шаблон [[Template: Infobox some subject]] ( некоторая тема должна быть в единственном числе и начинаться с заглавной буквы в соответствии с обычным использованием - см. Wikipedia: Заголовки статей , например, «Infobox поселение» или «Infobox NFL player»).
• Шаблон {{ infobox }} можно использовать для простого создания нового информационного окна. Если по какой-то причине {{ infobox }} не подходит и таблица должна быть создана вручную, код шаблона следует использовать class="infobox"для объявления основной таблицы. Это автоматически выбирает правильное выравнивание, размер шрифта и интервал, чтобы соответствовать существующим информационным блокам. Ширина 22 ems ( 22emв CSS ) предлагается в качестве дополнительного объявления для соответствия параметру {{ infobox }} по умолчанию.
• У шаблона должна быть большая жирная строка заголовка. Для этого можно использовать либо заголовок таблицы, либо заголовок. Оно должно называться обычным названием темы статьи, но может содержать полное (официальное) название; это не обязательно должно совпадать с заголовком статьи в Википедии, но вернуться к его использованию (с {{ PAGENAMEBASE }}) обычно нормально. Он не должен содержать ссылки.
• Параметры в инфобоксах должны:
  • иметь имя, а не нумеровать, для использования в будущем.
  • используйте строчные буквы, если это не имена собственные.
  • быть согласованным между информационными блоками. Например, {{ Infobox person }} использует |birth_date=, как и многие другие биографические инфобоксы, поэтому использование нового биографического инфобокса, скажем |date of birth=, вместо повторного использования существующего имени параметра будет затруднительным .
  • Используйте змеиный футляр (например |birth_date=). Не верблюжий регистр (например |birthDate=) или заглавный регистр (например |BirthDate=)
  • представляют пробелы с помощью подчеркивания , например, |birth_place=нет |birth-place=.
• Информационные блоки, использующие географические координаты, следует использовать в |coordinates=качестве имени параметра с шаблоном {{ corre }} в значении параметра.
• Если параметр неприменим или информация недоступна, его следует оставить пустым, а шаблон закодировать так, чтобы выборочно скрыть информацию или предоставить значения по умолчанию для параметров, которые не определены.

Причины несоответствия [ править ]

Ряд факторов может вызвать несоответствие доступной сводной информации для определенного типа статей:

Несоответствие дизайна

Инфобоксы, особенно ответвления инфобоксов для одной и той же категории статей, должны поддерживать согласованный внешний вид со связанными инфобоксами, особенно в отношении макета, цвета и структуры. Например, читатели ожидают некоторого сходства при просмотре статьи о Лондоне и Нью-Йорке .

Историческая незавершенность

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

Иерархическая непоследовательность

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

Несогласованность функций

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

Недостаток информации

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

Общие соображения по дизайну [ править ]

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

При разработке шаблона информационного окна учитывайте следующие вопросы:

Поле значения?

Насколько важно поле для статей, которые будут использовать информационное окно? Это сводная информация или более подробная информация, которую лучше разместить в тексте статьи?

Будет ли это поле иметь отношение ко многим статьям, в которых будет использоваться информационное окно?

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

Насколько вероятно, что поле будет пустым?

Любое поле, которое может быть пустым, должно быть необязательным. Однако обычно пустое поле может не быть особенно полезным или актуальным.

Можно ли повторно использовать имя поля в другом месте?

Например, если вы добавляете поле для даты смерти объекта в шаблон биографического информационного окна, используйте |death_date=от {{ Infobox person }}, а не похожее имя, например |date_of_death=или |died=.

Это для людей, мест или организаций?

Если это так, включите hCard микроформатого -смом проекта микроформат

Это для датированного события?

(Такие , как рекордно выпуск или спортивного крепеж) Если да, включает в себя hCalendar микроформата -Увидимся проекта микроформат

Географические информационные ящики [ править ]

Инфобоксы для географических объектов (например, городов и стран) обычно должны начинаться с заголовка статьи, хотя формальная версия названия (например, Республика Черногория в Черногории ) может быть заменена. Если в названии статьи отсутствует неоднозначность, простое имя может начинать информационное окно, если тема ясна (например, Сан-Паулу в Сан-Паулу (штат) ). Если это полезно, под ним могут быть указаны альтернативные или местные имена. Подробные исторические имена часто лучше во втором информационном окне, как в Аугсбурге .

Динамические шаблоны [ править ]

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

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

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

Читателей намного больше, чем редакторов

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

Редакторов статей намного больше, чем редакторов шаблонов

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

Требование [ править ]

Оцените потребность в новом информационном ящике перед его проектированием. При создании нового информационного окна следует учитывать несколько моментов:

1. Достаточные и подходящие отличные параметры
2. Не могут быть обработаны существующими информационными окнами
3. Нельзя решить, создав оболочку существующих информационных ящиков.

Реализации [ править ]

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

Условные шаблоны [ править ]

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

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

| caption = {{#if: {{{ image | }}} | {{{ caption | }}} }}

Мета-шаблоны с разрешением имен [ править ]

Несколько подшаблонов (и независимых шаблонов) имеют общий префикс имени. Они включаются в информационное окно на основе значения определенного параметра, который действует как суффикс имени. Например, мы создаем {{Infobox Ship/Military}}и {{Infobox Ship/Civilian}}и использовать {{Infobox Ship/{{{type}}}}}. Использование |type=Militaryв статье поводов {{Infobox Ship/Military}}для использования.

Информационные окна, состоящие из нескольких частей [ править ]

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

Взаимодействие между несколькими шаблонами [ править ]

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

Например, если группа WikiProject Saints хотела разработать шаблон на основе своего статического информационного поля, они могли бы использовать Template: Infobox Biography и разработать шаблон для конкретного проекта, содержащий только дополнительную информацию, и страницы отображали бы обе страницы «сложенными» вместе.

Использование инфобоксов в статьях [ править ]

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

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

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

Как и в шаблонах навигации , в информационных блоках не должно быть значков флажков. Для получения дополнительной информации о значках флагов см. MOS: FLAG .

Ссылки в инфобоксы [ править ]

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

Этническая принадлежность в инфобоксах [ править ]

Сообщество Wikipedia решило на этом RFC не разрешать использование ethnicity =параметра в информационных ящиках.

Национальность и гражданство [ править ]

Большинство инфобоксов с биографиями имеют национальность и гражданство. Как правило, следует избегать использования любого из них, если страна, к которой принадлежит объект, может быть выведена из страны рождения, как указано в |birthplace=.

При необходимости, например, в связи с изменением гражданства после рождения, двойным «гражданством» или другими необычными сценариями, используйте за |nationality=исключением случаев, когда |citizenship=это более целесообразно по необычным юридическим причинам. Одновременное использование гражданства и гражданства редко, если вообще когда-либо, необходимо (сложные случаи следует объяснять в тексте статьи). Ни одно из полей не должно использоваться для указания этнической принадлежности.

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

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

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

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

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

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

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

См. Также [ править ]

Список шаблонов [ править ]

• Википедия: Список информационных ящиков - основной список
• Все страницы с заголовками, начинающимися с Template: Infobox , недавно созданный список шаблонов, начинающийся с "Infobox ..."

Другая информация инфобокса [ править ]

• Справка: информационное окно
• Википедия: Указатель шаблонов / Очистка § Требуется информационное окно
• Все страницы с заголовками, начинающимися с Wikipedia: WikiProject Infobox , недавно созданный список соответствующих WikiProjects.
• Википедия: Арбитраж / Запросы / Дело / Инфобоксы
• Википедия: Дезинфобоксы , эссе
• Википедия: Дезинфобоксы: опровержение , эссе
• Википедия: Закон включения инфобокса , эссе

Другие типы шаблонов [ править ]

• Википедия: шаблоны навигации - нижние колонтитулы статей, содержащие ссылки на несколько связанных статей.
• Википедия: сообщения интерфейса MediaWiki - сообщения, отображаемые в окнах веб-интерфейса Википедии, зарезервированы для внутреннего использования системы и могут быть изменены только администраторами.
• Википедия: Указатель шаблонов - каталог всех шаблонов