Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
| intern:dokuwiki [2010-03-09 12:12] – 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:// | ||
| - | |||
| - | |||
| - | ===== 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: | ||
| - | |||
| - | ==== 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 | ||
| - | | %% FIXME %% | %% DELETEME %% | | ||
| - | |||
| - | ==== Typografische Ersetzungen ==== | ||
| - | [[DokuWiki]] kann einfache Textzeichen in ihre typografischen Entsprechungen umwandeln. | ||
| - | |||
| - | Hier eine Liste aller Zeichen, die DokuWiki kennt: | ||
| - | |||
| - | ^ -> ^ <- ^ < | ||
| - | | %% -> %% | %% <- %% | %% <-> %% | %% => %% | %% <= %% | %% <=> %% | %% >> %% | %% << %% | %% -- %% | %% --- %% | %% (c) %% | %% (tm) %% | %% (r) %% | | ||
| - | |||
| - | 640x480 | ||
| - | |||
| - | "He thought ' | ||
| - | |||
| - | < | ||
| - | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
| - | "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! | ||
| - | |||
| - | >>> | ||
| - | |||
| - | ===== 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. | | ||