\documentclass[]{schuleab}
\usepackage[utf8]{inputenc}
\usepackage{schulinf}

% Dieses Dokument ist in der Zusammenarbeit von Informatikreferendaren und
% ehemaligen Informatikreferendaren der Studienseminare (heute ZfsL) Arnsberg,
% Hamm und Solingen entstanden.
%
% Das Dokument steht unter der Lizenz: Creative Commons by-nc-sa Version 4.0
% http://creativecommons.org/licenses/by-nc-sa/4.0/deed.de
%
% Nach dieser Lizenz darf das Dokument beliebig kopiert und bearbeitet werden,
% sofern das Folgeprodukt wiederum unter gleichen Lizenzbedingungen vertrieben
% und auf die ursprünglichen Urheber verwiesen wird.
% Eine kommerzielle Nutzung ist ausdrücklich ausgeschlossen.
%
% Die Namensnennung durch einen Verweis und die Lizenzangabe der ursprünglichen
% Urheber auf den Materialien für Schülerinnen und Schüler ist erforderlich.
%
% Die Sammlung der Dokumente steht unter
% http://ddi.uni-wuppertal.de/material/materialsammlung/
% zur Verfügung.
%
% Das LaTeX-Paket zum Setzen der Dokumente der Sammlung steht
% unter  http://www.ctan.org/pkg/schule
% zur Verfügung.

\usepackage[pdfauthor={Referendare der Informatikfachseminare Arnsberg, Hamm und Solingen}]{hyperref}
\includexmp{lizenz}
\cclizenz{byncsaeu}
\footerQRLink{materialsammlung_qr_url.pdf}

\svnid{$Id: ab_06_latex.tex 1555 2016-08-21 21:41:15Z pieper $}

\dokName{RasPi: \LaTeX}
\jahrgang{9}

\usepackage{inconsolata}

%Anpassungen für die Einbindung im Skript
\newcommand{\singleSection}[1]{\section*{#1}}
\renewcommand{\thesubsection}{\arabic{subsection}}
\newenvironment{Aufgaben}{\subsection{Aufgaben}\begin{smallenumerate}}{\end{smallenumerate}}

\lstset{% 
	breaklines=true, % Zeilenumbrüche
	basicstyle=\ttfamily\small,
	breakatwhitespace=false,
	tabsize=2
}

\newcommand{\LaTeXOrt}{Arbeitblatt}

\begin{document}
\singleSection{\LaTeX\xspace auf dem Raspberry Pi}
Die Textsatzbeschreibungssprache \LaTeX{} ist eine verbreitete Möglichkeit Texte zu schreiben und gleichzeitig Anweisungen zu geben, wie dieser Text gesetzt werden soll. Auch dieses \LaTeXOrt{} ist mit Hilfe von \LaTeX{} geschrieben worden. \LaTeX{} wird durch verschiedene Programme auf fast allen Betriebssystemen unterstützt und benötigt neben dem Übersetzungsprogramm nur einen einfachen Texteditor und einen Betrachter für PDF-Dokumente.

\subsection{Installieren von \LaTeX}
Auf dem Raspberry Pi kann das System TeXlLive installiert werden, dass alle nötigen Tools zur Verfügung stellt. Installiert wird es mit folgendem Befehl:\footnote{Die Raspbian-Quellen sind stabil aber nicht immer die neusten. Eine Installation mit aktuellen Quellen ist unter \ref{texlive} zu finden.}

\begin{lstlisting}[frame=trBL]
	sudo apt-get install texlive texlive-lang-german
\end{lstlisting}

Neben vielen verschiedenen Paketen, mit denen unterschiedliche Funktionen unterstützt werden, ist es in der Regel hilfreich noch zwei weitere Pakete zu installieren:

\begin{lstlisting}[frame=trBL]
	sudo apt-get install texlive-generic-extra texlive-latex-extra
\end{lstlisting}

\subsection{Nutzung von \LaTeX}
Um Texte für \LaTeX{} zu schreiben reicht der einfache Texteditor Leafpad aus, der in der Regel schon installiert ist. Andere Editoren, wie z.\,B. Gummi können auch eingesetzt werden und bieten zusätzliche Extras.

Ein Einfacher Text wird damit wie folgt geschrieben, der z.\,B. in der Datei \lstinline|meintext.tex| abgespeichert werden kann.

\begin{lstlisting}[numbers=left, numberstyle=\tiny,  numbersep=5pt, language={[LaTeX]TeX}]
\documentclass[parskip=half]{scrartcl}
\usepackage{ngerman}
\usepackage[utf8]{inputenc}

\begin{document}

\section{Überschrift erster Ebene}

Ganz einfacher Text. Ganz normal herunter geschrieben.

\end{document}
\end{lstlisting}

Die Übersetzung des Textes in ein PDF-Dokument erfolgt dann mit dem Befehl:

\begin{lstlisting}[frame=trBL]
	pdflatex meintext.tex
\end{lstlisting}

Installiert ist in der Regel der PDF-Betrachter xpdf, mit dem man sich anschließend das Werk anschauen kann.

\subsection{Weitere Möglichkeiten}

Mit dem oben aufgezeigten Text sind die Möglichkeiten von \LaTeX\xspace bei weitem nicht deutlich. Weitere kleine Beispiele gibt es auf verschiedenen Seiten im Internet. Zu empfehlen ist dabei unter anderem das \LaTeX-Kochbuch unter \url{http://archiv.dante.de/TeX-Service/TSP/tex/cookbook/cookbook.html} oder der entsprechende Wikipedia-Ar\-ti\-kel mit entsprechenden Verweisen zu anderen Seiten unter \url{http://de.wikipedia.org/wiki/LaTeX}.

\begin{Aufgaben}
	\item Installiere das Grundsystem von TeXlLive
	\item Schreibe deinen eigenen kleinen Text und lasse ihn in ein PDF-Dokument übersetzen.
	\item Verfasse einen Text darüber, was du mit dem Raspberry bisher alles gemacht hast und was du noch vorhast mit ihm durchzuführen. Setze dabei auch weitere Möglichkeiten von \LaTeX\xspace ein. 
\end{Aufgaben}

\subsection{Installation direkt aus den TeXLive-Quellen}\label{texlive}
Fast täglich gibt es Ergänzungen und Verbesserungen bei den \LaTeX-Paketen. Die Quellen von Debian, auf dem das Raspbian aufsetzt, haben aber einen eingefrorenen Zustand, bis eine neue Version von Debian veröffentlicht wird. Zwar werden Sicherheitsupdates eingepflegt, aber diese betreffen eher die Programmteile von TeXlLive und nicht die Pakete zum setzen. Aus diesen Gründen kann es sinnvoll sein, direkt auf die TeXlLive-Quellen zu setzen.

Ist bereits eine Installation aus den Raspbian-Quellen erfolgt, so sollte diese entfernt werden. Dazu dienen folgende Aufrufe, die zuerst die wichtigen Pakete entfernen und im zweiten Schritt die verbliebenen Pakete denen dann die Grundlage fehlt.
\begin{lstlisting}[frame=trBL]
	sudo apt-get remove texlive
	sudo apt-get autoremove
\end{lstlisting}

Für die Installation von TeXlLive für den Raspberry Pi wir der Netzwerkinstaller benötigt, der folgendermaßen heruntergeladen und anschließen entpackt wird:

\begin{lstlisting}[frame=trBL]
	wget mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz
	tar -xf install-tl-unx.tar.gz
\end{lstlisting}

Entpackt wird eine Verzeichnis \lstinline|install-tl-XXXX|, wobei der letzte Teil einem Datum entspricht. In dieses Verzeichnis muss man wechseln und das eigentliche Installationsprogramm starten: 

\begin{lstlisting}[frame=trBL]
	sudo ./install-tl
\end{lstlisting}

Bevorzugt man eine graphische Variante und hat das Paket \lstinline|perl-tk| auf dem Raspberry Pi installiert, so kann man auch folgendes aufrufen:
\begin{lstlisting}[frame=trBL]
	sudo ./install-tl gui
\end{lstlisting}

In beiden Fällen empfiehlt es sich für den Anfang das Installationsschema bzw. der Installationsumfang \enquote{scheme-small} zu wählen. Fehlende benötigte Teile können anschließend immer noch der Startinstallation hinzugefügt werden. Die anschließende Installationsroutine wird einige Zeit benötigen, da die weiteren Daten aus dem Internet erst heruntergeladen werden.

Nach der Installation ist noch die Datei \lstinline|/etc/profile.d/texlive.sh| anzulegen mit dem folgenden Inhalt. Dieses ist nötig, damit man die Programme wie \lstinline|pdflatex| direkt aufrufen kann. Das 20xx muss dabei entsprechend der lokalen Installation angepasst werden.
\begin{lstlisting}[numbers=left, numberstyle=\tiny,  numbersep=5pt]
export PATH=/usr/local/texlive/20xx/bin/armhf-linux:$PATH
export MANPATH=/usr/local/texlive/20xx/texmf-dist/doc/man:$MANPATH
export INFOPATH=/usr/local/texlive/20xx/texmf-dist/doc/info:$INFOPATH
\end{lstlisting}

Bis zum nächsten Neustart des Raspberry Pi muss man in jeder einzelnen Shell die obigen Einträge per Hand nachladen:
\begin{lstlisting}[frame=trBL]
	source /etc/profile 
\end{lstlisting}

Danach lässt sich TeXLive über den eigenen Manager \lstinline|tlmgr| aktualisieren und erweitern. Mit einer graphischen Oberfläche geschieht dieses über: 
\begin{lstlisting}[frame=trBL]
	sudo su -
	tlmgr gui
\end{lstlisting}

Die reine Aktualisierung kann erfolgen durch:
\begin{lstlisting}[frame=trBL]
	sudo su -
	tlmgr update --self
	tlmgr update --list
	tlmgr update --all 
\end{lstlisting}

Will man nun andere Programme über den Raspbian Paketmanager installieren, die ein \LaTeX{}-System voraussetzen, so fehlen bei dieser Variante die entsprechenden Einträge. Möchte man diese nachziehen sollte man der Anleitung unter \url{http://tinyurl.com/texliveinstallation} im Ubuntu-Wiki folgen.

\end{document}