PmWikiRu /
ПожалуйÑта ÑкÑпериментируйте в пеÑочнице!СпиÑки Ñтраниц

авторам, админиÑтраторам (Ñредний) PmWiki поÑтавлÑетÑÑ Ñ Ð´Ð²ÑƒÐ¼Ñ Ð²Ñтроеными директивами Ð´Ð»Ñ Ð¿Ð¾ÑÑ‚Ñ€Ð¾ÐµÐ½Ð¸Ñ ÑпиÑков Ñтраниц -- (:pagelist:) и (:searchresults:). ОÑÐ½Ð¾Ð²Ð½Ð°Ñ Ñ€Ð°Ð·Ð½Ð¸Ñ†Ð° между ними ÑоÑтоит в том, что searchresults допиÑывает ÑÐ¾Ð¾Ð±Ñ‰ÐµÐ½Ð¸Ñ "Результаты поиÑка Ð´Ð»Ñ ..." в начало и "Ðайдено â„–â„–â„– Ñтраниц Ñреди â„–â„–â„– Ñтраниц" в конец результатов -- а во вÑём оÑтальном они по Ñути одинаковы.

ОÑновной ÑинтакÑиÑ

  • (:pagelist:) без аргументов показывает маркированый ÑпиÑок ÑÑылок на вÑе Ñтраницы отÑортированых в группы по алфавиту.
  • (:pagelist group=abc fmt=def list=ghi order=jkl argument1 argument2 etc:) показывает ÑпиÑок Ñтраниц ÑоглаÑно поддерживаемым параметрам. Параметры могут отÑутÑтвовать.

Параметры

Любой аргумент в (:pagelist:) не ÑвлÑющийÑÑ Ñ€Ð°Ð²ÐµÐ½Ñтвом ('key=value') воÑпринимаетÑÑ ÐºÐ°Ðº текÑÑ‚, который должен(или нет) приÑутÑтвовать в текÑте Ñтраниц попадущих в ÑпиÑок. Таким образом: 

    (:pagelist trail=PmWiki.DocumentationIndex list=normal Ñблочный -пирог:)

перечиÑлÑет вÑе "normal"(обычные) Ñтраницы цепочки DocumentationIndex и Ñодержащие Ñлово "Ñблочный", но не "пирог".

group= и name=

Параметры "group=" и "name=" ограничивают результаты Ñтраницами из указаной группы(group) или Ñ ÑƒÐºÐ°Ð·Ð°Ð½Ñ‹Ð¼ именем(name): 

    # Ð’Ñе Ñтраницы из группы Pmwiki:
    (:pagelist group=PmWiki :)
    # Ð’Ñе Ñтраницы не из групп PmWiki и Site:
    (:pagelist group=-PmWiki,-Site :)
    # Ð’Ñе Ñтраницы RecentChanges
    (:pagelist name=RecentChanges :)
    # Ð’Ñе Ñтраницы кроме RecentChanges
    (:pagelist name=-RecentChanges :)

ОбобщениÑ

Параметры name и group могут Ñодержать Ñимволы Ð¾Ð±Ð¾Ð±Ñ‰ÐµÐ½Ð¸Ñ ÐºÐ¾Ñ‚Ð¾Ñ€Ñ‹Ðµ отображают только Ñтраницы Ñовпадающие Ñ ÑƒÐºÐ°Ð·Ð°Ð½Ð½Ñ‹Ð¼ образцом:

  • Звёзда (*) предÑтавлÑет ноль или более любых Ñимволов;
  • Знак вопроÑа предÑтавлÑет только один любой Ñимвол.

Примеры: 

    # Ð’Ñе Ñтраницы из групп Ñ Ð¸Ð¼ÐµÐ½ÐµÐ¼ начинающимÑÑ Ñ "PmWiki"
    (:pagelist group=PmWiki* :)
    # Ð’Ñе Ñтраницы из групп Ñ Ð¸Ð¼ÐµÐ½ÐµÐ¼ начинающимÑÑ Ñ "PmWiki", кроме КитайÑкой(Zh)
    (:pagelist group=PmWiki*,-PmWikiZh* :)
    # Ð’Ñе Ñтраницы из группы PmCal Ñ Ð¸Ð¼ÐµÐ½Ð°Ð¼Ð¸ начинающимиÑÑ Ñ "2005":
    (:pagelist name=PmCal.2005* :)

trail=

ÐžÐ¿Ñ†Ð¸Ñ "trail=" берёт ÑпиÑок Ñтраниц Ð´Ð»Ñ Ð¿Ð¾ÐºÐ°Ð·Ð° из цепочки Ñтраниц: 

    # Показать вÑе Ñтраницы документации отÑортированые по времени редакции
    (:pagelist trail=PmWiki.DocumentationIndex order=-time:)
    # Показать пÑÑ‚ÑŒ недавно изменённых Ñтраниц
    (:pagelist trail=RecentChanges count=5:)

list=

Этой опцией указываетÑÑ Ð¸Ð¼Ñ Ñ„Ð¸Ð»ÑŒÑ‚Ñ€Ð° Ð´Ð»Ñ Ñ„Ð¾Ñ€Ð¼Ð¸Ñ€ÑƒÐµÐ¼Ð¾Ð³Ð¾ ÑпиÑка. Изначально у PmWiki определён только один фильтр - "list=normal", который иÑключает из результата Ñлужебные Ñтраницы AllRecentChanges, RecentChangesб GroupHeader, GroupFooter... и Ñ‚.п. Вики админиÑтратор может добавить в маÑÑив $SearchPatterns Ñвои ÑобÑтвенные фильтры. (Ñмотри Cookbook:SearchResults).

fmt=

Параметр "fmt=" указывает формат вывода ÑпиÑка. Ð’ PmWiki вÑтроено неÑколько форматов:

  • fmt=#bygroup - Показать Ñтраницы по группам в алфавитном порÑдке
  • fmt=#simple - Показать проÑтой упорÑдоченый ÑпиÑок Ñтраниц
  • fmt=#title - Показать ÑпиÑок заголовков Ñтраниц. ИÑпользуйте "order=title" Ð´Ð»Ñ Ñортировки по заголовкам (по умолчанию Ñортировка идёт по именам Ñтраниц).
  • fmt=#group - Показать ÑпиÑок групп
  • fmt=#include - Показать в ÑпиÑке Ñодержимое каждой Ñтраницы. (Ð´Ð»Ñ Ñправки, процеÑÑ Ñ„Ð¾Ñ€Ð¼Ð¸Ñ€Ð¾Ð²Ð°Ð½Ð¸Ñ Ñтраницы Ð´Ð»Ñ Ð±Ð¾Ð»ÑŒÑˆÐ¾Ð³Ð¾ ÑпиÑка может занÑÑ‚ÑŒ много времени!)

Индивидуальные форматы ÑпиÑков Ñтраниц могут быть определены иÑÐ¿Ð¾Ð»ÑŒÐ·ÑƒÑ ÑˆÐ°Ð±Ð»Ð¾Ð½Ñ‹ форматов ÑпиÑков PmWiki определены на Ñтранице Site.PageListTemplates.) ЕÑÑ‚ÑŒ неÑколько ÑпоÑобов указать какой шаблон иÑпользуетÑÑ:

  • fmt=#custom иÑпользует раздел #custom из Site.PageListTemplates (раздел подпиÑан Ñкорем [[#custom]].
  • fmt=MyTemplatePage#custom иÑпользует формат Ñо Ñтраницы MyTemplatePage из Ñекции #custom.
  • fmt=custom иÑпользует формат, который определён в cookbook Ñценарии как custom.

Cookbook:PagelistTemplateSamples Ñодержит много примеров индивидуальных форматов ÑпиÑков. Ð’ дополнение, в Cookbook:Cookbook еÑÑ‚ÑŒ и другие рецепты оÑобых значений fmt=, Ð²ÐºÐ»ÑŽÑ‡Ð°Ñ fmt=dictindex (алфавитный индекÑ) и fmt=forum (темы форума).

link=

СпиÑки Ñтраниц ÑÑылающихÑÑ Ð½Ð° указаную получаютÑÑ, еÑли воÑпользоватьÑÑ Ð¿Ð°Ñ€Ð°Ð¼ÐµÑ‚Ñ€Ð¾Ð¼ "link=", который оÑобенно удобен Ð´Ð»Ñ Ñтраниц категорий и поиÑка ÑвÑзанных Ñтраниц. 

    # вÑе Ñтраницы Ñо ÑÑылкой на PmWiki.DocumentationIndex
    (:pagelist link=PmWiki.DocumentationIndex:)
    # вÑе Ñтраницы Ñо ÑÑылкой на текущую Ñтраницу
    (:pagelist link={$FullName}:)
    # вÑе Ñтраницы категории "Skins"
    (:pagelist link=Category.Skins:)

count=

Длина ÑпиÑка ограничиваетÑÑ Ð¿Ð°Ñ€Ð°Ð¼ÐµÑ‚Ñ€Ð¾Ð¼ "count=". 

    # ПроÑтой маркированый ÑпиÑок деÑÑти Ñвежайших Ñтраниц
    (:pagelist trail=Site.AllRecentChanges count=10 fmt=#simple:)

order=

Ð”Ð»Ñ Ð¸Ð·Ð¼ÐµÐ½ÐµÐ½Ð¸Ñ Ð¿Ð¾Ñ€Ñдка Ñортировки ÑпиÑка пользуютÑÑ Ð¿Ð°Ñ€Ð°Ð¼ÐµÑ‚Ñ€Ð¾Ð¼ "order=". Отрицательное значение параметра указывает на обратный порÑдок Ñортировки. МножеÑтво критериев Ñортировки указываютÑÑ Ñ‡ÐµÑ€ÐµÐ· запÑтую:

  • order=name - Ð°Ð»Ñ„Ð°Ð²Ð¸Ñ‚Ð½Ð°Ñ Ñортировка по имени
  • order=-name - Ð¾Ð±Ñ€Ð°Ñ‚Ð½Ð°Ñ Ð°Ð»Ñ„Ð°Ð²Ð¸Ñ‚Ð½Ð°Ñ Ñортировка
  • order=title - Ñортировка по заголовкам
  • order=-time - более Ñвежие Ñтраницы будут ближе к началу ÑпиÑка
  • order=ctime - по времени ÑÐ¾Ð·Ð´Ð°Ð½Ð¸Ñ Ñтраниц
  • order=size - Ñортировка по размеру Ñтраниц
  • order=group,title - Ñортировка по группам, а затем по заголовкам
  • order=random - перемешать Ñтраницы в произвольную поÑледовательноÑÑ‚ÑŒ

Примеры

Ð’Ñтавить Ñодержимое произвольной Ñтраницы из группы Banners(Баннеры): 

    (:pagelist group=Banners order=random count=1 fmt=#include list=normal:)

Показать проÑтой ÑпиÑок деÑÑти Ñвежайших Ñтраниц: 

    (:pagelist trail=Site.AllRecentChanges count=10 fmt=#simple:)

Также Ñмотри

<< УÑÐ»Ð¾Ð²Ð½Ð°Ñ Ñ€Ð°Ð·Ð¼ÐµÑ‚ÐºÐ° | Ð”Ð¾ÐºÑƒÐ¼ÐµÐ½Ñ‚Ð°Ñ†Ð¸Ñ | Переменные Ñтраницы >>

Перевод Ñтраницы PmWiki.PageLists - Оригинал перевода PmWikiRu.PageLists - Backlinks
PmWikiRu.PageLists: Ñ€ÐµÐ´Ð°ÐºÑ†Ð¸Ñ Ð¾Ñ‚ 21.03.2006 22:48 Uhr
PmWiki.PageLists: Ñ€µÐ´Ð°ÐºÑ†Ð¸Ñ от 03.03.2023 22:04 Uhr

anzeigen · editieren · Datei hochladen · drucken · Anderungen
Seite zuletzt geändert am 21.03.2006 22:48 Uhr