size limits

IkiWiki/Plugin/linkmap.pm

@@ -18,6 +18,7 @@ my %maps;
 
 sub preprocess (@) { #{{{
 	my %params=@_;
+
 	$params{pages}="*" unless defined $params{pages};
 	
 	# Needs to update whenever a page is added or removed, so
@@ -83,6 +84,8 @@ sub genmap ($) { #{{{
 	print OUT "digraph linkmap$mapnum {\n";
 	print OUT "concentrate=true;\n";
 	print OUT "charset=\"utf-8\";\n";
+	print OUT "ratio=compress;\nsize=\"".($params{width}+0).", ".($params{height}+0)."\";\n"
+		if defined $params{width} and defined $params{height};
 	foreach my $item (keys %mapitems) {
 		print OUT "\"$item\" [shape=box,href=\"$mapitems{$item}\"];\n";
 		foreach my $link (map { IkiWiki::bestlink($item, $_) } @{$IkiWiki::links{$item}}) {

doc/plugins/linkmap.mdwn

@@ -14,6 +14,14 @@ the map can become very large, unweildy, and complicated. Also, the map is
 rebuilt whenever one of the mapped pages is changed, which can make the
 wiki a bit slow.
 
+Here are descriptions of all the supported parameters to the `linkmap`
+directive:
+
+* `pages` - A [[PageSpec]] of the pages to map.
+* `height`, `width` - Limit the size of the map to a given height and width,
+  in inches. Both must be specified for the limiting to take effect, otherwise
+  the map's size is not limited.
+
 This plugin is included in ikiwiki, but is not enabled by default.
 
 If this plugin is enabled, here is a link map of the index page and all