Модуль:Карточка/doc

Версия от 15:42, 19 ноября 2022; imported>Mikhail (1 версия импортирована)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

Это страница документации Модуль:Карточка.

Этот модуль составлен в 2014 году как проект новой реализации шаблона {{Карточка}}. Нынешняя реализация использует Модуль:Infobox. Документация по использованию шаблона расположена на странице соответствующего шаблона.

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

Модуль развёрнут в двух вариантах: боевая версия (привязана к {{карточка/модуль}}, в дальнейшем планируется привязка к {{карточка}}) и песочница для тестирования (привязана к {{карточка/песочница2}}).

Для песочницы развёрнут модуль юнит-тестирования (запустить).

Для тестирования в боевых условиях замените в частном шаблоне-карточке {{карточка}} на {{карточка/модуль}}.

Что следует учитывать при портировании карточек из английской Википедии

  • Все параметры переведены. Исключение составляет nocat. Внимание: при переводе шаблонов-карточек нужно заменять decat на nocat!
  • cellspacing заменён с 3 на 2 (польза от 3 неизвестна).
  • Очищены стандартные style-стили — этим занимается MediaWiki:Common.css, а не модуль. Стили по умолчанию в английской карточке немного отличаются от переведённой карточки.
  • Изменён способ обработки заголовок_курсивом на более привычный для раздела:
    В английской Википедии если italic title пустой, yes или force, то заголовок выводится курсивом.
    В переведённой версии если заголовок_курсивом не пустой (обычно пишется заголовок_курсивом=1), то заголовок выводится курсивом.
  • Изменён способ обработки nocat на более привычный для раздела:
    В английской Википедии если decat установлен в yes, то категоризация не выполняется.
    В переведённой версии если nocat не пустой (обычно пишется nocat=1), то категоризация не выполняется.

Изменения, которые, возможно, стоит внести перед интеграцией

  • Документировать параметры, которых раньше не было из-за технических ограничений (снятие ограничений на количество изображений, полей вверху, внизу)
  • Документировать новые параметры стилей и классов.
  • Документировать режимы внедрения и подкарточки.
  • Избавиться от scope — польза от него сомнительна, читалки с высокой вероятностью в состоянии определить порядок чтения карточек.

Проблемы внедрения

Используемый в коде подход гарантирует корректную работу только при шаге между подзаголовками и парами метка-текст не больше 50! В разных карточках можно встретить что-то вроде метка12=...|текст12=...|метка13=...|текст13=...|метка120=... — такие места нужно исправлять вручную.