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 Pagina aanpassen bovenaan- of 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 vierkante haken [[ ]] te gebruiken. U kunt een pagename gebruiken of een titel toevoegen Tekstlink naar de gewenste paginanaam.

U kunt een [[pagename]] gebruiken 
of een titel toevoegen [[pagename|Tekstlink naar de gewenste paginanaam]].

Wiki-paginanamen worden automatisch geconverteerd naar onderkast (kleine letters); bijzondere tekens zijn niet toegestaan.

Je kunt namespaces gebruiken door een dubbelepunt in de paginanaam.

Je kunt [[enige:namespaces]] gebruiken door een dubbelepunt in de 
paginanaam.

Voor details over namespaces zie namespaces

Links naar een specifieke alinea van de pagina is ook mogelijk. Voeg de alineanaam toe achter een hekje zoals bekent in HTML. Dit linkt naar deze alinea en dit kan nog korter als deze alinea op dezelfde pagina staat.

Dit linkt naar [[nl:wiki:syntax#interne|deze alinea]] 
en dit kan korter als [[#interne|deze alinea]] op dezelfde pagina staat.

Opmerkingen:

• Links naar een bestaande pagina hebben een andere stijl dan niet bestaande links.
• DokuWiki gebruikt standaard geen CamelCase om automatisch links te maken, maar dit gedrag kan aangezet worden door in de config-instellingen. Tip: Als DokuWiki een link is, dan staat het aan.
• Als een alinea-titel wordt gewijzigd, wijzigt alinealink [[nl:wiki:syntax#interne|deze alinea]] ook. Dus vertrouw niet teveel op alinealinks.

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.

Windows shares als [[\\server\share|deze]] worden ook herkend.

Opmerkingen:

• 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 een suggestie uit de Mozilla Knowledge Base. Echter, er zal nog steeds een JavaScript-waarschuwing gegeven worden bij het openen van een Windows Share. Om deze waarschuwing te verwijderen (voor alle gebruikers), moet je de volgende regel in conf/userscript.js plaatsen:

LANG.nosmblinks = '';

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

Kijk ook op FAQ over opsommingslijsten.

DokuWiki can bepaalde voor-gedefineerde tekens of strings omzetten in plaatjes of andere tekst of HTML.

De tekst-naar-afbeelding conversie wordt vooral gedaan voor smileys. En de tekst-naar-HTML conversie is vooral voor typografische vervangingen, maar kan ook worden ingesteld om andere HTML te gebruiken.

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 3 kol 2     | Regel 3 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 |

Opmerking: Verticale uitlijning wordt niet ondersteund.

Als het nodig is dat de tekst precies zo wordt weergegeven als getypt(zonder opmaak), Sluit dit gedeelte dan in met <nowiki> tags of nog makkelijker, met dubbele procenttekens %%.

Dit is wat tekst die adressen bevat zoals dit: http://www.splitbrain.org en **opmaakcode**, maar niets doet het. Hetzelfde is waar voor //__deze__ tekst// met een smiley ;-).

<nowiki> 
Dit is wat tekst die adressen bevat zoals dit: http://www.splitbrain.org en 
**opmaakcode**, maar niets doet het.
</nowiki> 
Hetzelfde is waar voor %%//__deze__ tekst// met een smiley ;-)%%.  

U kunt codeblokken 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.

Deze tekst begint met twee spaties

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.

Deze blokken zijn gemaakt met deze code:

  Deze tekst begint met twee spaties

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

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 nu wordt de taal van de gewenste codestijl 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: 4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript-french, actionscript, actionscript3, ada, algol68, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, epc, ecmascript, eiffel, email, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, go, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, html5, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, uscript, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic

Wanneer je <code> of <file> syntax gebruikt, wil je misschien ook dat de weergegeven code beschikbaar is om te downloaden. Dit kan door een bestandsnaam na de taal code toe te voegen:

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>

myexample.php

<?php echo "hello world!"; ?>

If you don't want any highlighting but want a downloadable file, specify a dash (-) as the language code: <code - myfile.foo>.

Je kunt ruwe HTML of PHP code in je documenten invoegen door het gebruiken van <html> of <php> tags. (Gebruik alleen hoofdletter tags als er block level elementen nodig zijn.)

HTML voorbeeld:

<html>
Dit is wat <span style="color:red;font-size:150%;">inline HTML</span>
</html>
<HTML>
<p style="border:2px dashed red;">En dit is wat block HTML</p>
</HTML>

Dit is wat inline HTML

En dit is wat block HTML

PHP voorbeeld:

<php>
echo 'Een logo gegenereerd door PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
echo '(genereert inline HTML)';
</php>
<PHP>
echo '<table class="inline"><tr><td>Dit is hetzelfde, maar in een block level element:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
echo '</tr></table>';
</PHP>

echo 'Een logo gegenereerd door PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; echo '(genereert inline HTML)';

echo '<table class="inline"><tr><td>Dit is hetzelfde, maar in een block level element:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
echo '</tr></table>';

Let op deze opmerking: HTML en PHP invoegen is standaard uitgeschakeld in de instellingen. De code wordt weergegeven in plaats van uitgevoerd als deze functie is uitgeschakeld.

DokuWiki kan data integreren van externe XML feeds. Voor het weergeven van XML feeds wordt SimplePie gebruikt. Alle formaten die door SimplePie worden begrepen kunnen ook worden gebruikt in DokuWiki. De weergave kan worden beïnvloed met de volgende parameters, gescheiden door spaties:

Het vernieuwingsinterval is standaard 4 uren. Een waarde onder de 10 minuten wordt behandeld als 10 minuten. Dokuwiki zal over het algemeen proberen om een gecachte versie van de pagina te bewaren, uiteraard is dit verkeerd als een pagina dynamische externe inhoud bevat. De parameter vertelt DokuWiki om de pagina te opnieuw te renderen en op te slaan in de cache als die ouder is dan de vernieuwingsinterval sinds de pagina de laatste keer was gerenderd.

Voorbeeld:

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

• Is Self-Healing Code the Future of Software Development? door EditorDavid (2023/06/10 22:53 (UTC))
• 'Extremely Remorseful' Lawyers Confronted by Judge Over 'Legal Gibberish' Citations from ChatGPT door EditorDavid (2023/06/10 21:54 (UTC))
• Linux Foundation Announces Collaboration for 'Open Radio Access Network' Prototypes door EditorDavid (2023/06/10 20:34 (UTC))
• Ted Kaczynski, Known as the 'Unabomber,' has Died in Prison at Age 81 door EditorDavid (2023/06/10 19:34 (UTC))
• CNN Sees 'Escalating Battle' Over Returning to the Office at Tech Companies door EditorDavid (2023/06/10 18:34 (UTC))

Sommige syntax beïnvloedt hoe DokuWiki een pagina rendert zonder dat het zelf uitvoer creëert. De volgende control macro's zijn beschikbaar:

Dokuwiki's syntax kan worden uitgebreid met Plugins. Hoe de geïnstalleerde plugins worden gebruikt is beschreven op hun eigen pagina's. De volgende syntax plugins zijn beschikbaar in deze DokuWiki installatie:

• Add New Page 2015-11-02 door Benjamin Santalucia, Sam Wilson, Michael Braun, Gerrit Uitslag, Albert Chern
  Adds a "new page form" to any wiki page.
• authorstats plugin 2021-02-28 door George Chatzisofroniou, Constantinos Xanthopoulos
  Plugin that outputs statistics about the wiki's authors.
• Bookcreator Plugin 2021-03-30 door Gerrit Uitslag (previous: Luigi Micco)
  Allow to make a book (PDF, ODT, HTML or text) from selected pages
• Box Plugin 2016-02-17 door Christopher Smith
  Boxes with titles, colour and rounded corners. Syntax: <box width class colours|title> ... </box|caption> width, class, colours title & caption are optional. The title can include some wiki markup, the box contents can include almost any wiki markup.
• Changes Plugin 2021-01-25 door Andreas Gohr
  List the most recent changes of the wiki
• Columns Plugin 2021-04-04 door Mykola Ostrovskyy
  Arrange information in multiple columns.
• Dw2Pdf plugin 2021-02-07 door Andreas Gohr and Luigi Micco
  DokuWiki to PDF converter
• epub 2011-07-1 door Myron Turner
  ebook creator
• HTML Comment Plugin 2013-03-19 door Christopher Arndt
  allows HTML comments to be retained in the output
• include plugin 2021-03-06 door Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
  Functions to include another page in a wiki page
• Info Plugin 2020-06-04 door Andreas Gohr
  Displays information about various DokuWiki internals
• keyboard 2020-09-27 door Gina Häußge
  The keyboard plugin provides a combined syntax and action plugin in order to markup text as keyboard keys, similar to (and making use of) the existing (X)HTML tag <kbd>…</kbd>. A quick button for the markup is automatically inserted into the toolbar of the edit form.
• Note Plugin 2020-06-28 door Olivier Cortès, Eric Hameleers, Christopher Smith, Aurélien Bompard, LarsDW223
  Add Note/Important/Tip/Warning Capability (DIV+CSS box)
• Pagelist Plugin 2020-09-27 door Matthias Schulte, Michael Hamann, Michael Klier, Gina Haeussge
  Lists pages in a nice formatted way
• PageQuery Plugin 2014-11-09 door Symon Bent
  Search for (fulltext) and list wiki pages, sorted and optionally grouped by name, date, creator, abc, etc. in columns. Insert the pagequery markup wherever you want your list to appear. E.g.{{pagequery>[query;fulltext;sort=key:direction,key2:direction;group;limit=??;cols=?;inwords;proper]}} [..] = optional
• Page Redirect 2017-05-12 door Elan Ruusamäe, David Lorentsen
  Redirects page requests based on content
• Tag Plugin 2020-09-26 door Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
  tag wiki pages
• Translation Plugin 2020-03-24 door Andreas Gohr
  Supports the easy setup of a multi-language wiki.
• Video Sharing Site Plugin 2020-03-18 door Andreas Gohr
  Easily embed videos from various Video Sharing sites. Example: {{youtube>XXXXXX}}
• WikiStatistics 2010-01-24 door Emanuele, Thomas
  Display statistics about the Wiki and their users
• Wrap Plugin 2018-04-22 door Anika Henke
  Universal plugin which combines functionalities of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction.