Opmaakregels (syntax)

DokuWiki ondersteunt eenvoudige opmaakregels om gegevensbestanden zo leesbaar mogelijk te maken. Deze pagina bevat alle mogelijke regels die u kunt gebruiken om uw teksten vorm te geven. Kijk naar de broncode van deze pagina door op de knop Edit this page onderaan deze pagina te klikken. Je komt dan in de editor. Als u iets wilt uitproberen, gebruik dan de playground-pagina. In de editor zijn opmaakregels ook makkelijk te verkrijgen via quickbuttons.

DokuWiki ondersteunt vetgedrukt, cursief, onderstreept en monospaced teksten. Uiteraard kunt u al deze mogelijkheden ”combineren”.

DokuWiki ondersteunt **vetgedrukt**, //cursief//,  __onderstreept__ en ''monospaced'' teksten. 
Uiteraard kunt u al deze mogelijkheden **__//”combineren”//__**.

U kunt ook _subscript en ^superscript gebruiken.

U kunt ook <sub>subscript</sub> en <sup>superscript</sup> gebruiken.

U kunt ook iets als verwijderd aangeven.

U kunt ook iets als <del>verwijderd</del> aangeven.

Paragrafen worden gemaakt door witregels (de return toets gebruiken). Als u een nieuwe regel wilt beginnen maar geen nieuwe paragraaf gebruikt u twee backslashes aan het eind van de regel.

Dit is een stukje tekst met wat afbrekingen.
Let er op dat de backslashes alleen aan het eind van een zin herkend worden of als zij gevolgd worden
door een spatie. \\Dit gebeurt er zonder spatie.

Dit is een stukje tekst met wat afbrekingen.\\
Let er op dat de backslashes alleen\\ aan het eind van een zin herkend 
worden of als zij gevolgd worden door een spatie. \\Dit gebeurt er zonder spatie.

Gebruik geforceerde nieuwe regels alleen bij uitzondering.

DokuWiki ondersteunt meerdere manieren om een link te maken.

Externe links worden ‘automagisch’ herkend: http://www.google.com of simpelweg www.google.com

U kunt een link ook een naam geven: Deze link wijst naar Google. E-mailadressen zoals deze: andi@splitbrain.org worden ook herkend.

Externe links worden ‘automagisch’ herkend: http://www.google.com of simpelweg www.google.com 
U kunt een link ook een naam geven: [[http://www.google.com|Deze link wijst naar Google]]. 
E-mailadressen zoals deze: <andi@splitbrain.org> worden ook herkend.

Interne links worden gemaakt door haken ( voorbeeld link ) te gebruiken. U kunt een syntax gebruiken of een titel toevoegen Syntax tekst. Wiki-paginanamen worden automatisch geconverteerd naar onderkast (kleine letters); bijzondere tekens zijn niet toegestaan. Links naar niet bestaande pagina's of 'dode' links worden rood en onderstreept weergegeven. Actieve links zijn groen: syntax.

Interne links worden gemaakt door haken ( [[voorbeeld link]] ) te gebruiken.
U kunt een paginanaam [[syntax]] gebruiken of een titel toevoegen [[syntax|Syntax tekst]].
Wiki-paginanamen worden automatisch geconverteerd naar onderkast (kleine letters);
bijzondere tekens zijn niet toegestaan. Links naar niet bestaande pagina's of 'dode' links
worden [[rood en onderstreept]] weergegeven. Actieve links zijn groen: [[handleidingen:wiki:syntax]].

Namespaces
Namespaces zijn de verschillende delen waaruit een Wiki-site kan bestaan. B.v. Boek 1, Boek 2, Boek 3 enz. U kunt linken naar namespaces door een dubbele punt in de naam van de pagina toe te voegen.

Namespaces zijn de verschillende delen waaruit een Wiki-site kan bestaan.
B.v. Boek 1, Boek 2, Boek 3 enz. U kunt linken naar [[namespaces]] door een
dubbele punt in de naam van de pagina toe te voegen.

U kunt ook naar een specifiek deel binnen een namespace linken door een stok ( | ) toe te voegen. Deze linkt naar deze pagina Formatterings syntax

U kunt ook naar een specifiek deel binnen een namespace linken door een stok ( | ) toe te voegen.
Deze linkt naar deze pagina [[handleidingen:wiki:syntax#interne|Opmaakregels (syntax)]]

U kunt ook naar een bepaalde paragraaf op een bepaalde pagina linken door een hekje toe te voegen. Deze linkt naar een paragraaf op deze pagina: Basis tekstopmaak U kunt eenvoudig zien waar u naartoe zou willen linken door (een deel van) de code uit de adresregel van uw browser te kopiëren.

U kunt ook naar een bepaalde paragraaf op een bepaalde pagina linken door een hekje toe
te voegen. Deze linkt naar een paragraaf op deze pagina:
[[syntax#basis_tekstopmaak|Basis tekstopmaak]] 
U kunt eenvoudig zien waar u naartoe zou willen linken door (een deel van) de code uit de
adresregel van uw browser te kopiëren.

DokuWiki ondersteunt Interwiki-links. Dat zijn snelle links naar andere Wiki's. Dit is bijvoorbeeld een link naar Wikipedia's pagina over Wiki's: Wiki.

DokuWiki ondersteunt [[doku>interwiki|Interwiki]]-links. Dat zijn snelle links
naar andere Wiki's. Dit is bijvoorbeeld een link naar Wikipedia's pagina over Wiki's: [[wp>Wiki]].

Windows shares als deze worden ook herkend. Let er op dat deze alleen zin hebben in een homogene gebruikersgroep zoals een bedrijfs Intranet.

N.B.

• Om veiligheidsredenen functioneert direct browsen op bijvoorbeeld een intranet als standaard uitsluitend in Microsoft Internet Explorer (en alleen in de 'locale zone').
• Voor Mozilla en Firefox kan het geactiveerd worden door de configuratieoptie security.checkloaduri in te stellen, maar dit wordt niet aangeraden.
• Kijk op 151 voor meer informatie.

U kunt ook een afbeelding gebruiken om naar een interne of externe pagina te linken door de syntax voor links en afbeeldingen (zie hieronder) te combineren.

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Let op: de enige afbeeldingsnaam die in een link wordt geaccepteerd is de naam die DokuWiki aan de afbeelding heeft gegeven nadat deze op de server is geplaatst. De gehele afbeelding en link syntax wordt ondersteund (inclusief vergroten/verkleinen, interne of externe afbeeldingen en URL's naar interwiki links.

U kunt voetnoten¹⁾ maken door de tekst van de voetnoot tussen dubbele haakjes te plaatsen.

U kunt uw materiaal tot in vijf verschillende niveaus verdelen om deze te structureren. Als u meer dan drie koppen gebruikt (Headlines 5, 4 en 3) wordt automatisch een inhoudsopgave aangemaakt - dit kan uitgeschakeld worden door het commando –NOTOC– in het document in te voegen.

==== Headline Level 3 ====
=== Headline Level 4 ===
== Headline Level 5 ==

Door tenminste vier koppeltekens ( - ) achter elkaar te plaatsen ontstaat automatisch een lijn.

U kunt interne en externe images invoegen door accolades ( {{}} )te gebruiken. Optioneel kunt u ook de afbeelding vergroten of verkleinen.

Werkelijke maat:

{{wiki:dokuwiki-128.png}}

Een bepaalde breedte aangegeven:

{{wiki:dokuwiki-128.png?50}}

Een bepaalde breedte en hoogte aangegeven:

{{wiki:dokuwiki-128.png?200x50}}

Een externe afbeelding waarvan de afmetingen zijn veranderd:

{{http://de3.php.net/images/php.gif?200x50}}

Een bepaalde breedte en hoogte aangegeven:

{{wiki:dokuwiki-128.png?200x50}}

Een externe afbeelding waarvan de afmetingen zijn veranderd:

{{http://de3.php.net/images/php.gif?200x100}}

Door links of rechts spaties toe te voegen kunt u links of rechts uitlijnen of centreren.

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

U kunt ook een titel toevoegen die in de meeste browsers getoond wordt.

{{ wiki:dokuwiki-128.png |Dit is de titel}}

Als u de naam van een bestand opgeeft (intern of extern), dat geen afbeelding is ((gif, jpeg, png), dan wordt deze als link weergegeven.

Om een afbeelding te linken naar een andere pagina kijkt u op afbeeldings_links hierboven.

Dokuwiki ondersteunt opsommingslijsten en genummerde lijsten. Begin een regel met twee spaties om een lijst te maken. Gebruik een * (asterisk) voor een opsomming of een - (koppelteken) voor een genummerde lijst.

• Dit is een opsomming
• Dit is de tweede regel
  • U kunt verschillende niveaus gebruiken
• Nog een regel

1. Dit is een opsomming
2. Dit is de tweede regel
   1. U kunt verschillende niveaus gebruiken
3. Nog een regel

  * Dit is een opsomming
  * Dit is de tweede regel
    * U kunt verschillende niveaus gebruiken
  * Nog een regel

  - Dit is een opsomming
  - Dit is de tweede regel
    - U kunt verschillende niveaus gebruiken
  - Nog een regel

Dokuwiki converteert algemeen gebruikte emoticons naar hun grafische afbeeldingen. Er kunnen smileys in de 'smiley'-directory bijgeplaatst worden die dan met de conf/smileys.conf geconfigureerd kunnen worden.

• 8-)
• 8-O
• :-(
• :-)
• =)
• :-/
• :-\
• :-?
• :-D
• :-P
• :-O
• :-X
• :-|
• ;-)
• ^_^
• :?:
• :!:
• LOL
• FIXME
• DELETEME

Dokuwiki converteert lettercodes naar hun overeenkomstige typografische afbeelding. Hier een paar voorbeelden.

→ ← → ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “He thought 'It's a man's world'…”

-> <- -> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

N.B.: Deze voorziening kan uitgeschakeld worden in config option en pattern file.

Soms is het nodig om in een tekst aan te geven of iets een opmerking of een reactie is. U kunt dan de volgende syntax gebruiken:

Ik geloof dat we het moeten doen

> Nee, ik vind van niet

>> Nou, ik zeg van wel

> Echt?

>> Ja!

>>> Laten we het dan maar doen!

Ik geloof dat we het moeten doen

Nee, ik vind van niet

Nou, ik zeg van wel

Echt?

Ja!

Laten we het dan maar doen!

DokuWiki ondersteunt een eenvoudige syntax om tabellen te maken.

Regels in tabellen moeten beginnen met een | (stok) voor gewone regels of een ^ voor een kopje boven de tabel.

^ Kopje 1      ^ Kopje 2       ^ Kopje 3          ^
| Regel 1 kol 1    | Regel 1 kol 2     | Regel 1 kol 3        |
| Regel 2 kol 1    | op twee kolommen (let op de twee stokken) ||
| Regel 3 kol 1    | Regel 2 kol 2     | Regel 2 kol 3        |

Sluit een tabel altijd af met een omhaal (return).

Om cellen horizontaal te verbinden maak dan de opvolgende cel helemaal leeg zoals in het voorbeeld hierboven. Let er op dat er wel altijd hetzelfde aantal stokken gebruikt wordt!

Verticale kopjes zijn ook mogelijk.

|       ^ Kopje 1       ^ Kopje 2          ^
^ Kopje 3    | Regel 1 kol 2     | Regel 1 kol 3        |
^ Kopje 4    | Regel 2 kol 2     | Regel 2 kol 3        |
^ Kopje 5    | Regel 3 kol 2     | Regel 3 kol 3        |

Je kan ook rowspans (verticaal samengevoegde cellen) krijgen door ::: in onderliggende cellen in te voeren.

Naast deze rowspan syntax mogen deze cellen niets anders dan spaties bevatten.

^ Kop 1          ^ Kop 2                                   ^ Kop 3              ^
| Rij 1 Col 1    | deze cellen zijn verticaal samengevoegd | Rij 1 Col 3        |
| Rij 2 Col 1    | :::                                     | Rij 2 Col 3        |
| Rij 3 Col 1    | :::                                     | Rij 2 Col 3        |

De inhoud van een tabel kan gecentreerd, links of rechts uitgelijnd worden. Plaats twee spaties achter de tekst om links uit te lijnen, begin de tekst met twee spaties om rechts uit te lijnen en plaats tenminste twee spaties voor én na een tekst om te centreren.

En zo ziet de code er uit:

^           Tabel met uitlijning           ^^^
|         rechts|    gecentreerd    |links          |
|links          |         rechts|    gecentreerd    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

U kunt paragrafen in uw documenten invoegen die niet door 'wiki' verwerkt worden door deze met tenminste twee spaties te laten beginnnen (zoals in eerdere voorbeelden getoond) of door de codes code of file te gebruiken.

De code is geformatteerd en alle spaties werden bewaard: zoals              <-dit

Deze is ongeveer hetzelfde en kunt u gebruiken door bijvoorbeeld een citaat aan te geven.

Om de parser een groter deel van het document te laten negeren (dus niet te verwerken) sluit dat gedeelte dan in met nowiki-tags of, eenvoudiger, met dubbele procent tekens %%.

Dit is een tekst met een adres: http://www.splitbrain.org en **opmaakregels**, maar er wordt niets mee gedaan.

Kijk in de broncode van deze pagina om te zien hoe deze blokken worden gebruikt.

DokuWiki kan broncode benadrukken zodat deze beter leesbaar wordt. Het gebruikt daarvoor de GeSHi Generic Syntax Highlighter – zodat elke door GeSHi ondersteunde taal wordt ondersteund. De syntax is hetzelfde als in de codeparagraaf in het vorige onderdeel maar deze keer wordt de gebruikte taal aan de tag toegevoegd. Bijvoorbeeld <code java>.

/** 
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

Momenteel worden de syntaxen van de volgende programmeertalen herkend: abap actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, cpp-qt, csharp, css, delphi, diff, div, dos, dot, d, eiffel, fortran, freebasic, genero, gml, groovy, haskell, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, m68k, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, per, php-brief, php, plsql, python, qbasic, rails, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml, xpp, z80