Модуль:Карточка/doc
Это страница документации Модуль:Карточка.
Этот модуль составлен в 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=...
— такие места нужно исправлять вручную.