Photos
Blog
Projects
vanrenterghem.biz
projects
/
git.ikiwiki.info.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
release candidate
[git.ikiwiki.info.git]
/
doc
/
plugins
/
write.mdwn
diff --git
a/doc/plugins/write.mdwn
b/doc/plugins/write.mdwn
index f4620b62328b4c0f7f611bc2ba21d21914855565..c3f531b66aa706f7b44eb4a0b52250f16d4ca732 100644
(file)
--- a/
doc/plugins/write.mdwn
+++ b/
doc/plugins/write.mdwn
@@
-217,6
+217,9
@@
value is ignored.
Runs on the raw source of a page or `*.tmpl` file that is being
used as a template, before it is parsed by [[!cpan HTML::Template]].
Runs on the raw source of a page or `*.tmpl` file that is being
used as a template, before it is parsed by [[!cpan HTML::Template]].
+For instance, the [[plugins/templatebody]] plugin uses this to return
+the content of the [[ikiwiki/directive/templatebody]] directive (if there
+is one) instead of the page's full content.
The function is passed named parameters:
The function is passed named parameters:
@@
-739,17
+742,24
@@
The `%pagesources` has can be used to look up the source filename
of a page. So the key is the page name, and the value is the source
filename. Do not modify this hash.
of a page. So the key is the page name, and the value is the source
filename. Do not modify this hash.
+Attachments also appear in this hash, with the same key and value.
+
$pagesources{"foo"} = "foo.mdwn";
$pagesources{"foo"} = "foo.mdwn";
+ $pagesources{"logo/ikiwiki.png"} = "logo/ikiwiki.png";
+
### `%destsources`
The `%destsources` hash records the name of the source file used to
create each destination file. The key is the output filename (ie,
### `%destsources`
The `%destsources` hash records the name of the source file used to
create each destination file. The key is the output filename (ie,
-"foo/index.html"), and the value is the
source filenam
e that it was built
-from (eg, "foo
.mdwn
"). Note that a single source file may create multiple
+"foo/index.html"), and the value is the
name of the pag
e that it was built
+from (eg, "foo"). Note that a single source file may create multiple
destination files. Do not modify this hash directly; call `will_render()`.
destination files. Do not modify this hash directly; call `will_render()`.
-
- $destsources{"foo/index.html"} = "foo.mdwn";
+
+Attachments also appear in this hash, with the same key and value.
+
+ $destsources{"foo/index.html"} = "foo";
+ $destsources{"logo/ikiwiki.png"} = "logo/ikiwiki.png";
## Library functions
## Library functions