wiki:WantedPagesMacro

List of non-existent wiki pages that are linked to

Description

This macro lists all wiki pages that are linked to but not created in wikis, ticket descriptions and ticket comments. That is, when a 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.

To use this macro, add the following to the wiki page that you want to investigate non-existent wiki pages from:

[[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)]].

Note that the regex matches all or part of the name.

More options:

filter
alias for ignored_referrers
filtertype
flags whether filter option is inclusive or exclusive, with values inclusive or exclusive (is also default value for backward compatibility)

Examples:

  • ignore all pages that contain 'Trac' in their name:
    • [[WantedPages(show_referrers, ignored_referrers=Trac)]]
    • [[WantedPages(show_referrers, ignored_referrers=Trac, filtertype=exclusive)]]
    • [[WantedPages(show_referrers, filter=Trac)]]
    • [[WantedPages(show_referrers, filter=Trac, filtertype=exclusive)]]
  • only show pages that contain 'Trac' in their name:
    • [[WantedPages(show_referrers, ignored_referrers=Trac, filtertype=inclusive)]]
    • [[WantedPages(show_referrers, filter=Trac, filtertype=inclusive)]]

Bugs/Feature Requests

Existing bugs and feature requests for WantedPagesMacro are here.

If you have any issues, create a new ticket.

defect

13 / 13

enhancement

15 / 16

task

3 / 3

Download

Download the zipped source for 0.10 or 0.11/0.12/1.0.

Source

You can check out WantedPagesMacro from here using Subversion, or browse the source with Trac.

Installation

You must have setuptools installed.

Run the following commands in the source directory:

python setup.py bdist_egg
cp dist/*.egg /path/to/projenv/plugins

General instructions on installing Trac plugins can be found on the TracPlugins page.

You also have to enable it in the trac.ini file:

[components]
wantedpages.* = enabled

Recent Changes

16397 by rjollos on 2017-03-25 09:37:00
Remove obsolete "0.9" code
16393 by rjollos on 2017-03-25 09:19:41
Remove eggs
14534 by glinders on 2015-04-16 22:59:29
#12261 Added filter options
(more)

Author/Contributors

Author: jfrancis
Maintainer: Geert
Contributors:

Last modified 2 months ago Last modified on Aug 6, 2018, 12:56:51 PM