online lip handout: corrections and formating

onlinelip/handout/appendix.tex

@@ -134,7 +134,7 @@
 
 \begin{figure}
   \centering
-  \includegraphics[width=0.6\linewidth]{vm-desktop.png}
+  \includegraphics[width=0.8\linewidth]{vm-desktop.png}
   \caption{
     Virtuelle Maschine nach dem ersten Start (ohne Willkommen-Fenster).
   }

onlinelip/handout/handout.tex

@@ -3,8 +3,8 @@
 \settypeblocksize{27cm}{19cm}{*}
 \setlrmargins{*}{*}{1}
 \setulmargins{*}{*}{1}
-\setcolsepandrule{7mm}{0.3pt}
-\setheadfoot{0mm}{0mm}
+\setcolsepandrule{8mm}{0.3pt}
+\setheadfoot{1mm}{0mm}
 \checkandfixthelayout
 \pagestyle{empty}
 \setsecnumdepth{none}
@@ -17,7 +17,15 @@
 \usepackage{graphicx}
 \graphicspath{{figures/}}
 \usepackage{hyperref}
-% TODO: hypersetup
+\definecolor{linkcolor}{rgb}{0.6,0,0.2}
+\definecolor{urlblue}{rgb}{0,0,0.9}
+\hypersetup{
+  pdftitle={Handout Linux Import Party WS2020/21},
+  pdfauthor={OSAK},
+  colorlinks=true,
+  linkcolor=linkcolor,
+  urlcolor=urlblue,
+}
 
 % luaLaTeX? XeLaTeX? pdfLaTeX?
 \usepackage{ifluatex}
@@ -42,10 +50,14 @@
 
 \newcommand\todo[1]{{\color{red}\textsc{Todo}: #1}}
 
-\usepackage{keystroke}
-\newcommand\return{\Return}
-
+%\usepackage{keystroke}
+%\newcommand\return{\Return}
 
+\usepackage{fancyhdr}
+\lhead{\slshape online Linux Import Party WS\,2020/21}
+\chead{\slshape Open Source Arbeitskreis}
+\rhead{\slshape\url{https://osak.fsmpi.rwth-aachen.de}}
+\pagestyle{fancy}
 
 \def\figureautorefname{Abb.}
 \def\tableautorefname{Tab.}
@@ -55,17 +67,19 @@
 \def\sectionautorefname{Abschnitt.}
 \def\subsectionautorefname{Unterabschnitt.}
 
+% Format file names and paths:
+\newcommand\file[1]{\enquote{#1}}
 
 \begin{document}
+
 \begin{multicols}{2}
-\todo{Formatierung, \ldots}
 
 \section{Wichtig!}
 \begin{itemize}
-  \item Mit dieser Anleitung kannst Du eine virtuelle Maschine mit Linux~Mint installieren.
-  \item Wir gehen davon aus, dass auf dem Computer ein Betriebssystem (Windows~10 oder macOS/OS~X\footnote{Leider können wir zu OS~X nicht so eine detaillierte Anleitung bereitstellen wie für Windows}) installiert ist. Das Linux wird dann innerhalb dieses \enquote{Host Systems} laufen.
-  \item Überspringe keine Schritte, es sei denn Du weißt \emph{genau} was du tust.
-  \item \textbf{Frag uns}, wenn Du etwas nicht verstehst oder wenn diese Anleitung nicht zu passen scheint: \href{mailto:osak@fsmpi.rwth-aachen.de}{\texttt{osak@fsmpi.rwth-aachen.de}}
+  \item Mit dieser Anleitung kannst Du eine virtuelle Maschine (VM) mit Linux~Mint installieren.
+  \item Wir gehen davon aus, dass auf dem Computer Windows~10 oder \mbox{macOS}/OS~X\footnote{Leider können wir zu OS~X nicht so eine detaillierte Anleitung bereitstellen wie für Windows, da wir keine Geräte zum Testen haben.} installiert ist. Das Linux wird dann innerhalb dieses \enquote{Host Systems} laufen.
+  \item Überspringe keine Schritte, es sei denn Du weißt \emph{genau} was Du tust.
+  \item \textbf{Frag uns}, wenn Du etwas nicht verstehst oder wenn diese Anleitung nicht zu passen scheint: \href{mailto:osak@fsmpi.rwth-aachen.de}{\texttt{osak@fsmpi.rwth-aachen.de}} oder am 12.11.2020 ab 16~Uhr im Live-Chat: \url{https://lip-chat.fsmpi.rwth-aachen.de/channel/general}
 \end{itemize}
 
 \section{Vorbereitung}
@@ -73,18 +87,18 @@ Prüfe, ob dein Computer geeignet ist, um darauf eine virtuelle Maschine zu betr
 \begin{itemize}
   \item \textbf{Massenspeicher (Festplatte)}: Du brauchst mindestens 15\,GB freien Speicher, mehr als 20\,GB sind dringend empfohlen.
     \begin{itemize}
-      \item In Windows: Im Explorer wird unter \enquote{Computer} die Festplattenbelegung angezeigt, siehe \autoref{fig:explorer}.
+      \item In Windows: Im Explorer wird unter \enquote{Computer} die Festplattenbelegung angezeigt (siehe \autoref{fig:explorer}).
     \end{itemize}
   \item \textbf{Arbeitsspeicher} (RAM): $\geq6$\,GB sind empfohlen, 4\,GB sind das notwendige Minimum.
     \begin{itemize}
-      \item In Windows: Im Task~Manager\footnote{Öffnen durch Rechtsklick auf die Startleiste, ggf.~\enquote{mehr Details} auswählen, siehe \autoref{fig:taskmanager}.\label{fn:taskmanager}}, Tab \enquote{Leistung}, wird der Arbeitsspeicher angezeigt (siehe \autoref{fig:taskmanager}). Wenn dort weniger als 2\,GB frei sind, obwohl keine anderen Programme laufen, ist der Arbeitsspeicher zu knapp.
+      \item In Windows: Im Task~Manager\footnote{Öffnen durch Rechtsklick auf die Startleiste, ggf.~\enquote{mehr Details} auswählen (siehe \autoref{fig:taskmanager}).\label{fn:taskmanager}}, Tab \enquote{Leistung}, wird der Arbeitsspeicher angezeigt (siehe \autoref{fig:taskmanager}). Wenn dort weniger als 2\,GB frei sind, obwohl keine anderen Programme laufen, ist der Arbeitsspeicher zu knapp.
     \end{itemize}
   \item Dein Betriebssystem muss ein \textbf{64\,bit} System sein. Bei fast allen aktuellen Computern ist das so. Um sicher zu gehen, kannst Du es so überprüfen:
     \begin{itemize}
       \item In Windows 10:
-        Im Explorer \textit{Rechtsklick} auf \enquote{Dieser PC}, \enquote{Eigenschaften} auswählen.
+        Im Explorer Rechtsklick auf \enquote{Dieser PC}, \enquote{Eigenschaften} auswählen.
         Es öffnet sich ein Fenster \enquote{System}.
-        Hier sollte unter \enquote{System} > \enquote{System Type} die Zeile mit \textbf{\enquote{64-bit}} anfangen, siehe \autoref{fig:systeminfo}.
+        Hier sollte unter \enquote{System} > \enquote{System Type} die Zeile mit \textbf{\enquote{64-bit}} anfangen (siehe \autoref{fig:systeminfo}).
     \end{itemize}
   \item Dein Prozessor muss \textbf{Hardwarevirtualisierung} unterstützen und diese muss angeschaltet sein.
     \begin{itemize}
@@ -93,7 +107,8 @@ Prüfe, ob dein Computer geeignet ist, um darauf eine virtuelle Maschine zu betr
     \end{itemize}
     Wenn die Hardwarevirtualisierung ausgeschaltet ist, kann man sie normalerweise im BIOS/UEFI-Menu des Computer anschalten.
     \begin{center}
-      \textbf{Achtung: Falsche Einstellungen im BIOS/UEFI können einen Computer unbrauchbar machen!} Wenn Du unsicher bist, \textbf{frag lieber nach!}
+      \textbf{{\color{red}Achtung:} Falsche Einstellungen im BIOS/UEFI können einen Computer unbrauchbar machen!}\\
+      Wenn Du unsicher bist, \textbf{frag lieber nach!}
     \end{center}
     In Windows 10 kommst Du normalerweise so ins \mbox{UEFI}: Öffne das Startmenu, drücke auf den Knopf zum Ausschalten und dann mit gedrückter Umschalttaste auf \enquote{Neu starten}.
   \item \textbf{Internet}: Es müssen insgesamt mindestens 2\,GB heruntergeladen werden.
@@ -102,7 +117,7 @@ Prüfe, ob dein Computer geeignet ist, um darauf eine virtuelle Maschine zu betr
 \section{Installation von VirtualBox}
 In dieser Anleitung wird die Installation in VirtualBox beschrieben. VirtualBox ist ein Programm zum Betreiben virtueller Maschinen. Wenn Du dafür lieber ein anderes Programm nutzt, gibt es einiges zu beachten.%
 \footnote{%
-  In unserer VM ist das Paket \texttt{virtualbox-guest-x11} vorinstalliert. Wenn Du ein anderes Virtualisierungsprogramm nutzt, solltest Du das deinstallieren und stattdessen die guest-tools für Dein Virtualisierungsprogramm installieren. Das Kapitel \autoref{sec:guest-tools} zu Dateiaustausch zwischen Guest- und Hostsystem ist spezifisch für VirtualBox. Hierfür ist der bei der Installation eingerichtete Nutzeraccount der Gruppe \texttt{vboxfs} hinzugefügt.
+  In unserer VM ist das Paket \texttt{virtualbox-guest-x11} vorinstalliert. Wenn Du ein anderes Virtualisierungsprogramm nutzt, solltest Du das deinstallieren und stattdessen die guest-tools für Dein Virtualisierungsprogramm installieren. Das Kapitel \hyperref[sec:optional-settings]{\enquote{Optionale Einstellungen}} ist spezifisch für VirtualBox. Zur Nutzung mit VirtualBox ist der bei der Installation eingerichtete Nutzeraccount bereits der Gruppe \texttt{vboxfs} hinzugefügt.
 }
 \begin{itemize}
   \item Lade VirtualBox hier herunter: \url{https://www.virtualbox.org/wiki/Downloads} (siehe \autoref{fig:vbox-download}).
@@ -113,70 +128,70 @@ In dieser Anleitung wird die Installation in VirtualBox beschrieben. VirtualBox
 
 \section{Erstellen der virtuellen Maschine}
 \begin{itemize}
-  \item Lade unsere vorinstallierte virtuelle Maschine (VM) hier herunter: \todo{Link}
+  \item Lade unsere vorinstallierte virtuelle Maschine (VM) hier herunter: \url{https://osak.fsmpi.rwth-aachen.de/os-images/lip-ws20.ova}
   \item Öffne die heruntergeladene \texttt{.ova}-Datei (in Windows mit Doppelklick).
     Falls das nicht funktioniert, öffne VirtualBox und wähle über \enquote{Importieren} die Datei aus (siehe \autoref{fig:vbox-import-manually}).
   \item Du solltest nun ein Fenster \enquote{Appliance-Einstellungen} sehen (wie \autoref{fig:vbox-import}).
     %Hier kannst Du den Arbeitsspeicher und die Anzahl der Prozessorkerne für die VM anpassen.
-    Wir empfehlen, hier die Standardeinstellungen zu behalten und die Einstellungen erst später anzupassen. Nur wenn man die Einstellungen später anpasst, wird auch angezeigt, ob diese Einstellungen zur vorhandenen Hardware passen. Das Importieren der VM kann etwas dauern.
-  \item Nach dem Importieren solltest Du in VirtualBox die neue VM in der linken Leiste sehen.
+    Wir empfehlen, hier die Standardeinstellungen zu behalten und die Einstellungen erst später anzupassen. Nur wenn man die Einstellungen später anpasst, wird auch angezeigt, ob diese Einstellungen zur vorhandenen Hardware passen.\\
+    Das Importieren der VM kann etwas dauern.
+  \item Nach dem Importieren solltest Du in VirtualBox die neue VM in der linken Leiste sehen (siehe \autoref{fig:vbox-vm-erstellt}).
 \end{itemize}
 
 \subsection{Notwendige Einstellungen}
-Arbeitsspeicher (auch RAM oder Hauptspeicher genannt) und CPU-Kerne werden zwischen VM und Hostsystem aufgeteilt.
+Arbeitsspeicher (auch RAM oder Hauptspeicher genannt) und CPU-Kerne werden zwischen VM und Hostsystem aufgeteilt. Hier wird diese Aufteilung festgelegt.
 \begin{itemize}
   \item Öffne die VirtualBox-Einstellungen der neuen VM. Klicke dazu in der linken Leiste auf die VM und danach in der oberen Leiste auf \enquote{Ändern}. (siehe \autoref{fig:vbox-vm-erstellt})
-  \item Im Abschnitt \enquote{System}, Tab \enquote{Motherboard} wird der Arbeitsspeicher (auch Hauptspeicher oder RAM genannt) angepasst (siehe \autoref{fig:vbox-edit-system}).
-    Passe die Größe des Arbeitsspeichers der VM so an, dass VM und Host möglichst beide mindestens 2\,GB haben.
+  \item Im Abschnitt \enquote{System}, Tab \enquote{Motherboard} wird der Arbeitsspeicher angepasst (siehe \autoref{fig:vbox-edit-system}).
+    Passe die Größe des Arbeitsspeichers der VM so an, dass VM und Host beide mindestens 2\,GB haben.
   \item Im Abschnitt \enquote{System}, Tab \enquote{Prozessor} wird die Anzahl der von der VM genutzten Prozessorkerne angepasst (siehe \autoref{fig:vbox-edit-system}).
     Wähle je nach erwarteter Nutzung innerhalb des von VirtualBox grün angezeigten Bereichs aus, wie viele Prozessorkerne die VM bekommen soll.
     %Eine CPU-Begrenzung ist in der Regel nicht nötig.
 \end{itemize}
 
 \subsection{Optionale Einstellungen}
+\label{sec:optional-settings}
 Die folgenden Einstellungen können auch später noch vorgenommen werden.
-Wichtig ist aber, dass die VM währenddessen ausgeschaltet sein muss!
-\begin{itemize}
-  \item Festplattengröße anpassen:\\
+\textbf{Wichtig ist aber, dass die VM dabei ausgeschaltet ist!}
+\begin{description}
+  \item[Festplattengröße anpassen.]
     In der vorinstallierten VM ist die Festplatte 12\,GB groß.
-    Die virtuelle Festplatte ist eine Datei, die erst beim Schreiben von Daten auf die virtuelle Festplatte größer wird. Die Datei ist also nicht von Anfang an 12\,GB groß. Allerdings schrumpft die Datei nicht, wenn Daten auf der virtuellen Festplatte gelöscht werden.
-
-    Eine virtuelle Festplatte kann man, während die VM ausgeschaltet ist, beliebig vergrößern, \emph{aber nicht verkleinern}. So kannst Du die virtuelle Festplatte vergrößern:
+    Die virtuelle Festplatte ist eine Datei, die erst beim Schreiben von Daten auf die virtuelle Festplatte größer wird. Die Datei ist also nicht von Anfang an 12\,GB groß. Allerdings schrumpft diese Datei \emph{nicht}, wenn Daten auf der virtuellen Festplatte gelöscht werden.
+    \\
+    Die virtuelle Festplatte kann man, während die VM ausgeschaltet ist, beliebig vergrößern, \emph{aber nicht verkleinern}. So wird die virtuelle Festplatte vergrößert:
     \begin{itemize}
-      \item Stelle sicher, dass die VM ausgeschaltet ist.
-      \item Öffne in VirtualBox den Medien-Manager: In der linken Leiste über \enquote{Tools/Media} oder in der obersten Leiste in \enquote{File/Virtual Media Manager} (siehe \autoref{fig:vbox-media}).
-      \item Unter \enquote{Eigenschaften}, im Tab \enquote{Festplatten} kannst Du die Größe der Festplatte(n) sehen anpassen.
+      \item Öffne in VirtualBox den Medien-Manager: In der linken Leiste über \enquote{Tools/Media} oder in der obersten Leiste in \enquote{Datei/Manager für virtuelle Medien} (siehe \autoref{fig:vbox-media}).
+      \item Unter \enquote{Eigenschaften}, im Tab \enquote{Festplatten} kannst Du die Größe der Festplatte(n) sehen und anpassen.
     \end{itemize}
 
-  \item Geteilte Ordner zwischen VM und Host:\\
-    Stelle sicher, dass die VM ausgeschaltet ist.
-    In den VirtualBox-Einstellungen für die VM, im Abschnitt \enquote{Gemeinsame Ordner} kannst Du gemeinsame Ordner hinzufügen, siehe \autoref{fig:shared-folder}. Wähle dabei \enquote{Automatisch einbinden} aus und lass das Eingabefeld \enquote{Einbindepunkte} leer.
-  \item Geteilte Zwischenablage:\\
-    In den VirtualBox-Einstellungen für die VM, im Abschnitt \enquote{Allgemein}, Tab \enquote{Erweitert} kannst du die gemeinsame Zwischenablage (Copy-Paste) und Drag'n'Drop zwischen Guest (VM) und Host aktivieren. (siehe \autoref{fig:clipboard})
-\end{itemize}
+  \item[Gemeinsame Ordner von VM und Host.]
+    In den VirtualBox-Einstellungen für die VM (\enquote{Ändern} in der oberen Leiste, siehe \autoref{fig:vbox-vm-erstellt}), im Abschnitt \enquote{Gemeinsame Ordner} kannst Du gemeinsame Ordner hinzufügen (siehe \autoref{fig:shared-folder}). Wähle dabei \enquote{Automatisch einbinden} aus und lass das Eingabefeld \enquote{Einbindepunkte} leer.
+  \item[Gemeinsame Zwischenablage.]
+    In den VirtualBox-Einstellungen für die VM, im Abschnitt \enquote{Allgemein}, Tab \enquote{Erweitert} kannst Du die gemeinsame Zwischenablage (Copy-Paste) und Drag'n'Drop zwischen VM und Host aktivieren. (siehe \autoref{fig:clipboard})
+\end{description}
 
 \subsection{Erster Start der VM}
 \begin{itemize}
-  \item Starte die VM. Du wirst automatisch durch eine grundlegende Einrichtung geführt. Das automatische Einrichten danach kann etwas dauern.\\
+  \item Starte die VM (\enquote{Starten} in der oberen Leiste, siehe \autoref{fig:vbox-vm-erstellt}). Du wirst automatisch durch eine grundlegende Einrichtung geführt. Das automatische Einrichten danach kann etwas dauern.\\
     \emph{(Wenn die Einrichtung fertig ist sieht es kurz so aus, als ob die VM abstürzt. Das ist normal und sollte nur ein paar Sekunden dauern.)}
   \item Prüfe, ob Du in der VM Internet hast. In der Startleiste liegt dafür der Browser (Firefox).
-  \item Wenn Du die Größe des Fensters änderst, in dem die VM angezeigt wird, sollte sich das Bild der VM entsprechend anpassen, um das ganze Fenster auszufüllen. Prüfe auch das.
-  \item \emph{(optional)} Prüfe, ob geteilte Ordner und Copy-Paste wie erwartet funktionieren. Geteilte Ordner sollten auf dem Desktop zu sehen sein, wenn Du beim Einrichten in VirtualBox \enquote{automatisch einbinden} ausgewählt hast (siehe \autoref{fig:vm-desktop}. Prüfe auch, ob Du in geteilten Ordnern Dateien erstellen und bearbeiten kannst.
+  \item Wenn Du die Größe des Fensters änderst, in dem die VM angezeigt wird, sollte sich das Bild der VM entsprechend anpassen, um das ganze Fenster auszufüllen. Prüfe auch das. (Es ist normal, dass das Anpassen an die Fenstergröße relativ langsam ist.)
+  \item \emph{(optional)} Prüfe, ob geteilte Ordner und Copy-Paste wie erwartet funktionieren. Geteilte Ordner sollten auf dem Desktop zu sehen sein (siehe \autoref{fig:vm-desktop}. Prüfe auch, ob Du in geteilten Ordnern Dateien erstellen und bearbeiten kannst.
 \end{itemize}
 
 \section{Zusätzliche Software}
 Für Studierende der Fachschaft Mathe/Physik/Informatik haben wir einige nützliche Programme gesammelt, die Du wie folgt installieren kannst.
 \begin{itemize}
-  \item Auf dem Desktop findest du ein Programm \texttt{LinuxParty}. Öffne diese mit Doppelklick.
-  \item Du wirst aufgefordert, dein Passwort einzugeben, um Pakete installieren zu können (siehe \autoref{fig:linuxparty}. Danach startet das Programm, mit dem du bequem nützliche Programm auswählen und installieren kannst. In einem Terminal\footnote{das schwarze Fenster mit weißem Text} wird Dir dabei angezeigt, was gerade passiert.
-  \item Das Herunterladen und Installieren der Programme kann einige Zeit dauern. Habe also bitte Geduld und warte, bis angezeigt wird, dass die Installation abgeschlossen ist.
+  \item Auf dem Desktop findest Du ein Programm \texttt{LinuxParty}\footnote{Zu LinuxParty gehören die Dateien \file{Downloads/linuxparty.sh} (das eigentliche Programm), \file{Downloads/packages} (eine Liste mit empfohlenen Paketen, die das Programm benutzt) und \file{Desktop/LinuxParty.desktop} (zum bequemen Öffnen des Programms). \file{linuxparty.sh} funktioniert allein als Programm, solange es im gleichen Order liegt wie \file{packages}.}. Öffne diese mit Doppelklick.
+  \item Du wirst aufgefordert, dein Passwort einzugeben, um Pakete installieren zu können (siehe \autoref{fig:linuxparty}). Danach kannst Du bequem nützliche Programm auswählen und installieren. In einem Terminal\footnote{das schwarze Fenster mit weißem Text} wird währenddessen angezeigt, was gerade passiert.
+  \item Das Herunterladen und Installieren der Programme kann einige Zeit dauern. Hab also bitte Geduld und warte, bis angezeigt wird, dass die Installation abgeschlossen ist.
 \end{itemize}
 
 \section{Grundlegende Infos zur Nutzung}
 \label{sec:nutzung}
 \begin{itemize}
   \item Zum Installieren von Software gibt es einen Paketmanager. Das hat den Vorteil, dass Programme bequem und sicher installiert werden können und automatisch nach Updates gesucht wird. Der Paketmanager wird Dich darauf hinweisen, wenn Updates verfügbar sind. Du solltest die Updates dann installieren.
-  \item Wenn Du ein Programm installieren willst, lade es \emph{nicht} einfach aus dem Internet herunter, sondern suche es zuerst mit der Anwendungsverwaltung, siehe \autoref{fig:pakete-installieren}. So findest Du Pakete, die für Dein System getestet sind und automatisch Updates bekommen.
+  \item Wenn Du ein Programm installieren willst, lade es \emph{nicht} einfach aus dem Internet herunter, sondern suche es zuerst mit der Anwendungsverwaltung (siehe \autoref{fig:pakete-installieren}). So findest Du Pakete, die für Dein System getestet sind und automatisch Updates bekommen.
   \item In einer VM kann Speicherplatz leicht knapp werden. Um Speicherplatz frei zu machen, sind z.B.~die Befehle \texttt{sudo apt autoremove} und \texttt{sudo apt clean} in der Kommandozeile (also im Terminal) hilfreich. Damit löschst Du Pakete, die nicht mehr benötigt werden. Die aktuelle Festplattenbelegung wird mit \texttt{df -h} angezeigt.
   \item Videokonferenz-Software sollte nicht in der VM genutzt werden.
   \item Viele Anleitungen (z.B.~zum Installieren speziellerer Pakete) funktionieren auch in Linux~Mint. Ein großer Unterschied ist jedoch, dass Mint kein snap verwendet. Snap ist ein zusätzlicher Paketmanager, der in Ubuntu beispielweise für Chromium (den freien Teil von Google Chrome) verwendet wird. Mehr dazu und eine Anleitung, wie Du snap trotzdem installieren kannst, findest Du hier: \url{https://linuxmint-user-guide.readthedocs.io/en/latest/snap.html}