[[PageOutline(2-5,Contents,pullout)]]
= Wanted Pages Macro

== Description

Lists all wiki pages that are linked to but not created in wikis, ticket descriptions and ticket comments. That is, when a [http://trac.edgewall.org/wiki/CamelCase CamelCase] identifier is listed in a wiki page, then a link is created to that page. However, if that page does not exist, then the link exists but the page is not created. For example, MyPageAbc is a link to !MyPageAbc, which does not exist.

== Bugs/Feature Requests

Existing bugs and feature requests for WantedPagesMacro are [report:9?COMPONENT=WantedPagesMacro here].

If you have any issues, create a [http://trac-hacks.org/newticket?component=WantedPagesMacro&owner=glinders new ticket].

== Download

Download the zipped source for [download:wantedpagesmacro/0.9 0.9] or [download:wantedpagesmacro/0.10 0.10] or [download:wantedpagesmacro/trunk 0.11/0.12/1.0].

== Install

You must have setuptools installed. 

Run the following commands in the source directory:
{{{
#!sh
  python setup.py bdist_egg
  cp dist/*.egg /path/to/projenv/plugins
}}}

For more information, see TracPlugins.

You also have to enable it in the trac.ini file for the environment:
{{{
#!ini
[components]
wantedpages.* = enabled
}}}

== Source

You can check out WantedPagesMacro from [http://trac-hacks.org/svn/wantedpagesmacro here] using Subversion, or [source:wantedpagesmacro browse the source] with Trac.

== Example

`[[WantedPages]]` lists all wiki pages that are linked to, but do not exist.

`[[WantedPages(show_referrers)]]` does the same thing, but also lists the pages that contain the broken links.

`[[WantedPages(ignored_referrers=<regex>)]]` does the same thing, but ignores referring pages that match the regular expression <regex>, eg `[[WantedPages(show_referrers,ignored_referrers=^Wiki[HP]|^Trac)]]`.

== Recent Changes

[[ChangeLog(wantedpagesmacro, 3)]]

== Author/Contributors

'''Author:''' [wiki:jfrancis] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''