Справка:CatList 🔗


Материал из VEDA Wiki
Версия от 01:42, 8 ноября 2024; Sphynkx (обсуждение | вклад)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к: навигация, поиск

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

Экстеншн подключается на странице установкой тегов <catlist></catlist>. Текст между тегами рассматривается как имя категории и выводятся страницы основного неймспейса, принадлежащие этой категории. В отсутствии текста между тегами экстеншн считает именем категории имя текущей страницы.

Экстеншн выводит список страниц, оформленных с разными шаблонами для инфобокса, однако можно настраивать вывод только определенными - см. параметр templates.

Управление количеством выводимых элементов не осуществлено (хотя и технически возможно) выводятся все страницы категории на единственную страницу.

Параметры в открывающем теге:

  • caption - настройка альтернативного заголовка секции. После знака = в кавычках указывается желаемый текст заголовка. В текст заголовка можно поместить "шаблон" {{cat}}, который подставит вики-ссылку на категорию. Напр.:
<catlist caption='My caption for {{cat}}:' namespaces='0,3000' templates='Организация,Персона'>Гватемала</catlist>
Также можно применять вики-форматирование, но с осторожностью. Если применяется форматирование шрифта (одиночными кавычками) надо убедиться, что содержимое модификатора охвачено двойными кавычками. Форматирование HTML-тегами не применять - вызывает сбой рендера. Если очень надо применить именно HTML-теги, то в них надо заменить символы < и > на &lt; и &gt; соответственно. Но без гарантий. Произвести такую замену на стадии кода экстеншна не удалось - вероятно баг движка.
  • gotop - подключение шаблона GoTop для "кнопки" возврата наверх страницы. Появится слева внизу. Параметр указывается без модификаторов.
  • namespaces - список номеров неймспейсов, разделенный запятыми (соответствие чисел и имен неймспейсов можно узнать, временно вставляя параметр shownamespaces). Указывается после знака = в кавычках. Напр.:
<catlist namespaces='0,3000'>Гватемала</catlist>
  • shownamespaces - вывод списка всех неймспейсов - номеров и соотв. имен. Отменяет вывод списка страниц. Не требует модификаторов. Пример:
<catlist shownamespaces></catlist>
Результат:

Array (

   [-2] => медиа
   [-1] => служебная
   [0] => 
   [1] => обсуждение
   [2] => участница
   [3] => обсуждение_участницы
   [4] => veda_wiki
   [5] => обсуждение_veda_wiki
   [6] => image
   [7] => image_talk
   [8] => mediawiki
   [9] => обсуждение_mediawiki
   [10] => шаблон
   [11] => обсуждение_шаблона
   [12] => справка
   [13] => обсуждение_справки
   [14] => категория
   [15] => обсуждение_категории
   [460] => campaign
   [461] => campaign_talk
   [828] => модуль
   [829] => обсуждение_модуля
   [1198] => translations
   [1199] => translations_talk
   [3000] => субтитры
   [3001] => обсуждение_субтитров
   [3002] => tech
   [3003] => tech_talks
   [3004] => policy
   [3005] => policy_talks

)


  • templates - список названий шаблонов, страницы с которыми будут выведены. Указывается после знака = в кавычках, имена инфобоксов разделяются запятыми. Напр.:
<catlist templates='Организация,Персона'>Гватемала</catlist>
Для страниц без инфобокса выдает плашку с дефолтной картинкой и именем страницы. Можно сделать "фейковый" инфобокс - в страницу добавить разметку шаблона, указать параметры Изображение, Синоним, НатСиноним и заполнить их. В качестве имени шаблона поставить любое слово, которое потом указать в параметре тега.. Можно использовать , который является шаблоном пустой вставки. После всех нужных параметров на новой строке указать |, т.к. внутри экстеншна поиск параметров происходит в участках между символами |. Пример:
{{empty
|Изображение = 1001-photo 2022-11-02 14-03-20 (3).jpg
|Синонимы = Синоним
|НатСинонимы=Натур.Синоним
|
}}
  • toc - Включение режима Алфавитно-цифрового указателя. Вверху генерируется оглавление из первых символов имени каждой найденной страницы, с ссылками на секции. Оглавление оборачивается в скрываемый блок. Список страниц разбивается на подгруппы по заглавным символам, а заглавный символ указывается в качестве имени секции. Параметр без модификатора формирует скрываемый блок в раскрытом состоянии. Чтобы начальное состояние было свернутым, после знака = указать модификатор collapsed.


;TODO: Написать алфавитную фцию - включение генерации TOC по 1м буквам страниц (!! вне зависимости от неймспейса) и разбивку списка по алфавитным подразделам. ;TODO2:Добавить параметр кастомного заголовка. ;TODO3: запушить в git.