%% LyX 1.4.2 created this file.  For more info, see http://www.lyx.org/.
%% Do not edit unless you really know what you are doing.
\documentclass[ngerman]{article}
\usepackage[T1]{fontenc}
\usepackage[latin1]{inputenc}
\usepackage{graphicx}
\IfFileExists{url.sty}{\usepackage{url}}
                      {\newcommand{\url}{\texttt}}

\makeatletter
\usepackage{babel}
\makeatother
\begin{document}

\title{Das Forth\discretionary{–}{}{–}e.V.\discretionary{–}{}{–}Wiki}


\author{Bernd Paysan}

\maketitle
\begin{multicols}{2}

\begin{abstract}
Die Website der Forth--Gesellschaft stellt Hilfsmittel zur Kommunikation
zwischen Vereinsmitgliedern und anderen Forth-Begeisterten zur Verfügung.
Eines dieser Hilfsmittel ist das Wiki. Dieser Artikel soll die Bedienung
und den Zweck des Wikis beschreiben, und auch den Unterschied zum
Blog (der Struktur der Hauptseite) aufzeigen.
\end{abstract}

\section{Einleitung}

Die Einstiegsseite der Forth--Gesellschaft ist mit Geeklog gemacht.
Geeklog ist ein Blog, also ein primär für Meldungen und Nachrichten
gedachtes Medium. Neue Nachrichten landen oben auf der Seite, ältere
Nachrichten verschwinden schnell aus dem Blickfeld und irgendwann
auch von der Seite.

Ein Blog ist also eine stapelartige Struktur, gemacht für temporäre
Einträge, nicht für dauerhafte Strukturen. Zwar enthält Geeklog auch
``static pages,'' also Seiten, die nicht so schnell verschwinden.
Diese übersichtlich miteinander zu verlinken ist aber nicht einfach
--- das System ist eben nicht dafür gedacht.

Deshalb habe ich Ende Februar ein Wiki (DokuWiki) installiert. Artikel
in einem Wiki stehen unter einen ,,Stichwort,{}`` das Wiki stellt
also eine Art Wörterbuch dar. Wikis sind damit für themenorientierte
Dokumentation geeignet. Verschiedene Themen--Komplexe kann man trennen,
indem man ``Namespaces,'' also Vokabulare verwendet.

%
\begin{figure*}
\includegraphics[width=1\textwidth]{2006-03/wiki-start}


\caption{Die Einstiegsseite des Wikis}
\end{figure*}


Wie beim Geeklog gilt auch für's Wiki: Kollaboratives Arbeiten ist
möglich und \emph{erwünscht}.

Wir hatten ja schon einmal ein Wiki auf der Forth--eV--Seite, und
damit eher gemischte Erfahrungen gemacht. Es sind damals nicht gerade
viele Beiträge zusammengekommen, die von Vandalen aber gleich wieder
gelöscht wurden. Deshalb nutzen wir die Zugangskontrolle des neuen
Wikis und erlauben nur Beiträge angemeldeter Benutzer. Derzeit kann
sich jeder selbst anmelden, sollte das zu einem Problem werden, können
wir auch das manual machen --- Wikispammer und andere Vandalen sollten
somit keine Chance haben.

Damit mehr Inhalte kommen, muss der Zweck und die Benutzung des Wikis
auch allgemein bekannt sein, und genau diesem Zweck dient dieser Artikel.


\section{Themen des Wikis}

Im Moment haben wir folgende Themen im Wiki:

\begin{itemize}
\item Forth--Wörter und ihre Definitionen

\begin{itemize}
\item Forth Target-, Cross- oder Meta-Compiler? Die verschiedenen Möglichkeiten
ein Forthsystem zu erzeugen hat Ullrich Hoffman aufgelistet. 
\item Threaded Code Die verschiedenen Möglichkeiten eine verkettete Liste
von Vektoren (Adressen) in einem Forth System anzulegen. 
\item Inner Interpreter und der Instruction Pointer in der virtuellen Forthmaschine.
\item Forth Kernel Words for embedded Systems
\item ANS American National Standard for Information Systems, Programming
Languages: Forth
\item Interessante Wörter aus Newsgruppen und andere Fundstücke
\end{itemize}
\item Projekte und ihr Stand

\begin{itemize}
\item R8C --- Das R8C--Gforth
\item Roboter --- Robotik--Projekte

\begin{itemize}
\item Forth in Balance
\item Forth spielt Solitär
\item Lego Forth
\end{itemize}
\item PIC --- PIC--basierte Forthe
\end{itemize}
\item Literatur--Liste
\item Quiz --- vom Ruby Quiz inspiriert

\begin{itemize}
\item LCD Numbers --- ein Quiz--Element aus dem Ruby Quiz für Forth adaptiert
\end{itemize}
\item Beispielhafte Forthprogramme

\begin{itemize}
\item Tetris for Terminals
\item Links auf andere Kollektionen
\end{itemize}
\item Rätselhaftes: Forth--Programme, die man nicht auf Anhieb versteht

\begin{itemize}
\item r> >r nicht in derselben Colon--Definition?
\end{itemize}
\item Dies und Das

\begin{itemize}
\item SMD--Chips einlöten
\end{itemize}
\end{itemize}

\section{Bedienung des Wikis}

Die Bedienung des Wikis ist eigentlich ganz einfach. Oben und unten
an jeder Seite sind Bedienknöpfe. Wenn man das Wiki nicht nur lesen,
sondern auch bearbeiten will, muss man sich zunächst


\subsection{Anmelden}

Hat man noch keinen Benutzernamen und Passwort, registriert man sich
einfach. Dazu wird ein Benutzername, ein voller Name und eine E--Mail--Adresse
verlangt. An diese E--Mail--Adresse bekommt man sein Passwort geschickt
--- auch in dem Fall, dass man das Passwort vergessen hat.

Hat man das Passwort, meldet man sich am besten dauerhaft an --- dann
speichert der Browser einen Cookie. Im Benutzerprofil kann man das
vom System vergebene Passwort auch noch ändern.


\subsection{Navigation}

Neben den bekannten Hyperlinks gibt's im Wiki eine Übersicht, die
alle Seiten in Namespaces gruppiert anzeigt. Im Eingabefeld rechts
oben kann man auch ganz gezielt suchen. Die ,,Spur{}``--Zeile oben
zeigt einem den Pfad, den man durch's Wiki genommen hat, und führt
auf vorher besuchte Seiten zurück. Ein Klick auf den Seitennamen zeigt,
welche andere Seiten auf diesen verweisen. Über das 4th--Logo kommt
man zurück zur Einstiegseite der Forth--Gesellschaft, und mit dem
Text--Link daneben (,,Forth--eV Wiki{}``) zur Startseite des Wikis.


\subsection{Änderungen verfolgen}

Das Wiki ändert sich ständig --- um den Überblick nicht zu verlieren,
was sich als letztes geändert hat, unterstützt es RSS--Feeds (allgemein
und auch Namespace--spezifische). Der Button ,,Letzte Änderungen{}``
zeigt ebenfalls, was sich gerade im Wiki tut. Ältere Versionen lassen
sich anzeigen und mit der aktuellen Version vergleichen.


\subsection{Diese Seite bearbeiten}

Diesen Knopf findet man sowohl oben und unten links auf jeder Seite
(wenn man nicht angemeldet ist, kann man hier nur den Quelltext der
Seite sehen). Das Wiki verwendet eine einfache Markup--Sprache, deren
wichtigste Elemente ich hier erkläre. Der Editor zeigt auch Icons
für diese Elemente an, sodass man für's Formatieren eigentlich nur
klicken muss.


\subsubsection{Struktur}

Abschnitte und Unterabschnitte markiert man links und rechts mit \texttt{=}--Zeichen.
Der oberste Abschnitt mit 6, die untergeordnete mit 5, 4, 3 und so
weiter. Absätze werden durch Leerzeilen getrennt.


\subsubsection{Textattribute}

\begin{description}
\item [{Fett}] Mit zwei \texttt{{*}{*}} links und rechts vom {*}{*}\textbf{fetten
Text}{*}{*}
\item [{Kursiv}] Mit zwei \texttt{//} links und rechts vom //\textit{kursiven
Text}//
\item [{Unterstrichen}] Mit zwei \texttt{\_\_} links und rechts vom \_\_\underbar{unterstrichenen
Text}\_\_
\item [{Schreibmaschine}] Mit zwei \texttt{''} links und rechts vom \texttt{\underbar{}}\texttt{''Schreibmaschinen-{}-Text''}
\end{description}
Natürlich kann man die Attribute auch beliebig kombinieren.


\subsubsection{Links}

Links schließt man in zwei eckige Klammern ein (\texttt{{[}{[}link]]}
oder \texttt{{[}{[}link|Beschreibung]]}). Interne Links sind ohne
\texttt{http://} und weisen auf Wiki--Seiten, externe Links mit http://
verweisen auf entsprechende externe Seiten. Das Wiki erkennt \texttt{http://}
aber auch direkt, ohne eckige Klammern. Namespaces des Wikis werden
im Linknamen durch Doppelpunkte abgetrennt, etwa \texttt{wiki:syntax}
oder \texttt{projects:r8c}. Natürlich kann man auch Bilder mit in
die Link--Beschreibung einbinden.


\subsubsection{Bilder und andere Dateien}

Bilder werden mit zwei geschweifte Klammern eingeschlossen, etwa \texttt{\{\{bild.png\}\}}.
Das Image--Icon im Text\-editor öffnet einen Dialog, mit dem Bilder
ins Wiki hochgeladen werden können. Neben Bildern können auch Filme,
PDFs und ähnliche Dokumente hochgeladen werden.


\subsubsection{Listen}

DokuWiki unterstützt sowohl geordnete als auch ungeordnete Listen.
Alle Listen--Einträge fangen mit 2 oder mehr Spaces ein (gerade Anzahl!);
gefolgt von {*} für ungeordnete und -- für geordnete Listen. Die Tiefe
der Einrückung hängt von der Anzahl der Spaces durch zwei ab.


\subsubsection{Umgewandelte Strings}

DokuWiki wandelt einige Strings automatisch um. Aus ASCII--Smileys
werden Icons, aus ASCII--Art--Pfeilen werden die entsprechenden Unicode--Zeichen.


\subsubsection{Code}

Code schreibt man zwischen \texttt{<code>} und \texttt{</code>} Tags.
DokuWiki unterstützt Syntax Highlighting, etwa \texttt{<code forth>}
für Forth--Quelltext.


\subsubsection{Weitere Features}

DokuWiki unterstützt auch Tabellen, ungeparste Blöcke und eine Menge
Plugins. Deshalb verweise ich hier einfach auf die Online--Dokumentation
unseres Wikis: \url{http://www.forth-ev.de/wiki/doku.php/wiki:syntax}


\section{Zweck}

Das Wiki soll mehrere Zwecke erfüllen:

\begin{itemize}
\item Zunächst wollen wir den Fortschritt von Projekten online dokumentieren.
Sichtbarkeit ist alles, nur über öffentlich zugängliches Material
können wir Aufmerksamkeit bekommen.
\item Dann wollen wir natürlich Hintergrundwissen über Forth sammeln und
zugänglich machen.
\item Das Wiki ermöglicht auch einen schnellen Austausch zwischen Mitgliedern,
ohne auf den Vierteljahresrhyhtmus der VD achten zu müssen. Ein Rückfluss
ist aber jederzeit möglich.
\item Zuletzt soll das Wiki eine zentrale Anlaufstelle für die Forth--Community
bilden. Es ist also für alle da, die Informationen über Forthiges
finden oder ins Netz stellen wollen.
\end{itemize}
Das Wiki wächst, also nutzt es. Je mehr Leute mitmachen, desto mehr
Nutzen kann jeder Einzelne daraus ziehen.

\end{multicols}
\end{document}
