~~NOCACHE~~ 
====== Orphans Plugin ======

I'm not sure why this is a plugin (extension) and not a standard feature of dokuwiki; it seems like something every wiki should have, given the ease of adding new pages. Anyway, it is, and I finally got around to installing it. The good news is that there are relatively few orphans, and I've clustered some of them into [[twigs|]] now.

==== Critique ====

The plugin seems to work pretty well on normal pages. However, it fails on pages **included** in other pages --rather than __linked__ -- by the [[http://www.dokuwiki.org/plugin:include|include]]  [[plugin_syntax|plugin]]. When I get some time, perhaps I'll look into how to add [[dokuwiki:orphans_not|that feature]].



From the [[http://www.dokuwiki.org/plugin:orphanswanted|orphanswanted plugin page]]:

==== Description ====

Use this plugin to find orphan pages and wanted pages.

OrphansWanted show which pages are:

    * **Orphans** (the page exists, but it has no links to it)
    * **Wanted** (the page does not exist, but there are link(s) to it elsewhere on the site)
    * **Valid** (the page exists, and it can be reached through a link)

Each table shows the reference count and a link to backlinks.

==== Usage ====

Basic usage is to place the one of the following four lines into the page markup:

   
   ~~ORPHANSWANTED:orphans~~
   ~~ORPHANSWANTED:wanted~~
   ~~ORPHANSWANTED:valid~~    
   ~~ORPHANSWANTED:all~~      << makes all three tables 

Anything other than these 4 words will generate a syntax error message.

**Enhanced** usage adds optional namespaces, each prefixed with an exclamation point '!' (think 'not')

 
  ~~ORPHANSWANTED:orphans|wanted|valid|all[!namespace!another!one:with:subspaces]~~
  
  Example -- exclude one namespace:
  
  ~~ORPHANSWANTED:wanted!wiki~~   Shows wanted pages, but none that are under the wiki: namespace
  
  Example -- exclude multiple namespaces: 
  
  ~~ORPHANSWANTED:orphans!wiki!sys:personal~~  Shows orphan pages, but none in the wiki: or in the sys:personal: namespaces  

===== Actual use on this wiki: links-to wanted =====

~~ORPHANSWANTED:orphans~~


===== And the "page wanted" pages -- dead-end links=====

~~ORPHANSWANTED:wanted~~