summaryrefslogtreecommitdiff
path: root/ikiwiki
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki')
-rw-r--r--ikiwiki/blog.mdwn111
-rw-r--r--ikiwiki/directive.mdwn51
-rw-r--r--ikiwiki/formatting.mdwn92
-rw-r--r--ikiwiki/markdown.mdwn21
-rw-r--r--ikiwiki/openid.mdwn29
-rw-r--r--ikiwiki/pagespec.mdwn135
-rw-r--r--ikiwiki/pagespec/attachment.mdwn66
-rw-r--r--ikiwiki/preprocessordirective.mdwn7
-rw-r--r--ikiwiki/searching.mdwn31
-rw-r--r--ikiwiki/subpage.mdwn20
-rw-r--r--ikiwiki/subpage/linkingrules.mdwn55
-rw-r--r--ikiwiki/wikilink.mdwn52
12 files changed, 278 insertions, 392 deletions
diff --git a/ikiwiki/blog.mdwn b/ikiwiki/blog.mdwn
index 505c72c..0a5a524 100644
--- a/ikiwiki/blog.mdwn
+++ b/ikiwiki/blog.mdwn
@@ -1,109 +1,8 @@
[[!meta robots="noindex, follow"]]
-[[!if test="enabled(inline)"
- then="Denne wiki har inline plugin **aktiveret**."
- else="Denne wiki har inline plugin **deaktiveret**."]]
-[[!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
-[[direktivet|directive]] `inline`. Som eksempel:
+This page has been removed from ikiwiki's basewiki. For documentation about
+creating a blog with ikiwiki, see the documentation of the
+[[!iki ikiwiki/directive/inline desc=inline]] directive.
- \[[!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.
-
-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.
-
-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:
-
- \[[!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:
-
- \[[!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:
-
- \[[!inline pages="link(life)"]]
-
-Eller medtag nogle mærkater og udelad andre:
-
- \[[!inline pages="link(debian) and !link(social)"]]
-
-## brug
-
-Der er mange parametre du kan bruge med `inline`-direktivet. Disse er de
-oftest brugte:
-
-* `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.
-* `archive` - Hvis "yes" er angivet, så vis kun sidetitler og nogle
- metadata, ikke det samlede indhold.
-* `description` - Angiver beskrivelsen til rss-fødningen hvis en dannes. Som
- standard bruges wikiens navn.
-* `skip` - Angiv et antal sider at springe over ved visning. Kan være
- nyttigt til at danne en fødning som kun viser arkiverede sider.
-* `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 indsendelsesformularen (postform) og gør det muligt
- at styre hvor nye indlæg ender, ved at angive siden som de skal være en
- [[UnderSide|subpage]] af.
-
-Her er nogle parametre der ikke så tit er nødvendige at bruge:
-
-* `actions` - Hvis angivet som "yes" tilføjes henvisninger nedenfor de
- indlejrede sider til redigering og diskussion (hvis de ville blive vist
- foroven på selve siden).
-* `rss` - Styrer dannelse af en rss-fødning. Hvis wikien er opsat til at
- danne rss-fødninger som standard, deaktiveres ved at angive "no". Hvis
- wikien er opsat til `allowrss`, aktiveres ved at angive "yes".
-* `atom` - Styrer dannelse af en atom-fødning. Hvis wikien er opsat til at
- danne atom-fødninger som standard, deaktiveres ved at angive "no". Hvis
- wikien er opsat til `allowatom`, aktiveres ved at angive "yes".
-* `feeds` - Styrer dannelse af alle typer af fødninger. Angiv "no" for at
- deaktivere dannelse af nogen 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 stadigt bør angive
- `archive=yes` hvis din skabelon ikke medtager sideindholdet.
-* `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.
-* `sort` - Styrer hvordan indlejrede sider sorteres. Standarden, "age",
- 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.
-* `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 siderne indlejret på siden.
-* `quick` - Opbyg arkiver i hurtigmodus, uden at læse siderne igennem efter
- metadata. som standard deaktiverer dette også dannelse af alle fødninger.
-* `timeformat` - Brug denne til at angive hvordan tiden eller datoen vises
- for sider i bloggen. Formateringsstrengen videregives til funktionen
- strftime(3).
-* `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 dén værdi medtages, men nogle af dem kan udelades
- ved at angive et mere snævert [[PageSpec]] her.
-* `guid` - Hvis en URI er angivet her (måske en UUID med `urn:uuid:` foran),
- vil Atom-fødningerne have dette som dets `<id>`. Standarden er at bruge
- URLen for siden som indeholder `inline`-direktivet.
+Please update your links, as this redirection page will be removed in a
+future ikiwiki release.
diff --git a/ikiwiki/directive.mdwn b/ikiwiki/directive.mdwn
index b2c3be0..c4342de 100644
--- a/ikiwiki/directive.mdwn
+++ b/ikiwiki/directive.mdwn
@@ -1,38 +1,45 @@
[[!meta robots="noindex, follow"]]
-Direktiver ligner et [[WikiLink]] i form, undtagen at de begynder med `!` og
-kan indeholde parametre. Generelt er formen:
+Directives are similar to a [[ikiwiki/WikiLink]] in form, except they
+begin with `!` and may contain parameters. The general form is:
- \[[!direktiv 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 direktiv behøver ikke at blive holdt på een linje, det kan bredes ud over
-flere linjer hvis du har lyst:
+A directive does not need to all be on one line, it can be
+wrapped to multiple lines if you like:
- \[[!direktiv foo="baldersnatch"
+ \[[!directive foo="baldersnatch"
bar="supercalifragilisticexpialidocious" 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:
- \[[!direktiv tekst="""
+ \[[!directive text="""
1. "foo"
2. "bar"
3. "baz"
"""]]
-Ikiwiki har også en ældre syntaks til direktiver, 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 wikier er dette valg som standard
-deaktiveret i øjeblikket, så ikiwiki understøtter den ældre syntaks.
+ikiwiki also has an older syntax for directives, which requires a
+space in directives to distinguish them from [[wikilinks|ikiwiki/wikilink]].
+This syntax has several disadvantages: it requires a space after directives
+with no parameters (such as `\[[pagecount ]]`), and it prohibits spaces in
+[[wikilinks|ikiwiki/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.
+
+[[!if test="enabled(listdirectives)" then="""
+Here is a list of currently available directives in this wiki:
+
+[[!listdirectives ]]
+"""]]
diff --git a/ikiwiki/formatting.mdwn b/ikiwiki/formatting.mdwn
index 0ba4d78..2ed5cc2 100644
--- a/ikiwiki/formatting.mdwn
+++ b/ikiwiki/formatting.mdwn
@@ -1,30 +1,30 @@
-[[!meta title="Formatering af wikisider"]]
+[[!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 form
-for tekstformatering 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,76 +33,74 @@ 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-formatering 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="""
-* Indsætte [[smileys]] og andre anvendelige symboler. :-)
+* Insert [[smileys]] and some other useful symbols. :-)
"""]]
[[!if test="enabled(shortcut) and shortcuts" then="""
-* Bruge [[genveje|shortcuts]] til at henvise til gængse ressourcer.
+* Use [[shortcuts]] to link to common resources.
\[[!wikipedia War\_of\_1812]]
"""]]
[[!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.
"""]]
-* Insæt diverse [[directiver|directive]] på en side til at udføre nyttige
- handlinger.
-[[!if test="enabled(toc) or enabled(meta) or (enabled(inline) and blog)" then="""
- Eksempelvis kan du:
+* Insert various [[directives|directive]] onto a page to perform useful
+ actions.
+[[!if test="enabled(toc) or enabled(meta) or enabled(inline)" then="""
+ For example, you can:
"""]]
[[!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 af sider:
+[[!if test="enabled(inline)" then="""
+ * Create a blog by inlining a set of pages:
\[[!inline pages="blog/*"]]
"""]]
[[!if test="enabled(listdirectives)" then="""
- Komplet oversigt over [[directiver|directive]] aktiveret for denne wiki:
+ Full list of [[directives|directive]] enabled for this wiki:
[[!listdirectives ]]
"""]]
diff --git a/ikiwiki/markdown.mdwn b/ikiwiki/markdown.mdwn
index 087b274..a419094 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
-[[formatering|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 [[WikiLinks|WikiLink]] og [[direktiver|directive]] ikke er en del
-af markdown-syntaksen, og er de eneste stumper opmærkning som denne wiki
-håndterer internt.
+Note that [[WikiLinks|WikiLink]] and [[directives|directive]] 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 ee84bea..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 ægthedsmekanisme som giver dig
-mulighed for at have eet login som du kan bruge på et voksende antal
-websteder.
+[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 den URL som du får når du registrerer 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 med OpenID, 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..c78666c 100644
--- a/ikiwiki/pagespec.mdwn
+++ b/ikiwiki/pagespec.mdwn
@@ -1,84 +1,91 @@
[[!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 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.
+* "`user(username)`" - tests whether a modification is being made by a
+ user with the specified username. If openid is enabled, an openid can also
+ be put here.
+* "`admin()`" - tests whether a modification is being made by one of the
+ wiki admins.
+* "`ip(address)`" - tests whether a modification is being made from the
+ specified IP address.
+
+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/pagespec/attachment.mdwn b/ikiwiki/pagespec/attachment.mdwn
index 061612f..2d33db7 100644
--- a/ikiwiki/pagespec/attachment.mdwn
+++ b/ikiwiki/pagespec/attachment.mdwn
@@ -1,55 +1,37 @@
[[!meta robots="noindex, follow"]]
[[!if test="enabled(attachment)"
- then="Denne wiki har vedhæftninger **aktiveret**."
- else="Denne wiki har vedhæftninger **deaktiveret**."]]
+ then="This wiki has attachments **enabled**."
+ else="This wiki has attachments **disabled**."]]
-Hvis vedhæftninger er aktiveret, kan wiki-administratoren styre hvilke typer
-vedhæftninger der vil blive accepteret gennem opsætningsindstillingen
-`allowed_attachments`.
+If attachments are enabled, the wiki admin can control what types of
+attachments will be accepted, via the `allowed_attachments`
+configuration setting.
-Som eksempel, for at begrænse vilkårlige filer til 50 kilobytes, men tillade
-større mp3-filer at blive lagt op af joey til en bestemt mappe, og checke
-alle vedhæftninger for vira, kunne noget i stil med dette bruges:
+For example, to limit arbitrary files to 50 kilobytes, but allow
+larger mp3 files to be uploaded by joey into a specific directory, and
+check all attachments for virii, something like this could be used:
virusfree() and ((user(joey) and podcast/*.mp3 and mimetype(audio/mpeg) and maxsize(15mb)) or (!ispage() and maxsize(50kb)))
-Den normale [[ikiwiki/PageSpec]]-syntaks er udvidet med følgende yderligere
-tests:
+The regular [[ikiwiki/PageSpec]] syntax is expanded with the following
+additional tests:
-* maxsize(størrelse)
-
- Tester hvorvidt vedhæftningen højst fylder er den angivne størrelse.
- Størrelsen angives som standard i bytes, men "kb", "mb", "gb" osv. kan bruges
- til at angive enheder.
+* "`maxsize(size)`" - Tests whether the attachment is no larger than the
+ specified size. The size defaults to being in bytes, but "kb", "mb", "gb"
+ etc can be used to specify the units.
-* minsize(størrelse)
-
- Tester hvorvidt størrelsen mindst fylder den angivne størrelse.
-
-* ispage()
-
- Tester hvorvidt vedhæftningen vil blive håndteret af ikiwiki som en wikiside.
- (altså om det har endelsen ".mdwn", eller ethvert andet aktiveret
- sideformat).
-
- Derfor, hvis du ikke vil tillade wikisider at blive lagt op som vedhæftninger,
- så brug `!ispage()` ; hvis du kun vil tillade wikisider at blive lagt op som
- vedhæftninger, så brug `ispage()`.
-
-* user(brugernavn)
-
- Tester hvorvidt vedhæftningen bliver lagt op af en bruger med det angivne
- brugernavn. Hvis openid er aktiveret, kan en openid også bruges her.
-
-* ip(adresse)
-
- Tester hvorvidt vedhæftningen bliver lagt op fra den angivne IP-adresse.
+* "`minsize(size)`" - Tests whether the attachment is no smaller than the
+ specified size.
-* mimetype(foo/bar)
+* "`ispage()`" - Tests whether the attachment will be treated by ikiwiki as a
+ wiki page. (Ie, if it has an extension of ".mdwn", or of any other enabled
+ page format).
- Dette checker MIME-typen for vedhæftningen. Du kan angive et glob som type,
- eksampelvis `mimetype(image/*)`.
+ So, if you don't want to allow wiki pages to be uploaded as attachments,
+ use `!ispage()` ; if you only want to allow wiki pages to be uploaded
+ as attachments, use `ispage()`.
-* virusfree()
+* "`mimetype(foo/bar)`" - This checks the MIME type of the attachment. You can
+ include a glob in the type, for example `mimetype(image/*)`.
- Checker vedhæftningen med et antivirusprogram.
+* "`virusfree()`" - Checks the attachment with an antiviral program.
diff --git a/ikiwiki/preprocessordirective.mdwn b/ikiwiki/preprocessordirective.mdwn
index 57f46c8..bd12895 100644
--- a/ikiwiki/preprocessordirective.mdwn
+++ b/ikiwiki/preprocessordirective.mdwn
@@ -1,6 +1,7 @@
[[!meta redir=ikiwiki/directive delay=10]]
[[!meta robots="noindex, follow"]]
-Denne side er flyttet til [[ikiwiki/directive|ikiwiki/directive]]. Opdatér
-dine henvisninger, da denne omdirigeringsside bliver fjernet i en fremtidig
-udgave af ikiwiki.
+This page has moved to
+[[ikiwiki/directive|ikiwiki/directive]]. Please
+update your links, as this redirection page will be removed in a future
+ikiwiki release.
diff --git a/ikiwiki/searching.mdwn b/ikiwiki/searching.mdwn
index 24ee343..539e719 100644
--- a/ikiwiki/searching.mdwn
+++ b/ikiwiki/searching.mdwn
@@ -1,21 +1,20 @@
[[!meta robots="noindex, follow"]]
[[!if test="enabled(search)"
-then="Denne wiki har søgning **aktiveret**."
-else="Denne wiki har søgning **deaktiveret**."]]
+then="This wiki has searching **enabled**."
+else="This wiki has searching **disabled**."]]
-Hvis søgning er aktiveret, kan du angive søgeudtryk i søgefeltet, som du
-ville forvente. Der er et par specielle ting du kan gøre for at konstruere
-mere effektive søgninger.
+If searching is enabled, you can enter search terms in the search field,
+as you'd expect. There are a few special things you can do to constuct
+more powerful searches.
-* Put gåseøjne omkring nogle ord for at søge efter dem som én formulering.
-* `AND` kan bruges til at søge efter dokumenter som indeholder to udtryk.
-* `OR` kan bruges ti at søge efter dokumenter som indeholder ethvert af to
- udtryk.
-* Parenteser kan bruges til at opbygge komplicerede
- søgeformuleringer. Eksempelvis "(foo AND bar) OR (mig AND dig)"
-* Put "-" foran et søgeudtryk for at undgå det blandt
- resultaterne. Eksempelvis vil "-discussion" udelade "discussion".
-* Brug "title:foo" til at søge efter en side med en given titel.
-* Brug "link:bar" til at søge efter sider som indeholder henvisning til
- "bar".
+* To match a phrase, enclose it in double quotes.
+* `AND` can be used to search for documents containing two expressions.
+* `OR` can be used to search for documents containing either one of
+ two expressions.
+* Parentheses can be used to build up complicated search expressions. For
+ example, "(foo AND bar) OR (me AND you)"
+* Prefix a search term with "-" to avoid it from appearing in the results.
+ For example, "-discussion" will omit "discussion".
+* To search for a page with a given title, use "title:foo".
+* To search for pages that contain a "bar" link, use "link:bar".
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 80c29ac..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 ea93116..371c252 100644
--- a/ikiwiki/wikilink.mdwn
+++ b/ikiwiki/wikilink.mdwn
@@ -1,34 +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]]`
-## Direktiver og wikilinks
-
-ikiwiki har to syntakser til [[direktiver|directive]]. Den ældre syntaks
-brugte mellemrum til at skelne mellem direktiver og wikilinks; det medfører,
-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.
+## Directives and WikiLinks
+
+ikiwiki has two syntaxes for
+[[directives|directive]]. The older syntax
+used spaces to distinguish between 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.