summaryrefslogtreecommitdiff
path: root/ikiwiki
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2008-01-20 21:08:43 +0100
committerJonas Smedegaard <dr@jones.dk>2008-01-20 21:08:43 +0100
commit7fe3413c0f7d21ee59cff100c4028567d0b8b78b (patch)
treef9d766c6a15c9eb0b7737bc1de87d297714159be /ikiwiki
parent24c37a431a54ebdc01a626eaaadf475bae0631d5 (diff)
Sync with ikiwiki 2.20 part I: Move a bunch of pages to ikiwiki/ subdir.
Diffstat (limited to 'ikiwiki')
-rw-r--r--ikiwiki/blog.mdwn94
-rw-r--r--ikiwiki/formatting.mdwn95
-rw-r--r--ikiwiki/markdown.mdwn14
-rw-r--r--ikiwiki/openid.mdwn32
-rw-r--r--ikiwiki/pagespec.mdwn77
-rw-r--r--ikiwiki/preprocessordirective.mdwn32
-rw-r--r--ikiwiki/subpage.mdwn12
-rw-r--r--ikiwiki/subpage/linkingrules.mdwn33
-rw-r--r--ikiwiki/wikilink.mdwn27
9 files changed, 416 insertions, 0 deletions
diff --git a/ikiwiki/blog.mdwn b/ikiwiki/blog.mdwn
new file mode 100644
index 0000000..d716faf
--- /dev/null
+++ b/ikiwiki/blog.mdwn
@@ -0,0 +1,94 @@
+[[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 `inline`
+[[PreprocessorDirektivet|PreProcessorDirective]]. Som eksempel:
+
+ \[[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
+
+Her er beskrivelser af alle de understøttede parametre til `inline` direktivet:
+
+* `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.
diff --git a/ikiwiki/formatting.mdwn b/ikiwiki/formatting.mdwn
new file mode 100644
index 0000000..e183d03
--- /dev/null
+++ b/ikiwiki/formatting.mdwn
@@ -0,0 +1,95 @@
+[[meta title="Hjælp til formattering af wiki-sider"]]
+
+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:
+
+hold afstand med blanke linjer mellem afsnit.
+
+du kan \**fremhæve*\* eller \*\***kraftigt fremhæve**\*\* tekst ved at placere
+det med enkelte eller dobbelte asterisker (stjerner) omkring.
+
+En liste oprettes ved at begynde hver linje med en asterisk:
+
+* "* dette er min liste"
+* "* et andet emne"
+
+En nummereret liste laves ved at starte hver linje med et nummer (ethvert nummer
+kan bruges) efterfulgt af punktum:
+
+1. "1. første linje"
+2. "2. anden linje"
+2. "2. tredje linje"
+
+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:
+
+# # h1
+## ## h2
+### ### h3
+#### #### h4
+##### ##### h5
+###### ###### h6
+
+En vandret skillelinje oprettes ved at skrive tre eller flere bindestreger eller
+stjerner på en linje for sig selv.
+
+----
+
+Citater angives ved at sætte ">" foran hver linje:
+
+> 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:
+
+ 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\)
+
+----
+
+Udover normal html-formattering med [[MarkDown]], kan du med denne wiki
+bruge følgende ekstra finesser:
+
+* Henvise til en anden side på wikien ved at skrive sidenavnet med dobbelte
+ lodrette klammer omkring. Udtrykket `\[[WikiLink]]` henviser til [[WikiLink]].
+
+[[if test="enabled(smiley) and smileys" then="""
+* Insætte [[smileys]] og andre anvendelige symboler. :-)
+"""]]
+
+[[if test="enabled(shortcut) and shortcuts" then="""
+* Bruge [[forkortelser|shortcuts]] til at henvise til gængse ressourcer.
+
+ \[[wikipedia War\_of\_1812]]
+"""]]
+
+[[if test="enabled(toc)" then="""
+* Tilføje en indholdsfortegnelse til en side:
+
+ \[[toc ]]
+"""]]
+
+
+[[if test="enabled(meta)" then="""
+* Ændre titlen på en side:
+
+ \[[meta title="fuldstændige sidetitel"]]
+"""]]
+
+[[if test="enabled(inline) and blog" then="""
+* Oprette en [[blog]] ved at indlejre et udvalg ad sider:
+
+ \[[inline pages="blog/*"]]
+"""]]
+
+[[if test="enabled(template) and templates" then="""
+* Oprette og udfylde [[skabeloner|templates]] for gentagne klumper ad
+ parameteriseret wikitekst.
+"""]]
diff --git a/ikiwiki/markdown.mdwn b/ikiwiki/markdown.mdwn
new file mode 100644
index 0000000..31c0126
--- /dev/null
+++ b/ikiwiki/markdown.mdwn
@@ -0,0 +1,14 @@
+[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.
+
+Du kan læse dokumentation til markdown-syntaksen under
+[[HjælptilFormattering|HelpOnFormatting]] 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.
+
diff --git a/ikiwiki/openid.mdwn b/ikiwiki/openid.mdwn
new file mode 100644
index 0000000..0801db2
--- /dev/null
+++ b/ikiwiki/openid.mdwn
@@ -0,0 +1,32 @@
+[[meta title="OpenID"]]
+
+[[if test="enabled(openid)"
+ then="Denne wiki har OpenID **aktiveret**."
+ else="Denne wiki har OpenID **deaktiveret**."]]
+
+[OpenID](http://openid.net) er en decentral autorisationsmekanisme som tillader
+dig at have eet login som du kan bruge på et voksende antal websites.
+websites.
+
+Du kan registrere en OpenID ved at besøge en af de følgende identitetsudbydere:
+
+* [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.
+"""]]
+
+---
+
+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:
+
+ \[[meta openid="http://yourid.myopenid.com/"
+ server="http://www.myopenid.com/server"]]
diff --git a/ikiwiki/pagespec.mdwn b/ikiwiki/pagespec.mdwn
new file mode 100644
index 0000000..83dfe1b
--- /dev/null
+++ b/ikiwiki/pagespec.mdwn
@@ -0,0 +1,77 @@
+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.
+
+Det simpleste PageSpec er simplethen en opremsning af sider med "or" imellem
+("or" betyder "eller" på engelsk). Dette modsvarer eksempelvis enhver af de tre
+angivne sider:
+
+ foo or bar or baz
+
+Mere hyppigt har du dog brug for at at at modsvare sider med noget til fælles i
+deres navne. Dette kan du udtrykke med et "glob-mønster". "`*`" står for ehhver
+del af sidenavnet, og "`?`" for ethvert enkelt bogstav i sidenavnet. Så dette
+modsvarer alle sider om musik, og alle [[UnderSider||SubPage]] til sandkassen,
+men ikke selve sandkasse-siden:
+not match the SandBox itself:
+
+ *musik* 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:
+
+ * 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 din en given side (eller glob)
+* "`backlink(side)`" - modsvarer kun sider som en given side henviser til
+* "`creation_month(måned)`" - modsvarer kun side 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
+* "`user(side)`" - kun tilgængelig under sideabonnements-opsætningen - modsvarer
+ kun ændringer foretaget af denne bruger
+
+For som 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 en
+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:
+
+ blog/* and (link(tag/foo) or link(tag/bar))
+
+Bemærk at sidenavne PageSpecs modsvares som de absolutte filnavne for siderne i
+wikien, så etpagespec "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".
+
+## Gammel syntaks
+
+Den gamle PageSpec-syntaks blev kaldt en "GlobList", og fungerede anderledes på
+to måder:
+
+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.
+
+Her er et eksempel på den gamle måde at modsvare alle sider undtagen sandkassen
+og diskussionssider:
+
+ * !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.
diff --git a/ikiwiki/preprocessordirective.mdwn b/ikiwiki/preprocessordirective.mdwn
new file mode 100644
index 0000000..140afab
--- /dev/null
+++ b/ikiwiki/preprocessordirective.mdwn
@@ -0,0 +1,32 @@
+Preprocessor-direktiver linger et [[WikiLink]] i form, på nær at de indeholder
+mellemrum og parametre. Generelt er formen:
+
+ \[[directive param="værdi" param="værdi"]]
+
+Dette udvides før resten af siden udarbejdes, og kan bruges til at omforme siden
+på forskellige måder.
+
+Citationen omkring værdier kan udelades hvis værdien er et simpelt ord. Desuden
+kan nogle direktiver bruge parametre uden værdier. Eksempel:
+
+ \[[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:
+
+ \[[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:
+
+ \[[directive text="""
+ 1. "foo"
+ 2. "bar"
+ 3. "baz"
+ """]]
diff --git a/ikiwiki/subpage.mdwn b/ikiwiki/subpage.mdwn
new file mode 100644
index 0000000..f9c252a
--- /dev/null
+++ b/ikiwiki/subpage.mdwn
@@ -0,0 +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.
+
+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.
+
+Henvisninger til og fra en [[UnderSide||SubPage]] er forklaret under
+[[HenvisningsRegler||LinkingRules]].
diff --git a/ikiwiki/subpage/linkingrules.mdwn b/ikiwiki/subpage/linkingrules.mdwn
new file mode 100644
index 0000000..78062b5
--- /dev/null
+++ b/ikiwiki/subpage/linkingrules.mdwn
@@ -0,0 +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.
+
+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.
+
+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.
+
+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]].
+
+Du kan bruge dette til, for eksempel, at henvise fra BazBar to
+"FooBar/UnderSide", eller fra BazBar/UnderSide til "FooBar/UnderSide".
+
+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".
+
+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.
diff --git a/ikiwiki/wikilink.mdwn b/ikiwiki/wikilink.mdwn
new file mode 100644
index 0000000..82ca76f
--- /dev/null
+++ b/ikiwiki/wikilink.mdwn
@@ -0,0 +1,27 @@
+WikiLinks gør det muligt enkelt at lave henvinstninger (linke) mellem side i
+wikien. Opret en [[WikiLink]] ved at skrive siden du vil henvise til med
+dobbelte klammer omkring. Ekempelvis `\[[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]]`.
+
+Specielle [[henvisningsregler|SubPage/LinkingRules]] træder i kraft når der
+henvises på tværs af [[undersider|SubPage]].
+
+Desuden, hvis filen der henvises til med en WikiLink ligner et billede, vil det
+blive vist indlejret i siden.
+
+WikiLinks parres med sidenavne uden skelen til store og små bogstaver, så du
+behøver ikke at bekymre dig for dette, og kan anvende stort begyndelsesbogstav
+i begyndelsen af en sætning o.l.
+
+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]].
+
+For at henvise til et anker inde på en side, kan du bruge noget i stil med
+`\[[WikiLink#foo]]`
+
+**Bemærk at du kan ikke bruge mellemrum i WikiLinks**. Erstat mellemrum med
+understregning. Tilstedeværelsen af mellemrum bruges til at skelne mellem et
+[[ReprocessorDirektiv|PreprocessorDirective]] og en WikiLink.