omit forum and javascript from list

[ikiwiki.git] / doc / plugins / orphans.mdwn

diff --git a/doc/plugins/orphans.mdwn b/doc/plugins/orphans.mdwn
index 1eab368f9221ff232a526e4a17a2e3cbea078ef0..8c0d0b933e1a290cc75e29cae7414065a93e32f8 100644 (file)
--- a/doc/plugins/orphans.mdwn
+++ b/doc/plugins/orphans.mdwn
@@ -1,16 +1,15 @@
-[[template id=plugin name=orphans included=1 author="""[[Joey]]"""]]
-[[tag type/meta]]
+[[!template id=plugin name=orphans author="[[Joey]]"]]
+[[!tag type/meta]]
 
-This plugin generates a list of possibly orphaned pages -- pages that no
-other page links to.
+This plugin provides the [[ikiwiki/directive/orphans]]
+[[ikiwiki/directive]], which generates a list of possibly orphaned pages --
+pages that no other page links to.
 
-The optional parameter "pages" can be a [[PageSpec]] specifying the pages
-to check for orphans, default is search them all.
+[[!if test="enabled(orphans)" then="""
+Here's a list of orphaned pages on this wiki:
 
-Note that it takes [[BackLinks]] into account, but does not count inlining a
-page as linking to it, so will generally count many blog-type pages as
-orphans.
-
-If it is enabled, here's a list of orphaned pages on this wiki:
-
-[[orphans ]]
+[[!orphans pages="* and !news/* and !todo/* and !bugs/* and !users/* and
+!recentchanges and !examples/* and !tips/* and !sandbox/* and !templates/* and
+!forum/* and !*.js
+!wikiicons/* and !plugins/*"]]
+"""]]