added pycharm installation instructions for ubuntu

Author: thomasWeise

notation/software.sty

@@ -19,7 +19,7 @@ description={The \href{https://python.org/}{\softwareStyle{Python}} programming
 name={\softwareStyle{Linux}},
 sort={Linux},
 description={%
-\href{https://www.linux.org/}{\softwareStyle{Linux}} is an open source operating system, i.e., a free alternative for \windows. %
+is an open source operating system, i.e., a free alternative for \windows. %
 Its variant \ubuntu\ is particularly easy to use and install. %
 We recommend using it for this course, for software development, and for research.%
 }%
@@ -31,7 +31,7 @@ We recommend using it for this course, for software development, and for researc
 name={\softwareStyle{PyCharm}},
 sort={PyCharm},
 description={%
-\href{https://www.jetbrains.com/pycharm/}{\softwareStyle{PyCharm}} is the convenient \python\ \gls{ide} that we recommend for this course.%
+is the convenient \python\ \gls{ide} that we recommend for this course.%
 }%
 }%
 \protected\gdef\pycharm{\gls{pycharm}}%
@@ -41,9 +41,9 @@ description={%
 name={\softwareStyle{Ubuntu}},
 sort={Ubuntu},
 description={%
-\href{https://ubuntu.com/}{\softwareStyle{Ubuntu}} is a variant of the open source operating system \linux. %
+is a variant of the open source operating system \linux. %
 We recommend that you use this operating system to follow this class, for software development, and for research. %
-If you are in China, you can download it from \expandafter{\ubuntuDownloadUrl}.%
+If you are in China, you can download it from \expandafter\url{\ubuntuDownloadUrl}.%
 }%
 }%
 \protected\gdef\ubuntu{\gls{ubuntu}}%

notation/terms.sty

@@ -14,14 +14,25 @@ For this course, we recommend using \pycharm.%
 }%
 %
 %
+\newglossaryentry{sudo}{%
+name={\texttt{sudo}},
+sort={sudo},
+description={%
+In order to perform administrative tasks such as installing new software under \linux, root (or ``super'') user privileges as needed. %
+A normal user can execute a program in the \gls{terminal} as super user by pre-pending \bashil{sudo}, often referred to as ``super user do.'' %
+This requires the root password.%
+}%
+}%
+%
+%
 \newglossaryentry{terminal}{%
 name={terminal},
 plural={terminals},
 description={%
 A terminal is a text-based window where you can enter commands and execute them by pressing \keys{\return}. %
 Knowing what a terminal is and how to use it is very essential in any programming- or system administration-related task. %
-If you want to open a terminal under \windows, you can press \keys{\OSwin + R}, type in \bashil{cmd}, and hit \keys{\return}, as shown, e.g., in \cpageref{fig:installingPythonWindows01openTerminal}. %
-Under \ubuntu\ \linux, \keys{\ctrl+\Alt+T} opens a terminal.%
-}
+If you want to open a terminal under \windows, you can \windowsTerminal, as shown, e.g., in \cpageref{fig:installingPythonWindows01openTerminal}. %
+Under \ubuntu\ \linux, \ubuntuTerminal\ opens a terminal.%
+}%
 }%
 %

styles/keys.sty

@@ -11,3 +11,5 @@
 \tw@make@key@box{OS@win}{\faWindows}%
 \tw@make@key@macro*{\OS}%
 %
+\protected\gdef\ubuntuTerminal{\keys{\ctrl+\Alt+T}}%
+\protected\gdef\windowsTerminal{press \keys{\OSwin + R}, type in \bashil{cmd}, and hit \keys{\return}}%

text/main/basics/gettingStarted/installingPyCharm/installingPyCharm.tex

@@ -7,6 +7,7 @@
 The installation guide for \pycharm\ can be found at \url{https://www.jetbrains.com/help/pycharm/installation-guide.html}.%
 %
 \hinput{installingPyCharmWindows}{installingPyCharmWindows}%
+\hinput{installingPyCharmUbuntu}{installingPyCharmUbuntu}%
 \afterpage{\clearpage}%
 \endhsection%
 %

text/main/basics/gettingStarted/installingPyCharm/installingPyCharmUbuntu/installingPyCharmUbuntu.tex

@@ -0,0 +1,78 @@
+\hsection{Installing PyCharm under Ubuntu Linux}%
+%
+\begin{figure}%
+\centering%
+%
+\subfloat[][%
+Installing \pycharm\ using the snap install command in a \gls{terminal} opened with \ubuntuTerminal.%
+\label{fig:installingPyCharmUbuntu01snapInstall}%
+]{\includegraphics[width=0.7\linewidth]{\currentDir/installingPyCharmUbuntu01snapInstall}}%
+%
+\\[10pt]
+%
+\subfloat[][%
+This command requires the super user password.%
+\label{fig:installingPyCharmUbuntu02sudo}%
+]{\includegraphics[width=0.7\linewidth]{\currentDir/installingPyCharmUbuntu02sudo}}%
+%
+\\[10pt]%
+%
+\subfloat[][%
+The installation begins.%
+\label{fig:installingPyCharmUbuntu03snapInstall}%
+]{\includegraphics[width=0.7\linewidth]{\currentDir/installingPyCharmUbuntu03snapInstall}}%
+%
+\\[10pt]%
+%
+\subfloat[][%
+The software package is downloaded.%
+\label{fig:installingPyCharmUbuntu04snapInstall}%
+]{\includegraphics[width=0.7\linewidth]{\currentDir/installingPyCharmUbuntu04snapInstall}}%
+%
+\\[10pt]%
+%
+\subfloat[][%
+The package is installed.%
+\label{fig:installingPyCharmUbuntu05snapInstallFinished}%
+]{\includegraphics[width=0.7\linewidth]{\currentDir/installingPyCharmUbuntu05snapInstallFinished}}%
+%
+\\[10pt]%
+%
+\subfloat[][%
+Open the launcher by pressing \OSwin\ and type in \bashil{pycharm} to find the \pycharm\ executable, then double-click it.%
+\label{fig:installingPyCharmUbuntu06launcher}%
+]{\tightbox{\includegraphics[height=3.1cm]{\currentDir/installingPyCharmUbuntu06launcher}}}%
+%
+\hfill%
+%
+\subfloat[][%
+The \pycharm\ welcome screen appears.%
+\label{fig:installingPyCharmUbuntu07welcome}%
+]{\tightbox{\includegraphics[height=3.1cm]{\currentDir/installingPyCharmUbuntu07welcome}}}%
+%
+\hfill%%
+%
+\subfloat[][%
+\pycharm\ has been started.%
+\label{fig:installingPyCharmUbuntu08pycharm}%
+]{\tightbox{\includegraphics[height=3.1cm]{\currentDir/installingPyCharmUbuntu08pycharm}}}%
+%
+\caption{The installation steps of \pycharm\ under \ubuntu\ linux.}%
+\label{fig:installingPyCharmUbuntu}%
+\end{figure}%
+%
+Installing \pycharm\ under \ubuntu\ \linux\ is very easy, as illustrated in \cref{fig:installingPyCharmUbuntu}.
+First, you open a \gls{terminal} by pressing \ubuntuTerminal.
+Then, enter the command \bashil{sudo snap install pycharm-community --classic} and hit return~(\cref{fig:installingPyCharmUbuntu01snapInstall}).
+This installs the \pycharm\ software package and the necessary super user privileges are obtained via the pre-pended \gls{sudo}, which will ask us to enter the root password, as sketched in \cref{fig:installingPyCharmUbuntu02sudo}.
+Then, the installation process basically runs automatically.
+Once it has completed (see \cref{fig:installingPyCharmUbuntu05snapInstallFinished}), you can press the \keys{\OSwin} key and type \bashil{pycharm} in the launcher window to find \pycharm~(\cref{fig:installingPyCharmUbuntu06launcher}).
+A double-click will open \pycharm.
+
+In the installation instructions for \windows, now a user agreement~(\cref{fig:installingPyCharmWindows16running}) and data upload statement~(\cref{fig:installingPyCharmWindows17running}) need to be performed.
+Since I already had \pycharm\ installed previously and probably already agreed/disagreed to them, respectively, these windows did not open in my current installation and I could not take screenshots of them.
+If they open, then you can probably treat them exactly as suggested in the \windows\ installation instructions \cref{sec:installingPyCharmWindows}.
+Either way, we finally get \pycharm\ up and running and can begin our coding~(\cref{fig:installingPyCharmUbuntu08pycharm}).
+%
+\endhsection%
+%