X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/58141a0ebcdf3313a83af712b83f8acd1c08aa3b..40f318f3e999ce5f7890deafcb56deb1c125bf7a:/doc/plugins/write.mdwn diff --git a/doc/plugins/write.mdwn b/doc/plugins/write.mdwn index d822408c2..8630b56ff 100644 --- a/doc/plugins/write.mdwn +++ b/doc/plugins/write.mdwn @@ -314,9 +314,9 @@ Makes the specified page depend on the specified [[PageSpec]]. #### `pagespec_match($$;$)` -Passed a page name, a [[PageSpec]], and the location the glob should be -matched against, returns true if the [[PageSpec]] matches the page. (If the -third parameter is not passed, relative PageSpecs will match relative to +Passed a page name, a [[PageSpec]], and the location the [[PageSpec]] should +be matched against, returns true if the [[PageSpec]] matches the page. (If +the third parameter is not passed, relative PageSpecs will match relative to the top of the wiki.) #### `bestlink($$)` @@ -413,3 +413,12 @@ See IkiWiki::RCS::Stub for the full list of functions. It's ok if rcs\_getctime does nothing except for throwing an error. See [[about_RCS_backends]] for some more info. + +## PageSpec plugins + +It's also possible to write plugins that add new functions to +[[PageSpecs|PageSpec]]. Such a plugin should add a function to the +IkiWiki::PageSpec package, that is named `match_foo`, where "foo()" is +how it will be accessed in a [[PageSpec]]. The function will be passed two +parameters: The name of the page being matched, and the thing to match +against. It should return true if the page matches.