----
===== Afbeeldingen en andere bestanden =====
U kunt interne en externe [[doku>images|afbeeldingen, audio of videobestanden]] invoegen door accolades (''{{}}'')te gebruiken.
Optioneel kunt u de grootte van de afbeelding bepalen.
Werkelijke breedte: {{wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png}}
Een bepaalde breedte aangegeven: {{wiki:dokuwiki-128.png?50}}
{{wiki:dokuwiki-128.png?50}}
Een bepaalde breedte en hoogte aangegeven: {{wiki:dokuwiki-128.png?200x50}}
{{wiki:dokuwiki-128.png?200x50}}
Een externe afbeelding waarvan de afmetingen zijn veranderd: {{http://de3.php.net/images/php.gif?200x50}}
{{http://de3.php.net/images/php.gif?200x50}}
Een bepaalde breedte en hoogte aangegeven: {{wiki:dokuwiki-128.png?200x50}}
{{wiki:dokuwiki-128.png?200x50}}
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 als een tooltip in de meeste browsers getoond wordt.
{{ wiki:dokuwiki-128.png |Dit is de titel}}
{{ wiki:dokuwiki-128.png |Dit is de titel}}
==== Ondersteunde mediaformaten ====
DokuWiki kan de volgende mediaformaten in de tekst weergeven:
| Image | ''gif'', ''jpg'', ''png'' |
| Video | ''webm'', ''ogv'', ''mp4'' |
| Audio | ''ogg'', ''mp3'', ''wav'' |
| Flash | ''swf'' |
Als u de naam van een bestand opgeeft die geen ondersteund mediaformaat is, dan wordt deze in plaats daarvan als link weergegeven.
Door ?linkonly aan de afbeelding toe te voegen kan je de afbeelding als een link tonen in plaats van in de tekst.
{{wiki:dokuwiki-128.png?linkonly}}
{{wiki:dokuwiki-128.png?linkonly}} Dit is gewoon een link naar de afbeelding.
==== Formaten om op terug te vallen ====
Jammer genoeg begrijpen niet alle browsers alle video- en audioformaten. Om dit probleem te omzeilen en compatibel te zijn met zoveel mogelijk browsers kan je jouw bestand in verschillende formaten uploaden.
Neem nu bijvoorbeeld deze mp4 video in de tekst:
{{video.mp4|A funny video}}
Als je behalve de video.mp4 waarnaar wordt verwezen ook een video.webm en video.ogv uploadt, zal Dokuwiki ze automatisch toevoegen als alternatieven zodat een van de drie bestanden wordt begrepen door je browser.
Bovendien ondersteunt DokuWiki ook een "poster"-beeld dat wordt getoond voor de video start. Dat beeld moet wel dezelfde bestandsnaam hebben als de video en is ofwel een jpg of png-bestand. In het voorbeeld bovenaan zou het bestand video.jpg werken.
===== 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 opsommingslijst
* Dit is de tweede regel
* U kunt verschillende niveaus gebruiken
* Nog een regel
- Dit is een genummerde lijst
- Dit is de tweede regel
- U kunt verschillende niveaus gebruiken
- Nog een regel
* Dit is een opsommingslijst
* Dit is de tweede regel
* U kunt verschillende niveaus gebruiken
* Nog een regel
- Dit is een genummerde lijst
- Dit is de tweede regel
- U kunt verschillende niveaus gebruiken
- Nog een regel
Kijk ook op [[doku>faq:lists|FAQ over lijsten]].
===== Tekstomzettingen =====
DokuWiki can bepaalde voorgedefineerde tekens of strings omzetten in afbeeldingen of andere tekst of HTML.
De [[smileys|tekst-naar-afbeelding conversie]] wordt vooral gedaan voor smileys. En de [[entities|tekst-naar-HTML conversie]] is vooral voor typografische vervangingen, maar kan ook worden ingesteld om andere HTML te gebruiken.
==== Tekst naar afbeeldingen conversie ====
Dokuwiki converteert algemeen gebruikte [[wpnl>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 %%
==== Tekst naar HTML conversie ====
[[Dokuwiki]] converteert lettercodes naar hun overeenkomstige typografische afbeelding. Hier een paar voorbeelden.
-> <- -> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"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 [[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 3 kol 2 | Regel 3 kol 3 |
Regels in tabellen moeten beginnen met een ''|'' 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 |
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 scheidingstekens 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.
^ 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.
^ 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 |
Opmerking: Verticale uitlijning wordt niet ondersteund.
===== Geen opmaak =====
Als het nodig is dat de tekst precies zo wordt weergegeven als getypt(zonder opmaak), Sluit dit gedeelte dan in met ''%%%%'' of ''%%%%'' 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
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.
===== 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 nu wordt de taal van de gewenste codestijl aan de tag toegevoegd. Bijvoorbeeld ''
/**
* 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//
==== Downloadbare Codeblokken ====
Wanneer je ''%%%%'' of ''%%%%'' 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:
If you don't want any highlighting but want a downloadable file, specify a dash (''-'') as the language code: ''%%%%''.
===== Ingevoegde HTML en PHP code=====
Je kunt ruwe HTML of PHP code in je documenten invoegen door het gebruiken van ''%%%%'' of ''%%%%'' tags. (Gebruik alleen hoofdletter tags als er block level elementen nodig zijn.)
HTML voorbeeld:
Dit is wat inline HTML
En dit is wat block HTML
Dit is wat inline HTML
En dit is wat block HTML
PHP voorbeeld:
echo 'Een logo gegenereerd door PHP:';
echo ' . ')
';
echo '(genereert inline HTML)';
echo 'Dit is hetzelfde, maar in een block level element: ';
echo '
';
echo 'Een logo gegenereerd door PHP:';
echo '';
echo '(genereert inline HTML)';
echo 'Dit is hetzelfde, maar in een block level element: ';
echo '
';
**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.
===== RSS/ATOM Feed Aggregation =====
DokuWiki kan data integreren uit externe XML feeds. Voor het aanmaken van XML feeds wordt [[http://simplepie.org/|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:
^ Parameter ^ Beschrijving ^
| een nummer | wordt gebruikt als maximum aantal weer te geven items, standaard op 8 |
| reverse | laat de laatste items in de feed het eerste zien |
| author | geeft de namen van item-auteurs |
| date | geeft itemdatums |
| description| geeft itembeschrijving. Als [[doku>config:htmlok|HTML]] uitgeschakeld is worden alle tags gestript |
| //n//[dhm] | vernieuwingsinterval, waar d=dagen, h=uren, m=minuten. (bijv. 12h = 12 uur). |
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 }}
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
===== Control Macros =====
Sommige syntax beïnvloedt hoe DokuWiki een pagina rendert zonder dat het zelf uitvoer creëert. De volgende control macro's zijn beschikbaar:
^ Macro ^ Beschrijving |
| %%~~NOTOC~~%% | Als deze macro wordt gevonden op een pagina, dan wordt er geen inhoudsopgave gemaakt |
| %%~~NOCACHE~~%% | DokuWiki cachet standaard alle uitvoer. Soms is dit niet gewenst (bijv. wanneer de %%%% syntax wordt gebruikt), het toevoegen van deze macro dwingt DokuWiki om bij elk verzoek de pagina opnieuw te renderen. |
===== Syntax Plugins =====
Dokuwiki's syntax kan worden uitgebreid met [[doku>plugins|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:
~~INFO:syntaxplugins~~