X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/b7e28ae022e38e903ae7bd807f68ea8e5b81a206..d772d2d3b26caae74166c88283fe7d2b78420f60:/doc/plugins/write.mdwn diff --git a/doc/plugins/write.mdwn b/doc/plugins/write.mdwn index 583ca541f..bfa0bad1d 100644 --- a/doc/plugins/write.mdwn +++ b/doc/plugins/write.mdwn @@ -81,9 +81,9 @@ function returns goes onto the page in place of the directive. Note that if the [[htmlscrubber]] is enabled, html in [[PreProcessorDirective]] output is sanitised, which may limit what your plugin can do. Also, the rest of the page content is not in html format at -preprocessor time. Text output by a preprocessor directive will be passed -through markdown (or whatever engine is used to htmlize the page) along -with the rest of the page. +preprocessor time. Text output by a preprocessor directive will be +linkified and passed through markdown (or whatever engine is used to htmlize +the page) along with the rest of the page. ## htmlize @@ -94,6 +94,9 @@ specifies the filename extension that a file must have to be htmlized using this plugin. This is how you can add support for new and exciting markup languages to ikiwiki. +The function is passed named parameters: "page" and "content" and should +return the htmlized content. + ## pagetemplate IkiWiki::hook(type => "pagetemplate", id => "foo", call => \&pagetemplate); @@ -115,18 +118,20 @@ a new custom parameter to the template. Use this to implement html sanitization or anything else that needs to modify the body of a page after it has been fully converted to html. -The function is passed the page content and should return the sanitized -content. + +The function is passed named parameters: "page" and "content", and +should return the sanitized content. ## format IkiWiki::hook(type => "format", id => "foo", call => \&format); -The function is passed the complete page content and can reformat it -and return the new content. The difference between format and sanitize is -that sanitize only acts on the page body, while format can modify the -entire html page including the header and footer inserted by ikiwiki, the -html document type, etc. +The difference between format and sanitize is that sanitize only acts on +the page body, while format can modify the entire html page including the +header and footer inserted by ikiwiki, the html document type, etc. + +The function is passed named parameters: "page" and "content", and +should return the formatted content. ## delete