Инструменты пользователя

Инструменты сайта


wiki:plugin:pagelist

Это старая версия документа!


PageList для «ДокуВики»

Совместим с «Докувики»

  • 2024-02-06 "Kaos" неизвестно
  • 2023-04-04 "Jack Jackrum" да
  • 2022-07-31 "Igor" да
  • 2020-07-29 "Hogfather" да

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

Последнее обновление:
2023-08-27
Предоставляет
Syntax, Helper
Репозиторий
исходный код

Теги: formatting, list, page, tables

Нужен для blog, discussion, tag

Update note: In August 2023 the css styling is changed a bit. The specific styles for each cell are replaced by more general styles. Also all styles, except simplelist, got an additional class plgnpglist'' to target better this plugin with your own styling. =====Совместимость===== Сообщайте об ошибках или просьбах о новых функциях в системе отслеживания ошибок Примечание по обновлению : в августе 2023 года стиль CSS немного изменился. Конкретные стили для каждой ячейки заменяются более общими стилями. Также все стили, кроме simplelist, получили дополнительный класс plgn__pglist, позволяющий лучше настроить этот плагин с помощью вашего собственного стиля. =====Монтаж===== Используйте менеджер плагинов для установки или… - скачать zip-файл - распаковать его в<dokuwiki>/lib/plugins/ - войдите как администратор и измените плагин в менеджере конфигурации =====Применение===== Просто оберните тегом обычный неупорядоченный список внутренних ссылок <pagelist>. Вы можете предоставить конкретные внутренние ссылки на страницы или попросить плагины предоставить их, как показано в примере ниже: <code>

</code> |[флаги]|флаги можно использовать для изменения внешнего вида списка страниц, флаги|необязательный| =====Флаги===== tablelayout ^ Флаг по умолчанию |^ Альтернативный флаг |^ Настройка в диспетчере конфигураций ^ | default | таблица с горизонтальными линиями | table, list или simplelist | стандартный стиль таблицы или списка «ДокуВики» | style | | firsthl | покажи первый заголовок | nofirsthl | покажи название страницы | showfirsthl | | date | показать дату создания или последней модификации | nodate | скрыть дату | showdate | | user | создатель шоу или участники nouser скрыть пользователя | showuser | | | | noheader | скрыть строку заголовка таблицы списка страниц | header | покажи заголовок | showheader | | nodesc | скрыть описание | desc | показать описание (из метаданных) | showdesc | | nocomments | скрыть количество комментариев | comments | показать количество комментариев (если установлен дискуссионный плагин ) | showcomments | | notags | скрыть теги tags показывать теги (если установлен плагин тегов ) | showtags | | | | nosort | нет сортировки страниц | rsort/sort | сортирует страницы (в обратном порядке) в алфавитном порядке по имени страницы | rsort/sort | | nodiff | нет отображения столбца различий | showdiff | отображает столбец различий со значком различий, ссылающимся на соответствующую страницу различий для каждой строки | showdiff | | noimage | показать изображение страницы | image | требуется установленный плагин Pageimage . Может быть определено на странице или будет использовано изображение с тем же именем, что и страница. | showimage | <code>

</code>

В приведенном выше примере список страниц будет отображать информацию о предоставленных страницах в таблице со строкой заголовка и столбцом комментариев (если установлен плагин обсуждений ). Пользователь (или плагин) должен указать конкретные страницы для отображения в списке. ===== Конфигурация и настройки ===== Плагин можно настроить с помощью менеджера конфигурации DokuWiki, доступного в меню администратора. Эти настройки также применяются к плагинам, которые используют вспомогательный компонент плагина списка страниц, например, архивный компонент плагина блога . |style|Стиль списка (по умолчанию, таблица, таблица/список, простой список)| |showheader|Показать заголовок таблицы| |showdate|Показывает/скрывает столбец даты (скрыть, дата создания, дата изменения)| |showuser|Показывает/скрывает столбец пользователя (скрыть, создатель, участники)| |showdesc|Показывает/скрывает краткое описание, взятое из первого абзаца страницы (скрыть, максимум 160 символов, максимум 500 символов)| |showcomments|Показывает/скрывает комментарии страницы (требуется плагин обсуждения )| |showlinkbacks|Показывает/скрывает обратные ссылки на странице (требуется плагин обратных ссылок )| |showtags|Показывает/скрывает теги страницы (требуется плагин тегов )| |sort|Сортирует страницы в алфавитном порядке по имени страницы.| |showdiff|Отображает столбец различий со значком различий, ссылающимся на соответствующую страницу различий для каждой строки.| |showimage|Показывает/скрывает столбец изображения (требуется плагин Pageimage ).| =====Вспомогательный плагин===== Вы можете легко использовать функциональность плагина Pagelist в своих собственных плагинах. Вот базовый фрагмент кода: <code php> $pages = [ ['id' ⇒ 'wiki:dokuwiki'], ['id' ⇒ 'wiki:syntax'], ]; $pagelist = $this→loadHelper('pagelist'); if (!$pagelist) return false; failed to load plugin $pagelist→startList(); foreach ($pages as $page){ $pagelist→addPage($page); } $renderer→doc .= $pagelist→finishList(); </code> С момента выпуска 2017-08-24 функция startList() имеет дополнительный параметр для указания класса CSS для добавления его в класс элемента таблицы: <code php> $pagelist→startList('myclass'); </code> Подробнее см. в разделе «Как использовать Pagelist в вашем плагине» . =====Обновление===== Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше. =====Файл для загрузки===== plugin-pagelist-master.zip =====Лицензия===== * Author: Dokufreaks (previous authors: Matthias Schulte, Michael Hamann, Esther Brunner, Gina Häußge, Michael Klier) * License: GNU GPL v2 Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на эту страницу с вашего сайта, если вам нравится этот продукт.

Только авторизованные участники могут оставлять комментарии.
wiki/plugin/pagelist.1768737855.txt.gz · Последнее изменение: VladPolskiy

Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: Public Domain
Public Domain Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki