urosm
/
ikiwiki
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

note about sort and dependency types 

There's a gotcha where pagespec_match_list is used with a dependency type
that is not a full content dependency, and so ikiwiki does not know that
a content change to a page that sorted too low to match needs to trigger
a rebuild, since its sort order may have changed.

Inline is mostly ok re this, as it does use content dependencies. Except
for in the case of raw mode. But then, page metadata is documented to not
be loaded, so it doesn't make sense to use sortspecs that depend on
metadata. I hope. :)
master
Joey Hess 2010-04-07 00:01:38 -04:00
parent 196851d4e2
commit d58444a3e9
1 changed files with 4 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
doc/plugins/write.mdwn
View File

@ -734,7 +734,10 @@ Additional named parameters can be specified:
* `filter` is a reference to a function, that is called and passed a page, * `filter` is a reference to a function, that is called and passed a page,
and returns true if the page should be filtered out of the list. and returns true if the page should be filtered out of the list.
* `sort` specifies a sort order for the list. See * `sort` specifies a sort order for the list. See
[[ikiwiki/PageSpec/sorting]] for the avilable sort methods. [[ikiwiki/PageSpec/sorting]] for the avilable sort methods. Note that
if a sort method is specified that depends on the
page content (such as 'meta(foo)'), the deptype needs to be set to
a content dependency.
* `reverse` if true, sorts in reverse. * `reverse` if true, sorts in reverse.
* `num` if nonzero, specifies the maximum number of matching pages that * `num` if nonzero, specifies the maximum number of matching pages that
will be returned. will be returned.