X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/9bb6b1be2e1a6e5da0903f3f7a1116cf747939e4..bcf08cf9053070c49cdf1e3f879bcd8527206e4e:/basewiki/pagespec.mdwn diff --git a/basewiki/pagespec.mdwn b/basewiki/pagespec.mdwn deleted file mode 100644 index 64710a2a5..000000000 --- a/basewiki/pagespec.mdwn +++ /dev/null @@ -1,58 +0,0 @@ -To select a set of pages, such as pages that are locked, pages -whose commit emails you want subscribe to, or pages to combine into a -[[blog]], the wiki uses a PageSpec. This is an expression that matches -a set of pages. - -The simplest PageSpec is a simple list of pages. For example, this matches -any of the three listed pages: - - foo or bar or baz - -More often you will want to match any pages that have a particular thing in -their name. You can do this using a glob pattern. "`*`" stands for any part -of a page name, and "`?`" for any single letter of a page name. So this -matches all pages about music, and any [[SubPage]]s of the SandBox, but does -not match the SandBox itself: - - *music* or SandBox/* - -You can also prefix an item with "`!`" to skip pages that match it. So to -match all pages except for Discussion pages and the SandBox: - - * and !SandBox and !*/Discussion - -It's also possible to match pages that link to a given page, by writing -"`link(page)`". Or, match pages that a given page links to, by -writing "`backlink(page)`". Or match pages created in a given month, year, -or day of the month by writing "`creation_month(month)`", -"`creation_year(year)`" or "`creation_day(mday)`". - -For example, to match all pages in a blog that link to the page about music -and were written on Mondays in 2005: - - blog/* and link(music) and creation_year(2005) and creation_day(0) - -More complex expressions can also be created, by using parentheses for -grouping. For example, to match pages in a blog that are tagged with either -of two tags, use: - - blog/* and (link(tag/foo) or link(tag/bar)) - -## Old syntax - -The old PageSpec syntax was called a "GlobList", and worked differently in -two ways: - -1. "and" and "or" were not used; any page matching any item from the list - matched. -2. If an item was prefixed with "`!`", then no page matching that item - matched, even if it matched an earlier list item. - -For example, here is the old way to match all pages except for the SandBox -and Discussion pages: - - * !SandBox !*/Discussion - -Using this old syntax is still supported. However, the old syntax is -deprecated and will be removed at some point, and using the new syntax is -recommended. diff --git a/basewiki/pagespec.mdwn b/basewiki/pagespec.mdwn new file mode 120000 index 000000000..71ea44d15 --- /dev/null +++ b/basewiki/pagespec.mdwn @@ -0,0 +1 @@ +../doc/pagespec.mdwn \ No newline at end of file