<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">#!/usr/bin/perl
#
# Produce page statistics in various forms.
#
# Currently supported:
#   cloud: produces statistics in the form of a del.icio.us-style tag cloud
#          (default)
#   table: produces a table with the number of backlinks for each page
#
# by Enrico Zini
package IkiWiki::Plugin::pagestats;

use warnings;
use strict;
use IkiWiki 3.00;

# Names of the HTML classes to use for the tag cloud
our @classes = ('smallestPC', 'smallPC', 'normalPC', 'bigPC', 'biggestPC' );

sub import {
	hook(type =&gt; "getsetup", id =&gt; "pagestats", call =&gt; \&amp;getsetup);
	hook(type =&gt; "preprocess", id =&gt; "pagestats", call =&gt; \&amp;preprocess);
}

sub getsetup () {
	return 
		plugin =&gt; {
			safe =&gt; 1,
			rebuild =&gt; undef,
			section =&gt; "widget",
		},
}

sub linktext ($%) {
	# Return the text of the link to a tag, depending on option linktext.
	my ($page, %params) = @_;
	if (exists $params{show} &amp;&amp;
		exists $pagestate{$page} &amp;&amp;
		exists $pagestate{$page}{meta}{$params{show}}) {
		return $pagestate{$page}{meta}{$params{show}};
	}
	else {
		return undef;
	}
}

sub preprocess (@) {
	my %params=@_;
	$params{pages}="*" unless defined $params{pages};
	my $style = ($params{style} or 'cloud');

	# Backwards compatibility
	if (defined $params{show} &amp;&amp; $params{show} =~ m/^\d+$/) {
		$params{limit} = $params{show};
		delete $params{show};
	}

	my %counts;
	my $max = 0;
	foreach my $page (pagespec_match_list($params{page}, $params{pages},
		                  # update when a displayed page is added/removed
	        	          deptype =&gt; deptype("presence"))) {
		use IkiWiki::Render;

		my @backlinks = IkiWiki::backlink_pages($page);

		if (exists $params{among}) {
			# only consider backlinks from the amoung pages
			@backlinks = pagespec_match_list(
				$params{page}, $params{among},
				# update whenever links on those pages change
				deptype =&gt; deptype("links"),
				list =&gt; \@backlinks
			);
		}
		else {
			# update when any page with links changes,
			# in case the links point to our displayed pages
			add_depends($params{page}, "*", deptype("links"));
		}

		$counts{$page} = scalar(@backlinks);
		$max = $counts{$page} if $counts{$page} &gt; $max;
	}

	if (exists $params{limit}) {
		my $i=0;
		my %show;
		foreach my $key (sort { $counts{$b} &lt;=&gt; $counts{$a} } keys %counts) {
			last if ++$i &gt; $params{limit};
			$show{$key}=$counts{$key};
		}
		%counts=%show;
	}

	if ($style eq 'table') {
		return "&lt;table class='".(exists $params{class} ? $params{class} : "pageStats")."'&gt;\n".
			join("\n", map {
				"&lt;tr&gt;&lt;td&gt;".
				htmllink($params{page}, $params{destpage}, $_, noimageinline =&gt; 1, linktext =&gt; linktext($_, %params)).
				"&lt;/td&gt;&lt;td&gt;".$counts{$_}."&lt;/td&gt;&lt;/tr&gt;"
			}
			sort { $counts{$b} &lt;=&gt; $counts{$a} } keys %counts).
			"\n&lt;/table&gt;\n" ;
	}
	else {
		# In case of misspelling, default to a page cloud

		my $res;
		if ($style eq 'list') {
			$res = "&lt;ul class='".(exists $params{class} ? $params{class} : "list")."'&gt;\n";
		}
		else {
			$res = "&lt;div class='".(exists $params{class} ? $params{class} : "pagecloud")."'&gt;\n";
		}
		foreach my $page (sort keys %counts) {
			next unless $counts{$page} &gt; 0;

			my $class = $classes[$counts{$page} * scalar(@classes) / ($max + 1)];
			
			$res.="&lt;li&gt;" if $style eq 'list';
			$res .= "&lt;span class=\"$class\"&gt;".
							htmllink($params{page}, $params{destpage}, $page, linktext =&gt; linktext($page, %params)).
			        "&lt;/span&gt;\n";
			$res.="&lt;/li&gt;" if $style eq 'list';

		}
		if ($style eq 'list') {
			$res .= "&lt;/ul&gt;\n";
		}
		else {
			$res .= "&lt;/div&gt;\n";
		}

		return $res;
	}
}

1
</pre></body></html>