<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">%% 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&gt; &gt;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{&lt;code&gt;} und \texttt{&lt;/code&gt;} Tags.
DokuWiki unterstÃ¼tzt Syntax Highlighting, etwa \texttt{&lt;code forth&gt;}
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}
</pre></body></html>