From e823ee4bea481f259369d9d58d2c761eba02aab2 Mon Sep 17 00:00:00 2001 From: Amitai Schlair Date: Sat, 23 Feb 2013 14:24:08 -0500 Subject: [PATCH] Document wc plugin. --- doc/plugins/contrib/wc.mdwn | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 doc/plugins/contrib/wc.mdwn diff --git a/doc/plugins/contrib/wc.mdwn b/doc/plugins/contrib/wc.mdwn new file mode 100644 index 000000000..97d501e34 --- /dev/null +++ b/doc/plugins/contrib/wc.mdwn @@ -0,0 +1,21 @@ +[[!template id=plugin name=wc author="[[schmonz]]"]] +[[!template id=gitbranch branch=schmonz/wc author="[[schmonz]]"]] +[[!tag type/meta]] + +This plugin counts words in a page. For a single page, write a +`\[[!wc]]` directive and the word count will be interpolated there. +For a site, add `` to your [[templates]]. + +If [[!cpan HTML::Strip]] is installed, the wordcount will be slightly +more accurate. + +Possible enhancements: + +* Optimize: count words iff the result will be displayed. `sanitize()` + seems like the right place to count. Since it's called well after + `preprocess()`, I can tell whether a directive needs the result, + but since it appears to be called before `pagetemplate()`, I can't + tell whether a template wants to know and possibly skip the + computation. (In other words, if I add `$needed_for_template` + like `$needed_for_directive`, it gets set too late for `sanitize()` + to see.) -- 2.39.5