20 Minuten Tutorial

Dieses interaktive step-by-step Tutorial wird Dich in die Foswiki Basics einführen...

1. Los geht's...

Öffne zwei Browserfenster, damit Du in dem einem dieser Anleitung folgen kannst, während Du im anderen Beispiele ausprobieren kannst.

2. Kurzer Überblick...

Eine Foswiki-Seite ist unterteilt in Webs; jedes von ihnen stellt normalerweise einen Bereich der Zusammenarbeit dar. Es ist möglich, jedes Web von jeder Stelle im Wiki aus zu erreichen. Standardmäßig befinden sich die Links zu den Webs im oberen Bereich der Seite unter dem Logo, oder im Menü auf der rechten Seite.

  • Jedes Web besteht aus verlinkten Topics, die als Seiten dargestellt werden.
  • Die Startseite jedes Webs ist das WebHome Topic.
  • Um ein Web zu durchstöbern klick man auf beliebige hervorgehobene Links. Diese Links werden WikiWords genannt und bestehen aus zwei oder mehreren aneinandergehängten Wörtern mit großen Anfangsbuchstaben.
  • Folge dem WikiWords Link und finde heraus, was er bedeutet.

  • Wenn man den Namen eines Topics kennt, kann man direkt dorthin "springen", indem man den Namen in das Jump Feld oben in der Seite eingibt.
  • Man kann jedes Web durchsuchen, indem man Begriffe in das Search Feld oben in der Seite eingibt. Foswiki sucht dann nach genauen Treffern; Alternativ können reguläre Ausdrücke bei der Suche verwendet werden.
TIP Nicht das Jump Feld mit dem Search Feld verwechseln.

3. Einen privaten Account anlegen...

Um Topics zu bearbeiten, benötigt man einen Foswiki Account.

  • Rufe die UserRegistration Seite auf, um Dir Deinen eigenen Foswiki Account anzulegen. Fülle nur einige wenige Zeilen aus und es kann losgehen!

4. Ansehen von Foswiki users und groups

  • Rufe das Main.WikiUsers Topic im Main Web auf; Dort findest Du eine Liste mit allen Foswiki Usern. Dein WikiName wird hier nach Deiner Registrierung gespeichert.
  • Rufe das Main.WikiGroups Topic im Main Web auf; dort findest Du eine Liste von Gruppen, die verwendet werden können um feingranulare Zugriffskontrollen zu definieren.

5. Test der Seiten-Steuerelemente

Die Steuerbereiche oben und/oder unten auf der Seite beiinhalten eine Sammlung von Icons oder Links, die einem ermöglichen, die verschiedensten Aktionen auszuführen. Verschiedene Skins zeigen unterschiedliche Links, die meisten der folgenden sind jedoch fast immer vorhanden:

  • [Edit] - Bearbeiten eines vorhandenen Topics (wird später näher beschrieben) mit Hilfe eines Editors, der einem normalen Texeditor ähnelt.
  • [Attach] - Anhängen von Dateien an ein Topic (wird später näher beschrieben).
  • [Print version] - Führt zu einer abgespeckten Version der Seite, sinnvoll um zu drucken.
  • [History] - Topics unterliegen einer Versionskontrolle. History zeigt Dir die komplette Änderungs-Historie eines Topics, z.B. wer hat wann was geändert.
  • [Raw View] - Zeigt den Source Text ohne Bearbeitungsmöglichkeit.
  • [More topic actions] - Weitere Steuerelemente wie umbenennen/verschieben oder um das Parent-Web des Topics einzustellen.

6. Ein neues Topic erstellen oder ein existierendes bearbeiten

Es gibt zwei unterschiedliche Möglichkeiten, ein neues Topic anzulegen:

  1. Ein Topic von Anfang an.
  2. Einem Link folgen, der auf ein Topic zeigt, welches noch nicht existiert.

6.1 Ein Topic aus dem Nichts erstellen

Zuerst wollen wir das Anlegen eines Topics ganz von Anfang an betrachten:
  • Rufe Sandbox web auf. Dieses Web stellt einen Bereich zur Verfügung, in dem man die Möglichkeit hat, nach Belieben zu experimentieren.
  • Klicke auf den [Create New Topic] Link im Hauptmenü; dieses befindet sich normalerweise rechts auf der Seite. Es öffnet sich eine neue Seite, in der man den Namen des Topics, das man anlegen will, einträgt. Dieser Name wird auch verwendet, um von einem Topic zu einem anderen zu verlinken. Zum Beispiel ist der Name dieses Topics FosWiki20MinutenTutorialDeutsch.
  • Gib den Namen für das neue Topic ein (am besten ein WikiWord), zum Beispiel MyFirstTopic (erscheint die Meldung, dass dieses Topic bereits existiert, wähle einen anderen Namen). Anschließend klicke [OK].
Beachte auch den folgenden Screenshot:

Topic name:


It's usually best to choose a WikiWord for the new topic name, otherwise automatic linking may not work. Characters not allowed in topic names, such as spaces will automatically be removed.

Topic parent:

 Pick from a list

Use template:

  • Die Seite wechselt nun in den Bearbeitungsmodus. Gib nun einige Zeilen Text ein, so als ob Du eine Email schreiben würdest.
  • Klicke [Save], um die Seite zu speichern. Der Bearbeitungsmodus verschwindet und Du wirst weitergeleitet, zum Topic, welches Du gearde angelegt hast. Herzlichen Glückwunsch - Du bist nun aktives Mitglied in der Foswiki-Gemeinschaft* Und es war wirklich einfach, oder?
Ein bestehendes Topic zu bearbeiten ist noch einfacher:
  • Klicke auf den [Edit] Link - Du wirst wieder zum Bearbeitungsmodus weitergeleitet.
  • Ändere Deinen Originaltext an einigen Stellen ab und speichere das Ganze. Fertig!

6.2 Ein Topic erstellen, indem man einem Link folgt

Nun kommen wir zur zweiten Möglichkeit, ein Topic anzulegen - indem wir einem Link folgen, der auf ein Topic zeigt, welches in diesem Moment noch nicht existiert:
  • Klick wieder auf den [Edit] Link.
  • Wieder im Bearbeitungsmodus, gib ein WikiWord ein. Ein WikiWord ist ein Wort bestehend aus mindestens zwei aneinandergehängten, groß geschriebenen Wörtern, also gib zum Beispiel ein: MySecondTopic.
  • Speichere das Topic und betrachte Dir das WikiWord, welches Du gerade eingegeben hast. Dir wird ein Fragezeichen hinter dem WikiWord auffallen. Wenn Du Dein zweites Topic angelegt hast, wird das Fragezeichen verschwinden und das Wort wird zu einem Link. Tatsächlich ist das Wort WikiWord auch ein Link. Die Verwendung von Topicnamen ist der einfachste Weg, Links zwischen zwei Topics zu erzeugen.
  • Nun klicke auf das Fragezeichen hinter dem WikiWord, welches Du gerade eingegeben hast. Du wirst weitergeleitet zum Bearbeitungsmodus, dieses Mal nicht zu Deinem ersten Topic, sondern zu dem neuen. Dieses neue (zweite) Topic ist benannt nach dem Link, den Du im Originaltopic angelegt hast. Das heißt, wenn das WikiWord welches Du im Originaltext eingegeben hast, MySecondTopic hieß, so heißt das neue Topic ebenfalls MySecondTopic.
    HELP Wenn Du nicht zum Bearbeitungsmodus geleitet wurdest, stattdessen komischen Text zu Gesicht bekommst (welchen nicht Du geschrieben hast), scheint es, als würde das Topic schon existieren. smile In diesem Fall gehe mit Deinem Browser zurück und gib etwas anderes als MySecondTopic ein.
Es gibt verschiedene Möglichkeiten, Text zu bearbeiten:
  1. Indem man den WYSIWYG Editor verwendet - markiere und formatiere Text genau so, wie Du es von einem normalen Texeditor gewohnt bist.
  2. Indem man TML shorthand verwendet - TML ist eine sehr einfache Auszeichnungssprache und steht für Topic Markup Language. Für weitere Informationen zur Bearbeitung von Topics mit Hilfe von TML wirf einen Blick auf TopicsAndWebs und ShortHand.

7. Benutze Deinen Browser um Dateien als Seitenanhänge hochzuladen...

Es ist möglich, jede Art von Dateityp an ein Topic anzuhängen - Dokumente, Bilder, Programme, was auch immer - wo sie geöffnet, angesehen oder heruntergeladen werden können.

  • Dateien anzuhängen funktioniert genau so, wie das Anhängen von Dateien an eine Email.
    1. Gehe ein weiteres Mal zu Deinem Sandbox-Topic und klicke auf das [Attach] Icon.
    2. Klicke [Browse], um eine Datei auf Deinem PC auszuwählen, die Du anhängen willst; gib optional einen Kommentar ein; belasse alles andere nicht markiert.
    3. Klicke [Upload file], dann scrolle an das Ende der Seite, um den neuen Anhang zu sehen.
  • Wiederhole die letzte Aktion - lade dieses Mal eine GIF, JPG oder PNG Bilddatei hoch.
    • Markiere die Properties: Box mit der Beschriftung Create a link to the attached file. Nach dem Speichern des Topics wird das Bild unten auf der Seite gezeigt.
    • Um das Bild zu verschieben, bearbeite das Topic und platziere die letzte Zeile (die beinhaltet: %ATTACHURL%) irgendwo auf der Seite.
  • Falls Du ein GIF, JPG or PNG Bild von Dir selbst, Deiner Katze oder Deines Familienanwesens zur Verfügung hast, warum lädtst du es nicht jetzt hoch, und personalisierst damit Deine Accountseite Main.WikiGuest?

8. Erhalte Hinweise per E-Mail bei allen Seitenänderungen...

WebNotify ist ein Abonnementen-Service, der Dich automatisch per E-Mail benachrichtigt, wenn sich Topics innerhalb eines bestimmten Foswiki-Webs ändern. Dies ist ein komfortabler Service - für viele Menschen ist es einfacher, E-Mails zu checken als Veränderung im Web zu finden.

  • Wenn Du Foswiki für die Zusammnarbeit bei einem Projekt verwendest, ist es wichtig zu wissen, wann jemand aus Deinem Team ein Update postet. Wenn Du einer speziellen Diskussion folgst, ist es sinnvoll, zu wissen, wenn neue Beiträge erstellt werden.
  • Hinweise (Alerts) werden per E-Mail gesendet, als Links zu verschiedenen Topics, die sich in einem bestimmten, festgelegten Zeitraum geändert haben: jeden Tag, jede Stunde, wie auch immer es für Dein System konfiguriert worden ist.
  • Es wird empfohlen, dass Du diesen Service ausprobierst, indem Du ihn für jedes Foswiki-Web, welches Dich interessiert, abonnierst. Man kann Hinweise webbasierend, schnell und einfach abonnieren und abbestellen mit WebNotify.
Das ist alles! Du bist nun mit allen Foswiki-Grundlagen ausgestattet. You are ready to roll!

HELP Wenn man neu in Foswiki ist, mag es einem komisch vorkommen, dass man die Einträge von anderen Leuten bearbeiten kann - wir sind es gewohnt, individuelle Nachrichten getrennt voneinander zu schreiben, per E-Mail, Message Boards oder anderen (nicht Wiki) Plattformen zur Zusammenarbeit. Sei unbesorgt. Du kannst wichtige Inhalte nicht aus Versehen löschen - es ist immer möglich, vorherige Versionen zu finden und wenn nötig, diese wieder herzustellen, falls man Änderungen rückgängig machen will. Nach kurzer Zeit wird es Dir in Fleisch und Blut übergegangen sein und Du wünscht Dir diese Möglichkeiten überall!

Verwandte Themen: UserDocumentationCategory, TopicsAndWebs, ShortHand
Topic revision: r1 - 17 Oct 2011, StevoGonzales
 
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. see CopyrightStatement. Creative Commons LicenseGet Foswiki at sourceforge.net. Fast, secure and Free Open Source software downloads