From 7fe3413c0f7d21ee59cff100c4028567d0b8b78b Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Sun, 20 Jan 2008 21:08:43 +0100 Subject: Sync with ikiwiki 2.20 part I: Move a bunch of pages to ikiwiki/ subdir. --- ikiwiki/blog.mdwn | 94 +++++++++++++++++++++++++++++++++++++ ikiwiki/formatting.mdwn | 95 ++++++++++++++++++++++++++++++++++++++ ikiwiki/markdown.mdwn | 14 ++++++ ikiwiki/openid.mdwn | 32 +++++++++++++ ikiwiki/pagespec.mdwn | 77 ++++++++++++++++++++++++++++++ ikiwiki/preprocessordirective.mdwn | 32 +++++++++++++ ikiwiki/subpage.mdwn | 12 +++++ ikiwiki/subpage/linkingrules.mdwn | 33 +++++++++++++ ikiwiki/wikilink.mdwn | 27 +++++++++++ 9 files changed, 416 insertions(+) create mode 100644 ikiwiki/blog.mdwn create mode 100644 ikiwiki/formatting.mdwn create mode 100644 ikiwiki/markdown.mdwn create mode 100644 ikiwiki/openid.mdwn create mode 100644 ikiwiki/pagespec.mdwn create mode 100644 ikiwiki/preprocessordirective.mdwn create mode 100644 ikiwiki/subpage.mdwn create mode 100644 ikiwiki/subpage/linkingrules.mdwn create mode 100644 ikiwiki/wikilink.mdwn (limited to 'ikiwiki') 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: <>, 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. -- cgit v1.2.3