wiki:syntax
Verschillen
Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.
| Beide kanten vorige revisieVorige revisieVolgende revisie | Vorige revisie | ||
| wiki:syntax [2007/08/09 13:12] – Pieter van der Meulen | wiki:syntax [2024/02/10 21:25] (huidige) – Externe bewerking 127.0.0.1 | ||
|---|---|---|---|
| Regel 1: | Regel 1: | ||
| - | ====== | + | ====== |
| - | [[wiki:DokuWiki]] | + | [[doku>DokuWiki]] |
| - | ===== Basis tekstopmaak | + | ===== Basic Text Formatting |
| - | Dokuwiki ondersteunt | + | DokuWiki supports |
| - | < | + | DokuWiki supports |
| - | Dokuwiki ondersteunt | + | Of course you can **__//'' |
| - | Natuurlijk kan je deze allemaal | + | |
| - | </ | + | |
| - | Je kan ook < | + | You can use < |
| - | < | + | You can use < |
| - | Je kan ook < | + | |
| - | </ | + | |
| - | Je kan ook nog teksten markeren om te <del>verwijderen</ | + | You can mark something as <del>deleted</ |
| - | < | + | You can mark something as <del>deleted</ |
| - | Je kan ook nog teksten markeren om te <del>verwijderen</ | + | |
| - | </ | + | |
| - | **Paragrafen** worden gemaakt door een witregel tussen de tekst te plaatsen. Als je een **nieuwe regel**wilt beginnen zonder paragraaf, dan kun je twee backslashes | + | **Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes |
| - | Dit is tekst met enkele afgebroken regels\\ Merk op dat de | + | This is some text with some linebreaks\\ Note that the |
| - | twee backslashes | + | two backslashes |
| - | of gevolgd door\\ een spatie | + | or followed by\\ a whitespace |
| - | < | + | This is some text with some linebreaks\\ Note that the |
| - | Dit is tekst met enkele afgebroken regels\\ Merk op dat de | + | |
| - | twee backslashes | + | or followed by\\ a whitespace |
| - | of gevolgd door\\ een spatie | + | |
| - | </ | + | |
| - | Het beste is als je nieuwe regels enkel gebruikt wanneer het echt nodig is. | + | You should use forced newlines only if really needed. |
| - | ===== Link ===== | + | ===== Links ===== |
| - | Dokuwiki ondersteunt meerdere manieren om links te leggen. | + | DokuWiki supports multiple ways of creating |
| + | ==== External ==== | ||
| - | ==== Externe ==== | + | External links are recognized automagically: |
| - | Externe | + | DokuWiki supports multiple ways of creating links. External |
| + | automagically: http:// | ||
| + | | ||
| + | addresses like this one: <andi@splitbrain.org> are recognized, too. | ||
| - | < | + | ==== Internal ==== |
| - | Externe links worden automatisch herkend: http:// | + | |
| - | </ | + | |
| - | ==== Interne ==== | + | Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]]. |
| - | Interne | + | Internal |
| + | a [[pagename]] or use an additional | ||
| - | < | + | [[doku> |
| - | 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 [[wiki: | + | You can use [[some: |
| - | < | + | You can use [[some: |
| - | Je kunt [[wiki: | + | |
| - | </ | + | |
| - | Voor meer gedetailleerde informatie over namespaces | + | For details about 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 [[syntax# | + | Linking to a specific section |
| - | < | + | This links to [[syntax# |
| - | Dit verwijst naar [[syntax# | + | |
| - | </ | + | Notes: |
| - | Opmerking: | + | |
| - | | + | * DokuWiki does not use [[wp> |
| - | * Dokuwiki gebruikt standaard geen [[wp> | + | * When a section' |
| - | * Als een sectietitel veranderd wordt, dan verandert zijn verwijzing ook. Vertrouw dus niet te veel op sectie-links. | + | |
| ==== Interwiki ==== | ==== Interwiki ==== | ||
| - | Dokuwiki ondersteunt | + | DokuWiki supports |
| - | < | + | DokuWiki supports |
| - | Dokuwiki ondersteunt | + | For example this is a link to Wikipedia' |
| - | </ | + | |
| - | ==== Gedeelde | + | ==== Windows |
| - | Gedeelde | + | Windows |
| - | < | + | |
| - | Gedeelde | + | |
| + | Notes: | ||
| + | |||
| + | * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone" | ||
| + | * For Mozilla and Firefox it can be enabled through different workaround mentioned in the [[http:// | ||
| + | <?php | ||
| + | /** | ||
| + | * Customization of the english language file | ||
| + | * Copy only the strings that needs to be modified | ||
| + | */ | ||
| + | $lang[' | ||
| </ | </ | ||
| - | Opmerkingen: | + | ==== Image Links ==== |
| - | * Omwille van de veiligheid zijn gedeelde Windows-bestanden standaard enkel beschikbaar in Microsoft Internet Explorer (en dan nog enkel ' | + | |
| - | * Voor Mozilla en Firefox can het geactiveerd worden in de configuratie [[http:// | + | |
| - | * Zie [[bug> | + | |
| - | ==== Linken naar afbeeldingen ==== | + | You can also use an image to link to another internal or external page by combining the syntax for links and [[# |
| - | Het is ook mogelijk afbeeldingen te gebruiken om links te leggen naar interne of externe pagina' | + | |
| - | < | + | [[http:// |
| - | [[http://www.php.net|{{wiki: | + | |
| - | </ | + | |
| - | [[http://www.php.net|{{wiki: | + | Please note: The image formatting is the only formatting syntax accepted in link names. |
| - | Merk op: De afbeeldingsformaten zijn enkel formaten die toegestaan zijn in hyperlinks. | + | The whole [[# |
| - | De volledige [[# | + | ===== Footnotes ===== |
| - | ===== Voetnoten ===== | + | You can add footnotes ((This is a footnote)) by using double parentheses. |
| - | Je kan voetnoten toevoegen | + | You can add footnotes |
| - | < | + | ===== Sectioning ===== |
| - | Je kan voetnoten toevoegen ((Dit is een voetnoot)) door dubbele haken te gebruiken | + | |
| - | </ | + | |
| - | ===== Secties ===== | + | You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically -- this can be disabled by including the string ''< |
| - | 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 ''< | + | ==== Headline Level 3 ==== |
| + | === Headline Level 4 === | ||
| + | == Headline Level 5 == | ||
| - | ==== Hoofding | + | |
| - | === Hoofding | + | === Headline Level 4 === |
| - | == Hoofding | + | == Headline Level 5 == |
| - | < | + | By using four or more dashes, you can make a horizontal line: |
| - | ==== Hoofding 3 ==== | + | |
| - | === Hoofding 4 === | + | |
| - | == Hoofding 5 == | + | |
| - | </ | + | |
| - | + | ||
| - | Door vier of meer liggende streepjes te zetten maak je een horizontale lijn | + | |
| ---- | ---- | ||
| - | ===== Afbeeldingen en andere bestanden | + | ===== Media Files ===== |
| - | Je kan externe en interne | + | You can include external and internal |
| - | Echte maat: {{wiki: | + | Real size: {{wiki: |
| - | Herschaal naar nieuwe breedte: | + | Resize to given width: {{wiki: |
| - | Herschaal naar nieuwe breedte en hoogte: {{wiki: | + | Resize to given width and height((when the aspect ratio of the given width and height doesn' |
| - | Herschaalde externe afbeelding: {{http://de3.php.net/ | + | Resized external image: {{https://www.php.net/ |
| - | < | + | Real size: {{wiki: |
| - | Echte maat: {{wiki: | + | |
| + | Resize to given width and height: {{wiki: | ||
| + | Resized external image: {{https:// | ||
| - | Herschaal naar nieuwe breedte: | ||
| - | Herschaal naar nieuwe breedte en hoogte: {{wiki: | + | By using left or right whitespaces you can choose the alignment. |
| - | + | ||
| - | Herschaalde externe afbeelding: | + | |
| - | </ | + | |
| - | + | ||
| - | Door links o recht spaties te laten, kan je de uitlijning kiezen. | + | |
| {{ wiki: | {{ wiki: | ||
| Regel 169: | Regel 153: | ||
| {{ wiki: | {{ wiki: | ||
| - | < | + | {{ wiki: |
| - | {{ wiki: | + | |
| + | | ||
| - | {{wiki: | + | Of course, you can add a title (displayed as a tooltip by most browsers), too. |
| - | {{ wiki: | + | {{ wiki: |
| - | </ | + | |
| - | Natuurlijk kan je ook een titel toevoegen.((meestal als tooltip getoond)) | + | {{ wiki: |
| - | {{ wiki: | + | For linking an image to another page see [[#Image Links]] above. |
| + | |||
| + | ==== Supported Media Formats ==== | ||
| - | < | + | DokuWiki can embed the following media formats directly. |
| - | {{ wiki: | + | |
| - | </ | + | | Image | '' |
| + | | Video | '' | ||
| + | | Audio | '' | ||
| + | | Flash | '' | ||
| + | |||
| + | If you specify a filename that is not a supported media format, then it will be displayed as a link instead. | ||
| + | |||
| + | By adding ''? | ||
| + | |||
| + | {{wiki: | ||
| + | |||
| + | {{wiki: | ||
| + | |||
| + | ==== Fallback Formats ==== | ||
| + | |||
| + | Unfortunately not all browsers understand all video and audio formats. To mitigate the problem, you can upload your file in different formats for maximum browser compatibility. | ||
| - | als je een filenaam vastlegt (intern of extern) die geen afbeelding is ('' | + | For example consider this embedded mp4 video: |
| - | Om een afbeelding naar een andere pagina te linken, zie [[Image Links]] vanboven. | + | {{video.mp4|A funny video}} |
| + | When you upload a '' | ||
| + | Additionally DokuWiki supports a " | ||
| - | ===== Lijsten | + | ===== Lists ===== |
| - | Dokuwiki | + | Dokuwiki |
| - | * Dit is een lijst | + | * This is a list |
| - | * Het tweede | + | * The second |
| - | * Je kan meerdere niveaus hebben | + | * You may have different levels |
| - | * Nog een item | + | * Another |
| - | - Dit is een lijst | + | - The same list but ordered |
| - | - Het tweede | + | - Another |
| - | - Je kan meerdere niveaus hebben | + | - Just use indention for deeper levels |
| - | - Nog een item | + | - That's it |
| < | < | ||
| - | * Dit is een lijst | + | * This is a list |
| - | * Het tweede | + | * The second |
| - | * Je kan meerdere niveaus hebben | + | * You may have different levels |
| - | * Nog een item | + | * Another |
| - | - Dit is een lijst | + | - The same list but ordered |
| - | - Het tweede | + | - Another |
| - | - Je kan meerdere niveaus hebben | + | - Just use indention for deeper levels |
| - | - Nog een item | + | - That's it |
| </ | </ | ||
| - | ===== Smileys ===== | + | Also take a look at the [[doku> |
| - | DokuWiki | + | ===== Text Conversions ===== |
| + | |||
| + | DokuWiki | ||
| + | |||
| + | The text to image conversion is mainly done for smileys. And the text to HTML conversion is used for typography replacements, | ||
| + | |||
| + | ==== Text to Image Conversions ==== | ||
| + | |||
| + | DokuWiki converts commonly used [[wp> | ||
| * 8-) %% 8-) %% | * 8-) %% 8-) %% | ||
| Regel 236: | Regel 247: | ||
| * ;-) %% ;-) %% | * ;-) %% ;-) %% | ||
| * ^_^ %% ^_^ %% | * ^_^ %% ^_^ %% | ||
| + | * m( %% m( %% | ||
| * :?: %% :?: %% | * :?: %% :?: %% | ||
| * :!: %% :!: %% | * :!: %% :!: %% | ||
| Regel 242: | Regel 254: | ||
| * DELETEME %% DELETEME %% | * DELETEME %% DELETEME %% | ||
| - | ===== Typografie ===== | + | ==== Text to HTML Conversions |
| - | [[Dokuwiki]] can eenvoudige karakters omzetten naar hun typografische correcte vorm. Hieronder volgt een lijst met herkende karakters. | + | Typography: |
| -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
| - | "Hij zei: 'Ik wiki vaak op wikipedia' | + | "He thought |
| < | < | ||
| -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
| - | "Hij zei: 'Ik wiki vaak op wikipedia' | + | "He thought |
| </ | </ | ||
| - | Men kan deze kerkenning ook uitschakelen in de configuratie. | + | The same can be done to produce any kind of HTML, it just needs to be added to the [[doku> |
| - | ===== Citeren ===== | + | There are three exceptions which do not come from that pattern file: multiplication entity (640x480), ' |
| - | Soms kan het zijn dat je tekst wil weergeven als antwoord of commentaar. Hiervoor kan je volgende | + | ===== Quoting ===== |
| + | |||
| + | Some times you want to mark some text to show it's a reply or comment. You can use the following | ||
| < | < | ||
| Regel 286: | Regel 300: | ||
| >>> | >>> | ||
| + | ===== Tables ===== | ||
| - | ===== Tabellen ===== | + | DokuWiki supports a simple syntax to create tables. |
| - | DokuWiki maakt van een eenvoudige syntax gebruik om tabellen te maken. | + | ^ Heading 1 ^ Heading 2 ^ Heading 3 ^ |
| + | | Row 1 Col 1 | Row 1 Col 2 | Row 1 Col 3 | | ||
| + | | Row 2 Col 1 | some colspan (note the double pipe) || | ||
| + | | Row 3 Col 1 | Row 3 Col 2 | Row 3 Col 3 | | ||
| - | ^ Hoofding 1 ^ Hoofding 2 ^ Hoofding 3 ^ | + | Table rows have to start and end with a '' |
| - | | 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 '' | + | ^ Heading 1 ^ Heading 2 ^ Heading 3 ^ |
| + | | ||
| + | | Row 2 Col 1 | some colspan (note the double pipe) || | ||
| + | | Row 3 Col 1 | Row 3 Col 2 | Row 3 Col 3 | ||
| - | < | + | To connect cells horizontally, |
| - | ^ 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! | + | Vertical tableheaders are possible, too. |
| - | | Hoofding | + | | ^ Heading |
| - | ^ Rij 1 Col 1 | + | ^ Heading 3 |
| - | ^ Rij 2 Col 1 | + | ^ Heading 4 |
| - | ^ Rij 3 Col 1 | + | ^ Heading 5 |
| - | Zoals je kunt zien, bepaalt de deler voor een cel of het een hoofding is of niet: | + | As you can see, it's the cell separator before a cell which decides about the formatting: |
| - | < | + | |
| - | | Hoofding | + | ^ Heading 3 |
| - | ^ Rij 1 Col 1 | + | ^ Heading 4 |
| - | ^ Rij 2 Col 1 | + | ^ Heading 5 |
| - | ^ Rij 3 Col 1 | + | |
| - | </ | + | |
| - | Opmerking: Het verticaal samenvoegen van cellen is niet mogelijk. | + | You can have rowspans (vertically connected cells) by adding '' |
| - | 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. | + | ^ Heading 1 ^ Heading 2 ^ Heading 3 ^ |
| + | | Row 1 Col 1 | this cell spans vertically | Row 1 Col 3 | | ||
| + | | Row 2 Col 1 | ::: | Row 2 Col 3 | | ||
| + | | Row 3 Col 1 | ::: | Row 2 Col 3 | | ||
| + | Apart from the rowspan syntax those cells should not contain anything else. | ||
| - | ^ Tabbel met uitlijning | + | |
| - | | | + | | Row 1 Col 1 |
| - | |links | | + | | Row 2 Col 1 |
| - | | xxxxxxxxxxxx | + | | Row 3 Col 1 |
| - | Zo ziet de code eruit: | + | You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text. |
| - | < | + | ^ Table with alignment |
| - | ^ Tabbel met uitlijning | + | | right| center |
| - | | rechts| center | + | |left |
| - | |links | + | |
| | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
| - | </ | ||
| - | ===== Non-Wiki tekst ===== | + | This is how it looks in the source: |
| + | |||
| + | ^ Table with alignment | ||
| + | | | ||
| + | |left | | ||
| + | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
| - | 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 '' | + | Note: Vertical alignment is not supported. |
| + | |||
| + | ===== No Formatting ===== | ||
| + | |||
| + | If you need to display text exactly like it is typed (without any formatting), | ||
| + | |||
| + | < | ||
| + | This is some text which contains addresses like this: http:// | ||
| + | </ | ||
| + | The same is true for %%// | ||
| + | |||
| + | < | ||
| + | This is some text which contains addresses like this: http:// | ||
| + | </ | ||
| + | The same is true for %%// | ||
| + | |||
| + | ===== Code Blocks ===== | ||
| + | |||
| + | You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags '' | ||
| + | |||
| + | This is text is indented by two spaces. | ||
| < | < | ||
| - | Dit is code waar al de spaties behouden worden: zoals < | + | This is preformatted |
| </ | </ | ||
| < | < | ||
| - | Dit is ongeveer hetzelfde, alleen kan je dit gebruiken om aan te tonen dat je een file citeert. | + | This is pretty much the same, but you could use it to show that you quoted a file. |
| </ | </ | ||
| - | Om ervoor te zorgen dat een deel volledig genegeerd wordt bij het verwerken (bv. geen opmaak gebruiken), zet je de tekst tussen '' | + | Those blocks were created by this source: |
| - | < | + | This is text is indented by two spaces. |
| - | Dit is tekst die een adres bevat zoals: http:// | + | |
| - | </ | + | |
| - | Bekijk de bron van deze pagina om te zien hoe je deze blokken kan gebruiken. | + | < |
| + | This is preformatted code all spaces are preserved: like <-this | ||
| + | </ | ||
| + | < | ||
| + | This is pretty much the same, but you could use it to show that you quoted a file. | ||
| + | </ | ||
| - | ===== Herkennen syntax ===== | + | ==== Syntax Highlighting |
| - | [[DokuWiki]] can broncode herkennen, waardoor deze gemakkelijker te lezen is. Het gebruikt de [[http:// | + | [[wiki:DokuWiki]] can highlight sourcecode, which makes it easier to read. It uses the [[http:// |
| <code java> | <code java> | ||
| - | /** | + | /** |
| * The HelloWorldApp class implements an application that | * The HelloWorldApp class implements an application that | ||
| * simply displays "Hello World!" | * simply displays "Hello World!" | ||
| Regel 377: | Regel 418: | ||
| </ | </ | ||
| - | De volgende talen worden op dit moment herkend: // | + | The following language strings are currently recognized: //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 |
| - | ===== Toevoegen HTML en PHP ===== | + | There are additional [[doku> |
| - | Je kan pure HTML en PHP in je pagina's toevoegen door de '' | + | ==== Downloadable Code Blocks ==== |
| + | |||
| + | When you use the '' | ||
| < | < | ||
| - | <html> | + | <file php myexample.php> |
| - | This is some <font color="red" | + | <?php echo "hello world!"; ?> |
| - | </html> | + | </file> |
| </ | </ | ||
| - | <html> | + | <file php myexample.php> |
| - | This is some <font color="red" | + | <?php echo "hello world!"; ?> |
| - | </html> | + | </file> |
| - | < | + | If you don't want any highlighting but want a downloadable file, specify a dash ('' |
| - | < | + | |
| - | echo 'A logo generated by PHP:'; | + | |
| - | echo '<img src="' | + | |
| - | </php> | + | |
| - | </code> | + | |
| - | < | + | ===== RSS/ATOM Feed Aggregation ===== |
| - | echo 'A logo generated by PHP:'; | + | [[DokuWiki]] can integrate data from external XML feeds. For parsing the XML feeds, [[http:// |
| - | echo '< | + | |
| - | </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. | + | ^ Parameter |
| + | | any number | will be used as maximum number items to show, defaults to 8 | | ||
| + | | reverse | ||
| + | | author | ||
| + | | date | show item dates | | ||
| + | | description| show the item description. All HTML tags will be stripped | | ||
| + | | nosort | ||
| + | | //n//[dhm] | refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours). | | ||
| + | |||
| + | The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. [[wiki: | ||
| + | |||
| + | By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the '' | ||
| + | |||
| + | **Example:** | ||
| + | |||
| + | {{rss> | ||
| + | |||
| + | {{rss> | ||
| + | |||
| + | |||
| + | ===== Control Macros ===== | ||
| + | |||
| + | Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble: | ||
| + | |||
| + | ^ Macro ^ Description | | ||
| + | | %%~~NOTOC~~%% | ||
| + | | %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%< | ||
| ===== Syntax Plugins ===== | ===== Syntax Plugins ===== | ||
| - | De syntax van DokuWiki | + | DokuWiki's syntax can be extended by [[doku> |
| ~~INFO: | ~~INFO: | ||
| + | |||
wiki/syntax.1186657979.txt.gz · Laatst gewijzigd: (Externe bewerking)
