diff options
author | Jonas Smedegaard <dr@jones.dk> | 2010-10-14 13:38:18 +0200 |
---|---|---|
committer | Jonas Smedegaard <dr@jones.dk> | 2010-10-14 13:38:18 +0200 |
commit | 04b07d80a598c6c8cfb7606ecafd91c459117d5c (patch) | |
tree | 7ffb060c1ece3193d4c56f354d6ff4e4f7aaed12 /ikiwiki |
Diffstat (limited to 'ikiwiki')
-rw-r--r-- | ikiwiki/directive.mdwn | 42 | ||||
-rw-r--r-- | ikiwiki/formatting.mdwn | 108 | ||||
-rw-r--r-- | ikiwiki/markdown.mdwn | 12 | ||||
-rw-r--r-- | ikiwiki/openid.mdwn | 29 | ||||
-rw-r--r-- | ikiwiki/pagespec.mdwn | 85 | ||||
-rw-r--r-- | ikiwiki/pagespec/attachment.mdwn | 38 | ||||
-rw-r--r-- | ikiwiki/pagespec/po.mdwn | 21 | ||||
-rw-r--r-- | ikiwiki/searching.mdwn | 21 | ||||
-rw-r--r-- | ikiwiki/subpage.mdwn | 14 | ||||
-rw-r--r-- | ikiwiki/subpage/linkingrules.mdwn | 36 | ||||
-rw-r--r-- | ikiwiki/wikilink.mdwn | 30 |
11 files changed, 436 insertions, 0 deletions
diff --git a/ikiwiki/directive.mdwn b/ikiwiki/directive.mdwn new file mode 100644 index 0000000..4014092 --- /dev/null +++ b/ikiwiki/directive.mdwn @@ -0,0 +1,42 @@ +[[!meta robots="noindex, follow"]] +Direktiver ligner et [[ikiwiki/WikiLink]] i form, undtagen at de begynder +med `!` og kan indeholde parametre. Generelt er formen: + + \[[!direktiv 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]] + +Et direktiv behøver ikke at blive holdt på een linje, det kan bredes ud over +flere linjer hvis du har lyst: + + \[[!direktiv foo="baldersnatch" + bar="supercalifragilisticexpialidocious" baz=11]] + +Flere linjer *citeret* tekst kan også bruges som værdi. For at tillade +citation i den citerede tekst skal du adskille blokken med trippel-citat: + + \[[!direktiv tekst=""" + 1. "foo" + 2. "bar" + 3. "baz" + """]] + +Ikiwiki har også en ældre syntaks til direktiver, som kræver et mellemrum i +direktiver for at skelne dem fra [[wikilinks|ikiwiki/wikilink]]. Denne +syntaks har flere ulemper: den kræver et mellemrum efter direktiver uden +parametre (såsom `\[[pagecount ]]`), og den forbyder mellemrum i +[[wikilinks|ikiwiki/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. + +[[!if test="enabled(listdirectives)" then=""" +Her er en oversigt over konkret tilgængelige direktiver i for denne wiki: + +[[!listdirectives ]] +"""]] diff --git a/ikiwiki/formatting.mdwn b/ikiwiki/formatting.mdwn new file mode 100644 index 0000000..4a61761 --- /dev/null +++ b/ikiwiki/formatting.mdwn @@ -0,0 +1,108 @@ +[[!meta title="Formatering af wikisider"]] +[[!meta robots="noindex, follow"]] + +Teksten på denne wiki er, som udgangspunkt, skrevet på en måde som ligger +tæt op ad hvordan du muligvis formulerer dig i email-beskeder. Denne form +for tekstformatering kaldes [[MarkDown]], og det fungerer sådan her: + +hold afstand med blanke linjer mellem afsnit. + +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: + +* "* 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: + +> At være eller ikke være, +> det er spørgsmålet. + +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-formatering 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=""" +* Indsætte [[smileys]] og andre anvendelige symboler. :-) +"""]] + +[[!if test="enabled(shortcut) and shortcuts" then=""" +* Bruge [[genveje|shortcuts]] til at henvise til gængse ressourcer. + + \[[!wikipedia War\_of\_1812]] +"""]] + +[[!if test="enabled(template) and templates" then=""" +* Oprette og udfylde [[skabeloner|templates]] for gentagne klumper af + parameteriseret wikitekst. +"""]] + +* Indsæt diverse [[directiver|directive]] på en side for at udføre nyttige + handlinger. +[[!if test="enabled(toc) or enabled(meta) or enabled(inline)" then=""" + Eksempelvis kan du: +"""]] + +[[!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)" then=""" + * Oprette en [[blog]] ved at indlejre et udvalg af sider: + + \[[!inline pages="blog/*"]] +"""]] + +[[!if test="enabled(listdirectives)" then=""" + Komplet oversigt over [[directiver|directive]] aktiveret for denne wiki: + [[!listdirectives ]] +"""]] diff --git a/ikiwiki/markdown.mdwn b/ikiwiki/markdown.mdwn new file mode 100644 index 0000000..72269f8 --- /dev/null +++ b/ikiwiki/markdown.mdwn @@ -0,0 +1,12 @@ +[[!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. + +Du kan læse dokumentation til markdown-syntaksen under +[[formatering|formatting]] og [Markdown: +syntax](http://daringfireball.net/projects/markdown/syntax). + +Bemærk at [[WikiLinks|WikiLink]] og [[direktiver|directive]] ikke er en del +af markdown-syntaksen, og er de eneste stumper opmærkning som denne wiki +håndterer internt. diff --git a/ikiwiki/openid.mdwn b/ikiwiki/openid.mdwn new file mode 100644 index 0000000..a51416b --- /dev/null +++ b/ikiwiki/openid.mdwn @@ -0,0 +1,29 @@ +[[!meta title="OpenID"]] +[[!meta robots="noindex, follow"]] + +[[!if test="enabled(openid)" + then="Denne wiki har OpenID **aktiveret**." + else="Denne wiki har OpenID **deaktiveret**."]] + +[OpenID](http://openid.net) er en decentral ægthedsmekanisme som giver dig +mulighed for at have eet login som du kan bruge på et voksende antal +websteder. + +If you have an account with some of the larger web service providers, you +might already have an OpenID. [Directory of OpenID +providers](http://openiddirectory.com/openid-providers-c-1.html) + +[[!if test="enabled(openid)" then=""" +Du kan logge på denne wiki med OpenID, ved blot at angive den i +OpenID-feltet på login-siden. Du behøves ikke at oplyse din adgangskode til +denne wiki eller at gennemgå en registreringsproces når du bruger OpenID. +"""]] + +--- + +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..cc7f142 --- /dev/null +++ b/ikiwiki/pagespec.mdwn @@ -0,0 +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 passer for et bestemt udvalg af +sider. + +Det simpleste PageSpec er simpelthen en opremsning af sider med "or" imellem +("or" betyder "eller" på engelsk). Dette passer eksempelvis for enhver af de +tre nævnte sider: + + foo or bar or baz + +Mere hyppigt har du dog brug for at passe for sider med noget bestemt i +deres navne. Dette kan du udtrykke med et "glob-mønster". "`*`" står for +enhver del af et sidenavn, og "`?`" for ethvert enkeltbogstav i et +sidenavn. Så dette passer for alle sider om musik, og alle +[[UnderSider||SubPage]] til sandkassen, men ikke selve sandkasse-siden: + + *musik* or SandBox/* + +Du kan også angive "`!`" foran et emne for at undgå sider som passer for +det. Så for at passe for alle sider undtagen diskussionssider og sandkassen: + + * and !SandBox and !*/Discussion + +Resultaterne kan begrænses mere nuanceret med disse funktioner: + +* "`glob(someglob)`" - matches pages and other files that match the given glob. + Just writing the glob by itself is actually a shorthand for this function. +* "`page(glob)`" - like `glob()`, but only matches pages, not other files +* "`link(page)`" - matches only pages that link to a given page (or glob) +* "`tagged(tag)`" - matches pages that are tagged or link to the given tag (or + tags matched by a glob) +* "`backlink(page)`" - matches only pages that a given page links to +* "`creation_month(month)`" - matches only files created on the given month +* "`creation_day(mday)`" - or day of the month +* "`creation_year(year)`" - or year +* "`created_after(page)`" - matches only files created after the given page + was created +* "`created_before(page)`" - matches only files created before the given page + was created +* "`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)`", "`guid(glob)`" + - match pages that have the given metadata, matching the specified glob. +* "`user(username)`" - tests whether a modification is being made by a + user with the specified username. If openid is enabled, an openid can also + be put here. Glob patterns can be used in the username. For example, + to match all openid users, use `user(*://*)` +* "`admin()`" - tests whether a modification is being made by one of the + wiki admins. +* "`ip(address)`" - tests whether a modification is being made from the + specified IP address. +* "`comment(glob)`" - matches comments to a page matching the glob. +* "`comment_pending(glob)`" - matches unmoderated, pending comments. +* "`postcomment(glob)`" - matches only when comments are being + posted to a page matching the specified glob + +For eksempelvis at passe for 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 passer for hvert af de tre udtryk passer for +det hele. Brug "and" når du vil kombinere udtryk på den måde; "or" når det +er nok for en side at den passer for ét udtryk. Bemærk at det ikke giver +mening at sige "index and SandBox", da ingen sider kan passe for begge +udtryk. + +Mere komplekse udtryk kan dannes ved at gruppere med paranteser. Eksempelvis +passer dette for sider i en blog som er mærket af med en af to mærkater: + + blog/* and (tagged(foo) or tagged(bar)) + +Bemærk at PageSpecs for sidenavne afstemmes som de absolutte filnavne for +siderne i wikien, så et pagespec "foo" brugt på siden "a/b" vil ikke passe +for siderne navngivet "a/foo" eller "a/b/foo". For at afstemme relativt til +samme mappe som siden der indeholder pagespec'et kan du bruge +"./". Eksempelvis passer "./foo" på siden "a/b" for siden "a/foo". + +To indicate the name of the page the PageSpec is used in, you can use a +single dot. For example, `link(.)` matches all the pages linking to the page +containing the PageSpec. diff --git a/ikiwiki/pagespec/attachment.mdwn b/ikiwiki/pagespec/attachment.mdwn new file mode 100644 index 0000000..d7c3360 --- /dev/null +++ b/ikiwiki/pagespec/attachment.mdwn @@ -0,0 +1,38 @@ +[[!meta robots="noindex, follow"]] +[[!if test="enabled(attachment)" + then="Denne wiki har vedhæftninger **aktiveret**." + else="Denne wiki har vedhæftninger **deaktiveret**."]] + +Hvis vedhæftninger er aktiveret, kan wiki-administratoren styre hvilke typer +vedhæftninger der vil blive accepteret gennem opsætningsindstillingen +`allowed_attachments`. + +For example, to limit most users to uploading small images, and nothing +else, while allowing larger mp3 files to be uploaded by joey into a specific +directory, and check all attachments for viruses, something like this could +be used: + + virusfree() and ((user(joey) and podcast/*.mp3 and mimetype(audio/mpeg) and maxsize(15mb)) or (mimetype(image/*) and maxsize(50kb))) + +Den normale [[ikiwiki/PageSpec]]-syntaks er udvidet med følgende yderligere +tests: + +* "`maxsize(størrelse)`" - tester hvorvidt vedhæftningen højst fylder den + angivne størrelse. Størrelsen angives som standard i bytes, men "kb", + "mb", "gb" osv. kan bruges til at angive enheder. + +* "`minsize(størrelse)`" - tester hvorvidt størrelsen mindst fylder den + angivne størrelse. + +* "`ispage()`" - tester hvorvidt vedhæftningen bliver håndteret af ikiwiki + som en wikiside. (altså om den har endelsen ".mdwn", eller et hvilket som + helst andet aktiveret sideformat). + + Derfor, hvis du ikke vil tillade wikisider at blive lagt op som vedhæftninger, + så brug `!ispage()` ; hvis du kun vil tillade wikisider at blive lagt op som + vedhæftninger, så brug `ispage()`. + +* "`mimetype(foo/bar)`" - checker MIME-typen for vedhæftningen. Du kan + angive et glob som type, eksampelvis `mimetype(image/*)`. + +* "`virusfree()`" - checker vedhæftningen med et antivirusprogram. diff --git a/ikiwiki/pagespec/po.mdwn b/ikiwiki/pagespec/po.mdwn new file mode 100644 index 0000000..6acb5be --- /dev/null +++ b/ikiwiki/pagespec/po.mdwn @@ -0,0 +1,21 @@ +[[!if test="enabled(po)" + then="Denne wiki har oversættelser **aktiveret**." + else="Denne wiki har oversættelser **deaktiveret**."]] + +Hvis udvidelsen [[!iki plugins/po desc=po]] er aktiveret er den normale +[[ikiwiki/PageSpec]]-syntaks udvidet med følgende yderligere tests som kan +bruges til at forbedre brugernavigation i en flersproget wiki: + +* "`lang(LL)`" - tester hvorvidt en side er skrevet i sproget angivet som en + ISO639-1 (to-bogstavs) sprogkode. +* "`currentlang()`" - tester hvorvidt en side er skrevet i samme sprog som + den nuværende side. +* "`needstranslation()`" - tests whether a page needs translation work. Only + slave pages match this PageSpec. A minimum target translation percentage + can optionally be passed as an integer parameter: "`needstranslation(50)`" + matches only pages less than 50% translated. + +Bemærk at enhver ikke-po side antages at være skrevet i +`po_master_language`, som angivet i `ikiwiki.setup`. + +[[!meta robots="noindex, follow"]] diff --git a/ikiwiki/searching.mdwn b/ikiwiki/searching.mdwn new file mode 100644 index 0000000..48ff245 --- /dev/null +++ b/ikiwiki/searching.mdwn @@ -0,0 +1,21 @@ +[[!meta robots="noindex, follow"]] + +[[!if test="enabled(search)" +then="Denne wiki har søgning **aktiveret**." +else="Denne wiki har søgning **deaktiveret**."]] + +If searching is enabled, you can enter search terms in the search field, as +you'd expect. There are a few special things you can do to construct more +powerful searches. + +* Put gåseøjne omkring nogle ord for at søge efter dem som én formulering. +* `AND` kan bruges til at søge efter dokumenter som indeholder to udtryk. +* `OR` kan bruges ti at søge efter dokumenter som indeholder ethvert af to + udtryk. +* Parenteser kan bruges til at opbygge komplicerede + søgeformuleringer. Eksempelvis "(foo AND bar) OR (mig AND dig)" +* Put "-" foran et søgeudtryk for at undgå det blandt + resultaterne. Eksempelvis vil "-discussion" udelade "discussion". +* Brug "title:foo" til at søge efter en side med en given titel. +* Brug "link:bar" til at søge efter sider som indeholder henvisning til + "bar". diff --git a/ikiwiki/subpage.mdwn b/ikiwiki/subpage.mdwn new file mode 100644 index 0000000..2b5a3c1 --- /dev/null +++ b/ikiwiki/subpage.mdwn @@ -0,0 +1,14 @@ +[[!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. + +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]]. diff --git a/ikiwiki/subpage/linkingrules.mdwn b/ikiwiki/subpage/linkingrules.mdwn new file mode 100644 index 0000000..bea5336 --- /dev/null +++ b/ikiwiki/subpage/linkingrules.mdwn @@ -0,0 +1,36 @@ +[[!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 passer til din henvisning. + +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. + +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. + +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]]. + +Du kan bruge dette til eksempelvis at henvise fra BazBar til +"FooBar/UnderSide", eller fra BazBar/UnderSide til "FooBar/UnderSide". + +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". + +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. diff --git a/ikiwiki/wikilink.mdwn b/ikiwiki/wikilink.mdwn new file mode 100644 index 0000000..86aa3d9 --- /dev/null +++ b/ikiwiki/wikilink.mdwn @@ -0,0 +1,30 @@ +[[!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]]`. + + +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]]. + +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. + +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]]` . + +If the file linked to by a WikiLink looks like an image, it will be +displayed inline on the page. + +--- + +You can also put an url in a WikiLink, to link to an external page. Email +addresses can also be used to generate a mailto link. |