summaryrefslogtreecommitdiff
path: root/ikiwiki/pagespec.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/pagespec.mdwn')
-rw-r--r--ikiwiki/pagespec.mdwn118
1 files changed, 61 insertions, 57 deletions
diff --git a/ikiwiki/pagespec.mdwn b/ikiwiki/pagespec.mdwn
index f135efb..156e3f6 100644
--- a/ikiwiki/pagespec.mdwn
+++ b/ikiwiki/pagespec.mdwn
@@ -1,81 +1,85 @@
-Til at angive et udvalg af sider, eksempelvis låste sider, sider du vil abonnere
-på ændringer til, eller sider som skal udgøre en blog, anvender wikien et
-PageSpec. dette er et udtryk som modsvarer et bestemt udvalg af sider.
+[[!meta robots="noindex, follow"]]
+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.
-Det simpleste PageSpec er simpelthen en opremsning af sider med "or" imellem
-("or" betyder "eller" på engelsk). Dette modsvarer eksempelvis enhver af de tre
-nævnte sider:
+The simplest PageSpec is a simple list of pages. For example, this matches
+any of the three listed pages:
foo or bar or baz
-Mere hyppigt har du dog brug for at at at modsvare sider med noget tilfælles i
-deres navne. Dette kan du udtrykke med et "glob-mønster". "`*`" står for ehhver
-del af sidenavnet, og "`?`" for ethvert enkeltbogstav i sidenavnet. Så dette
-modsvarer alle sider om musik, og alle [[UnderSider||SubPage]] til sandkassen,
-men ikke selve sandkasse-siden:
+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:
- *musik* or SandBox/*
+ *music* or SandBox/*
-Du kan også angive "`!`" foran et emne for at undgå sider som modsvarer det. Så
-for at modsvare alle sider undtagen diskussionssider og sandkassen:
+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
-En række mere nøjagtige begrænsninger kan tilføjes med disse funktioner:
-
-* "`link(side)`" - modsvarer kun sider som henviser til en given side (eller glob)
-* "`backlink(side)`" - modsvarer kun sider som en given side henviser til
-* "`creation_month(måned)`" - modsvarer kun sider oprettet den givne måned
-* "`creation_day(månedsdag)`" - eller dag på måneden
-* "`creation_year(år)`" - eller år
-* "`created_after(side)`" - modsvarer kun sider oprettet efter den givne side
- blev oprettet
-* "`created_before(side)`" - modsvarer kun sider oprettet før den givne side
- blev oprettet
-* "`glob(nogetglob)`" - modsvarer sider som modsvarer det givne glob. Blot at
- skrive glob'et alene er faktisk en genvej til denne funktion.
-* "`internal(glob)`" - lissom `glob()`, men modsvarer også internt anvendte
- sider som glob normalt ikke modsvarer.
+Some more elaborate limits can be added to what matches using any of these
+functions:
+
+* "`link(page)`" - match only pages that link to a given page (or glob)
+* "`backlink(page)`" - match only pages that a given page links to
+* "`creation_month(month)`" - match only pages created on the given month
+* "`creation_day(mday)`" - or day of the month
+* "`creation_year(year)`" - or year
+* "`created_after(page)`" - match only pages created after the given page
+ was created
+* "`created_before(page)`" - match only pages created before the given page
+ was created
+* "`glob(someglob)`" - match pages that match the given glob. Just writing
+ the glob by itself is actually a shorthand for this function.
+* "`internal(glob)`" - like `glob()`, but matches even internal-use
+ pages that globs do not usually match.
* "`title(glob)`", "`author(glob)`", "`authorurl(glob)`",
- "`license(glob)`", "`copyright(glob)`" - modsvarer sider med de givne
- metadata, som modsvarer det angivne glob.
+ "`license(glob)`", "`copyright(glob)`" - match pages that have the given
+ metadata, matching the specified glob.
-For eksempelvis at modsvare alle sider i en blog som henviser til en side om
-musik og som blev skrevet i 2005:
+For example, to match all pages in a blog that link to the page about music
+and were written in 2005:
- blog/* and link(musik) and creation_year(2005)
+ blog/* and link(music) and creation_year(2005)
-Bemærk brugen af "and" i eksemplet ovenfor ("and" betyder "og" på engelsk), som
-betyder at kun sider der modsvarer hver af de tre udtryk modsvarer det hele.
-Brug "and" når du vil kombinere udtryk på den måde; "or" når det er nok at én
-side modsvarer et udtryk. Bemærk at det ikke giver mening at sige "index and
-SandBox", da ingen sider kan modsvare begge udtryk.
+Note the use of "and" in the above example, that means that only pages that
+match each of the three expressions match the whole. Use "and" when you
+want to combine expression like that; "or" when it's enough for a page to
+match one expression. Note that it doesn't make sense to say "index and
+SandBox", since no page can match both expressions.
-Mere komplekse udtryk kan dannes ved at gruppere med paranteser. Eksempelvis
-modsvarer dette sider i en blog som er mærket af med en af to mærkater:
+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))
-Bemærk at PageSpecs for sidenavne modsvares som de absolutte filnavne for siderne i
-wikien, så et pagespec "foo" brugt på siden "a/b" vil ikke modsvare siderne
-navngivet "a/foo" eller "a/b/foo". For at modsvare relativt til samme mappe som
-siden der indeholder pagespec'et kan du bruge "./". Eksempelvis modsvarer
-"./foo" på siden "a/b" siden "a/foo".
+Note that page names in PageSpecs are matched against the absolute
+filenames of the pages in the wiki, so a pagespec "foo" used on page
+"a/b" will not match a page named "a/foo" or "a/b/foo". To match
+relative to the directory of the page containing the pagespec, you can
+use "./". For example, "./foo" on page "a/b" matches page "a/foo".
-## Gammel syntaks
+## Old syntax
-Den gamle PageSpec-syntaks blev kaldt en "GlobList", og fungerede anderledes på
-to måder:
+The old PageSpec syntax was called a "GlobList", and worked differently in
+two ways:
-1. "and" og "or" blev ikke brugt; enhver side modsvarede ethvert emne fra
- listen.
-2. Hvis et emne havde "`!`" foran, modsvarede ingen side dette emne, heller ikke
- hvis det modsvarede et tidligere emne.
+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.
-Her er et eksempel på den gamle måde at modsvare alle sider undtagen sandkassen
-og diskussionssider:
+For example, here is the old way to match all pages except for the SandBox
+and Discussion pages:
* !SandBox !*/Discussion
-Brug af denne gamle syntaks er stadigt understøttet. Den er dog på vej ud, så
-det anbefales at bruge den nye syntaks.
+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.