\section{Orxonox installieren, kompillieren und starten}

In dieser ersten Lektion wirst du lernen, wie man Orxonox auf den
Tardis Rechnern der ETH zum laufen bringt. Dazu wirst du die
gebr\"auchlichen Open Source Tools \emph{subversion} verwenden um die Daten zu \emph{fetchen} und die Automake/Autoconf scripts um das Projekt zu komilieren. \newline
Im zweiten Teil wirst du bekannte Tools ausprobieren, die zur Kommunikation zwischen den Entwicklern dient.


\begin{description}
\item[Source Code runterladen:] Lade den Source mit Subversion runter, dabei verwenden wir die Syntax aus dem Theorieteil. Zuerst m\"ussen wir aber ein Verzeichnis erstellen und wechseln in dieses:
\codesnip{gobble=0}
mkdir svn
cd svn
\end{Verbatim}
Nun k\"onnen wir den Source auschecken. Dazu wirst du deinen
Benutzernamen mit dem dazugeh\"origen Passwort brauchen, dass wir dir
auf einem separaten Blatt gegeben haben (das Blatt mit Passwort bitte nach
Eingabe und Auswendiglernen aufessen :D ).
Orxonox braucht zur Ausf\"uhrung zwei \emph{Repositories}, eines f\"ur
den Source (\verb"../orxonox/") und eins f\"ur Daten wie Grafiken,
Level und Models (\verb"../data/")
\codesnip{gobble=0}
svn co https://svn.orxonox.net/orxonox/trunk orxonox/trunk
svn co https://svn.orxonox.net/data orxonox/data
\end{Verbatim}


\item[Source Code Compilieren] Versuche nun Orxonox zu
  kompilieren. Dazu verwendest du die standard GNU Compiler
  Collection (\verb"GCC") wie \verb"g++" und \verb"make". Die
  Schwierigkeit beim Compilieren liegt meistens darin, dass die Tool
  unmengen an Flags und command-line argumenten unterst\"utzen. Lass
  dich nicht verwirren. \newline
Die folgenden Einstellungen sind \textbf{ausschliesslich f\"ur die Tardis Rechner an der ETH}. Wenn du Orxonox zu Hause installieren willst, dann foglst du am besten den Tutorials auf der Website \footnote{Website/Wiki unter \verb"www.orxonox.net"}

  \begin{enumerate}
    \item{Envirtonment Variablen setzen:} \\
      Die Tardis Rechner an der ETH verwenden (im Vergleich zu anderen
      Linux Distributionen) spezielle Verzeichnisse, die durch
      sogenannte \verb"environement variables" gesetzt werden
      m\"ussen.
      
      Auf den Tardis musst du die Kommandos die in
      \textbf{/usr/pack/gamelibs-1.0-to/SEPP/README} und \textbf{orxonox/trunk/scripts/tardis.txt}
      stehen verwenden.

    \item{spezielles configure flag fuer tardis}
      Da wir festgestellt haben, dass die eingabe der oben genannten
      Flags ziemlich viel Zeit beanspruchen, haben wir spezielle f\"ur
      den Gebrauch mit Tardis-Rechnern einen speziellen flag ins
      configure eingebaut:
\codesnipper{gobble=0}
set path= ( /usr/pack/gtk-2.8.3-mo/i686-debian-linux3.1/bin $path )
./configure --with-tardis
\end{Verbatim}
    \item{Konfigurieren, Kompilieren, Linken} If this two commands
      should produce errors during the configure process, try to
      execute \textbf{./MakeMakefile} first, this will regenerate the
      makefiles.
\codesnip{gobble=0}
make
      \end{Verbatim}
    \item{Ausf\"uhren}
      \codesnip{gobble=0}
./src/orxonox
      \end{Verbatim}
  \end{enumerate}

\end{description}


\section{Kommunikation}


\begin{description}
 \item[Mailinglisten:] Trage dich in die folgenden Mailing Lisen ein. Orxonox hat drei verschiedene Mailinglisten: \verb"announce" (Ank\"undigungen von Releases oder Events), \verb"dev" (Entwickler unter sich) und \verb"commit" (die commit messages).
  Geht dazu auf die folgenden Webpages, um euch anzumelden:
  \codesnip{gobble=0}
https://mail.datacore.ch/mailman/listinfo/orxonox-announce
https://mail.datacore.ch/mailman/listinfo/orxonox-dev
https://mail.datacore.ch/mailman/listinfo/orxonox-commit
  \end{Verbatim}
   Wir empfehlen dir sehr f\"ur die drei Mailinglisten einen Filter in deinem Mailclient zu definieren (z.B. kannst du f\"ur jede Liste ein Verzeichnis erstellen). Dies hilft dir den \"Uberblick zu wahren.
 
  \item[IRC:] Der \emph{Internet Relay Chat} ist gut geeignet f\"ur kleinere (real-time) Diskussionen. Wir werden viel im \emph{Orxonox IRC} anzutreffen sein, damit wir euch allen bei euren Problemen so schnell wie m\"oglich helfen k\"onnen. Auf den Tardis sind auch IRC Clients installiert, starte \verb"xchat" und \emph{joine} den Channel orxonox. 
  \codesnip{gobble=0}
xchat irc://irc.datacore.ch      
    ->   /join #orxonox
  \end{Verbatim}
  
  \item[WIKI:] Damit Informationen auch f\"ur die Leute zug\"anglich gemacht werden k\"onnen, die nicht auf einer Mailingliste eingeschriben sind oder sich im IRC aufhalten, werden wichtige Informationen direkt ins Wiki geschrieben. Das Wiki ist der wichtigste Datenpool von Orxonox.
  \codesnip{gobble=0}
https://www.orxonox.net/cgi-bin/trac.cgi
  \end{Verbatim}
  Login ins Wiki mit dem Benutzernamen und dem Passwort, dass du von uns erhalten hast. Suche den Bereich People unter Misc (unten auf der Seite), dort findest du deinen Namen, in einer komischen grauen Farbe und einem Fragezeichen am Ende (undefinierte Links nehmen im Trac-Wiki diese graue Farbe an). Wenn du auf deinen Namen klickst, dann kommst du auf eine neue leere Seite. Schreibe hier etwas kleines \"uber dich, damit du die Wiki Syntax kennenlernst\footnote{Wiki Syntax auch einsehbar unter: https://www.orxonox.net/cgi-bin/trac.cgi/wiki/WikiFormatting}.
  
\end{description}



\section{Selbstst\"andiges Arbeiten zu Hause}

\begin{enumerate}
\item Versuche Orxonox nun mal zu Hause zum laufen zu bringen, damit du auch
von dort arbeiten kannst. Wir empfehlen dir Orxonox unter einer Linux
Distribution aufzusetzen und zu entwicklen, da dies am einfachsten
geht. Orxonox funktioniert aber auch unter Windows und MacOSX
(V10.4). \newline
Falls du bei der Installation auf Probleme stossen solltest, komm doch
einfach in den IRC Chat oder schreibe ein Mail an die development Mailingliste.

\item Schau dir unter
  \verb"https://www.orxonox.net/cgi-bin/trac.cgi/wiki/PPS_Topics" die
  Projekt Themen an und \"uberlege dir, woran du gerne arbeiten w\"urdest.
\end{enumerate}
