diff options
Diffstat (limited to 'ikiwiki')
| -rw-r--r-- | ikiwiki/blog.mdwn | 166 | ||||
| -rw-r--r-- | ikiwiki/formatting.mdwn | 94 | ||||
| -rw-r--r-- | ikiwiki/markdown.mdwn | 21 | ||||
| -rw-r--r-- | ikiwiki/openid.mdwn | 36 | ||||
| -rw-r--r-- | ikiwiki/pagespec.mdwn | 118 | ||||
| -rw-r--r-- | ikiwiki/preprocessordirective.mdwn | 45 | ||||
| -rw-r--r-- | ikiwiki/subpage.mdwn | 20 | ||||
| -rw-r--r-- | ikiwiki/subpage/linkingrules.mdwn | 54 | ||||
| -rw-r--r-- | ikiwiki/wikilink.mdwn | 47 |
9 files changed, 313 insertions, 288 deletions
diff --git a/ikiwiki/blog.mdwn b/ikiwiki/blog.mdwn index b05afac..f1293ec 100644 --- a/ikiwiki/blog.mdwn +++ b/ikiwiki/blog.mdwn @@ -1,96 +1,100 @@ -[[if test="enabled(inline)" - then="Denne wiki har inline plugin **aktiveret**." - else="Denne wiki har inline plugin **deaktiveret**."]] +[[!meta robots="noindex, follow"]] +[[!if test="enabled(inline)" + 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: +[[!if test="enabled(inline)" + 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"]] + \[[!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"]] + \[[!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"]] + \[[!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)"]] + \[[!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)"]] + \[[!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. Aktiv som standard hvis wikien er - sat op til at bruge rss-fødninger - angiv "no" for at deaktivere. -* `atom` - Styrer dannelsen af en atom-fødning. Aktiv som standard hvis wikien - er sat op til at bruge atom-fødninger - angiv "no" for at deaktivere. -* `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 9090ef8..29dbce1 100644 --- a/ikiwiki/formatting.mdwn +++ b/ikiwiki/formatting.mdwn @@ -1,29 +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 @@ -32,64 +33,63 @@ 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 ">": > 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. :-) +[[!if test="enabled(smiley) and smileys" then=""" +* Insert [[smileys]] and some other useful symbols. :-) """]] -[[if test="enabled(shortcut) and shortcuts" then=""" -* Bruge [[forkortelser|shortcuts]] til at henvise til gængse ressourcer. +[[!if test="enabled(shortcut) and shortcuts" then=""" +* Use [[shortcuts]] to link to common resources. - \[[wikipedia War\_of\_1812]] + \[[!wikipedia War\_of\_1812]] """]] -[[if test="enabled(toc)" then=""" -* Tilføje en indholdsfortegnelse til en side: +[[!if test="enabled(toc)" then=""" +* Add a table of contents to a page: - \[[toc ]] + \[[!toc ]] """]] -[[if test="enabled(meta)" then=""" -* Ændre titlen på en side: +[[!if test="enabled(meta)" then=""" +* 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: +[[!if test="enabled(inline) and blog" then=""" +* Create a [[blog]] by inlining a set of pages: - \[[inline pages="blog/*"]] + \[[!inline pages="blog/*"]] """]] -[[if test="enabled(template) and templates" then=""" -* Oprette og udfylde [[skabeloner|templates]] for gentagne klumper ad - parameteriseret wikitekst. +[[!if test="enabled(template) and templates" then=""" +* Create and fill out [[templates]] for repeated chunks of + parameterized wiki text. """]] diff --git a/ikiwiki/markdown.mdwn b/ikiwiki/markdown.mdwn index 5735527..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. +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://jrblevin.freeshell.org/software/markdown-mode/) til -emacs kan være en hjælp ved redigering. - -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. +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. +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 0801db2..dd851e5 100644 --- a/ikiwiki/openid.mdwn +++ b/ikiwiki/openid.mdwn @@ -1,32 +1,34 @@ -[[meta title="OpenID"]] +[[!meta title="OpenID"]] +[[!meta robots="noindex, follow"]] -[[if test="enabled(openid)" - then="Denne wiki har OpenID **aktiveret**." - else="Denne wiki har OpenID **deaktiveret**."]] +[[!if test="enabled(openid)" + 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 websites. +[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/) -* eller en af de [mange andre derude](http://openiddirectory.com/index.php?dir=1).. - -Din OpenID er en URL som du får når du registerer dig. -[[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. +* [TrustBearer](https://openid.trustbearer.com/) +* or any of the [many others out there](http://openiddirectory.com/openid-providers-c-1.html). + +Your OpenID is the URL that you are given when you sign up. +[[!if test="enabled(openid)" then=""" +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/" + \[[!meta openid="http://yourid.myopenid.com/" server="http://www.myopenid.com/server"]] diff --git a/ikiwiki/pagespec.mdwn b/ikiwiki/pagespec.mdwn index f135efb..156e3f6 100644 --- a/ikiwiki/pagespec.mdwn +++ b/ikiwiki/pagespec.mdwn @@ -1,81 +1,85 @@ -Til at angive et udvalg af sider, eksempelvis låste sider, sider du vil abonnere -på ændringer til, eller sider som skal udgøre en blog, anvender wikien et -PageSpec. dette er et udtryk som modsvarer et bestemt udvalg af sider. +[[!meta robots="noindex, follow"]] +To select a set of pages, such as pages that are locked, pages +whose commit emails you want subscribe to, or pages to combine into a +blog, the wiki uses a PageSpec. This is an expression that matches +a set of pages. -Det simpleste PageSpec er simpelthen en opremsning af sider med "or" imellem -("or" betyder "eller" på engelsk). Dette modsvarer eksempelvis enhver af de tre -nævnte sider: +The simplest PageSpec is a simple list of pages. For example, this matches +any of the three listed pages: foo or bar or baz -Mere hyppigt har du dog brug for at at at modsvare sider med noget tilfælles i -deres navne. Dette kan du udtrykke med et "glob-mønster". "`*`" står for ehhver -del af sidenavnet, og "`?`" for ethvert enkeltbogstav i sidenavnet. Så dette -modsvarer alle sider om musik, og alle [[UnderSider||SubPage]] til sandkassen, -men ikke selve sandkasse-siden: +More often you will want to match any pages that have a particular thing in +their name. You can do this using a glob pattern. "`*`" stands for any part +of a page name, and "`?`" for any single letter of a page name. So this +matches all pages about music, and any [[SubPage]]s of the SandBox, but does +not match the SandBox itself: - *musik* or SandBox/* + *music* or SandBox/* -Du kan også angive "`!`" foran et emne for at undgå sider som modsvarer det. Så -for at modsvare alle sider undtagen diskussionssider og sandkassen: +You can also prefix an item with "`!`" to skip pages that match it. So to +match all pages except for Discussion pages and the SandBox: * and !SandBox and !*/Discussion -En række mere nøjagtige begrænsninger kan tilføjes med disse funktioner: - -* "`link(side)`" - modsvarer kun sider som henviser til en given side (eller glob) -* "`backlink(side)`" - modsvarer kun sider som en given side henviser til -* "`creation_month(måned)`" - modsvarer kun sider oprettet den givne måned -* "`creation_day(månedsdag)`" - eller dag på måneden -* "`creation_year(år)`" - eller år -* "`created_after(side)`" - modsvarer kun sider oprettet efter den givne side - blev oprettet -* "`created_before(side)`" - modsvarer kun sider oprettet før den givne side - blev oprettet -* "`glob(nogetglob)`" - modsvarer sider som modsvarer det givne glob. Blot at - skrive glob'et alene er faktisk en genvej til denne funktion. -* "`internal(glob)`" - lissom `glob()`, men modsvarer også internt anvendte - sider som glob normalt ikke modsvarer. +Some more elaborate limits can be added to what matches using any of these +functions: + +* "`link(page)`" - match only pages that link to a given page (or glob) +* "`backlink(page)`" - match only pages that a given page links to +* "`creation_month(month)`" - match only pages created on the given month +* "`creation_day(mday)`" - or day of the month +* "`creation_year(year)`" - or year +* "`created_after(page)`" - match only pages created after the given page + was created +* "`created_before(page)`" - match only pages created before the given page + was created +* "`glob(someglob)`" - match pages that match the given glob. Just writing + the glob by itself is actually a shorthand for this function. +* "`internal(glob)`" - like `glob()`, but matches even internal-use + pages that globs do not usually match. * "`title(glob)`", "`author(glob)`", "`authorurl(glob)`", - "`license(glob)`", "`copyright(glob)`" - modsvarer sider med de givne - metadata, som modsvarer det angivne glob. + "`license(glob)`", "`copyright(glob)`" - match pages that have the given + metadata, matching the specified glob. -For eksempelvis at modsvare alle sider i en blog som henviser til en side om -musik og som blev skrevet i 2005: +For example, to match all pages in a blog that link to the page about music +and were written in 2005: - blog/* and link(musik) and creation_year(2005) + blog/* and link(music) and creation_year(2005) -Bemærk brugen af "and" i eksemplet ovenfor ("and" betyder "og" på engelsk), som -betyder at kun sider der modsvarer hver af de tre udtryk modsvarer det hele. -Brug "and" når du vil kombinere udtryk på den måde; "or" når det er nok at én -side modsvarer et udtryk. Bemærk at det ikke giver mening at sige "index and -SandBox", da ingen sider kan modsvare begge udtryk. +Note the use of "and" in the above example, that means that only pages that +match each of the three expressions match the whole. Use "and" when you +want to combine expression like that; "or" when it's enough for a page to +match one expression. Note that it doesn't make sense to say "index and +SandBox", since no page can match both expressions. -Mere komplekse udtryk kan dannes ved at gruppere med paranteser. Eksempelvis -modsvarer dette sider i en blog som er mærket af med en af to mærkater: +More complex expressions can also be created, by using parentheses for +grouping. For example, to match pages in a blog that are tagged with either +of two tags, use: blog/* and (link(tag/foo) or link(tag/bar)) -Bemærk at PageSpecs for sidenavne modsvares som de absolutte filnavne for siderne i -wikien, så et pagespec "foo" brugt på siden "a/b" vil ikke modsvare siderne -navngivet "a/foo" eller "a/b/foo". For at modsvare relativt til samme mappe som -siden der indeholder pagespec'et kan du bruge "./". Eksempelvis modsvarer -"./foo" på siden "a/b" siden "a/foo". +Note that page names in PageSpecs are matched against the absolute +filenames of the pages in the wiki, so a pagespec "foo" used on page +"a/b" will not match a page named "a/foo" or "a/b/foo". To match +relative to the directory of the page containing the pagespec, you can +use "./". For example, "./foo" on page "a/b" matches page "a/foo". -## Gammel syntaks +## Old syntax -Den gamle PageSpec-syntaks blev kaldt en "GlobList", og fungerede anderledes på -to måder: +The old PageSpec syntax was called a "GlobList", and worked differently in +two ways: -1. "and" og "or" blev ikke brugt; enhver side modsvarede ethvert emne fra - listen. -2. Hvis et emne havde "`!`" foran, modsvarede ingen side dette emne, heller ikke - hvis det modsvarede et tidligere emne. +1. "and" and "or" were not used; any page matching any item from the list + matched. +2. If an item was prefixed with "`!`", then no page matching that item + matched, even if it matched an earlier list item. -Her er et eksempel på den gamle måde at modsvare alle sider undtagen sandkassen -og diskussionssider: +For example, here is the old way to match all pages except for the SandBox +and Discussion pages: * !SandBox !*/Discussion -Brug af denne gamle syntaks er stadigt understøttet. Den er dog på vej ud, så -det anbefales at bruge den nye syntaks. +Using this old syntax is still supported. However, the old syntax is +deprecated and will be removed at some point, and using the new syntax is +recommended. diff --git a/ikiwiki/preprocessordirective.mdwn b/ikiwiki/preprocessordirective.mdwn index 660d411..743c0d9 100644 --- a/ikiwiki/preprocessordirective.mdwn +++ b/ikiwiki/preprocessordirective.mdwn @@ -1,32 +1,39 @@ -Preprocessor-direktiver ligner et [[WikiLink]] i form, på nær at de indeholder -mellemrum og parametre. Generelt er formen: +[[!meta robots="noindex, follow"]] +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]] + \[[!tag foo]] -Bemærk at hvis et preprocessor-directiv ingen parametre har, skal der puttes et -mellemrum efter dets navn, for at undgå forveksling med et [[WikiLink]]. Eksempel: - - \[[pagecount ]] - -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" + \[[!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=""" + \[[!directive text=""" 1. "foo" 2. "bar" 3. "baz" """]] + +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 2024a0f..e047b86 100644 --- a/ikiwiki/subpage.mdwn +++ b/ikiwiki/subpage.mdwn @@ -1,12 +1,12 @@ -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. +[[!meta robots="noindex, follow"]] +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 78062b5..e547f30 100644 --- a/ikiwiki/subpage/linkingrules.mdwn +++ b/ikiwiki/subpage/linkingrules.mdwn @@ -1,33 +1,33 @@ -For at henvise til eller fra en [[UnderSide|SubPage]] kan du normalt bruge en -normal [[WikiLink]] som ikke indeholder navnet på den den overliggende mappe for -[[SubPage]]. Ikiwiki vil dykke ned i mappehierarkiet og leder efter en side som -modsvarer din henvisning. +[[!meta robots="noindex, follow"]] +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, for eksempel, FooBar/UnderSide henviser til "AndenSide", vil ikiwiki først -foretrække at pege henvisningen til FooBar/UnderSide/AndenSide hvis den -eksisterer, derefter til FooBar/AndenSide og til sidst til AndenSide 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 på FooBar/EnSide to "AndenSide" -i øjeblikket henviser til AndenSide i roden af wikien, og FooBar/Andenside -oprettes, så vil henvisningen _ændres_ til at pege på FooBar/AndenSide. På den -anden side, ville en henvisning fra BazBar til "AndenSide" være uberørt af denne -oprettelse 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, som i -"FooBar/Andenside" for mere præcist at angive hvilken side der henvises til. -Dette er den eneste måde at henvise til en uafhængig [[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, for eksempel, at henvise fra BazBar to -"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 henvsning, tilæ at angive præcist -hvilken side der henvises til, når der er flere sider med lignenden navne og -henvisningen går til den forkerte side som standard. Eksempelvis vil henvisning -fra "FooBar/UnderSide" til "/AndenSide" henvise "AndenSide" i roden af wikien, -selvom der er en "FooBar/Andenside". +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". -Hvis wikien er opsat med en brugermappe, kan du desuden henvise til sider -indenfor brugermappen uden at angive en sti til dem. Dette er for at tillade nem -henvisning til en brugers side i en brugermappe ved signering af kommentarer. -Sådanne henvisninger undersøges der for sidst af alle. +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 e167c12..bd5e3d1 100644 --- a/ikiwiki/wikilink.mdwn +++ b/ikiwiki/wikilink.mdwn @@ -1,27 +1,36 @@ -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]]`. +[[!meta robots="noindex, follow"]] +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 parres med 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]]` -**Bemærk at du ikke kan bruge mellemrum i WikiLinks**. Erstat mellemrum med -understregning. Tilstedeværelsen af mellemrum bruges til at skelne mellem et -[[PreprocessorDirektiv|PreprocessorDirective]] og en WikiLink. +## 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. |