diff options
author | Joey Hess <joey@gnu.kitenet.net> | 2010-04-06 23:15:33 -0400 |
---|---|---|
committer | Joey Hess <joey@gnu.kitenet.net> | 2010-04-06 23:15:33 -0400 |
commit | bab8fec52468b780485bdf96a37a593bd033c7e3 (patch) | |
tree | 5f292e4e6205bd4fcde1be249c1fe646dc75a26c /doc/ikiwiki | |
parent | 9dc220711dff12fd45274c4e2fd2645a33d3de5c (diff) | |
parent | a2dc8c9373b36f7cc8da239b823b5839788a743d (diff) | |
download | ikiwiki-bab8fec52468b780485bdf96a37a593bd033c7e3.tar ikiwiki-bab8fec52468b780485bdf96a37a593bd033c7e3.tar.gz |
Merge remote branch 'smcv/ready/sort-package'
Conflicts:
debian/NEWS
Diffstat (limited to 'doc/ikiwiki')
-rw-r--r-- | doc/ikiwiki/directive/meta.mdwn | 12 | ||||
-rw-r--r-- | doc/ikiwiki/pagespec/sorting.mdwn | 20 |
2 files changed, 29 insertions, 3 deletions
diff --git a/doc/ikiwiki/directive/meta.mdwn b/doc/ikiwiki/directive/meta.mdwn index 557441c0b..5a3919dea 100644 --- a/doc/ikiwiki/directive/meta.mdwn +++ b/doc/ikiwiki/directive/meta.mdwn @@ -23,6 +23,13 @@ Supported fields: be set to a true value in the template; this can be used to format things differently in this case. + An optional `sortas` parameter will be used preferentially when + [[ikiwiki/pagespec/sorting]] by `meta(title)`: + + \[[!meta title="The Beatles" sortas="Beatles, The"]] + + \[[!meta title="David Bowie" sortas="Bowie, David"]] + * license Specifies a license for the page, for example, "GPL". Can contain @@ -37,6 +44,11 @@ Supported fields: Specifies the author of a page. + An optional `sortas` parameter will be used preferentially when + [[ikiwiki/pagespec/sorting]] by `meta(author)`: + + \[[!meta author="Joey Hess" sortas="Hess, Joey"]] + * authorurl Specifies an url for the author of a page. diff --git a/doc/ikiwiki/pagespec/sorting.mdwn b/doc/ikiwiki/pagespec/sorting.mdwn index 697818a2a..5c6cfcc2b 100644 --- a/doc/ikiwiki/pagespec/sorting.mdwn +++ b/doc/ikiwiki/pagespec/sorting.mdwn @@ -5,9 +5,23 @@ orders can be specified. * `age` - List pages from the most recently created to the oldest. * `mtime` - List pages with the most recently modified first. -* `title` - Order by title. -* `title_natural` - Only available if [[!cpan Sort::Naturally]] is - installed. Orders by title, but numbers in the title are treated +* `title` - Order by title (page name). +[[!if test="enabled(sortnaturally)" then=""" +* `title_natural` - Orders by title, but numbers in the title are treated as such, ("1 2 9 10 20" instead of "1 10 2 20 9") +"""]] +[[!if test="enabled(meta)" then=""" +* `meta(title)` - Order according to the `\[[!meta title="foo" sortas="bar"]]` + or `\[[!meta title="foo"]]` [[ikiwiki/directive]], or the page name if no + full title was set. `meta(author)`, `meta(date)`, `meta(updated)`, etc. + also work. +"""]] + +In addition, you can combine several sort orders and/or reverse the order of +sorting, with a string like `age -title` (which would sort by age, then by +title in reverse order if two pages have the same age). + +Plugins can add additional sort orders, so more might be available on this +wiki. [[!meta robots="noindex, follow"]] |