› wiki2xhtml, Schnellstart

Andere Sprache: en it ru

Was braucht es nun wirklich, um mit wiki2xhtml eine Seite zu erstellen? Hier ein kurzer Überblick und Einstieg, der die Möglichkeiten von wiki2xhtml zeigen soll.


XHTML-Dateien erstellen

Du wirst dich jetzt vielleicht fragen: «Warum nicht HTML?». xhtml[1] ist im Grunde das Selbe wie html, der Unterschied ist, dass der Code sauberer sein muss. So kann man etwas sicherer sein, dass der Browser, der die Datei liest, auch das anzeigt, was man will.

wiki2xhtml liest Text aus beliebigen Textdateien. Binäre Dateien[2] (wie Bilder), die keinen Text enthalten, werden nicht akzeptiert. Um Textdateien zu bearbeiten und zu schreiben, empfiehlt sich für Windows ein Programm wie Notepad++, PSPad, oder Notepad2 (bitte nicht den bei Windows mitgelieferten Notepad nehmen, damit lässt sich nicht arbeiten). Gute plattformunabhängige Editoren sind etwa jEdit (Java) und Vim (für Tastaturfans).

Die Dateiendung der Textdatei spielt eigentlich keine Rolle, am besten ist trotzdem .txt, damit man sofort sieht, dass es eine Textdatei ist. Falls du gerade keinen Text zur Hand hast, aus dem du eine xhtml-Datei erstellen willst, kannst du zum Beispiel einen Blindtext[3] nehmen. Speichere ihn nun in eine Datei (vielleicht index.txt; daraus wird nachher index.html, die im Internet automatisch erscheint, wenn kein spezieller Dateiname angegeben wird) in einem separaten Verzeichnis. In dieses Verzeichnis (zum Beispiel «page» im Programmverzeichnis) werden alle Dateien gespeichert, die später für die Seite benötigt werden. So ist nachher alles beieinander, und man muss nicht lange suchen.

Das Programm wird folgendermassen gestartet:

Im nun erscheinenden Dialogfeld kann bei «Select/Add files» durch einen Klick auf einen der Buttons die Datei (index.txt) hinzugefügt werden. Klicke auf «Next», dann auf «Go!». Die Datei index.html wird nun im Verzeichnis «html» erstellt.

Falls dir das reicht, kannst du das Programm nun mit «Exit» beenden. Falls nicht, kannst du wieder einen vorherigen Tab[5] anwählen, die Einstellungen ändern und mit dem Schnellstart-Tutorial weiterfahren. Top

Ein Menu hinzufügen

Sobald eine Internetseite aus mehr als einer Seite besteht – was normalerweise der Fall ist –, benötigt man ein Menu zur Navigation. Damit dies nicht bei jeder Seite neu eingetippt werden muss und so bei einer Änderung alle Seiten geändert werden müssen, wird es in einer separaten Datei gespeichert. Diese ist nach dem Muster «* Titel 1, Dateiname 1 ↵ * Titel 2, Dateiname 2 ↵ …» aufgebaut (↵ bezeichnet einen Zeilenumbruch). Erstelle eine zweite Textdatei (blindtext.txt) mit beliebigem Inhalt (je nach Belieben noch eine dritte oder vierte). Dass die Endung der Dateien nach dem Konvertieren nicht mehr .txt lautet, sondern .html, muss berücksichtigt werden! Aus index.txt wird nun also index.html, aus blindtext.txt wird blindtext.html. Die beiden Dateien sollen im Menu den Namen «Home» und «Blindtext» bekommen. Erstelle eine neue Textdatei für das Navigationsmenu (navigation.txt) und schreibe dort nun das Menu hinein: * Home, index.html * Blindtext, blindtext.html

Wähle nun in wiki2xhtml beim Tab «Settings» unter «Set the index file» die Datei navigation.txt und klicke wieder auf «Go!». Die Seite verfügt nun über ein Menu. Top

Formatierung

Es gibt noch ein paar wenige Befehle, die du kennen solltest. Eine Übersicht über alle möglichen Befehle findest du bei der Dokumentation.

Überschriften müssen auf einer separaten Linie stehen. Bei einer Überschrift zweiter Ordnung musst du zwei Gleichheitszeichen an den Anfang und ans Ende der Zeile setzen (für eine Überschrift dritter Ordnung drei Gleichheitszeichen etc., bis 6): == Frühling == Die Überschrift erster Ordnung, also die Seitenüberschrift bzw. der Seitentitel, kann irgendwo im Text mit folgendem Befehl gesetzt werden: {{H1:Jahreszeiten}}

Links werden automatisch erkannt, falls sie mit http://, www oder ftp:// beginnen. Soll der Link einen Namen bekommen, kann er folgendermassen beschriftet werden: [http://freepdfxp.de/fpxp.htm PDF-Dateien erstellen] Liegt das Ziel auf der selben Domain (zum Beispiel wird wiki2xhtml.sourceforge.net/doc.html mit wiki2xhtml.sourceforge.net/doc-de.html verlinkt), kann stattdessen ein interner Link eingefügt werden (hier in doc-de.html): [[doc.html english]] Daraus resultiert folgender Link: english. Bei Problemen mit Links: Vielleicht steht bei der Dokumentation etwas. Falls nicht: Siehe FAQ-Teil bei der Dokumentation.

Fett/Kursiv: Für diese Auszeichnungen wird der Apostroph verwendet. Umschliesst man Text mit zwei Apostrophen, wird er kursiv gesetzt, mit drei wird er fett. '''Fett''' und ''kursiv'' zusammen ist '''''schrecklick!''''' Top

Fussnoten

  1. [↑] Wikipedia: XHTML
  2. [↑] Binärdateien: Siehe Wikipedia: Binär- und Textdatei
  3. [↑] Ein Blindtext wird verwendet, um zum Beispiel eine Seite mit Text zu füllen, damit man schauen kann, wie das Resultat aussieht.
  4. [↑] Kommandozeile unter Windows: cmd.exe
  5. [↑] Ein Tab wird auch Registerkarte (Wikipedia) genannt.