diff options
Diffstat (limited to 'ikiwiki')
| -rw-r--r-- | ikiwiki/blog.mdwn | 111 | ||||
| -rw-r--r-- | ikiwiki/directive.mdwn | 51 | ||||
| -rw-r--r-- | ikiwiki/formatting.mdwn | 92 | ||||
| -rw-r--r-- | ikiwiki/markdown.mdwn | 21 | ||||
| -rw-r--r-- | ikiwiki/openid.mdwn | 29 | ||||
| -rw-r--r-- | ikiwiki/pagespec.mdwn | 135 | ||||
| -rw-r--r-- | ikiwiki/pagespec/attachment.mdwn | 66 | ||||
| -rw-r--r-- | ikiwiki/preprocessordirective.mdwn | 7 | ||||
| -rw-r--r-- | ikiwiki/searching.mdwn | 31 | ||||
| -rw-r--r-- | ikiwiki/subpage.mdwn | 20 | ||||
| -rw-r--r-- | ikiwiki/subpage/linkingrules.mdwn | 55 | ||||
| -rw-r--r-- | ikiwiki/wikilink.mdwn | 52 |
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. |