Gebruikershulpmiddelen

Site-hulpmiddelen


wiki:syntax

Dit is een oude revisie van het document!


Opmaak syntax

DokuWiki maakt gebruikt van een eenvoudige opmaak, zodat de datafiles zo leesbaar mogelijk zijn. Deze pagina bevat al de mogelijke syntax die jullie nodig zouden kunnen hebben bij het aanpassen van pagina's. Werp een blik op de 'broncode' van deze pagina door op de knop Pagina aanpassen te klikken boven- of onderaan de pagina. Als je wat wilt proberen, maak dan gebruik van de zandbak. De eenvoudige opmaak is gemakkelijke te bereiken via sneltoetsen.

Basis tekstopmaak

Dokuwiki ondersteunt vette, cursieve, onderlijnde en monospaced teksten. Natuurlijk kan je deze allemaal combineren!

Dokuwiki ondersteunt **vette**, //cursieve//, __onderlijnde__ en ''monospaced'' teksten.
Natuurlijk kan je deze allemaal **__//''combineren''//__**!

Je kan ook subscript en superscript gebruiken.

Je kan ook <sub>subscript</sub> en <sup>superscript</sup> gebruiken.

Je kan ook nog teksten markeren om te verwijderen.

Je kan ook nog teksten markeren om te <del>verwijderen</del>.

Paragrafen worden gemaakt door een witregel tussen de tekst te plaatsen. Als je een nieuwe regelwilt beginnen zonder paragraaf, dan kun je twee backslashes typen, gevolgd door een spatie of een regeleinde.

Dit is tekst met enkele afgebroken regels
Merk op dat de twee backslashes enkel herkend worden op het einde van de regel
of gevolgd door
een spatie \\dit gebeurt er zonder een (spatie).

Dit is tekst met enkele afgebroken regels\\ Merk op dat de
twee backslashes enkel herkend worden op het einde van de regel\\
of gevolgd door\\ een spatie \\dit gebeurt er zonder een (spatie).

Het beste is als je nieuwe regels enkel gebruikt wanneer het echt nodig is.

Dokuwiki ondersteunt meerdere manieren om links te leggen.

Externe

Externe links worden automatisch herkend: http://www.google.be of eenvoudiger www.google.be - Je kan ook een naam bij een link zetten: Deze link wijst naar google. E-mailadressen zoals deze huybkoen@gmail.com worden ook herkend.

Externe links worden automatisch herkend: http://www.google.be of eenvoudiger www.google.be - Je kan ook een naam bij een link zetten: [[http://www.google.be|Deze link wijst naar google]]. E-mailadressen zoals deze <huybkoen@gmail.com> worden ook herkend.

Interne

Interne links worden gemaakt door vierkante haken te gebruiken. Je kan kiezen om enkel de paginanaam weer te geven of de titel. Wiki-paginanamen worden automatisch omgezet in kleine letters en speciale tekens zijn niet toegestaan.

Interne links worden gemaakt door vierkante haken te gebruiken. Je kan kiezen om enkel de [[paginanaam]] weer te geven of de [[paginanaam|titel]]. Wiki-paginanamen worden automatisch omgezet in kleine letters en speciale tekens zijn niet toegestaan.

Je kunt namespaces gebruiken door een dubbele punt te plaatsen in de paginanaam.

Je kunt [[wiki:namespaces]] gebruiken door een dubbele punt te plaatsen in de paginanaam.

Voor meer gedetailleerde informatie over namespaces zie: wiki:namespaces.

Het is ook mogelijk om naar een specifieke sectie te linken. Voeg gewoon de sectienaam toe achter een #-teken zoals in HTML. Dit verwijst naar deze Sectie.

Dit verwijst naar [[syntax#internal|deze Sectie]].

Opmerking:

  • Links naar bestaande pagina worden in een andere stijl weergegeven dan niet-bestaande pagina.
  • Dokuwiki gebruikt standaard geen CamelCase om automatische links te laggen, maar dit kan geactiveerd worden in de config. Hint: Als DokuWiki een link is, dan zijn CamelCase-links geactiveerd.
  • Als een sectietitel veranderd wordt, dan verandert zijn verwijzing ook. Vertrouw dus niet te veel op sectie-links.

Interwiki

Dokuwiki ondersteunt Interwiki links. Dit zijn snelle links naar andere wiki's. Bijvoorbeeld: dit is een link naar wikipedia's pagina over Wiki's: Wiki

Dokuwiki ondersteunt [[doku>wiki:interwiki|Interwiki]] links. Dit zijn snelle links naar andere wiki's. Bijvoorbeeld: dit is een link naar wikipedia's pagina over Wiki's: [[wp>Wiki]]

Gedeelde Windows-bestanden

Gedeelde Windows-bestanden zoals this worden ook herkend. Denk er echter aan dat dit enkel nuttig is voor een homogene gebruikersgroep zoals een gezamelijkIntranet.

Gedeelde Windows-bestanden zoals [[\\server\share|this]] worden ook herkend.

Opmerkingen:

  • Omwille van de veiligheid zijn gedeelde Windows-bestanden standaard enkel beschikbaar in Microsoft Internet Explorer (en dan nog enkel 'lokaal').
  • Voor Mozilla en Firefox can het geactiveerd worden in de configuratie security.checkloaduri, maar dit wordt niet aangeraden!
  • Zie 151 voor meer informatie

Linken naar afbeeldingen

Het is ook mogelijk afbeeldingen te gebruiken om links te leggen naar interne of externe pagina's door de syntax voor links en afbeeldingen te combineren (zie lager) zoals hier:

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

Merk op: De afbeeldingsformaten zijn enkel formaten die toegestaan zijn in hyperlinks.

De volledige Afbeeldingen en links syntax is ondersteund (waaronder ook afbeeldingsgrootte wijzigen, interne en externe afbeeldingen en URL's en interwiki links).

Voetnoten

Je kan voetnoten toevoegen 1) door dubbele haken te gebruiken

Je kan voetnoten toevoegen ((Dit is een voetnoot)) door dubbele haken te gebruiken

Secties

Je kan secties op 5 verschillende niveaus toepassen met 5 verschillende titels om je inhoud te sructureren. Als je meer dan 3 hoofdingen gebruikt, wordt er automatisch een inhoudstafel gegenereerd - dit kan afgezet worden door <nowikiW</nowiki> in het document toe te voegen.

Hoofding 3

Hoofding 4

Hoofding 5
==== Hoofding 3 ====
=== Hoofding 4 ===
== Hoofding 5 ==

Door vier of meer liggende streepjes te zetten maak je een horizontale lijn


Afbeeldingen en andere bestanden

Je kan externe en interne afbeeldingen invoegen door accolades te gebruiken. Als optie kan je de afmetingen ervan bepalen.

Echte maat:

Herschaal naar nieuwe breedte:

Herschaal naar nieuwe breedte en hoogte:

Herschaalde externe afbeelding:

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

Herschaal naar nieuwe breedte:           {{wiki:dokuwiki-128.png?50}}

Herschaal naar nieuwe breedte en hoogte: {{wiki:dokuwiki-128.png?200x50}}

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

Door links o recht spaties te laten, kan je de uitlijning kiezen.

{{ wiki:dokuwiki-128.png}}

{{wiki:dokuwiki-128.png }}

{{ wiki:dokuwiki-128.png }}

Natuurlijk kan je ook een titel toevoegen.2)

This is the caption

{{ wiki:dokuwiki-128.png |This is the caption}}

als je een filenaam vastlegt (intern of extern) die geen afbeelding is (gif, jpeg, png), dan zal het bestand als link weergegeven worden.

Om een afbeelding naar een andere pagina te linken, zie Image Links vanboven.

Lijsten

Dokuwiki geordende en niet-geordende lijsten. Om een lijstitem te maken, laat je je tekst twee spaties inspringen en gebruik een * voor een niet-geordende lijsten of een - voor een geordende.

  • Dit is een lijst
  • Het tweede item
    • Je kan meerdere niveaus hebben
  • Nog een item
  1. Dit is een lijst
  2. Het tweede item
    1. Je kan meerdere niveaus hebben
  3. Nog een item
  * Dit is een lijst
  * Het tweede item
    * Je kan meerdere niveaus hebben
  * Nog een item

  - Dit is een lijst
  - Het tweede item
    - Je kan meerdere niveaus hebben
  - Nog een item

Smileys

DokuWiki zet veel gebruikte emoticons om naar de grafische equivalent. Men kan meer smileys in de smiley map plaatsen en hen instelling in conf/smileys.conf. Hier volgt een overzicht van de smileys die bij DokuWiki horen.

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

Typografie

Dokuwiki can eenvoudige karakters omzetten naar hun typografische correcte vorm. Hieronder volgt een lijst met herkende karakters.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “Hij zei: 'Ik wiki vaak op wikipedia'…”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"Hij zei: 'Ik wiki vaak op wikipedia'..."

Men kan deze kerkenning ook uitschakelen in de configuratie.

Citeren

Soms kan het zijn dat je tekst wil weergeven als antwoord of commentaar. Hiervoor kan je volgende syntax gebruiken:

I think we should do it

> No we shouldn't

>> Well, I say we should

> Really?

>> Yes!

>>> Then lets do it!

I think we should do it

No we shouldn't
Well, I say we should
Really?
Yes!
Then lets do it!

Tabellen

DokuWiki maakt van een eenvoudige syntax gebruik om tabellen te maken.

Hoofding 1 Hoofding 2 Hoofding 3
Rij 1 Col 1 Rij 1 Col 2 Rij 1 Col 3
Rij 2 Col 1 colspan (Denk aan de dubbele verticalen streep)
Rij 3 Col 1 Rij 2 Col 2 Rij 2 Col 3

Een tabel moet beginnen en eindigen met een | voor een normale rij en ||^|| voor een hoofding

^ Hoofding 1     ^ Hoofding 2      ^ Hoofding 3                   ^
| Rij 1 Col 1    | Rij 1 Col 2     | Rij 1 Col 3                    |
| Rij 2 Col 1    | colspan (Denk aan de dubbele verticalen streep) ||
| Rij 3 Col 1    | Rij 2 Col 2     | Rij 2 Col 3                    |

Om 2 cellen horizontaal samen te laten horen, maak je gewoon de volgende cel helemaal leeg (zie hoger). Zorg ervoor dat je steeds dezelfde hoeveelheid delers hebt!

Hoofding 1 Hoofding 2 Hoofding 3
Rij 1 Col 1 Rij 1 Col 2 Rij 1 Col 3
Rij 2 Col 1 geen colspan
Rij 3 Col 1 Rij 2 Col 2 Rij 2 Col 3

Zoals je kunt zien, bepaalt de deler voor een cel of het een hoofding is of niet:

| Hoofding 1     ^ Hoofding 2      ^ Hoofding 3                   ^
^ Rij 1 Col 1    | Rij 1 Col 2     | Rij 1 Col 3                    |
^ Rij 2 Col 1    | geen colspan    |                                |
^ Rij 3 Col 1    | Rij 2 Col 2     | Rij 2 Col 3                    |

Opmerking: Het verticaal samenvoegen van cellen is niet mogelijk.

Je kan celinhouden ook uitlijnen. Laat minstens twee spaties voor of na de celinhoud: voeg twee spaties links toe om rechts uit te lijnen, rechts om links uit te lijnen en aan beide kanten om te centreren.

Tabbel met uitlijning
rechts center links
links rechts center
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

Zo ziet de code eruit:

^           Tabbel met uitlijning          ^^^
|         rechts|    center    |links          |
|links          |         rechts|    center    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Non-Wiki tekst

Je kan tekst aan een pagina toevoegen die niet door de wiki verwerkt wordt door twee of meer spaties voor de tekst te zetten of door de tags code of file te gebruiken.

Dit is code waar al de spaties behouden worden: zoals              <- dit
Dit is ongeveer hetzelfde, alleen kan je dit gebruiken om aan te tonen dat je een file citeert.

Om ervoor te zorgen dat een deel volledig genegeerd wordt bij het verwerken (bv. geen opmaak gebruiken), zet je de tekst tussen nowiki-tags of eenvoudig door procenttekens te gebruiken (%%).

Dit is tekst die een adres bevat zoals: http://wiki.kokohuyb.be en **opmaak**, maar er gebeurt niets mee.

Bekijk de bron van deze pagina om te zien hoe je deze blokken kan gebruiken.

Herkennen syntax

DokuWiki can broncode herkennen, waardoor deze gemakkelijker te lezen is. Het gebruikt de GeSHi 3) – zodat elke taal door GeSHi ondersteund wordt. De syntax is hetzelfde al in de code blokken in de vorige secties, met dit keer de naam van de gebruikte taal tussen de tags. Bv. <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.
    }
}

De volgende talen worden op dit moment herkend: actionscript, actionscript-french, ada, apache, applescript, asm, asp, bash, blitzbasic, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, diff, d, div, dos, eiffel, freebasic, gml, html4strict, ini, inno, java, javascript, lisp, lua, matlab, mpasm, mysql, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, scheme, sdlbasic, smarty, sql, ruby, vb, vbnet, vhdl, visualfoxpro, xml

Toevoegen HTML en PHP

Je kan pure HTML en PHP in je pagina's toevoegen door de html - of php - tags te gebruiken zoals hier:

<html>
This is some <font color="red" size="+1">HTML</font>
</html>

<html> This is some <font color=“red” size=“+1”>HTML</font> </html>

<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>

<php> echo 'A logo generated by PHP:'; echo '<img src=“' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '” alt=“PHP Logo !” />'; </php>

Let op: HTML en PHP toevoegen is standaard uitgeschakeld in de configuratie. Als deze af staat, wordt de code getoond in plaats van uitgevoerd.

Syntax Plugins

De syntax van DokuWiki kan uitgebreid worden door Plugins toe te voegen. Hoe deze geïnstalleerd worden kan op de bijhorende pagina gelezen worden. De volgende syntax plugins zijn in deze DokuWiki beschikbaar:

1)
Dit is een voetnoot
2)
meestal als tooltip getoond
3)
Generic Syntax Highlighter
wiki/syntax.1186657979.txt.gz · Laatst gewijzigd: (Externe bewerking)