diff options
Diffstat (limited to 'ikiwiki')
| -rw-r--r-- | ikiwiki/blog.mdwn | 156 | ||||
| -rw-r--r-- | ikiwiki/formatting.mdwn | 80 | ||||
| -rw-r--r-- | ikiwiki/markdown.mdwn | 21 | ||||
| -rw-r--r-- | ikiwiki/openid.mdwn | 27 | ||||
| -rw-r--r-- | ikiwiki/pagespec.mdwn | 129 | ||||
| -rw-r--r-- | ikiwiki/preprocessordirective.mdwn | 41 | ||||
| -rw-r--r-- | ikiwiki/subpage.mdwn | 20 | ||||
| -rw-r--r-- | ikiwiki/subpage/linkingrules.mdwn | 55 | ||||
| -rw-r--r-- | ikiwiki/wikilink.mdwn | 53 |
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. |