Wiki Kurzeinführung

new line

Most important for wikis: How to tell the Wiki to make a new line.
Use a double backslash with spaces around it: \\

Images

Best inserted using the image button. If you want to have a label with an image description below the image, use the imagebox plugin:

Just add [ ] around the image tag.

[{{ImagePath|Caption}}]

The caption can be formatted. Here is an example:

[{{ :pasted:20200801-124136.png?nolink | This is the caption }}]

This is the caption

\\  ==== copy and paste ====

If you want to be quick, e.g. with screenshots, you can paste them (you cannot paste a file from the clipboard! You can only paste imagedata that is on the clipboard): put your cursor in the text box where you want to insert the image and press ctrl+p or whatever the equivalent on a Mac is.

Formatierungen

Bartels und Stöckler (Hrsg). Wissenschaftstheorie. Paderborn: Mentis Verlag, ¹2007, ²2009.

Bartels und Stöckler (Hrsg). Wissenschaftstheorie. Paderborn: Mentis Verlag, <sup>1</sup>2007, <sup>2</sup>2009.

You can use _subscript and ^superscript, too.

You can use <sub>subscript</sub> and <sup>superscript</sup>, too.

No Formatting

If you need to display text exactly like it is typed (without any formatting), enclose the area either with <nowiki> tags or even simpler, with double percent signs %%.

This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. The same is true for //__this__ text// with a smiley ;-).

<nowiki>
This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
</nowiki>
The same is true for %%//__this__ text// with a smiley ;-)%%.

Zitate - Quotes

“Ich stelle oft fest, dass ich nur etwas zitiere, was ich vor längerer Zeit gelesen habe, und das wird dann zu einer Wiederentdeckung. Vielleicht sollte ein Dichter besser namenlos sein.” (S. 17 unten)

>"Ich stelle oft fest, dass ich nur etwas zitiere, was ich vor längerer Zeit gelesen habe, und das wird dann zu einer Wiederentdeckung. Vielleicht sollte ein Dichter besser namenlos sein." (S. 17 unten) \\

Tabellen - Tables

You can have rowspans (vertically connected cells) by adding ::: into the cells below the one to which they should connect.

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.

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

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
right	center	left
left	right	center
xxxxxxxxxxxx	xxxxxxxxxxxx	xxxxxxxxxxxx

This is how it looks in the source:

^           Table with alignment           ^^^
|         right|    center    |left          |
|left          |         right|    center    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Note: Vertical alignment is not supported.

Tag

{{tag>[list of tags]}}

[list of tags]	a space separated list of tags that describe the content of the current page	required

Examples:

{{tag>tag1 tag2 tag3}}
with namespaces: {{tag>ns1:tag1 ns1:tag2 ns2:subns1:tag3}}

Count

{{count>[tag]}}

[tag]	the category tag for which you want the list the occurrence	required

Example:

{{count>+}} – List all tags with related occurrences.
{{count>tag1 tag2}} – List the occurrence of tag1 and tag2.
{{count>tag1 tag2 tag3&. ns1 ns2}} – List all occurrences for the given tags inside the namespaces (the dot specifies the root namespace)

Stichwörter

{{keywords>art in the park,Sheffield,urban,street,creative}}

Ändern einer Seite

Einfach “Bearbeiten/Seite bearbeiten” oder so ähnlich im Menü verwenden oder - je nach Wiki - auf der rechten Seite den Bearbeiten Schalter anklicken. Was immer geht: Shift+Alt+e (manchmal auch Strg+Alt+e, kommmt auf den Browser an) Die geänderte Seite wird gespeichert durch Strg+Alt+s, oder den Speichern Schalter.

Anlegen einer neuen Seite

Um eine neue Seite anzulegen, wird zunächst in einer bestehenden Seite ein Verweis darauf angelegt mit [[Name der neuen Seite|]]. Diese Seite speichern.
Dann auf den neuen Link klicken. Auf der Zielseite, die als nicht existent angegeben wird, einfach wie üblich Seite editieren (siehe oben) wählen.

Nützliches für den Editiermodus

Keine Umbrüche verwenden: Möglichst keine Umbrüche mit Enter erzeugen. Die Wiki soll das selbst regeln. Nur wenn wirklich ein Umbruch explizit gewünscht ist, kann er mit zwei Mal Enter forciert werden. Zwei Backslashs eingeleitet und gefolgt von einem Leerzeichen haben ebenfalls einen Umbruch zur Folge.
** Text ** : Text innerhalb eines Paares doppelter Sternchen wird fett formatiert
Zwei Leerzeichen und ein * erzeugen einen unnummerierten Listenpunkt
Zwei Leerzeichen und ein - erzeigen einen nummerierten Listenpunkt

%% Text %% : Alles innerhalb eines Paars doppelter Prozentzeichen wird von der Wiki nicht interpretiert.%%[[Test|]]%% ergibt in der Ausgabe [[Test|]]. Das gleiche kann man mit <nowiki> und </nowiki> erreichen.
Überschriften lassen sich am Besten mit den Schaltern erzeugen
Links zu einer anderen Wiki-Seite Auch dafür eignet sich ein Schalter am Besten: Die Kettenglieder ohne Weltkugel
Links ins WWWW* Dazu eignet sich der Schalter mit den Kettengliedern und der Weltkugel

Code

Syntax Highlighting

DokuWiki can highlight sourcecode, which makes it easier to read. It uses the GeSHi Generic Syntax Highlighter – so any language supported by GeSHi is supported. The syntax uses the same code and file blocks described in the previous section, but this time the name of the language syntax to be highlighted is included inside the tag,
e.g. <code java> or <file java>.

sxh syntax highlighter

Another option is:

 
<sxh [brush][; options]>
... code/text ...
</sxh>

and the brushes are here: https://github.com/crazy-max/dokuwiki-plugin-syntaxhighlighter4. Most importantly it does support powershell and typescript. And it does look a bit more appealing, I think.

icons and labels

The smiley button in the editor shows a selection of icons. But you can also just type the label's name into the editor. Some labels should be used only for a certain purpose (we search for them):

command	looks like	meaning
i_todo_icon		Something needs to be done.
i_depr		Correct information for a current version but a change is planned in the future.

folding

we have two section toggle plugins installed:

the first one corresponds with the “fold/unfold all” button in the menu:

++++ Title |

| This table | is only shown | when you unfold the block |

{{page>some other wiki page&inline}}

++++

The second one does not, but is a bit more obviously styled:

<hidden my title>
content to be folded /unfolded.
</hidden>

discussions

just add:

~~DISCUSSION~~

how to add your own avatar

that's a bit tricky. Go here: user.

Table of Contents