WikiDer > Справка: Создание информационных ящиков - Википедия

Help:Designing infoboxes - Wikipedia

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

Создание нового информационного окна

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

Прототипы инфобоксов следует разместить на Википедия: Список инфобоксов / Предлагается подстраница, когда предлагается, и добавленная в соответствующую подкатегорию, когда реализована.

Создание прототипа инфобокса

Инфобоксы могут быть легко прототипированы в собственном редакторе дизайна. пространство пользователя. Чтобы начать новую страницу в своем пространстве имен, введите «Special: Mypage /», а затем имя страницы, которую вы хотите создать, в поле поиска (или создайте такую ​​ссылку в таком месте, как общая песочница). Например, чтобы создать дом для прототипа «Infobox_mysubject» в вашем пользовательском пространстве, вы должны выполнить поиск: Special: Mypage / Infobox mysubject. Затем к включать шаблон прототипа в ветку обсуждения после его создания, если ваш идентификатор пользователя Tom, вы должны использовать шаблон с {{Пользователь: Tom / Infobox mysubject}}. Вы также можете провести тестирование в различных шаблонные песочницы.

Общие этапы создания прототипа:

  • Определение общего подхода к реализации
  • Создание инфобокса
  • Реализация информационного окна
  • Документирование, для других редакторов, как использовать информационное окно
  • Категоризация информационного окна, чтобы сделать его более доступным для других редакторов
  • Тестирование реализации инфобокса

Определение общего подхода

Существует три метода создания прототипа:

  1. Использовать {{информационное окно}} для создания прототипа. Этот способ самый простой и поэтому настоятельно рекомендуется. В остальной части этого раздела предполагается, что редактор-проектировщик выбирает этот подход.
  2. Использовать стол для создания «статического информационного блока», конвертируемого в шаблон после того, как редактор дойдет до «окончательного» дизайна. Смотрите также Википедия: Мышление вне информационного ящика.
  3. Используйте MediaWiki шаблон возможность создания прототипа с использованием документации на mw: Справка: Шаблоны. Хотя это обеспечивает максимальную гибкость, это, безусловно, самый сложный подход (и выходит за рамки данной статьи).

Проектирование

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

Заголовок
без рамки
Подпись к изображению
РазделА
FieldNameA1FieldParameterA1
FieldNameA2FieldParameterA2
FieldNameA3FieldParameterA3
РазделB
FieldNameB1FieldParameterB1
FieldNameБи 2FieldParameterБи 2

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

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

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

Реализация

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

{{infobox | вышестиль = | выше = | изображение = | caption = | headerstyle = | header1 = | label1 = | data1 = | header2 = | label2 = | data2 = ... | header20 = | label20 = | data20 =}}

Сопоставление визуальных элементов с параметрами инфобокса очень просто:

Визуальный элементКак реализоватьПараметры для реализацииПримечания
Цветные полосы заголовка и разделов| abovestyle = фон:цвет;
| headerstyle = фон:цвет;
НиктоВидеть http://www.w3.org/TR/CSS2/propidx.html для стилей кроме фон
Заголовок| выше = {{{имя | {{PAGENAME}} }}}{{{имя}}}
Изображение| image = {{#if: {{{изображение |}}} | [[Файл: {{{изображение}}}} | 22Эм]]}}
| caption = {{{caption |}}}
{{{изображение}}}, {{{подпись}}}Изображения необходимо указывать с помощью расширенный синтаксис изображения
Заголовок раздела| заголовокп = Фиксированное название разделаНикто
Обязательное поле без значения по умолчанию| этикеткап = Фиксированное имя поля
| данныеп = {{{Имя параметра}}}
{{{Имя параметра}}}Обратите внимание, что параметры заключены в тройные фигурные скобки. {{{...}}}
Необязательное поле| этикеткап = Фиксированное имя поля
| данныеп = {{{Имя параметра|}}}
{{{Имя параметра}}}Использование | чтобы указать пустую строку по умолчанию ({{{...|}}})
Обязательное поле со значением по умолчанию| этикеткап = Фиксированное имя поля
| данныеп = {{{Имя параметра|значение по умолчанию}}}
{{{Имя параметра}}}
Поле отображается условно| этикеткап = Фиксированное имя поля
| данныеп = {{#if: {{{Имя параметраесли указано|}}}|{{{Имя параметразатем покажите это|}}} }}
{{{Имя параметраесли указано}}},
{{{Имя параметразатем покажите это}}}
Общая форма {{#если:тест|затем текст|другой текст}}}
Необязательный заголовок раздела| заголовокп = {{#if: {{{Имя параметра1|}}}{{{Имя параметра2|}}}{{{Имя параметра3|}}}|Фиксированное название раздела}}{{{Имя параметра1}}}
{{{Имя параметра2}}}
{{{Имя параметра3}}}
Обратите внимание на объединение трех параметров.

Видеть mw: Справка: Расширение: Функции парсера для описания #если функция парсера.

При принятии стилевых решений редакторы должны следовать Руководство стиля как можно точнее. Изображения необходимо указывать с помощью расширенный синтаксис изображения. При указании стилей (например, для надстиль, тип кузова, и стиль заголовка), http://www.w3.org/TR/CSS2/propidx.html отличный справочник.

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

  • Отображение заголовка вне информационного окна (а не внутри информационного окна)
  • Отображение дополнительного текста под заголовком или внизу информационного окна (для «см. Также», сносок, вики-ссылки на «список» статей и т. Д.)
  • Отображение второго изображения
  • Отображение изображений где угодно, кроме верхней части информационного окна
  • Сопоставление отдельных полей с соответствующими микроформат (Смотрите также Википедия: Микроформаты WikiProject)
  • Отображение панели навигации «просмотреть / изменить / обсудить» для информационного окна

Опять же, эти функции задокументированы в {{информационное окно}}.

Документирование

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

  • Во-первых, убедитесь, что {{Документация}} добавляется к шаблону и заключена в <noinclude> элементы.(Смотрите также ниже) Убедитесь, что между концом шаблона (}}) и <noinclude> поскольку они, если они есть, будут включены в каждую статью, в которой используется шаблон.
{{информационное окно ...}}<noinclude>{{документация}}<!-- Please add category and language links to the bottom of the /doc sub-page, not here --></noinclude>
  • Затем создайте страницу документации как подстраницу из самого шаблона информационного окна (например, Special: Mypage / Infobox mysubject / doc). Самый простой способ сделать это - следовать [Создайте] ссылка из пустого {{документация}} включение. Это предварительно загрузит основную страницу документации, которую можно заполнить базовыми сведениями, ссылками на похожие шаблоны, межвики-ссылками и ссылками на категории (внизу, в <noinclude></noinclude> раздел).
  • Наконец, разделите документацию на следующие разделы:
  • Обзор
  • Параметры (их значения и являются ли они необязательными, имеют ли они значение по умолчанию или отображаются условно)
  • Пустой шаблон (подходит для копирования и вставки в статьи)
  • Примеры (например, для демонстрации эффектов условно отображаемых параметров)
  • Микроформаты (если используется)

Категоризация

Чтобы другим редакторам было легче находить информационное окно, категории и межвики-ссылки должны быть добавлены в нижнюю часть документации информационного окна (по адресу Special: Mypage / Infobox mysubject / doc).

Обратите внимание, что по соглашению информационное окно должно быть категоризировано с использованием явного ключ сортировки который удаляет префикс информационного окна. Другими словами, вместо того, чтобы позволить ключу сортировки категорий по умолчанию Википедия: PAGENAME (в нашем примере "Инфобокс mysubject"), редакторы должны явно указать"Моя тема"как ключ сортировки категорий, как в [[Категория: шаблоны инфобокса Mycategory | Моя тема]].

Тестирование

Редакторы должны тестировать прототипы информационных боксов в своих пользовательских пространствах. Простейшим способом является размещение редактором полного имени страницы проверяемого шаблона в фигурных скобках шаблона (например, {{Special: Mypage / Infobox mysubject}}) на собственной странице пользователя, Специальное: Моя страница.

После тестирования прототипа информационного бокса он готов для экспертной оценки и развертывания.

Информационное окно скелета

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

{{infobox | вышестиль = | выше = | изображение = | caption = | headerstyle = | header1 = | label1 = | data1 = | header2 = | label2 = | data2 = | header3 = | label3 = | data3 = | header4 = | label4 = | data4 = | header5 = | label5 = | data5 = | header6 = | label6 = | data6 = | header7 = | label7 = | data7 = | header8 = | label8 = | data8 = | header9 = | label9 = | data9 = | header10 = | label10 = | data10 =}}  {{Documentation}} 

Пример {{информационное окно}} - на основе инфобоксов

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