summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/todo/pagestats:_ability_to_limit_to_links_from_certain_pages.mdwn16
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/todo/pagestats:_ability_to_limit_to_links_from_certain_pages.mdwn b/doc/todo/pagestats:_ability_to_limit_to_links_from_certain_pages.mdwn
new file mode 100644
index 000000000..abf7c3fea
--- /dev/null
+++ b/doc/todo/pagestats:_ability_to_limit_to_links_from_certain_pages.mdwn
@@ -0,0 +1,16 @@
+The `among` branch in my git repository refactors IkiWiki::Render a
+bit, then uses this refactoring to add a [[ikiwiki/directive/pagestats]]
+parameter `among` that will only count links from pages that match a
+given [[ikiwiki/PageSpec]]. From its documentation:
+
+> The optional `among` parameter limits counting to pages that match a
+> [[ikiwiki/PageSpec]]. For instance, to display a cloud of tags used on blog
+> entries, you could use:
+>
+> \[[!pagestats pages="tags/*" among="blog/posts/*"]]
+>
+> or to display a cloud of tags related to Linux, you could use:
+>
+> \[[!pagestats pages="tags/* and not tags/linux" among="tagged(linux)"]]
+
+Suggestions for a better parameter name are welcome. --[[smcv]]