FormatierungsRegeln

Grundlegende Regeln

Text wird in dem Textfeld auf der Editierseite eingegeben. Üblicherweise gibt es in diesem Textfeld einen automatischen Zeilenumbruch, so wie man das von Word und anderen Textverarbeitungsprogrammen gewohnt ist.
Solange man aber in einem normalen Fliesstext Absatz schreibt, also Text, der nicht eingerückt ist oder als Liste dargestellt wird, spielt es aber eh keine Rolle, ob man den Text automatisch umbrechen lässt oder ob man das manuell mit der Enter-Taste tut.

Das wichtigste als Merkliste:

• Eine Leerzeile beginnt einen neuen Absatz. Das gilt auch für Listen.
• Um eine neue Zeile aber keinen neuen Absatz zu beginnen, kann der aus HTML entlehnte harte Umbruch <br/> genutzt werden. Das ist zwar gegen die reine Wiki-Philosophie, aber ab und an denn doch nicht zu vermeiden.
• Wörter, die in doppelte einfache Hochkommata eingeschlossen sind, werden kursiv (''kursiv'') dargestellt, bei dreifachen Hochkommata fett ('''fett'''). Auch erlaubt, aber unhandlicher, sind die HTML Tags für italic oder bold.
• <tt>Schreibmaschinenschrift</tt> gibt's dagegen nur in der HTML-Variante. Vier Hochkommata vor und nach dem Wort wären denn doch ein bisschen heftig.
• <tt> sollte man aber nur für kurze Textfetzen im laufenden Fliesstext verwenden. Wer längere Textpassagen in Typewriterschrift setzten will, tut sich leichter, wenn er die Zeilen einfach mit einem Space beginnt. In diesem Fall wird dann nicht nur der Font gewechselt sondern auch alle manuellen Enter im Text als Zeilenumbruch wiedergegeben.
• Die verschärfte Variante davon ist dagegen wiederum an HTML angelehnt: <pre> und </pre> bewirken von der Formatierung her das gleiche wie die Spaces am Anfang der Zeile. Allerdings werden innerhalb dieser Tags auch keine CamelCase-Wörter als Links wiedergegeben.
• Strukturierende Elemente:
  • "----" vier aufeinander folgende Bindestriche ergeben eine horizontale Linie über die komplette Breite
  • ": " Doppelpunkt und Blank am Zeilenanfang rücken die Zeile ein
  • Überschriften werden auf einer Zeile für sich von Gleichheitszeichen am Anfang und am Ende eingeschlossen. Ein "=" vorne und hinten ergibt die grösste Überschrift, vier "====" die kleinste.
  • "* " als die beiden ersten Zeichen in der Zeile ergibt eine freie Liste
  • "# " statt des * bildet eine numerierte Aufzählung, dabei ist allerdings zu beachten, dass eine Leerzeile die Zählung wieder bei eins beginnen lässt
  • ";" Semicolon plus Begriff gefolgt von einem ":" Doppelpunkt und weiterem Text ergibt eine Definitions-Liste, wie sie gerne in Wörterbüchern genutzt wird.
  • Für alle diese strukturierenden Elemente ist zu beachten, dass sie in der Regel nur dann funkionieren, wenn sie durch ein Leerzeichen vom eigentlichen Text getrennt sind.
• Mit "||" lassen sich Tabellen konstruieren (Indem ein Leerzeichen zwischen die Doppelstriche und den Text eingefügt oder weggelassen wird, kann die Ausrichtung des Textes festgelegt werden.)
  Achtung: Wenn die Tabelle eine zusätzliche letzte Spalte hat, in der in keiner Zeile was drin steht, die nur stört und das ganze schöne Layout verhunzt, dann kann man entweder 5 mal die Bar-Paare (||) nachzählen und beim 6.Preview verzweifeln, weil die blöde Spalte immer noch da ist. Oder man konzentriert sich auf das Zeilenende und löscht dort die Leerzeichen hinter dem letzten Bar-Paar auf der Zeile weg. Daran liegt nämlich diese Geisterspalten-Erscheinung meistens.

• Um diese automatischen Formatierungsregeln kurzfristig aufzuheben z.B. um tatsächlich mal ein Wort mit Gross-Kleinschreibung zu schreiben schliesst man diese in <nowiki>CamelCase</nowiki> ein.

Links zu anderen Seiten

Am einfachsten umzusetzen sind Links zu anderen Seiten auf diesem Wiki: Diese Seiten haben nämlich die Wiki-typische Gross-Kleinschreibung wie z.B. AbfallTrennung. Die wenigen Seiten, die nur aus einem Teil oder aus einer Silbe bestehen und deshalb nur einen Grossbuchstaben haben, die beiden Seiten mit den Neuigkeiten News und Aktuelles zum Beispiel, müssen in doppelte eckige Klammern gesetzt werden, damit daraus ein Link ohne die Klammern wird:

Alles, was mit http oder mit ftp anfängt, etwa http://irgenwo.hin/ wird automatisch zum Link. Soll statt der URL selber ein frei gewählter Text im Fliesstext erscheinen, dann muss die URL zusammen mit dem beschreibenden Text in einfache eckige Klammern verpackt werden.

Wenn diese eckigen Klammern benutzt werden, lassen sich auch flexible Links auf Seiten auf diesem Server bewerkstelligen, ohne dass man sich den Kopf darüber zerbrechen muss, ob dieser Link jetzt von extern oder von intern funktionieren soll. http://platon1.ath.cx/wg/ funktioniert zum Beispiel nicht von intern, während http://192.168.1.77/wg/ natürlich nicht von aussen funktioniert. Immer funktioniert dagegen:

Das funktioniert auch mit Bildern [/~rolf/images/kabel.jpeg] die auf dem WG-Server liegen. Bilder auf dem lokalen Server können dann auch optional fließend im Text verankert werden indem nach der Image Datei ein Pipezeichen angehängt wird und direkt danach mit left oder right spezifiziert wird, ob das Bild an den linken oder den rechten Land gleiten soll:
[/~rolf/images/kabel.jpeg|right]

Inhaltsverzeichnis?

Das Inhaltsverzeichnis wird automatisch angelegt und beinhaltet alle Überschriften, also alles, was in Paare von 2, 3 oder 4 Gleichheitszeichen eingeschlossen ist.
Hier ist allerdings zu beachten, dass dieses automatische Inhaltsverzeichnis beim Preview nicht angezeigt wird.

Auf der News-Seite ist lässt sich das schon in sinnvollerem Einsatzgebiet begutachten.

Smilies

Folgende Smilies werden als Bildchen gerendert:

:-) -→

;-) -→

:-] -→

8-) -→

:-| -→

:-/ -→

:-( -→

:-{ -→

Wer's genauer wissen will: Preview macht's möglich

Bilder

Bilder kriegt man auf eine Seite, indem man einfach die URL des Bildes in den Text, den man gerade bearbeitet, einfügt.
Z.B. erzeugt http://home.t-online.de/home/kneller/bilder_x1/b/bier08.gif dieses Bild

Bilder, die man im Internet findet, lassen sich so ganz einfach einbinden, indem man mit rechts auf das gefundene Bild klickt, "Grafikadresse kopieren" wählt und schließlich im Wiki diese einfügt.

  Bitte achtet darauf, keine großen Bilder oder sogar Fotos direkt ins
  Wiki einzufügen, schließlich ist das Wiki ja eigentlich für Text gedacht!

Kommentare

Generell gibt es auf jeder Seite die Möglichkeit, einen Kommentar anzuhängen anstatt die Seite direkt zu ändern, was wohl vor allen Dingen für die zurückhaltenderen Menschen unter uns interessant sein dürfte. – Oder für die mit einem ausgeprägten Selbstdarstellungsbewußtsein. Denn auf der Kommentar-Seite wird zu jedem Statement der Name und das Datum hinzugefügt.

Anstatt auf Edit this page klickt ihr auf den Comments on … Link, tippt euren Kommentar ein previewt und speichert ihn .. das war's. Die Kommentare sieht man allerdings nicht direkt, sondern man muss sich extra eine Seite weiterklicken. Wenn man so will, sind die Kommentare so was wie die Leserbriefe in den Tagezeitungen, da sie sich auch getrennt vom redaktionellen Text auf einer eigenen Seite befinden. Den üblichen Passus Die Redaktion behält es sich vor, den Inhalt der veröffentlichen Briefe zu kürzen werdet ihr bei uns auf dem Wiki natürlich nicht finden.

Alternativ könnt ihr aber auch euren Kommentar direkt auf die jeweilige Seite setzen. Dann sollte er allerdings auch entsprechend hervorgehoben sein. Die empfohlene Methode dafür ist entweder Einrückung mit ":", das wird allerdings spätestens ab der zweiten Einrücktiefe unschön und innerhalb des eingerückten Textes lassen sich auch nicht mehr so ohne weiteres Absätze, Tabellen oder ASCII-Art nutzen.

Mehr Möglichkeiten hat man, wenn man den eigenen Senf mit einem einfachen [new] am Anfang des Absatzes markiert

  [new]
  Das ist der bissige Kommentar eines ganz speziellen Freundes.
  
                    .----.
                 _.'__    `. 
             .--(#)(##)---/#\
           .' @          /###\
           :         ,   #####
            `-..__.-' _.-\###/  
       jgs        `;_:    `"'
                .'"""""`. 
               /,  JOE  ,\
              //  COOL!  \\
              `-._______.-'
              ___`. | .'___ 
             (______|______)
  
  || Mo || Hundekuchen ||
  || Di || Donuts ||
  
  [new]
  Hey, du Sack, wenn du schon Bilderchen von meiner Homepage klaust, dann
  lass wenigstens noch ein Link dabei! http://www.chris.com/ascii/

Und so sieht's dann aus:

                 .----.
              _.'__    `. 
          .--(#)(##)---/#\
        .' @          /###\
        :         ,   #####
         `-..__.-' _.-\###/
    jgs        `;_:    `"'
             .'"""""`. 
            /,  JOE  ,\
           //  COOL!  \\
           `-._______.-'
           ___`. | .'___ 
          (______|______)

Um noch mal auf die Zeitgenossen mit dem ausgeprägten Selbstdarstellungsbewußtsein zurück zu kommen: Dieses [new] ist die entschärfte Variante einer [new:MeinName:2005-01-31 01:47 UTC] Markierung, die außer dem geänderten Hintergrund auch ein Mini-Bildchen mit auf die Seite bringt. Wer unbedingt genaueres darüber wissen muss, findet es auf: http://www.oddmuse.org/cgi-bin/wiki/Portraits_Support_Extension

Mit Homepage ist natürlich die Homepage auf dem Wiki gemeint und nicht irgendein Webspace auf der eigenen Domain.