summaryrefslogtreecommitdiff
path: root/ikiwiki
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2008-06-12 15:32:34 +0200
committerJonas Smedegaard <dr@jones.dk>2008-06-12 15:32:34 +0200
commitf620f245c67518ab00bfe49be15f0fb2ec10118f (patch)
tree4e81d3b36aa24d83d3e9773552c5009bc48baf98 /ikiwiki
parent807066884a865bdd5baf72ba42acff46eeecd3b9 (diff)
Replace with upstream 2.49, resetting translation completely.
Diffstat (limited to 'ikiwiki')
-rw-r--r--ikiwiki/blog.mdwn156
-rw-r--r--ikiwiki/formatting.mdwn80
-rw-r--r--ikiwiki/markdown.mdwn21
-rw-r--r--ikiwiki/openid.mdwn27
-rw-r--r--ikiwiki/pagespec.mdwn129
-rw-r--r--ikiwiki/preprocessordirective.mdwn41
-rw-r--r--ikiwiki/subpage.mdwn20
-rw-r--r--ikiwiki/subpage/linkingrules.mdwn55
-rw-r--r--ikiwiki/wikilink.mdwn53
9 files changed, 286 insertions, 296 deletions
diff --git a/ikiwiki/blog.mdwn b/ikiwiki/blog.mdwn
index e7320fd..f1293ec 100644
--- a/ikiwiki/blog.mdwn
+++ b/ikiwiki/blog.mdwn
@@ -1,102 +1,100 @@
[[!meta robots="noindex, follow"]]
[[!if test="enabled(inline)"
- then="Denne wiki har inline plugin **aktiveret**."
- else="Denne wiki har inline plugin **deaktiveret**."]]
+ then="This wiki has the inline plugin **enabled**."
+ else="This wiki has the inline plugin **disabled**."]]
[[!if test="enabled(inline)"
- then="Du kan"
- else="Hvis denne wiki havde inline plugin aktiveret, kunne du"]]
-omlægge enhver side på denne wiki til en weblog ved at bruge `inline`
-[[PreprocessorDirektivet|PreProcessorDirective]]. Som eksempel:
+ then="You can"
+ else="If this wiki had the inline plugin enabled, you could"]]
+turn any page on this wiki into a weblog by using the `inline`
+[[PreProcessorDirective]]. For example:
\[[!inline pages="blog/* and !*/Discussion" show="10" rootpage="blog"]]
-Enhver side der modsvarer det angivne [[PageSpec]] (i eksemplet enhver
-[[UnderSide|SubPage]] til "blog") vil blive del af bloggen, og de nyeste 10
-af dem vil dukke op på siden. Bemærk at hvis filer som ikke er sider
-modsvarer [[PageSpec]]'et, bliver de medtaget i fødningen (feed) gennem
-RSS-indkapslinger, som er anvendeligt til podcasting.
+Any pages that match the specified [[PageSpec]] (in the example, any
+[[SubPage]] of "blog") will be part of the blog, and the newest 10
+of them will appear in the page. Note that if files that are not pages
+match the [[PageSpec]], they will be included in the feed using RSS
+enclosures, which is useful for podcasting.
-Den valgfri `rootpage`-parameter fortæller wikien at nye indlæg til denne
-blog som standard skal være [[UnderSider|SubPage]] til "blog", og aktiverer
-en formular øverst i bloggen som kan bruges til at tilføje nye emner.
+The optional `rootpage` parameter tells the wiki that new posts to this blog
+should default to being [[SubPage]]s of "blog", and enables a form at the
+top of the blog that can be used to add new items.
-Hvis du har lyst til at din blog skal have en arkivside med oversigt over
-alle indlæg skrevet nogensinde til den, kan det gøres sådan her:
+If you want your blog to have an archive page listing every post ever made
+to it, you can accomplish that like this:
\[[!inline pages="blog/* and !*/Discussion" archive="yes"]]
-Du kan endda lave en automatisk dannet liste over alle de sider på wikien,
-med de nyeste tilføjet øverst, sådan her:
+You can even create an automatically generated list of all the pages on the
+wiki, with the most recently added at the top, like this:
\[[!inline pages="* and !*/Discussion" archive="yes"]]
-Hvis du vil have mulighed for at tilføje sider til en given blogfødning ved
-at mærke dem af, kan du også gøre det. Du afmærker en side ved blot at lave
-en henvisning til en en eller flere sider som repræsenterer dets
-mærkater. Brug derefter det særlige `link()` [[PageSpec]] til at modsvare
-alle sider med en given mærkat:
+If you want to be able to add pages to a given blog feed by tagging them,
+you can do that too. To tag a page, just make it link to a page or pages
+that represent its tags. Then use the special `link()` [[PageSpec]] to match
+all pages that have a given tag:
\[[!inline pages="link(life)"]]
-Eller medtag nogle mærkater og udelad andre:
+Or include some tags and exclude others:
\[[!inline pages="link(debian) and !link(social)"]]
-## brug
+## usage
-Her er beskrivelser af alle de understøttede parametre til `inline`
-direktivet:
+Here are descriptions of all the supported parameters to the `inline`
+directive:
-* `pages` - Et [[PageSpec]] af siderne at indlejre.
-* `show` - Angiver det maksimale antal modsvarende sider at indlejre.
- Standard er 10, på nær arkivering, hvor standarden er at vise alle. Sæt
- til 0 for at vise alle modsvarende sider.
-* `skip` - Angiv et antal sider at springe over ved visning. Kan være
- nyttigt til at danne en fødning som kun viser akriverede sider.
-* `rss` - Styrer dannelsen af en rss-fødning. Hvis wikien er opsat til at
- danne rss feeds som standard, deaktiveres ved at angive "no". Hvis wikien
- er opsat til `allowrss`, aktiveres ved at angive "yes".
-* `atom` - Styrer dannelsen af en atom-fødning. Hvis wikien er opsat til at
- danne atom feeds som standard, deaktiveres ved at angive "no". Hvis wikien
- er opsat til `allowatom`, aktiveres ved at angive "yes".
-* `feeds` - Styrer dannelsen af alle typer af fødninger. Angiv "no" for at
- deaktivere dannelsen af fødninger.
-* `postform` - Angiv "yes" for at aktivere en formular til at indsende nye
- sider til en [[blog]].
-* `postformtext` - Angiv den tekst som skal vises i en indsendelsesformular
- (postform).
-* `rootpage` - Aktiverer også en formular til at indsende nye indlæg til en
- [[blog]], og gør det muligt at angive den overliggende side for nye sider.
-* `archive` - Hvis der angives "yes" vises kun sidetitler og nogle metadata,
- ikke det samlede indhold.
-* `quick` - Opbyg arkiver i hurtigmodus, uden at læse siderne igennem efter
- metadata. som standard deaktiverer dette også dannelsen af alle fødninger.
-* `template` - Angiver skabelonen der udfyldes ved visning af hver indlejret
- side. Som standard bruges `inlinepage`-skabelonen, mens
- `archivepage`-skabelonen bruges til arkiver. Brug denne parameter til at
- bruge en anden skabelon end normalt, for eksempel `titlepage`-skabelonen
- som kun viser indlægs titler. Bemærk at du bør angive `archive=yes` hvis
- din skabelon ikke medtager indhold.
-* `raw` - I stedet for som standard at lave en [[blog]], vil siden, når raw
- angives som "yes", inkluderes råt, uden yderligere opmærkning omkring den,
- som om den var en integreret den af kildekoden til den indlejrende side.
-* `description` - Angiver beskrivelsen til rss-fødningen hvis en dannes. Som
- standard bruges wikiens navn.
-* `actions` - Hvis den angives som "yes" tilføjes henvisninger i bunden af
- de indlejrede sider til redigering og diskussion (hvis de ville blive vist
- i toppen af siderne selv).
-* `sort` - Styrer sortering af indlejrede sider. Standarden, "age", sorterer
- sorterer nyest oprettede sider først. Angives "title" sorteres siderne
- efter titel, og "mtime" sorterer nyest redigerede sider først.
-* `reverse` - Hvis du angiver "yes", sorteres i omvendt rækkefølge.
-* `feedpages` - Et [[PageSpec]] af indlejrede sider som medtages i
- rss/atom-fødninger. Standarden er den sammen som for `pages`-værdien
- ovenfor, og kun sider som modsvarer denne værdi medtages, men nogle af
- disse kan udelades ved at angive et mere snævert [[PageSpec]] her.
-* `feedshow` - Angiver det maksimale antal modsvarende sider at medtage i
- rss/atom-fødninger. Standarden er den samme som `show`-værdien ovenfor.
-* `feedonly` - Dan kun fødninger, vis ikke sider indlejret på siden.
-* `timeformat` - Brug denne til at angive hvordan tid eller dato skal vises
- for sider i bloggen. Formatteringsstrengen videregives til strftime(3)
- funktionen.
+* `pages` - A [[PageSpec]] of the pages to inline.
+* `show` - Specify the maximum number of matching pages to inline.
+ Default is 10, unless archiving, when the default is to show all.
+ Set to 0 to show all matching pages.
+* `skip` - Specify a number of pages to skip displaying. Can be useful
+ to produce a feed that only shows archived pages.
+* `rss` - controls generation of an rss feed. If the wiki is configured to
+ generate rss feeds by default, set to "no" to disable. If the wiki is
+ configured to `allowrss`, set to "yes" to enable.
+* `atom` - controls generation of an atom feed. If the wiki is configured to
+ generate atom feeds by default, set to "no" to disable. If the wiki is
+ configured to `allowatom`, set to "yes" to enable.
+* `feeds` - controls generation of all types of feeds. Set to "no" to
+ disable generating any feeds.
+* `postform` - Set to "yes" to enables a form to post new pages to a [[blog]].
+* `postformtext` - Set to specify text that is displayed in a postform.
+* `rootpage` - Also enables a form to post new pages to a [[blog]], and
+ allows specifying of a page that is used as the parent page for new pages.
+* `archive` - If set to "yes", only list page titles and some metadata, not
+ full controls.
+* `quick` - Build archives in quick mode, without reading page contents for
+ metadata. By default, this also turns off generation of any feeds.
+* `template` - Specifies the template to fill out to display each inlined
+ page. By default the `inlinepage` template is used, while
+ the `archivepage` template is used for archives. Set this parameter to
+ use some other, custom template, such as the `titlepage` template that
+ only shows post titles. Note that you should still set `archive=yes` if
+ your custom template does not include the page content.
+* `raw` - Rather than the default behavior of creating a [[blog]],
+ if raw is set to "yes", the page will be included raw, without additional
+ markup around it, as if it were a literal part of the source of the
+ inlining page.
+* `description` - Sets the description of the rss feed if one is generated.
+ Defaults to the name of the wiki.
+* `actions` - If set to "yes" add links to the bottom of the inlined pages
+ for editing and discussion (if they would be shown at the top of the page
+ itself).
+* `sort` - Controls how inlined pages are sorted. The default, "age" is to
+ sort newest created pages first. Setting it to "title" will sort pages by
+ title, and "mtime" sorts most recently modified pages first.
+* `reverse` - If set to "yes", causes the sort order to be reversed.
+* `feedpages` - A [[PageSpec]] of inlined pages to include in the rss/atom
+ feeds. The default is the same as the `pages` value above, and only pages
+ matches by that value are included, but some of those can be excluded by
+ specifying a tighter [[PageSpec]] here.
+* `feedshow` - Specify the maximum number of matching pages to include in
+ the rss/atom feeds. The default is the same as the `show` value above.
+* `feedonly` - Only generate the feed, do not display the pages inline on
+ the page.
+* `timeformat` - Use this to specify how to display the time or date for pages
+ in the blog. The format string is passed to the strftime(3) function.
diff --git a/ikiwiki/formatting.mdwn b/ikiwiki/formatting.mdwn
index b54b3cd..29dbce1 100644
--- a/ikiwiki/formatting.mdwn
+++ b/ikiwiki/formatting.mdwn
@@ -1,30 +1,30 @@
-[[!meta title="Formattering af wiki-sider"]]
+[[!meta title="Formatting wiki pages"]]
[[!meta robots="noindex, follow"]]
-Teksten på denne wiki er, som udgangspunkt, skrevet på en måde som ligger
-tæt op ad hvordan du muligvis formulerer dig i email-beskeder. Denne
-skrivestil kaldes [[MarkDown]], og det fungerer sådan her:
+Text on this wiki is, by default, written in a form very close to how you
+might write text for an email message. This style of text formatting is
+called [[MarkDown]], and it works like this:
-hold afstand med blanke linjer mellem afsnit.
+Leave blank lines between paragraphs.
-du kan \**fremhæve*\* eller \*\***kraftigt fremhæve**\*\* tekst ved at
-placere det med enkelte eller dobbelte asterisker (stjerner) omkring.
+You can \**emphasise*\* or \*\***strongly emphasise**\*\* text by placing it
+in single or double asterisks.
-En liste oprettes ved at begynde hver linje med en asterisk:
+To create a list, start each line with an asterisk:
-* "* dette er min liste"
-* "* et andet emne"
+* "* this is my list"
+* "* another item"
-En nummereret liste laves ved at starte hver linje med et nummer (ethvert
-nummer kan bruges) efterfulgt af punktum:
+To make a numbered list, start each line with a number (any number will
+do) followed by a period:
-1. "1. første linje"
-2. "2. anden linje"
-2. "2. tredje linje"
+1. "1. first line"
+2. "2. second line"
+2. "2. third line"
-En overskrift eller en sektion er en linje med et eller flere `#`-tegn
-efterfulgt af et mellemrum og overskriftsteksten. Antallet af `#`-tegn
-styrer overskriftens størrelse:
+To create a header, start a line with one or more `#` characters followed
+by a space and the header text. The number of `#` characters controls the
+size of the header:
# # h1
## ## h2
@@ -33,65 +33,63 @@ styrer overskriftens størrelse:
##### ##### h5
###### ###### h6
-En vandret skillelinje oprettes ved at skrive tre eller flere bindestreger
-eller stjerner på en linje for sig selv.
+To create a horizontal rule, just write three or more dashes or stars on
+their own line:
----
-Citater angives ved at sætte ">" foran hver linje:
+To quote someone, prefix the quote with ">":
-> At være eller ikke være,
-> det er spørgsmålet.
+> To be or not to be,
+> that is the question.
-En kodeblok skrives ved at indrykke hver linje med eet tabulator-tegn eller
-4 mellemrum:
+To write a code block, indent each line with a tab or 4 spaces:
10 PRINT "Hello, world!"
20 GOTO 10
-Du kan henvise til en URL eller en email-adresse ved at putte addressen i
-vinkelklammer: <<http://ikiwiki.info>>, eller du kan bruge formen
-\[henvisningstekst\]\(adresse\)
+To link to an url or email address, you can just put the
+url in angle brackets: <<http://ikiwiki.info>>, or you can use the
+form \[link text\]\(url\)
----
-Udover normal html-formattering med [[MarkDown]], kan du med denne wiki
-bruge følgende ekstra finesser:
+In addition to basic html formatting using [[MarkDown]], this wiki lets
+you use the following additional features:
-* Henvise til en anden side på wikien ved at skrive sidenavnet med dobbelte
- lodrette klammer omkring. Udtrykket `\[[WikiLink]]` henviser til
- [[WikiLink]].
+* To link to another page on the wiki, place the page's name inside double
+ square brackets. So you would use `\[[WikiLink]]` to link to [[WikiLink]].
[[!if test="enabled(smiley) and smileys" then="""
-* Insætte [[smileys]] og andre anvendelige symboler. :-)
+* Insert [[smileys]] and some other useful symbols. :-)
"""]]
[[!if test="enabled(shortcut) and shortcuts" then="""
-* Bruge [[forkortelser|shortcuts]] til at henvise til gængse ressourcer.
+* Use [[shortcuts]] to link to common resources.
\[[!wikipedia War\_of\_1812]]
"""]]
[[!if test="enabled(toc)" then="""
-* Tilføje en indholdsfortegnelse til en side:
+* Add a table of contents to a page:
\[[!toc ]]
"""]]
[[!if test="enabled(meta)" then="""
-* Ændre titlen på en side:
+* Change the title of a page:
- \[[!meta title="fuldstændige sidetitel"]]
+ \[[!meta title="full page title"]]
"""]]
[[!if test="enabled(inline) and blog" then="""
-* Oprette en [[blog]] ved at indlejre et udvalg ad sider:
+* Create a [[blog]] by inlining a set of pages:
\[[!inline pages="blog/*"]]
"""]]
[[!if test="enabled(template) and templates" then="""
-* Oprette og udfylde [[skabeloner|templates]] for gentagne klumper af
- parameteriseret wikitekst.
+* Create and fill out [[templates]] for repeated chunks of
+ parameterized wiki text.
"""]]
diff --git a/ikiwiki/markdown.mdwn b/ikiwiki/markdown.mdwn
index 96a0ed0..bbda9ad 100644
--- a/ikiwiki/markdown.mdwn
+++ b/ikiwiki/markdown.mdwn
@@ -1,14 +1,13 @@
[[!meta robots="noindex, follow"]]
-[Markdown](http://daringfireball.net/projects/markdown/) er et minimalt
-opmærkningssprog som afspejler simpel tekst som det bruges i
-email-beskeder. Det er standard opmærkningssprog for denne wiki.
+[Markdown](http://daringfireball.net/projects/markdown/)
+is a minimal markup language that resembles plain text as used in
+email messages. It is the markup language used by this wiki by default.
-Du kan læse dokumentation til markdown-syntaksen under
-[[formattering|formatting]] og [Markdown:
-syntax](http://daringfireball.net/projects/markdown/syntax). En [markdown
-modus](http://jblevins.org/projects/markdown-mode/) til emacs kan være en
-hjælp ved redigering.
+For documentation about the markdown syntax, see [[formatting]] and
+[Markdown: syntax](http://daringfireball.net/projects/markdown/syntax). A
+[markdown mode](http://jblevins.org/projects/markdown-mode/) for
+emacs can help in editing.
-Bemærk at [[WikiLink]]s og [[PreProcessorDirective]]s ikke er en del af
-markdown-syntaksen, og er de eneste stumper opmærkning som denne wiki
-håndterer internt.
+Note that [[WikiLink]]s and [[PreProcessorDirective]]s are not part of the
+markdown syntax, and are the only bit of markup that this wiki handles
+internally.
diff --git a/ikiwiki/openid.mdwn b/ikiwiki/openid.mdwn
index d4bb9b6..dd851e5 100644
--- a/ikiwiki/openid.mdwn
+++ b/ikiwiki/openid.mdwn
@@ -2,36 +2,33 @@
[[!meta robots="noindex, follow"]]
[[!if test="enabled(openid)"
- then="Denne wiki har OpenID **aktiveret**."
- else="Denne wiki har OpenID **deaktiveret**."]]
+ then="This wiki has OpenID **enabled**."
+ else="This wiki has OpenID **disabled**."]]
-[OpenID](http://openid.net) er en decentral autorisationsmekanisme som
-tillader dig at have eet login som du kan bruge på et voksende antal
+[OpenID](http://openid.net) is a decentralized authentication mechanism
+that allows you to have one login that you can use on a growing number of
websites.
-Du kan registrere en OpenID ved at besøge en af de følgende
-identitetsudbydere:
+To sign up for an OpenID, visit one of the following identity providers:
* [MyOpenID](https://www.myopenid.com/)
* [GetOpenID](https://getopenid.com/)
* [Videntity](http://videntity.org/)
* [LiveJournal](http://www.livejournal.com/openid/)
* [TrustBearer](https://openid.trustbearer.com/)
-* eller en af de [mange andre
- derude](http://openiddirectory.com/openid-providers-c-1.html).
+* or any of the [many others out there](http://openiddirectory.com/openid-providers-c-1.html).
-Din OpenID er en URL som du får når du registerer dig.
+Your OpenID is the URL that you are given when you sign up.
[[!if test="enabled(openid)" then="""
-Du kan logge på denne wiki medOpenID, ved blot at angive den i OpenID-feltet på
-login-siden. Du behøves ikke at oplyse din adgangskode til denne wiki eller at
-gennemgå en registreringsproces når du bruger OpenID.
+To sign in to this wiki using OpenID, just enter it in the OpenID field in the
+signin form. You do not need to give this wiki a password or go through any
+registration process when using OpenID.
"""]]
---
-Det er også muligt at lave en side i wikien brugbar som en OpenID URL, ved
-at delegere den til en openid server. Her er et eksempel på hvordan det kan
-gøres:
+It's also possible to make a page in the wiki usable as an OpenID url,
+by delegating it to an openid server. Here's an example of how to do that:
\[[!meta openid="http://yourid.myopenid.com/"
server="http://www.myopenid.com/server"]]
diff --git a/ikiwiki/pagespec.mdwn b/ikiwiki/pagespec.mdwn
index 56d9d08..156e3f6 100644
--- a/ikiwiki/pagespec.mdwn
+++ b/ikiwiki/pagespec.mdwn
@@ -1,84 +1,85 @@
[[!meta robots="noindex, follow"]]
-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.
+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
-enhver 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.
-* "`title(glob)`", "`author(glob)`", "`authorurl(glob)`", "`license(glob)`",
- "`copyright(glob)`" - modsvarer sider med de givne metadata, som modsvarer
- det angivne glob.
-
-For eksempelvis at modsvare alle sider i en blog som henviser til en side om
-musik og som blev skrevet i 2005:
-
- blog/* and link(musik) 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.
-
-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:
+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)`" - match pages that have the given
+ metadata, matching the specified glob.
+
+For example, to match all pages in a blog that link to the page about music
+and were written in 2005:
+
+ blog/* and link(music) and creation_year(2005)
+
+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.
+
+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.
diff --git a/ikiwiki/preprocessordirective.mdwn b/ikiwiki/preprocessordirective.mdwn
index 8fe073d..743c0d9 100644
--- a/ikiwiki/preprocessordirective.mdwn
+++ b/ikiwiki/preprocessordirective.mdwn
@@ -1,25 +1,26 @@
[[!meta robots="noindex, follow"]]
-Preprocessor-direktiver ligner et [[WikiLink]] i form, på nær at de begynder
-med `!` og kan indeholde parametre. Generelt er formen:
+Preprocessor directives are similar to a [[WikiLink]] in form, except they
+begin with `!` and may contain parameters. The general form is:
- \[[!directive param="værdi" param="værdi"]]
+ \[[!directive param="value" param="value"]]
-Dette udvides før resten af siden udarbejdes, og kan bruges til at omforme
-siden på forskellige måder.
+This gets expanded before the rest of the page is processed, and can be used
+to transform the page in various ways.
-Citationen omkring værdier kan udelades hvis værdien er et simpelt
-ord. Desuden kan nogle direktiver bruge parametre uden værdier. Eksempel:
+The quotes around values can be omitted if the value is a simple word.
+Also, some directives may use parameters without values, for example:
\[[!tag foo]]
-Et preprocessor-directiv behøves ikke at holdes på een linje, det kan godt
-brede sig over flere linjer hvis du har lyst:
+A preprocessor directive does not need to all be on one line, it can be
+wrapped to multiple lines if you like:
\[[!directive foo="baldersnatch"
bar="supercalifragalisticexpealadocious" baz=11]]
-Flere linjer *citeret* tekst kan også bruges som værdi. For at tillade
-citation i den citerede tekst skal du adskille blokken med trippel-citat:
+Also, multiple lines of *quoted* text can be used for a value.
+To allow quote marks inside the quoted text, delimit the block
+of text with triple-quotes:
\[[!directive text="""
1. "foo"
@@ -27,12 +28,12 @@ citation i den citerede tekst skal du adskille blokken med trippel-citat:
3. "baz"
"""]]
-Ikiwiki har også en ældre syntaks til preprocessordirektiver, som kræver et
-mellemrum i direktiver for at skelne dem fra [[wikilinks|wikilink]]. Denne
-syntaks har flere ulemper: den kræver et mellemrum efter direktiver uden
-parametre (såsom `\[[pagecount ]]`), og den forbyder mellemrum i
-[[wikilinks|wikilink]]. Ikiwiki har nu den `!`-foranstillede syntaks vist
-ovenfor som det foretrukne alternativ. Ikiwiki understøtter dog fortsat den
-ældre syntaks, hvis ikke `prefix_directives`-valget er aktiveret. For
-bagudkompatibilitet med eksisterende er dette valg som standard deaktiveret
-i øjeblikket, så ikiwiki understøtter den ældre syntaks.
+ikiwiki also has an older syntax for preprocessor directives, which requires a
+space in directives to distinguish them from [[wikilinks|wikilink]]. This
+syntax has several disadvantages: it requires a space after directives with no
+parameters (such as `\[[pagecount ]]`), and it prohibits spaces in
+[[wikilinks|wikilink]]. ikiwiki now provides the `!`-prefixed syntax shown
+above as the preferred alternative. However, ikiwiki still supports wikis
+using the older syntax, if the `prefix_directives` option is not enabled.
+For backward compatibility with existing wikis, this option currently
+defaults to off, so ikiwiki supports the old syntax.
diff --git a/ikiwiki/subpage.mdwn b/ikiwiki/subpage.mdwn
index 186f734..e047b86 100644
--- a/ikiwiki/subpage.mdwn
+++ b/ikiwiki/subpage.mdwn
@@ -1,14 +1,12 @@
[[!meta robots="noindex, follow"]]
-ikiwiki understøtter placering af sider i et mappehierarki. Eksempelvis har
-denne side, [[UnderSide|SubPage]], nogle relaterede sider placeret under
-sig, bl.a. [[HenvisningsRegler|SubPage/LinkingRules]]. dette er en praktisk
-måde at bringe orden i din wiki fremfor blot at have een stor mappe fuld af
-sider.
+ikiwiki supports placing pages in a directory hierarchy. For example,
+this page, [[SubPage]] has some related pages placed under it, like
+[[SubPage/LinkingRules]]. This is a useful way to add some order to your
+wiki rather than just having a great big directory full of pages.
-En [[UnderSide|SubPage]] oprettes ved blot at oprette undermappen og tilføje
-sider til den. Denne side er eksempelvis SubPage.mdwn i kildekoden til denne
-wiki, og der er også en SubPage undermappe, som indeholder
-SubPage/LinkingRules.mdwn. Undersider kan nedarves så dybt du har lyst.
+To add a SubPage, just make a subdirectory and put pages in it. For
+example, this page is SubPage.mdwn in this wiki's source, and there is also
+a SubPage subdirectory, which contains SubPage/LinkingRules.mdwn. Subpages
+can be nested as deeply as you'd like.
-Henvisninger til og fra en [[UnderSide||SubPage]] er forklaret under
-[[HenvisningsRegler||LinkingRules]].
+Linking to and from a SubPage is explained in [[LinkingRules]].
diff --git a/ikiwiki/subpage/linkingrules.mdwn b/ikiwiki/subpage/linkingrules.mdwn
index d3be5aa..e547f30 100644
--- a/ikiwiki/subpage/linkingrules.mdwn
+++ b/ikiwiki/subpage/linkingrules.mdwn
@@ -1,36 +1,33 @@
[[!meta robots="noindex, follow"]]
-For at henvise til eller fra en [[underside|SubPage]] kan du normalt bruge
-en almindelig normal [[WikiLink]] som ikke indeholder navnet på den
-overliggende mappe til [[undersiden|SubPage]]. Ikiwiki gennemgår
-mappehierarkiet og kigger efter en side som modsvarer din henvisning.
+To link to or from a [[SubPage]], you can normally use a regular
+[[WikiLink]] that does not contain the name of the parent directory of
+the [[SubPage]]. Ikiwiki descends the directory hierarchy looking for a
+page that matches your link.
-Hvis eksempelvis FooBar/UnderSide henviser til "EnAndenSide", vil ikiwiki
-først foretrække at knytte henvisningen til FooBar/UnderSide/EnAndenSide
-hvis den eksisterer, så til FooBar/EnAndenSide og til sidst til EnAndenSide
-i roden af wikien.
+For example, if FooBar/SubPage links to "OtherPage", ikiwiki will first
+prefer pointing the link to FooBar/SubPage/OtherPage if it exists, next
+to FooBar/OtherPage and finally to OtherPage in the root of the wiki.
-Bemærk at dette betyder, at hvis en henvisning fra FooBar/EnSide til
-"EnAndenSide" i øjeblikket henviser til EnAndenSide i roden af wikien, og
-FooBar/EnAndenSide oprettes, så vil henvisningen blive _ændret_ til at pege
-på FooBar/EnAndenSide. Omvendt vil en henvisning fra BazBar til
-"EnAndenSide" ikke blive berørt af oprettelsen af en [[underside|SubPage]]
-til FooBar.
+Note that this means that if a link on FooBar/SomePage to "OtherPage"
+currently links to OtherPage, in the root of the wiki, and FooBar/OtherPage
+is created, the link will _change_ to point to FooBar/OtherPage. On the
+other hand, a link from BazBar to "OtherPage" would be unchanged by this
+creation of a [[SubPage]] of FooBar.
-Du kan også angive en henvisning som indeholder et mappenavn, lissom
-"FooBar/EnAndenSide", for mere nøjagtigt at angive hvilken side der henvises
-til. Kun på den måde kan du henvise til en anden sides
-[[underside|SubPage]].
+You can also specify a link that contains a directory name, like
+"FooBar/OtherPage" to more exactly specify what page to link to. This is
+the only way to link to an unrelated [[SubPage]].
-Du kan bruge dette til eksempelvis at henvise fra BazBar til
-"FooBar/UnderSide", eller fra BazBar/UnderSide til "FooBar/UnderSide".
+You can use this to, for example, to link from BazBar to "FooBar/SubPage",
+or from BazBar/SubPage to "FooBar/SubPage".
-Du kan også bruge "/" i begyndelsen af en henvisning, til at angive
-nøjagtigt hvilken side der henvises til, når der er flere mulige sider med
-lignende navne og henvisningen ender forkert som standard. Eksempelvis vil
-en henvisning fra "FooBar/UnderSide" til "/EnAndenSide" henvise til
-"EnAndenSide" i roden af wikien, selvom der er en "FooBar/EnAndenSide".
+You can also use "/" at the start of a link, to specify exactly which page
+to link to, when there are multiple pages with similar names and the link
+goes to the wrong page by default. For example, linking from
+"FooBar/SubPage" to "/OtherPage" will link to the "OtherPage" in the root
+of the wiki, even if there is a "FooBar/OtherPage".
-Desuden kan du, hvis wikien er opsat med "userdir", henvise til sider under
-hjemmemapper uden at angive en sti til dem. Dette er for at tillade enkel
-henvisning til en brugers side i hjemmemappen, som signatur ved en
-kommentar. Sådanne henvisninger prøves allersidst.
+Also, if the wiki is configured with a userdir, you can link to pages
+within the userdir without specifying a path to them. This is to allow for
+easy linking to a user's page in the userdir, to sign a comment. These
+links are checked for last of all.
diff --git a/ikiwiki/wikilink.mdwn b/ikiwiki/wikilink.mdwn
index 12ad9d4..bd5e3d1 100644
--- a/ikiwiki/wikilink.mdwn
+++ b/ikiwiki/wikilink.mdwn
@@ -1,35 +1,36 @@
[[!meta robots="noindex, follow"]]
-WikiLinks gør det muligt enkelt at lave henvisninger (linke) mellem sider i
-wikien. Opret en [[WikiLink]] ved at skrive siden du vil henvise til med
-dobbelte klammer omkring. Ekempelvis `\[[WikiLink]]`.
+WikiLinks provide easy linking between pages of the wiki. To create a
+[[WikiLink]], just put the name of the page to link to in double brackets.
+For example `\[[WikiLink]]`.
-Hvis du vil skrive noget i stil med `\[[WikiLink]]` uden at det skal blive
-til en wikilink, så put en `\` (backslash) foran, som i `\\[[WikiLink]]`.
+If you ever need to write something like `\[[WikiLink]]` without creating a
+wikilink, just prefix it with a `\`, like `\\[[WikiLink]]`.
-Specielle [[henvisningsregler|SubPage/LinkingRules]] træder i kraft når der
-henvises på tværs af [[undersider|SubPage]].
+There are some special [[SubPage/LinkingRules]] that come into play when
+linking between [[SubPages|SubPage]].
-Desuden, hvis filen der henvises til med en WikiLink ligner et billede, vil
-det blive vist indlejret i siden.
+Also, if the file linked to by a WikiLink looks like an image, it will
+be displayed inline on the page.
-WikiLinks knyttes til sidenavne uden skelen til store og små bogstaver, så
-du behøver ikke at bekymre dig om dette, og kan anvende stort
-begyndelsesbogstav i begyndelsen af en sætning o.l.
+WikiLinks are matched with page names in a case-insensitive manner, so you
+don't need to worry about getting the case the same, and can capitalise
+links at the start of a sentence, and so on.
-Det er også muligt at skrive en WikiLink som bruger noget andet end
-sidenavnet som henvisningstekst. Eksempelvis henviser `\[[foo_bar|SandBox]]`
-til sandkassen, men henvisningen fremstår som her: [[foo_bar|SandBox]].
+It's also possible to write a WikiLink that uses something other than the page
+name as the link text. For example `\[[foo_bar|SandBox]]` links to the SandBox
+page, but the link will appear like this: [[foo_bar|SandBox]].
-For at henvise til et anker inde på en side, kan du bruge noget i stil med
+To link to an anchor inside a page, you can use something like
`\[[WikiLink#foo]]`
-## Preprocessordirektiver og wikilinks
-
-ikiwiki har to syntakser til
-[[preprocessordirektiver|PreprocessorDirective]]. Den ældre syntaks brugte
-mellemrum til at skelne mellem preprocessordirektiver og wikilinks; met det
-result, at når den syntaks anvendes kan du ikke bruge mellemrum i WikiLinks,
-og må erstatte mellemrum med understregning. Den nyere syntaks, aktiveret
-med valget `prefix_directives` i en ikiwiki opsætningsfil, sætter `!` foran
-direktiver, og forhindrer derfor ikke henvisninger med mellemrum. Fremtidige
-versioner af ikiwiki vil aktivere dette valg som standard.
+## Preprocessor directives and wikilinks
+
+ikiwiki has two syntaxes for
+[[preprocessor_directives|PreprocessorDirective]]. The older syntax
+used spaces to distinguish between preprocessor directives and
+wikilinks; as a result, with that syntax in use, you cannot use spaces
+in WikiLinks, and must replace spaces with underscores. The newer
+syntax, enabled with the `prefix_directives` option in an ikiwiki
+setup file, prefixes directives with `!`, and thus does not prevent
+links with spaces. Future versions of ikiwiki will turn this option
+on by default.