====== 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 [[handleidingen:wiki:playground|playground]]-pagina. In de editor zijn opmaakregels ook makkelijk te verkrijgen via [[doku>toolbar|quickbuttons]].

===== Basis tekstopmaak =====

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 <sub>subscript</sub> en <sup>superscript</sup> gebruiken.

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

U kunt ook iets als <del>verwijderd</del> 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.

===== Links =====

DokuWiki ondersteunt meerdere manieren om een link te maken. 

==== Externe ====

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.

  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 ====

Interne links worden gemaakt door haken ( [[voorbeeld link]] ) te gebruiken. U kunt een [[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]].

  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 [[nl:syntax|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: [[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. 

  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.

==== Interwiki ====

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]].

  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 ====

Windows shares als [[\\server\share|deze]] worden ook herkend. Let er op dat deze alleen zin hebben in een homogene gebruikersgroep zoals een bedrijfs [[wp>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 [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]] in te stellen, maar dit wordt niet aangeraden.
  * Kijk op [[dokubug>151]] voor meer informatie.

==== Afbeeldings links ====

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}}]]

{{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 [[#images_and_other_files|afbeelding]] en [[#links|link]] syntax wordt ondersteund (inclusief vergroten/verkleinen, interne of externe afbeeldingen en URL's naar interwiki links.

===== Voetnoten =====

U kunt voetnoten((Dit is de tekst van een voetnoot)) maken door de tekst van de voetnoot tussen dubbele haakjes te plaatsen. 

===== In secties verdelen =====

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 ==

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

==== Plaatsen van lijnen ====

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

----

===== Afbeeldingen en andere bestanden =====

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

Werkelijke maat:                        {{wiki:dokuwiki-128.png}}
<code>
{{wiki:dokuwiki-128.png}}
</code>
Een bepaalde breedte aangegeven:            {{wiki:dokuwiki-128.png?50}}
<code>
{{wiki:dokuwiki-128.png?50}}
</code>
Een bepaalde breedte en hoogte aangegeven: {{wiki:dokuwiki-128.png?200x50}}
<code>
{{wiki:dokuwiki-128.png?200x50}}
</code>
Een externe afbeelding waarvan de afmetingen zijn veranderd:           {{http://de3.php.net/images/php.gif?200x50}}
<code>
{{http://de3.php.net/images/php.gif?200x50}}
</code>
Een bepaalde breedte en hoogte aangegeven: {{wiki:dokuwiki-128.png?200x50}}
<code>
{{wiki:dokuwiki-128.png?200x50}}
</code>
Een externe afbeelding waarvan de afmetingen zijn veranderd:         {{http://de3.php.net/images/php.gif?200x100}}
<code>
{{http://de3.php.net/images/php.gif?200x100}}
</code>
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 }}

  {{ 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}}

  {{ 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 [[syntax#afbeeldings_links]] hierboven.

===== Lijsten =====

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

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

<code>
  * 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
</code>

===== Smileys =====
Dokuwiki converteert algemeen gebruikte [[wp>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-)  %%
  * 8-O %%  8-O  %%
  * :-( %%  :-(  %%
  * :-) %%  :-)  %%
  * =)  %%  =)   %%
  * :-/ %%  :-/  %%
  * :-\ %%  :-\  %%
  * :-? %%  :-?  %%
  * :-D %%  :-D  %%
  * :-P %%  :-P  %%
  * :-O %%  :-O  %%
  * :-X %%  :-X  %%
  * :-| %%  :-|  %%
  * ;-) %%  ;-)  %%
  * ^_^ %%  ^_^  %%
  * :?: %%  :?:  %%
  * :!: %%  :!:  %%
  * LOL %%  LOL  %%
  * FIXME %%  FIXME %%
  * DELETEME %% DELETEME %%

===== Typografie =====

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

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

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

N.B.: Deze voorziening kan uitgeschakeld worden in [[doku>config#typography|config option]] en  [[doku>entities|pattern file]].

===== Citeren =====

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!

===== Tabellen =====

DokuWiki ondersteunt een eenvoudige syntax om tabellen te maken.

^ 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        |

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        |

  |       ^ 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.
^ 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        |

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

<code>
^ 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        |
</code>


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.

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

En zo ziet de code er uit:

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

===== Niet verwerkte paragrafen =====

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.

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

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

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 ''<nowiki>%%</nowiki>''.

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

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

===== Syntax benadrukken =====

[[DokuWiki]] kan broncode benadrukken zodat deze beter leesbaar wordt. Het gebruikt daarvoor de [[http://qbnz.com/highlighter/|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 ''<nowiki><code java></nowiki>''.

<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.
    }
}
</code>

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