Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
| intern:dokuwiki [2010-03-09 11:32] – zueger1 | intern:dokuwiki [2012-09-14 11:30] (aktuell) – gelöscht zueger1 | ||
|---|---|---|---|
| Zeile 1: | Zeile 1: | ||
| - | ====== DokuWiki ====== | ||
| - | Diese Seite erklärt den Umgang mit [[doku> | ||
| - | |||
| - | ===== Einfache Text Formatierung ===== | ||
| - | DokuWiki unterstützt **fette**, // | ||
| - | |||
| - | DokuWiki unterstützt **fette**, // | ||
| - | Natürlich kann dies auch **__//'' | ||
| - | |||
| - | Text kann auch < | ||
| - | |||
| - | Text kann auch < | ||
| - | |||
| - | Auch kann ein Text < | ||
| - | |||
| - | Auch kann ein Text < | ||
| - | |||
| - | **Abschnitte** werden automatisch durch eine leere Zeile generiert. Um einen einfachen Zeilenumbruch zu erstellen, ohne einen neuen Absatz zu beginnen, können zwei Backslashes verwendet werden, gefolgt von einem Zeilenumbruch oder Leerzeichen. | ||
| - | |||
| - | ===== Links ===== | ||
| - | DokuWiki unterstützt verschiedene Arten von Links. | ||
| - | |||
| - | ==== Extern ==== | ||
| - | Externe Links werden automatisch genriert: http:// | ||
| - | [[http:// | ||
| - | |||
| - | Externe Links werden automatisch genriert: http:// | ||
| - | [[http:// | ||
| - | |||
| - | |||
| - | ==== Intern ==== | ||
| - | Interne Links werden ebenfalls mit eckigen Klammern erstellt. Dazu wird einfach entweder nur der [[Seitenname]] oder alternativ noch ein [[Seitenname | Linktex]] angegeben. | ||
| - | |||
| - | Interne Links werden ebenfalls mit eckigen Klammern erstellt. Dazu wird einfach entweder nur der [[Seitenname]] oder alternativ noch ein [[Seitenname | Linktex]] angegeben. | ||
| - | |||
| - | [[doku> | ||
| - | |||
| - | Für eine hirarchische Strukturierung werden Namensräume unterstützt. Diese werden durch Doppelpunkte getrennt: [[Namensraum: | ||
| - | |||
| - | Für eine hirarchische Strukturierung werden Namensräume unterstützt. Diese werden durch Doppelpunkte getrennt: [[Namensraum: | ||
| - | |||
| - | Eine detailierte Erklärung ist auf der DokuWiki-Seite vorhanden: [[doku> | ||
| - | |||
| - | |||
| - | ==== Interwiki ==== | ||
| - | DokuWiki unterstütz auch [[doku> | ||
| - | |||
| - | DokuWiki unterstütz auch [[doku> | ||
| - | |||
| - | |||
| - | ==== Windows Freigaben ==== | ||
| - | Windowsfreigaben wie z.B. [[\\ntb\exchange|dieses hier]] werden auch unterstütz. Solche Links sollten jedoch auf jeden Fall vermieden werden, da sie einerseits nur NTB-intern funktionieren und auch hier nur je nach Browser und Version. | ||
| - | |||
| - | Windowsfreigaben wie z.B. [[\\ntb\exchange|dieses hier]] werden auch unterstütz. | ||
| - | |||
| - | ==== Verlinkte Bilder ==== | ||
| - | Es können natürlich auch Bilder verlinkt werden, nicht nur Texte. Dazu ist einfach der Text in einem Link durch die entsprechnde Syntax für ein [[# | ||
| - | |||
| - | [[http:// | ||
| - | |||
| - | [[http:// | ||
| - | |||
| - | ===== Fussnoten ===== | ||
| - | Fussnoten können ebenfalls hinzugefügt werden ((Wie zum Beispiel diese hier)). | ||
| - | |||
| - | Fussnoten können ebenfalls hinzugefügt werden ((Wie zum Beispiel diese hier)). | ||
| - | |||
| - | ===== Überschriften ===== | ||
| - | DokuWiki unterstützt bis zu 5 Überschrifts-Hirarchien. Überschrift 1 wird für den Seitentitel verwendet. Für die Überschriften 2 bis 4 wird automatisch ein Inhaltsverzeichnis auf der linken Seite erstellt (erst ab 3 Überschriften). Dies kann mit ''< | ||
| - | |||
| - | ===== Headline Level 2 ===== | ||
| - | ==== Headline Level 3 ==== | ||
| - | === Headline Level 4 === | ||
| - | == Headline Level 5 == | ||
| - | |||
| - | ===== Headline Level 2 ===== | ||
| - | ==== Headline Level 3 ==== | ||
| - | === Headline Level 4 === | ||
| - | == Headline Level 5 == | ||
| - | |||
| - | Werden mehr als 4 Bindestriche (< | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ===== Bilder und andere Dateien ===== | ||
| - | |||
| - | You can include external and internal [[doku> | ||
| - | |||
| - | Real size: {{wiki: | ||
| - | |||
| - | Resize to given width: | ||
| - | |||
| - | Resize to given width and height((when the aspect ratio of the given width and height doesn' | ||
| - | |||
| - | Resized external image: | ||
| - | |||
| - | Real size: {{wiki: | ||
| - | Resize to given width: | ||
| - | Resize to given width and height: {{wiki: | ||
| - | Resized external image: | ||
| - | |||
| - | |||
| - | By using left or right whitespaces you can choose the alignment. | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | {{wiki: | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | {{ wiki: | ||
| - | {{wiki: | ||
| - | {{ wiki: | ||
| - | |||
| - | Of course, you can add a title (displayed as a tooltip by most browsers), too. | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | If you specify a filename (external or internal) that is not an image ('' | ||
| - | |||
| - | For linking an image to another page see [[#Image Links]] above. | ||
| - | |||
| - | ===== Lists ===== | ||
| - | |||
| - | Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a '' | ||
| - | |||
| - | * This is a list | ||
| - | * The second item | ||
| - | * You may have different levels | ||
| - | * Another item | ||
| - | |||
| - | - The same list but ordered | ||
| - | - Another item | ||
| - | - Just use indention for deeper levels | ||
| - | - That's it | ||
| - | |||
| - | < | ||
| - | * This is a list | ||
| - | * The second item | ||
| - | * You may have different levels | ||
| - | * Another item | ||
| - | |||
| - | - The same list but ordered | ||
| - | - Another item | ||
| - | - Just use indention for deeper levels | ||
| - | - That's it | ||
| - | </ | ||
| - | |||
| - | Also take a look at the [[doku> | ||
| - | |||
| - | ===== Boxen ===== | ||
| - | |||
| - | Boxen können relativ leicht erzeugt werden. Einige Beispiele: | ||
| - | <box | Titel > Das ist die einfachste möglichkeit für eine Box </ | ||
| - | |||
| - | <box | Titel > Das ist die einfachste möglichkeit für eine Box </ | ||
| - | | ||
| - | Das selbe noch mit etwas Farbe und rechts ausgerichtet: | ||
| - | <box 70% right green | Titel > Das ist die einfachste Möglichkeit für eine farbige Box </ | ||
| - | |||
| - | ~~CLEARFLOAT~~ | ||
| - | |||
| - | <box 70% right green | Titel > Das ist die einfachste Möglichkeit für eine farbige Box </ | ||
| - | |||
| - | Oder als Warnung: | ||
| - | <box red 100% | Titel > Das ist eine einfache Möglichkeit für eine Warnung </ | ||
| - | |||
| - | <box red 100% | Titel > Das ist eine einfache Möglichkeit für eine Warnung </ | ||
| - | | ||
| - | Die blauen Boxen bedürfen noch einer Überarbeitung: | ||
| - | <box blue | Titel > Blaue Boxen sehen noch sehr hässlich aus... </ | ||
| - | |||
| - | <box blue | Titel > Blaue Boxen sehen noch sehr hässlich aus... </ | ||
| - | | ||
| - | Natürlich können auch Boxen mit Code-Abschnitten erstellt werden. Dies eignet sich hervorragend für Beispiele: | ||
| - | |||
| - | <box 70% center green | Beispiel> | ||
| - | Das ist ein Beispiel mit etwas Code: | ||
| - | <code java> | ||
| - | public class HalloWelt { | ||
| - | public static void main(String[] args) { | ||
| - | System.out.println(" | ||
| - | } | ||
| - | } | ||
| - | </ | ||
| - | Und hier könnte noch eine Erkärung stehen. | ||
| - | </ | ||
| - | |||
| - | <box 50% center green | Beispiel> | ||
| - | Das ist ein Beispiel mit etwas Code: | ||
| - | <code java> | ||
| - | public class HalloWelt { | ||
| - | public static void main(String[] args) { | ||
| - | System.out.println(" | ||
| - | } | ||
| - | } | ||
| - | </ | ||
| - | Und hier könnte noch eine Erkärung stehen. | ||
| - | </ | ||
| - | |||
| - | ==== Text to Image Conversions ==== | ||
| - | |||
| - | DokuWiki converts commonly used [[wp> | ||
| - | |||
| - | * 8-) %% 8-) %% | ||
| - | * 8-O %% 8-O %% | ||
| - | * :-( %% :-( %% | ||
| - | * :-) %% :-) %% | ||
| - | * =) %% =) %% | ||
| - | * :-/ %% :-/ %% | ||
| - | * :-\ %% :-\ %% | ||
| - | * :-? %% :-? %% | ||
| - | * :-D %% :-D %% | ||
| - | * :-P %% :-P %% | ||
| - | * :-O %% :-O %% | ||
| - | * :-X %% :-X %% | ||
| - | * :-| %% :-| %% | ||
| - | * ;-) %% ;-) %% | ||
| - | * ^_^ %% ^_^ %% | ||
| - | * :?: %% :?: %% | ||
| - | * :!: %% :!: %% | ||
| - | * LOL %% LOL %% | ||
| - | * FIXME %% FIXME %% | ||
| - | * DELETEME %% DELETEME %% | ||
| - | |||
| - | ==== Text to HTML Conversions ==== | ||
| - | |||
| - | Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters. | ||
| - | |||
| - | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
| - | "He thought ' | ||
| - | |||
| - | < | ||
| - | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
| - | "He thought ' | ||
| - | </ | ||
| - | |||
| - | The same can be done to produce any kind of HTML, it just needs to be added to the [[doku> | ||
| - | |||
| - | There are three exceptions which do not come from that pattern file: multiplication entity (640x480), ' | ||
| - | |||
| - | ===== Quoting ===== | ||
| - | |||
| - | Some times you want to mark some text to show it's a reply or comment. You can use the following syntax: | ||
| - | |||
| - | I think we should do it | ||
| - | | ||
| - | > No we shouldn' | ||
| - | | ||
| - | >> Well, I say we should | ||
| - | | ||
| - | > Really? | ||
| - | | ||
| - | >> Yes! | ||
| - | | ||
| - | >>> | ||
| - | |||
| - | I think we should do it | ||
| - | |||
| - | > No we shouldn' | ||
| - | |||
| - | >> Well, I say we should | ||
| - | |||
| - | > Really? | ||
| - | |||
| - | >> Yes! | ||
| - | |||
| - | >>> | ||
| - | |||
| - | ===== Tables ===== | ||
| - | |||
| - | DokuWiki supports a simple syntax to create tables. | ||
| - | |||
| - | ^ 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 | | ||
| - | |||
| - | Table rows have to start and end with a '' | ||
| - | |||
| - | ^ 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 | | ||
| - | |||
| - | To connect cells horizontally, | ||
| - | |||
| - | Vertical tableheaders are possible, too. | ||
| - | |||
| - | | ^ Heading 1 ^ Heading 2 ^ | ||
| - | ^ Heading 3 | Row 1 Col 2 | Row 1 Col 3 | | ||
| - | ^ Heading 4 | no colspan this time | | | ||
| - | ^ Heading 5 | Row 2 Col 2 | Row 2 Col 3 | | ||
| - | |||
| - | As you can see, it's the cell separator before a cell which decides about the formatting: | ||
| - | |||
| - | | ^ Heading 1 ^ Heading 2 ^ | ||
| - | ^ Heading 3 | Row 1 Col 2 | Row 1 Col 3 | | ||
| - | ^ Heading 4 | no colspan this time | | | ||
| - | ^ Heading 5 | Row 2 Col 2 | Row 2 Col 3 | | ||
| - | |||
| - | You can have rowspans (vertically connected cells) by adding '':::'' | ||
| - | |||
| - | ^ 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 | ||
| - | | | ||
| - | |left | | ||
| - | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
| - | |||
| - | This is how it looks in the source: | ||
| - | |||
| - | ^ Table with alignment | ||
| - | | | ||
| - | |left | | ||
| - | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
| - | |||
| - | 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. | ||
| - | |||
| - | < | ||
| - | 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. | ||
| - | </ | ||
| - | |||
| - | Those blocks were created by this source: | ||
| - | |||
| - | This is text is indented by two spaces. | ||
| - | |||
| - | < | ||
| - | 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. | ||
| - | </ | ||
| - | |||
| - | ==== Syntax Highlighting ==== | ||
| - | |||
| - | [[wiki: | ||
| - | |||
| - | <code java> | ||
| - | /** | ||
| - | * The HelloWorldApp class implements an application that | ||
| - | * simply displays "Hello World!" | ||
| - | */ | ||
| - | class HelloWorldApp { | ||
| - | public static void main(String[] args) { | ||
| - | System.out.println(" | ||
| - | } | ||
| - | } | ||
| - | </ | ||
| - | |||
| - | The following language strings are currently recognized: //abap, actionscript-french, | ||
| - | |||
| - | ==== Downloadable Code Blocks ==== | ||
| - | |||
| - | When you use the '' | ||
| - | |||
| - | < | ||
| - | <file php myexample.php> | ||
| - | <?php echo "hello world!"; | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | <file php myexample.php> | ||
| - | <?php echo "hello world!"; | ||
| - | </ | ||
| - | |||
| - | If you don't want any highlighting but want a downloadable file, specify a dash ('' | ||
| - | |||
| - | ===== Makros ===== | ||
| - | Die folgenden Makros stehen zur Zeit zur verfügung: | ||
| - | |||
| - | ^ Makro ^ Beschreibung | | ||
| - | | %%~~NOTOC~~%% | ||
| - | | %%~~NOCACHE~~%% | ||
| - | | %%~~CLEARFLOAT~~%% | Textfluss aufheben. Sehr nützlich im Zusammenhang mit Boxen und Bildern. | | ||