#!/usr/bin/perl # Provides a list of pages no other page links to. package IkiWiki::Plugin::orphans; use warnings; use strict; use IkiWiki 3.00; sub import { hook(type => "getsetup", id => "orphans", call => \&getsetup); hook(type => "preprocess", id => "orphans", call => \&preprocess); } sub getsetup () { return plugin => { safe => 1, rebuild => undef, }, } sub preprocess (@) { my %params=@_; $params{pages}="*" unless defined $params{pages}; # Needs to update whenever a link changes, on any page # since any page could link to one of the pages we're # considering as orphans. add_depends($params{page}, "*", links => 1); # Also needs to update whenever potential orphans are added or # removed. add_depends($params{page}, $params{pages}, presence => 1); my @orphans; foreach my $page (pagespec_match_list( [ grep { ! IkiWiki::backlink_pages($_) && $_ ne 'index' } keys %pagesources ], $params{pages}, location => $params{page})) { # If the page has a link to some other page, it's # indirectly linked to a page via that page's backlinks. next if grep { length $_ && ($_ !~ /\/\Q$config{discussionpage}\E$/i || ! $config{discussion}) && bestlink($page, $_) !~ /^(\Q$page\E|)$/ } @{$links{$page}}; push @orphans, $page; } return gettext("All pages have other pages linking to them.") unless @orphans; return "\n"; } 1