book51.ru

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

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

  • Показать страницу
  • История страницы
  • Ссылки сюда
  • Оставить на чай
  • Экспорт в PDF
  • Наверх
    • Вы посетили:
    wiki:plugin:pagelist

    Различия

    Показаны различия между двумя версиями страницы.

    Ссылка на это сравнение

    Предыдущая версия справа и слеваПредыдущая версия
    wiki:plugin:pagelist [2024/08/26 08:40] – vladpolskiywiki:plugin:pagelist [Дата неизвестна] (текущий) – внешнее изменение (Дата неизвестна) 127.0.0.1
    Строка 1: Строка 1:
    -======Blog для «ДокуВики»====== +======PageList для «ДокуВики»====== 
    -{{:wiki:plugin:dwplugin.png?70 |}} Плагин блога делает блоги в вашей вики легко возможными. Компонент блога показывает последние записи (страницы) из пространства имен в обратном хронологическом порядке. В этой новой версии дата создания является ключом сортировки — больше не дата последней не незначительной модификации, как в предыдущих версиях. Компонент архива перечисляет все записи, которые были написаны (созданы) в указанном месяце.+{{:wiki:plugin:dwplugin.png?70 |}} Перечисляет страницы в красивой таблице или неупорядоченном списке. Плагин Pagelist берет список вики-страниц и предоставляет красиво отформатированную таблицу с информацией о них. Плагин имеет ряд флагов, которые можно использовать для управления информацией и форматом списка страниц. Пользователь может предоставить список ссылок на конкретные страницы, а также некоторые популярные вспомогательные плагины, такие как плагины «Блог », «Обсуждение» , «Редактор », «Тег» , «Задача» и «Директор» .
      
    -  * **Релиз:** 2024-02-06.  +  * **Релиз:** 2023-07-12.  
    -  * **Репозиторий:** https://github.com/dokufreaks/plugin-blog+  * **Репозиторий:**https://github.com/dokufreaks/plugin-pagelist
       * **Совместимость с «Докувики»:** 04.04.2023 "Джек Джекрам"    * **Совместимость с «Докувики»:** 04.04.2023 "Джек Джекрам" 
      
    Строка 10: Строка 10:
     Сообщайте об ошибках или просьбах о новых функциях в [[https://github.com/dokufreaks/plugin-pagelist/issues|системе отслеживания ошибок]] Сообщайте об ошибках или просьбах о новых функциях в [[https://github.com/dokufreaks/plugin-pagelist/issues|системе отслеживания ошибок]]
      
     +**Примечание по обновлению** : в августе 2023 года стиль CSS немного изменился. Конкретные стили для каждой ячейки заменяются более общими стилями. Также все стили, кроме **simplelist**, получили дополнительный класс **plgn__pglist**, позволяющий лучше настроить этот плагин с помощью вашего собственного стиля.
      
     =====Монтаж===== =====Монтаж=====
    Строка 18: Строка 18:
       - распаковать его в<dokuwiki>/lib/plugins/   - распаковать его в<dokuwiki>/lib/plugins/
       - войдите как администратор и измените плагин в менеджере конфигурации   - войдите как администратор и измените плагин в менеджере конфигурации
    -===== Installation ===== +=====Применение=====
    - +
    -^  Download   | [[https://github.com/dokufreaks/plugin-blog/tarball/master|plugin-blog.tgz]]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | +
    -^  BundleHub  | Configure your own DokuWiki blogsuite install package, consisting of all mandatory plugins plus any optional features you want to include: \\ [[http://dokuwiki.foosel.org/blogsuite/index.php|BlogSuite BundleHub]] :!: ** The Bundle Hub is currently out of date and not updated any more, please install the plugins individually** :!: \\ FIXME Site seems to be down for sime time, [[http://web.archive.org/web/20120110121631/http://dokuwiki.foosel.org/blogsuite/index.php|here is the archived version]] if you want to see possible optional plugins & features.  | +
    -^  Tips       | If you intend to use this plugin be sure to take a look at the [[tips:blogging|blogging tips page]]                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | +
    - +
    -===== Syntax ===== +
    - +
    -=== Blog === +
    - +
    -  {{blog>[namespace]?[number]&[flags]}} +
    - +
    -^ [namespace] | namespace for the blog; subspaces will be searched as well; ''*'' is the whole wiki, ''.'' is the same namespace as the page lies in  | optional; default is the blog namespace set in the configuration | +
    -^ [number] | number of entries to show per page | optional; default is 5 | +
    -^ [flags] | flags are delimited by ''&'' | | +
    -^     ::: | all [[include#configuration_and_flags|Include plugin flags]] are supported | optional | +
    -^     ::: | Form placement: ''topform''/''bottomform''/''noform'' | optional, default is ''topform'' | +
    -^     ::: | Custom new-entry form title: ''newentrytitle=Custom title'' | optional, can also be set as a [[#configuration_and_settings|configuration option]] | +
    -^     ::: | Hide paging controls: ''nopagingcontrols'' | optional | +
    - +
    -This includes a specified number of most recent blog entries from the given namespace into the current page. Below the entries a link to the page (permalink), the author, the creation date and the number of comments are shown. Link, author, date and comments info can be hidden. At the end of the blog a link to older entries lets you navigate in the history of the blog. At the very end, if you have enough rights to create new pages, a form for new blog entries is displayed. +
    - +
    -Note that when the page with the blog syntax is in the specified namespace, content my be shown twice. At some point, the loop will be detected and stopped. You should therefore make sure that either the page with the listing is in a different namespace or use the ''excluded_pages''-option to explicitly exclude the blog page from the blog listing. +
    - +
    - +
    -=== Archive === +
    - +
    -  {{archive>[namespace]?[month]&[flags]&author=[username]}} +
    - +
    -^ [namespace] | the namespace for which you want an archive list; ''*'' is the whole wiki, ''.'' is the same namespace as the page lies in | optional; default is the namespace specified in the configuration | +
    -^ [month] | the month for the archive list in YYYY-MM format; ''*'' for all pages | required | +
    -^ [flags] | pagelist flags delimited by ''&'', see [[pagelist#flags]] | optional | +
    -^ [username] | username of an author | optional | +
    - +
    - +
    -Shows a table with all pages of the given namespace that were created in the specified month. +
    - +
    -  {{autoarchive>[namespace]}} +
    - +
    -Creates an automatic archive. +
    - +
    -===== Configuration and Settings ===== +
    - +
    -The blog plugin can be configured using the DokuWiki configuration manager available in the admin menu. +
    - +
    -^ ''namespace''         | The default namespace which is used if no namespace was given in the syntax                                                                                                                                   | +
    -^ ''formposition''      | You can choose to display the new entry form either above or below the blog entries                                                                                                                           | +
    -^ ''newentrytitle''     | Set a custom title for all new entry forms.  This can also be set on individual blog forms.                                                                                                                   | +
    -^ ''dateprefix''        | A date prefix that automatically gets added to pages created with the new entry form. You can use the options from the [[phpnet>strftime]] PHP function; namespace separators work as well, e.g. ''%Y:%m%d''  | +
    -^ ''sortkey''           | Defines how the blog entries are sorted. Available options are creation date, modification date, page name, page ID and page title (first headline)                                                           | +
    -^ ''sortorder''         | Sort the blog entries ascending/descending                                                                                                                                                                    | +
    -^ ''excluded_pages''    | Exclude certain pages from the blog listing. Requires a regular expression. Use for example ''%%!(^|:)start$!%%'' in order to exclude start pages from all blog listings.  \\ To exclude both start and rightsidebar directly below :blog use \\ ''!(^|:)blog:(start|rightsidebar)$!''    | +
    -^ ''showhistogram''     | Display a histogram in normal archive mode (not for autoarchive)                                                                                                                                              | +
    -^ ''max_months''        | Maximum number of months to show in the histogram                                                                                                                                                             | +
    -^ ''histogram_height''  | Height of the histogram (in pixels)                                                                                                                                                                           | +
    - +
    -===== Changes ===== +
    - +
    -  * **2013-10-20**: Translation updates, fix cache handling for empty blog listings +
    -  * **2013-03-27**: Better cache handling for the archive syntax +
    -    * the syntax that lists everything till now correctly updates the cache now whenever a page is changed or a comment or linkback is added. +
    -    * the cache is not used anymore when it contains an archive listing with a page that the current user can't access. The excluded pages won't be included again automatically unless the cache expires for other reasons, the ''%%~~NOCACHE~~%%'' macro can be used if this is needed. +
    - +
    - +
    -===== Development ===== +
    - +
    -=== Change Log === +
    - +
    -{{rss>https://github.com/dokufreaks/plugin-blog/commits/master.atom date}} +
    - +
    -=== Bugs / Feature Requests === +
    - +
    -Please report bugs or feature requests at the [[https://github.com/dokufreaks/plugin-blog/issues|Bug tracker]]. +
    - +
    - +
    -===== FAQ ===== +
    - +
    -Please also have a look at the [[tips:blogging]] tips page! +
    - +
    -=== My dates are shown wrong. What can I do? === +
    - +
    -Make sure you run the latest version of all required plugins and DokuWiki. +
    - +
    -=== Is it possible to change the way the date is displayed? === +
    - +
    -Yes, the plugin uses the [[config:dformat]] option to format the date. +
    - +
    -=== How can I alter the date of a blog post? === +
    - +
    -You can use the [[plugin:meta]] plugin to manually set the creation date (and modification date) in the page source, then select the modification date in the blog plugins order setting. An alternative solution would be to alter the timestamps of the created files. +
    - +
    -=== Is it possible to show table of contents? === +
    - +
    -The table of contents is shown automatically (depending on the settings in DokuWiki itself) from version 2013-02-07 on. +
    - +
    -=== The header is always a link to the page even though it's disabled in the include plugin settings ===+
      
    -The blog plugin assumes that in the context of a blog the header should be a link. However from version 2013-02-26 on it is possible to disable this behavior by using the ''nolink''-flag, the blog plugin now only sets a default without overriding the ''nolink'' flag.+Просто оберните тегом обычный неупорядоченный список внутренних ссылок %%<pagelist>%%. Вы можете предоставить конкретные внутренние ссылки на страницы или попросить плагины предоставить их, как показано в примере ниже:
      
    -=== Is it possible to show just the first lines of each post with a 'Read more' link to view the full post? ===+<code> 
     +<pagelist&[флаги]>  
     +  * [[..:blog:|Плагин блога]]  
     +  * [[..:discussion:|Плагин обсуждения]]  
     +  * [[..:editor:|Плагин редактора]]  
     +  * [[.. :tag:|Плагин тега]]  
     +  * [[..:wrap|Плагин переноса|Это показано в ячейке описания]]  
     +</pagelist> 
     +</code>
      
    -I think I solved myself. +|[флаги]|флаги можно использовать для изменения внешнего вида списка страниц, флаги|необязательный|
    -In the blog mark, use the following flags+
      
    -  {{blog>?5&firstseconly&readmore}}+=====Флаги=====
      
    -This will work if you add an H2 header (in the full post) where you want to make appear the 'Read more' link. +{{tablelayout?rowsHeaderSource=Auto&colwidth=""}} 
    -If you don't need or want an H2 header in your post, you can add a empty H2 header, just as a delimiter for the text you want to show in the Blog's headlines+^ Флаг по умолчанию                                                                     |^ Альтернативный флаг                                                                                                                                                            |^ Настройка в диспетчере конфигураций  ^ 
     +| 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                            |
      
      
    -=== the excluded_pages does not work ===+<code> 
     +<pagelist&default&nodate&nouser&sort> 
     +  * [[wiki:plugin:backuptool:|]] 
     +  * [[wiki:plugin:autotooltip:|]] 
     +  * [[wiki:plugin:codeprettify:|]] 
     +  * [[wiki:plugin:citations:|]] 
     +  * [[wiki:plugin:cookiebanner|]] 
     +</pagelist> 
     +</code> 
     +<pagelist&default&nodate&nouser&sort> 
     +  * [[wiki:plugin:backuptool:|]] 
     +  * [[wiki:plugin:autotooltip:|]] 
     +  * [[wiki:plugin:codeprettify:|]] 
     +  * [[wiki:plugin:citations:|]] 
     +  * [[wiki:plugin:cookiebanner|]] 
     +</pagelist>
      
    -In the blog mark ,use the following flags +В приведенном выше примере список страниц будет отображать информацию о предоставленных страницах в таблице со строкой заголовка и столбцом комментариев (если установлен плагин обсуждений ). Пользователь (или плагин) должен указать конкретные страницы для отображения в списке. 
    -  {{blog>*?5&!(^|:)index$!}} +===== Конфигурация и настройки =====
    -  or +
    -  {{blog>*?5&excluded_pages=!(^|:)index$!}}+
      
    -all above flags does not work, the index pages in sub namespace is still included .+Плагин можно настроить с помощью менеджера конфигурации DokuWiki, доступного в меню администратора. Эти настройки также применяются к плагинам, которые используют вспомогательный компонент плагина списка страниц, например, архивный компонент плагина блога .
      
    -> This is global configuration, you should configure it in ''Configuration Manager''. --- //Siyuan Liu 2023-08-17//+|style|Стиль списка (по умолчанию, таблица, таблица/список, простой список)| 
     +|showheader|Показать заголовок таблицы| 
     +|showdate|Показывает/скрывает столбец даты (скрыть, дата создания, дата изменения)| 
     +|showuser|Показывает/скрывает столбец пользователя (скрыть, создатель, участники)| 
     +|showdesc|Показывает/скрывает краткое описание, взятое из первого абзаца страницы (скрыть, максимум 160 символов, максимум 500 символов)| 
     +|showcomments|Показывает/скрывает комментарии страницы (требуется плагин  [[https://www.dokuwiki.org/plugin:discussion|обсуждения]] )| 
     +|showlinkbacks|Показывает/скрывает обратные ссылки на странице (требуется плагин обратных ссылок )| 
     +|showtags|Показывает/скрывает теги страницы (требуется плагин тегов )| 
     +|sort|Сортирует страницы в алфавитном порядке по имени страницы.| 
     +|showdiff|Отображает столбец различий со значком различий, ссылающимся на соответствующую страницу различий для каждой строки.| 
     +|showimage|Показывает/скрывает столбец изображения (требуется плагин [[https://www.dokuwiki.org/plugin:pageimage|Pageimage]] ).|
      
     +=====Вспомогательный плагин=====
     +Вы можете легко использовать функциональность плагина Pagelist в своих собственных плагинах. Вот базовый фрагмент кода:
      
    -===== Discussion =====+<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>
      
    -Please report bugs or feature requests at the [[https://github.com/dokufreaks/plugin-blog/issues|Bug tracker]].+С момента выпуска 2017-08-24 функция startList() имеет дополнительный параметр для указания класса CSS для добавления его в класс элемента таблицы:
      
    -Is it possible to make a blog in one namespace be in ascending order, and a blog in a different namespace to be in descending order?+<code php> 
     +$pagelist->startList('myclass'); 
     +</code> 
     +Подробнее см. в разделе [[wiki:plugin:pagelist_development|«Как использовать Pagelist в вашем плагине»]] .
     =====Обновление===== =====Обновление=====
     Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше. Для обновления удалите исходную папку lib/plugins/displaywikipage и установите новую версию, как указано выше.
     =====Файл для загрузки===== =====Файл для загрузки=====
    -{{ :wiki:plugin:plugin-blog-master.zip |}}+{{ :wiki:plugin:plugin-pagelist-master.zip |}}
     =====Лицензия===== =====Лицензия=====
    -  * **Author:** [[freaks@dokuwiki.org|Dokufreaks (previous authors: Michael Hamann, Gina Häußge, Michael Klier, Esther Brunner)]]+  * **Author:** [[freaks@dokuwiki.org|Dokufreaks (previous authors: Matthias Schulte, Michael Hamann, Esther Brunner, Gina Häußge, Michael Klier)]]
       * **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]]   * **License:** [[http://www.opensource.org/licenses/gpl-license.php|GNU GPL v2]]
      
    -Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на [[https://www.dokuwiki.org/plugin:blog|эту страницу]] с вашего сайта, если вам нравится этот продукт.+Это не обязательно, но, пожалуйста, рассмотрите возможность ссылки на [[https://www.dokuwiki.org/plugin:pagelist#pagelist_plugin|эту страницу]] с вашего сайта, если вам нравится этот продукт.
      
      
    wiki/plugin/pagelist.1724650804.txt.gz · Последнее изменение: 2024/08/26 08:40 — vladpolskiy