Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
| intern:dokuwiki [2011-09-19 09:51] – zueger1 | intern:dokuwiki [2012-09-14 11:30] (aktuell) – gelöscht zueger1 | ||
|---|---|---|---|
| Zeile 1: | Zeile 1: | ||
| - | ====== DokuWiki Leitfaden====== | ||
| - | 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:// | ||
| - | |||
| - | |||
| - | ===== Strukturierung ===== | ||
| - | |||
| - | ==== Überschriften ==== | ||
| - | DokuWiki unterstützt bis zu 5 Überschrift-Hirarchien. Überschrift 1 wird für den Seitentitel verwendet. Die Stufen 2-5 können für die Textgliederung verwendet werden. Beispiel für eine Überschrift der Stufe 4: | ||
| - | |||
| - | === Headline Level 4 === | ||
| - | |||
| - | Alle Möglichen Überschriften: | ||
| - | |||
| - | ====== Headline Level 1 ====== | ||
| - | ===== Headline Level 2 ===== | ||
| - | ==== Headline Level 3 ==== | ||
| - | === Headline Level 4 === | ||
| - | == Headline Level 5 == | ||
| - | |||
| - | ==== Inhaltsverzeichnis ==== | ||
| - | Für die Überschriften 2 bis 4 wird automatisch ein Inhaltsverzeichnis auf der linken Seite erstellt (erst wenn min. drei Überschriften vorhanden sind). Dies kann mit ''< | ||
| - | |||
| - | ==== 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)). | ||
| - | |||
| - | ==== Trennlinie ==== | ||
| - | Werden mehr als 4 Bindestriche (< | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ===== Bilder und andere Dateien ===== | ||
| - | |||
| - | ==== Bilder per Dialogfeld einbauen ==== | ||
| - | Bilder und Dateien zum Herunterladen können einfach über die Schaltfläche //Bilder und andere Dateien einfügen// ((4. Schaltfläche von Links)) eingefügt werden. In diesem Dialog können die Dateien auch direkt hochgeladen werden. Dabei ist zu beachten, das diese direkt in den Workspace der gerade bearbeiteten Seite geladen werden. Es ist somit nicht notwendig, die Dateien systemweit eindeutig zu benennen, jedoch zwingend innerhalb eines Namespaces. Folgende Dateiformate sind zu verwenden: | ||
| - | * Bilder: JPEG oder PNG | ||
| - | * Dokumente: PDF | ||
| - | * Archive: ZIP | ||
| - | |||
| - | Aus Sicherheitsgründen nicht akzeptabel sind ausführbare Dateien ((EXE, COM, etc.))! | ||
| - | |||
| - | Word-, Excel, PowerPoint oder OpenOffice-Dokumente sind nur dann zu verwenden, wenn sie von den Studenten bearbeitet werden müssen, ansonsten sind PDF-Dokumente vorzuziehen. | ||
| - | |||
| - | ==== Grösse von Bildern | ||
| - | Mit geschweiften Klammern können sowohl externe als auch interne [[doku> | ||
| - | |||
| - | Original Größe: | ||
| - | |||
| - | Eine Breite vorgeben: | ||
| - | |||
| - | Breite und Höhe vorgeben: | ||
| - | |||
| - | Größe für externe Bilder vorgeben: | ||
| - | |||
| - | Original Größe: | ||
| - | Eine Breite vorgeben: | ||
| - | Breite und Höhe vorgeben: | ||
| - | Größe für externe Bilder vorgeben: | ||
| - | |||
| - | ==== Ausrichten von Bildern ==== | ||
| - | Mit Leerzeichen zur Rechten und/oder Linken innerhalb der Klammern kann ein Bild horizontal ausgerichtet werden(links, | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | {{wiki: | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | {{ wiki: | ||
| - | {{wiki: | ||
| - | {{ wiki: | ||
| - | |||
| - | bei Ausrichtung und der Verwendung eines Titels sollte man drauf achten dass der Titel nach dem Leerzeichen kommt | ||
| - | {{ wiki: | ||
| - | {{wiki: | ||
| - | {{ wiki: | ||
| - | |||
| - | |||
| - | ==== Tooltipps ==== | ||
| - | Auch Titel, in den meisten Browsern als Tooltip angezeigt, können angegeben werden. | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | ==== Bildlegenden ==== | ||
| - | Mit einer zusätzlichen eckigen Klammer wird der Titel als Legende unter dem Bild dargestellt: | ||
| - | [{{ wiki: | ||
| - | |||
| - | [{{ wiki: | ||
| - | |||
| - | ==== Dateidownload ==== | ||
| - | |||
| - | Wenn eine Datei angegeben wird, die kein Bild ('' | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | ==== Automatische Verlinkung ==== | ||
| - | |||
| - | Bilder werden automatisch mit einer Verlinkung zur Ihren [[wpde> | ||
| - | |||
| - | Dieses Verhalten kann über die Option ? | ||
| - | |||
| - | {{wiki: | ||
| - | {{wiki: | ||
| - | |||
| - | Ausserdem kann mit ?direct das Bild, z.Bsp. als Vollansicht, | ||
| - | |||
| - | {{wiki: | ||
| - | {{wiki: | ||
| - | |||
| - | ===== Listen ===== | ||
| - | |||
| - | DokuWiki kennt unsortierte und nummerierte Listen. Um einen Listeneintrag zu erzeugen, beginne eine Zeile mit 2 Leerzeichen. Diesen Leerzeichen folgt dann ein " | ||
| - | |||
| - | * Dies ist ein Eintrag einer unsortierten Liste | ||
| - | * Ein zweiter Eintrag | ||
| - | * Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen | ||
| - | * Noch ein Eintrag | ||
| - | |||
| - | - Dies ist ein Eintrag einer nummerierte Liste | ||
| - | - Ein zweiter Eintrag | ||
| - | - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen | ||
| - | - Noch ein Eintrag | ||
| - | |||
| - | < | ||
| - | * Dies ist ein Eintrag einer unsortierten Liste | ||
| - | * Ein zweiter Eintrag | ||
| - | * Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen | ||
| - | * Noch ein Eintrag | ||
| - | |||
| - | - Dies ist ein Eintrag einer nummerierte Liste | ||
| - | - Ein zweiter Eintrag | ||
| - | - Unterschiedliche Ebenen einer Liste durch Hinzufügen von weiteren 2 Leerzeichen | ||
| - | - Noch ein Eintrag | ||
| - | </ | ||
| - | |||
| - | ===== 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. | ||
| - | </ | ||
| - | |||
| - | ===== Zeichenersetzung ===== | ||
| - | DokuWiki kann einfache Textfolgen durch Grafiken oder typografisch korrekte Zeichen ersetzen. | ||
| - | |||
| - | ==== Smileys ==== | ||
| - | Dokuwiki verwandelt oft genutzte [[wpde> | ||
| - | |||
| - | ^ 8-) ^ 8-O ^ :-( ^ :-) ^ =) ^ :-/ ^ :-\ ^ :-? ^ :-D ^ :-P ^ :-O ^ :-X ^ :-| ^ ;-) ^ :?: ^ :!: ^ '' | ||
| - | | %% 8-) %% | %% 8-O %% | %% :-( %% | %% :-) %% | %% =) | ||
| - | |||
| - | ==== Icons und Hinweise ==== | ||
| - | ^ FIXME ^ DELETEME ^ TODO ^ NEW ^ WARNING ^ IMPORTANT ^ NTBLOGO ^ FOLDER ^ FILE ^ | ||
| - | | %% FIXME %% | %% DELETEME %% | %% TODO %% | %%NEW%% | %%WARNING%% | %%IMPORTANT%% | %%NTBLOGO%% | %%FOLDER%% | %%FILE%% | | ||
| - | |||
| - | ==== Typografische Ersetzungen ==== | ||
| - | [[DokuWiki]] kann einfache Textzeichen in ihre typografischen Entsprechungen umwandeln. | ||
| - | |||
| - | Hier eine Liste aller Zeichen, die die NTB-Installation von DokuWiki kennt: | ||
| - | |||
| - | ^ -> ^ <- ^ <-> ^ ==> ^ <=> ^ <= ^ >= ^ >> ^ << | ||
| - | | %% -> %% | %% <- %% | %% <-> %% | %% ==> %% | %% <=> %% | %%<=%% | %%>=%% |%% >> %% | %% << %% | %% -- %% | %% --- %% | %% (c) %% | %% (tm) %% | %% (r) %% | %% ... %% | | ||
| - | |||
| - | 640x480 | ||
| - | |||
| - | "He thought ' | ||
| - | |||
| - | < | ||
| - | 640x480 | ||
| - | "He thought ' | ||
| - | </ | ||
| - | |||
| - | |||
| - | ===== 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! | ||
| - | |||
| - | >>> | ||
| - | |||
| - | ===== Tabellen ===== | ||
| - | |||
| - | Mit DokuWiki können Tabellen ganz einfach erstellt werden: | ||
| - | |||
| - | ^ hervorgehoben | ||
| - | | Zeile 1 Spalte 1 | Zeile 1 Spalte 2 | Zeile 1 Spalte 3 | | ||
| - | | Zeile 2 Spalte 1 | doppelte Spaltenbreite (beachte den doppelten senkrechten Strich) || | ||
| - | | Zeile 3 Spalte 1 | Zeile2 Spalte 2 | Zeile 2 Spalte 3 | | ||
| - | |||
| - | Felder einer Tabelle starten mit " | ||
| - | |||
| - | ^ hervorgehoben | ||
| - | | Zeile 1 Spalte 1 | Zeile 1 Spalte 2 | Zeile 1 Spalte 3 | | ||
| - | | Zeile 2 Spalte 1 | doppelte Spaltenbreite (beachte den doppelten senkrechten Strich) || | ||
| - | | Zeile 3 Spalte 1 | Zeile2 Spalte 2 | Zeile 2 Spalte 3 | | ||
| - | |||
| - | Zellen über mehrere Spalten werden erzeugt, wenn man, wie oben gezeigt, am Ende einer solchen Spalte soviele " | ||
| - | Kurz gesagt: Alle Zeilen einer Tabelle müssen die gleiche Anzahl an Feldtrennern " | ||
| - | |||
| - | Hervorgehobene Felder in Vertikaler Ausrichtung sind auch möglich. | ||
| - | |||
| - | | ^ hervorgehoben 1 ^ hervorgehoben 2 ^ | ||
| - | ^ hervorgehoben 3 | Zeile 1 Spalte 2 | Zeile 1 Spalte 3 | | ||
| - | ^ hervorgehoben 4 | Zeile 2 Spalte 2 | | | ||
| - | ^ hervorgehoben 5 | Zeile 3 Spalte 2 | Zeile 3 Spalte 3 | | ||
| - | |||
| - | Wie wir sehen, entscheidet der Feldtrenner (" | ||
| - | |||
| - | | ^ hervorgehoben 1 ^ hervorgehoben 2 ^ | ||
| - | ^ hervorgehoben 3 | Zeile 1 Spalte 2 | Zeile 1 Spalte 3 | | ||
| - | ^ hervorgehoben 4 | Zeile 2 Spalte 2 | | | ||
| - | ^ hervorgehoben 5 | Zeile 3 Spalte 2 | Zeile 3 Spalte 3 | | ||
| - | |||
| - | Felder über mehrere Zeilen (vertikal verbundene Zellen) lassen sich durch hinzufügen von '':::'' | ||
| - | |||
| - | ^ Titelzeile 1 ^ Titelzeile 2 ^ Titelzeile 3 ^ | ||
| - | | Zeile 1 Spalte 1 | Diese Zelle ist vertikal verbunden | Zeile 1 Spalte 3 | | ||
| - | | Zeile 2 Spalte 1 | ::: | Zeile 2 Spalte 3 | | ||
| - | | Zeile 3 Spalte 1 | ::: | Zeile 3 Spalte 3 | | ||
| - | |||
| - | Außer den drei Doppelpunkten darf die zu verbindende Zelle keine weiteren Inhalte haben. | ||
| - | |||
| - | ^ Titelzeile 1 ^ Titelzeile 2 ^ Titelzeile 3 ^ | ||
| - | | Zeile 1 Spalte 1 | Diese Zelle ist vertikal verbunden | Zeile 1 Spalte 3 | | ||
| - | | Zeile 2 Spalte 1 | ::: | Zeile 2 Spalte 3 | | ||
| - | | Zeile 3 Spalte 1 | ::: | Zeile 3 Spalte 3 | | ||
| - | |||
| - | |||
| - | *Der Inhalt einer Zelle kann horizontal ausgerichtet werden. Füge 2 Leerzeichen hinzu:\\ | ||
| - | * 2 Leerzeichen Links vom Text: rechtsbündig | ||
| - | * 2 Leerzeichen Rechts vom Text: linksbündig | ||
| - | * 2 Leerzeichen Links und Rechts vom Text: zentriert | ||
| - | |||
| - | ^ Tabelle mit Ausrichtung | ||
| - | |Links | ||
| - | |Links | ||
| - | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
| - | |||
| - | So sieht die Formatierung aus: | ||
| - | |||
| - | ^ Tabelle mit Ausrichtung | ||
| - | | Rechts| | ||
| - | |Links | ||
| - | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
| - | |||
| - | <box 100% green | Hinweis zu dem senkrechten Balken-Zeichen> | ||
| - | Dieses Zeichen ist auf einer PC-Tastatur erreichbar über die Taste " | ||
| - | </ | ||
| - | |||
| - | ===== 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. | | ||