version=pmwiki-2.1.11 ordered=1 urlencoded=1
agent=Mozilla/5.0 (Windows; U; Windows NT 5.1; fr; rv:1.8.0.4) Gecko/20060508 Firefox/1.5.0.4
author=
csum=
ctime=1145221251
host=85.1.123.161
name=PmWikiFr.PagelistsExplained
rev=15
targets=Cookbook.SearchResults,Site.PageListTemplates,PmWikiFr.PagelistTemplateSamples,Cookbook.DictIndex,Cookbook.SimpleForum,PmWikiFr.Backlinks,Cookbook.FastBacklinks,Profiles.Pm,Profiles.HansB,Profiles.Tpahl,PmWiki.Directives,Profiles.DirkBlaas,Category.Searching
text=(:title Comment lister les pages:)%0a%25vert%25Traduction à compléter.%0a%0a!! Question%0aComment utiliser la directive [@(:pagelist:)@]?%0a%0a!! Réponse%0aPmWiki possède deux directives destinées à générer des listes de pages -- [@(:pagelist:)@]%0aet [@(:searchresults:)@]. La différence essentielle entre les deux est que 'searchresults': génère les textes "Les résultats de la recherche pour ..." et "### pages trouvées parmi ### " encadrant le résultat -- à part ça, ce sont des directives similaires.%0a%0a!! Syntaxe de base%0a* [@(:pagelist:)@] sans arguments affiche une liste à puce de toutes les pages, avec les liens, ordonnées par ordre alphabétique et par groupes.%0a* [@(:pagelist group=abc fmt=def list=ghi order=jkl argument1 argument2 etc:)@] affiche une liste de page en fonction des paramètres fournis. Les paramètres sont optionnels.%0a%0a!!Paramètres%0aTout argument fourni avec [@(:pagelist:)@] qui n'est pas de la forme  @@'clé=valeur'@@ est traité comme du texte qui doit (ou ne doit pas) figurer dans le texte de la page. Ainsi%0a%0a    [@(:pagelist trail=PmWiki.IndexDocumentation list=normal pomme -caramel:)@]%0a%0aliste toutes les pages "normales" du trail IndexDocumentation qui contiennent le mot "pomme" mais pas le mot "caramel".%0a%0a!!! group= paramètre %0a-%3cLe paramètre @@"'''group='''"@@ limite les résultats aux pages appartenant à un groupe donné.%0a%0a!!! name= paramètre %25green%25[-(nouveauté de pmwiki 2.1.beta21)-]%0a-%3cLe paramètre @@"'''name='''"@@ limite les résultats à certaines pages avec un nom spécifique. Utiliser des caractères spéciaux de remplacement avec des noms partiels.%0a%0a!!! Utiliser des caractères de remplacement dans les noms %25green%25[-(nouveauté de pmwiki 2.1.beta21)-]%0aLes caractères de remplacement peuvent être utilisés avec les paramètres ''group'' et ''name''.\\%0aCe sont le caractère '''*''' représentant n'importe quelle séquence de caractères, le caractère '''?''' représente un caractère unique. Le signe '''-''' ou le point d'exclamation '''!''' sont utilisés pour indiquer une négation.%0a%0aExemples d'utilisation de caratères de remplacement :%0a%0a* Toutes les pages d'un groupe PmWiki:     %0a->[@(:pagelist group=PmWiki :)@]%0a%0a* Toutes les pages sauf celles d'un groupe PmWiki:     %0a->[@(:pagelist group=-PmWiki :)@]%0a%0a* Toutes les pages de n'importe quel groupe commençant par "PmWiki":%0a->[@(:pagelist group=PmWiki* :)@]%0a%0a* Toutes les pages de n'importe quel groupe commençant par "PmWiki", mais pas "PmWikiZh":%0a->[@(:pagelist group=PmWiki*,-PmWikiZh* :)@]%0a%0a* Toutes les pages sauf celles nommées "HomePage":%0a->[@(:pagelist name=-HomePage :)@]%0a%0a* Toutes les pages du groupe PmCal dont le nom commence par "2005":%0a->[@(:pagelist name=PmCal.2005* :)@]%0a%0aLes jokers fonctionnent aussi avec les balises de condition, ce qui nous donne:%0a->[@(:if name PmCal.2005* :)%0a    (:if group PmWiki* :)%0a    (:if name Profiles.*,-Profiles.Profiles :)@]%0a%0a!!! trail= paramètre%0a-%3cLe paramètre @@"'''trail='''"@@ renvoie la liste des pages affichées dans un `WikiTrail.%0a%0a!!! list= paramètre%0a-%3cL'option @@"'''list='''"@@ pertmet à la recherche d'inclure/exclure des pages qui sont définies par l'administrateur dans des ensembles précisés dans le fichier config.php.  PmWiki prédéfini @@"list=normal"@@, qui exclut les choses telles que AllRecentChanges, RecentChanges, GroupHeader, GroupFooter, GroupAttributes, etc., de l'affichage des résultats. Les administrateurs du Wiki peuvent définir leurs propres listes via le tableau  $SearchPatterns (voir en anglais) [[Cookbook.SearchResults]]).%0a%0a!!! fmt= paramètre%0a-%3cLe paramètre @@"'''fmt='''"@@ détermine comment la liste résultante doit être affichée.  %0a%0a!!!! paramètres fmt prédéfinis:%0aPmWiki prédéfinit "fmt=simple", "fmt=bygroup", "fmt=title", et "fmt=group". Sans paramètre fmt= la valeur par défaut est par groupe.%0a* @@fmt=bygroup@@ est la valeur par défaut et produit une liste de pages triée par groupes.%0a* @@fmt=simple@@ donne une liste de noms de pages de la forme Groupe.Nom.%0a* @@fmt=title@@ donne une liste de titres de page. Par défaut [@order=title@] ce qui trie les pages par titre.%0a* @@fmt=group@@ donne une liste de groupes, sans noms de pages.%0a%0a!!!! PageLists Templates%0a%0aDepuis la version 2.1.beta15, PmWiki utilise les templates pour ses formats prédéfinis de pagelist, lesquels sont stocké dans [[Site.PageListTemplates]], et peuvent être édité là.  D'autres formats personnalisés peuvent être ajoutés, à cette page ou à n'importe quel autre, ou défini dans config.php ou un script cookbook. Il y a plusieurs façons d'indiquer quel template pagelist à utiliser:%0a%0a* [@fmt=#custom@] utilise le format personnalisé de [[Site.PageListTemplates]] depuis la section #custom. %0a* [@fmt=MyTemplatePage#custom@] utilise le format personnalisé de la page MyTemplatePage depuis sa section #custom.%0a* [@fmt=custom@] utilise le format personnalisé qui est défini dans un script cookbook de ''custom''.%0a%0aCheck out these custom [[PagelistTemplateSamples]].%0a%0a!!!! Custom formats added by cookbook scripts: %0a* [@fmt=dictindex@] is added by [[Cookbook.DictIndex]]. It gives an pagelist broken into alphabetical sections.  %0a* [@fmt=forum@] is added by [[Cookbook.SimpleForum]]. It gives a 3-column table with page title, modified date and author.%0a%0aCookbook recipes can add more output formatting options by creating new format template sections, or via the $FPLFunctions array as a custom function.  Several that are planned are also @@"fmt=publish"@@ to displays the contents of each page in the list, @@"fmt=include"@@ to include portions of a page's text, "fmt=category" to display pages in a form suitable for category listings, and "fmt=menu" to display the list as an expandable or dropdown menu.%0a%0a!!! link= parameter%0a-%3cThe @@"'''link='''"@@ parameter provides a list of pages that have a link to `SomeGroup.SomePage specified. Some examples for this (see also [[Backlinks]], [[Cookbook/FastBacklinks]]):%0a* To display a list of all pages that have a page link to `PmWiki.DocumentationIndex:%0a->[@(:pagelist link=PmWiki.DocumentationIndex:)@]%0a%0a* To display a list of all pages that link to the current page:%0a->[@(:pagelist link={$FullName} :)@]%0a   %0a* To display a list of all pages in group Main that have a page link to Main.HomePage:%0a->[@(:pagelist group=Main link=Main.HomePage:)@]%0a%0a* To display a list of all pages in the "Skins" category.%0a->[@(:pagelist link=Category.Skins:)@]%0a%0a->%25red%25'' could there be a [@(:pagelist link=Groupname:)@], somehow?''%0a%0a!!! count= parameter%0aThe @@"'''count='''"@@ parameter restricts the pagelist to only the first of a number of pages specified.\\%0aExample: display the "top twenty" biggest cookbook pages:%0a->[@(:pagelist group=Cookbook order=-size count=20 :)@] %0a%0a!!! order= parameter%0a-%3cThe "'''order='''" parameter allows the pagelist to be sorted in different ways than the default alphabetical order. %0a* @@order=name@@ Alphabetical listing (A to Z), this is PmWiki's default.%0a* @@order=-name@@ Reverse alphabetical listing (Z to A).%0a* @@order=title@@ Pagelist sorted alphabetically (A to Z) by titles rather than names.%0a* @@order=-title@@ Reverse alphabetical (Z to A) listing by titles rather than names.%0a* @@order=ctime@@ Pagelist sorted by creation time (most recently created pages last).%0a* @@order=-ctime@@ Pagelist in reverse order by creation time (most recently created pages first).%0a* @@order=time@@ Pagelist sorted by modification time (most recently changed pages last).%0a* @@order=-time@@ Pagelist in reverse order by modification time (most recently changed pages first).%0a* @@order=size@@ Pagelist sorted by page size (not file size), smallest pages first.%0a* @@order=-size@@ Pagelist sorted by page size, biggest pages first.%0a* @@order=random@@ Pagelist sorted randomly%0a%0a->Note: fmt=trail results in an unordered pagelist, i.e. the trail order is preserved in the pagelist. So PmWiki's alphabetical default order does not apply in this case.%0a%0a->Note: ctime is added to pages only from pmwiki 2.1.beta15 onwards, pages created by earlier versions don't carry a ctime attribute and can't be sorted that way. %0a%0a!!!! Examples%0aExample 1: Display all pages of the current group, except this page, by time of modification, most recent first:%0a->[@(:pagelist group={$Group} order=-time list=normal -{$FullName}:)@]%0a%0aExample 2: Displays a list of all pages with links to Pm's profiles page (i.e., pages containing [[~Pm]].  What's more, the pages are listed in reverse order by modification time (most recently changed pages first):%0a->[@(:pagelist link=Profiles.Pm order=-time fmt=simple:)@]%0a%0a->Note that the @@link=@@ and @@order=@@ options are "expensive" in that they require a fair amount of page scanning in order to obtain their results.  On the other hand, @@link=@@ and @@order=@@ are less expensive than doing full text searches, and in future versions of PmWiki they may end up being optimized even further.%0a%0a!! Comments/Questions%0a%0a!!! A through AZ B through BZ C through CZ titles listing%0a%0aI will have a large wiki with lots of play titles. I would like to be able to have separate pagelists containing section A titles, section B titles, section C titles, etc. instead of one large alphabetical listing of titles. Is this possible with pagelist? PL 20060218%0a%0a->You can use wildcards for this:%0a      !!!A section: %0a      [@(:pagelist group=Plays list=normal name=A* :)@]%0a      !!!B section:%0a      [@(:pagelist group=Plays list=normal name=B* :)@]%0a      !!!C section:%0a      [@(:pagelist group=Plays list=normal name=C* :)@]%0a      etc.%0a      !!!X Y Z section%0a      [@(:pagelist group=Plays list=normal name=X*,Y*,Z* :)@] %0a%25right%25~''[[~HansB]]''%0a%0a!!!! Searching for page names only (not content)%0aIn a large wiki, pages are often named systematically, so I sometimes need to get a list of pages with specific name parts (the Linux [@ls *name*@] thing). I couldn't find a way to configure it (list=xxx allows so but only for predefined patterns), so I added the following code to pagelist.php (beta36) near line 111 next to the 'group' option:%0a  if ($opt['named']) array_unshift($pats,"/({$opt['named']})/i");%0aThen with%0a  [@(:pagelist named=ReleaseNotes list=normal:)@]%0aI get (very quick) a list of all pages containing [@"ReleaseNotes"@] in their name. Wouldn't that be worth adding to the mainline code? [[~tpahl]]%0a%0a----%0a!!! Listing all groups except one%0a->[@(:pagelist group= -PmWiki:)@] will list from all groups execpt PmWiki. See [[PmWiki/Directives#pagelist]]%0a----%0a!! Question %0a[@(:pagelist group=Recipes list=normal apple pie:)@]%0alists all pages with apple AND pie in them,%0ahow do I get a list of all pages with apple OR pie?%0a!!! Answer%0aI would suggest use two pagelist directives:\\%0a[@(:pagelist group=Recipes list=normal apple :)@]\\%0a[@(:pagelist group=Recipes list=normal pie:)@]\\%0a[[~DirkBlaas]]%0a[[%3c%3c]]%0a%25blue%25This unfortunately list all pages that have both apple and pie on them twice.%25%25%0a%0a[@(:pagelist group=Recipes list=normal -apple -pie:)@]%0alists all pages without apple OR pie,%0ahow do I get a list of all pages without apple AND pie in them?%0a----%0a!! How to exclude more than one group%0aThis is possible from pmwiki 2.1.beta21 onwards using this syntax:%0a   [@(:pagelist group=-xxx,-yyy,-zzz :)@]%0a(HansB gave me this hint - Thanks!)%0a%0aDoes this apply to the name parameter too, eg%0a [@(:pagelist group=TrampingReports order=-name list=normal name=-2005*,-HomePage,-Template:)@]%0a%0a!! Voir aussi%0a* [[PmWiki.Directives#attachlist]]%0a%0a!! Contributeurs%0a* Radu%0a* joachim Durchholz%0a* [[~HansB]]%0a----%0aCategory: [[!Searching]]%0a%25tr%25 Traduction de Cookbook:PageListsExplained
time=1152777499
title=Comment lister les pages