doc/bugs/inline_sort-by-title_issues.mdwn

   1 The [[plugins/inline]] plugin has a `sort="title"` option that causes the pages in the list to be sorted by title rather than creation time.  The [[plugins]] list on this wiki was recently changed to use this option.  If you look at the plugin page, you'll notice that it doesn't look correctly sorted.  e.g. `attach (third party plugin)` falls between `conditional` and `default content for *copyright* and *license*`.
   2
   3 I think the problem here is that the pages are being sorted by their path, whereas only the basename is displayed.  This makes the example above:
   4
   5  * plugins/conditional
   6  * plugins/contrib/attach
   7  * plugins/contrib/default content for *copyright* and *license*
   8
   9 and now you can see why it is ordered that way, and why later on we get:
  10
  11  * plugins/contrib/unixauth (third party plugin)
  12  * plugins/creole
  13
  14 which appears to list `unixauth` before `creole`.
  15
  16 I'm not sure what the best fix is.  One fix would be to add another sort option, `sort="path"`, that would use the current (broken) sort by title.  Then add a true `sort="title"` that actually sorts on the title.  It might also be interesting to modify the sort=path to actually list the full path in the links - that way it would be obvious how it is sorted.  Or you could ignore the idea for `sort="path"`, and tell people to use [[plugins/map]] for that.
  17
  18 --[[users/Will]]
  19
  20 And here is a [[patch]] for this.  It makes `sort=title` actually sort on the title, and adds `sort=path` if you really want to sort on the path.  `sort=path` still only displays titles.  Just use map if you want more.
  21
  22     diff --git a/IkiWiki/Plugin/inline.pm b/IkiWiki/Plugin/inline.pm
  23     index 9c336e7..99f6de3 100644
  24     --- a/IkiWiki/Plugin/inline.pm
  25     +++ b/IkiWiki/Plugin/inline.pm
  26     @@ -185,9 +185,12 @@ sub preprocess_inline (@) {
  27                 }
  28         }
  29
  30     -   if (exists $params{sort} && $params{sort} eq 'title') {
  31     +   if (exists $params{sort} && $params{sort} eq 'path') {
  32                 @list=sort @list;
  33         }
  34     +   elsif (exists $params{sort} && $params{sort} eq 'title') {
  35     +           @list=sort { lc(pagetitle(basename($a))) cmp lc(pagetitle(basename($b))) } @list;
  36     +   }
  37         elsif (exists $params{sort} && $params{sort} eq 'mtime') {
  38                 @list=sort { $pagemtime{$b} <=> $pagemtime{$a} } @list;
  39         }
  40     diff --git a/doc/ikiwiki/blog.mdwn b/doc/ikiwiki/blog.mdwn
  41     index 19ec7ac..7608628 100644
  42     --- a/doc/ikiwiki/blog.mdwn
  43     +++ b/doc/ikiwiki/blog.mdwn
  44     @@ -89,7 +89,8 @@ Here are some less often needed parameters:
  45        inlining page.
  46      * `sort` - Controls how inlined pages are sorted. The default, "age" is to
  47        sort newest created pages first. Setting it to "title" will sort pages by
  48     -  title, and "mtime" sorts most recently modified pages first.
  49     +  title, "path" sorts by the path to the page, and "mtime" sorts most
  50     +  recently modified pages first.
  51      * `reverse` - If set to "yes", causes the sort order to be reversed.
  52      * `feedshow` - Specify the maximum number of matching pages to include in
  53        the rss/atom feeds. The default is the same as the `show` value above.
  54
  55 > Thanks for the patch. [[done]], but I left off the sort=path. Also left
  56 > off the lc (if you ask your locale to sort case-sensatively, it should, I
  57 > think). --[[Joey]]