X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/72c53650ad4a708493880daa75cdda9d056fc75e..21bb9de4964a8d58355606213d94fa570b1a5af3:/doc/plugins/write.mdwn diff --git a/doc/plugins/write.mdwn b/doc/plugins/write.mdwn index 9d85d4a9f..25ea8a98e 100644 --- a/doc/plugins/write.mdwn +++ b/doc/plugins/write.mdwn @@ -76,8 +76,8 @@ adding or removing files from it. hook(type => "filter", id => "foo", call => \&filter); Runs on the raw source of a page, before anything else touches it, and can -make arbitrary changes. The function is passed named parameters `page` and -`content` and should return the filtered content. +make arbitrary changes. The function is passed named parameters "page", +"destpage", and "content". It should return the filtered content. ### preprocess @@ -136,7 +136,7 @@ preprocess hook. The "template" parameter is a [[cpan HTML::Template]] object that is the template that will be used to generate the page. The function can manipulate that template object. -The most common thing to do is probably to call $template->param() to add +The most common thing to do is probably to call `$template->param()` to add a new custom parameter to the template. ### sanitize @@ -283,7 +283,7 @@ ikiwiki program. Hook into ikiwiki's processing. See the discussion of hooks above. Note that in addition to the named parameters described above, a parameter -named no_override is supported, If it's set to a true value, then this hook +named `no_override` is supported, If it's set to a true value, then this hook will not override any existing hook with the same id. This is useful if the id can be controled by the user. @@ -308,7 +308,7 @@ appear on the wiki page, rather than calling error(). Creates and returns a [[cpan HTML::Template]] object. The first parameter is the name of the file in the template directory. The optional remaining -parameters are passed to HTML::Template->new. +parameters are passed to `HTML::Template->new`. #### `htmlpage($)` @@ -389,7 +389,7 @@ A failure to write the file will result in it dying with an error. If the destination directory doesn't exist, it will first be created. -### `will_render($$)` +#### `will_render($$)` Given a page name and a destination file name (not including the base destination directory), register that the page will result in that file @@ -435,9 +435,9 @@ ikiwiki's support for revision control systems also uses pluggable perl modules. These are in the `IkiWiki::RCS` namespace, for example `IkiWiki::RCS::svn`. -Each RCS plugin must support all the IkiWiki::rcs\_* functions. +Each RCS plugin must support all the `IkiWiki::rcs_*` functions. See IkiWiki::RCS::Stub for the full list of functions. It's ok if -rcs\_getctime does nothing except for throwing an error. +`rcs_getctime` does nothing except for throwing an error. See [[about_RCS_backends]] for some more info.