Clarify and fix minor issues

This commit is contained in:
Knoch 2021-01-01 16:31:41 +01:00
parent dd2b5043f0
commit 9fcc0ee1a4

View File

@ -5,11 +5,11 @@ Wir verwenden hierfür gern das Paket \mintinline{latex}{minted}, das zwar etwas
\subsection{Installation}
\todo{Python- und Pip-Installation unter allen OS testen}
Für \mintinline{latex}{minted} zu verwenden, ist eine Installation der Programmiersprache Python 3 notwendig.
Zur Verwendung von \mintinline{latex}{minted} ist eine Installation der Programmiersprache Python 3 notwendig.
Die Installationsdateien sind auf der Projekt-Website\footnote{Verfügbar unter \url{https://www.python.org/downloads/}.} zu finden.
Ein ausführlicherer Beitrag zur Installation unter Windows\footnote{Jason FitzpatrickHow to Install Python on Windows. How-To Geek. July 11, 2017. Verfügbar unter \url{https://www.howtogeek.com/197947/how-to-install-python-on-windows/}.} führt euch durch die verschiedenen Schritte, die speziell für dieses Betriebssystem notwendig sind\footnote{Insbesondere das Anpassen des Systempfads sollte nicht vergessen werden.}.
Nach der erfolgreichen Installation solltet ihr in der Eingabeaufforderung\footnote{Navigation unter Windows: \faWindows\ + R → \enquote{cmd} eingeben → Enter} folgende Eingabe vornehmen können:
Nach der erfolgreichen Installation solltet ihr in der Eingabeaufforderung\footnote{Navigation unter Windows: \faWindows\ + R → \enquote{cmd} eingeben → Enter} \mintinline{bash}{python3 --version} eingeben und mit Enter bestätigen können und in etwa folgendes Ergebnis erhalten:
\begin{minted}[]{bash}
$ python3 --version
@ -18,7 +18,7 @@ Python 3.8.5
Sollte die Versionsnummer höher sein, ist alles bestens.
Im gleichen Fenster gebt ihr jetzt den Befehl \mintinline{bash}{pip install Pygments} ein, womit das Pygments-Paket für Python installiert wird.
Ab jetzt könnt ihr das \LaTeX-Paket \mintinline{latex}{minted} über \mintinline{latex}{\usepackage{minted}} verwenden.
Nach Abschluss dieses Vorgangs könnt ihr das \LaTeX-Paket \mintinline{latex}{minted} über \mintinline{latex}{\usepackage{minted}} einbinden.
\subsection{Compiler-Befehl ändern}
Bevor es allerdings richtig losgehen kann, müssen wir noch eine Kleinigkeit im Compile-Prozess anpassen.
@ -48,21 +48,20 @@ Schaut am besten mal in die Einstellungen oder bemüht eine Suchmaschine.
Jetzt kann der eigentliche Spaß losgehen.
Quelltext könnt ihr von nun an unter Angabe der Sprache in einer eigenen Umgebung setzen:
\example{lst:MintedEnvironment}{code/minted-umgebung}{Beispielhaftes Quelltext-Listing.}
\example{lst:MintedEnvironment}{code/minted-umgebung}{Beispielhaftes Quelltext-Listing}
\noindent Außerdem gibt es eine Kurzschreibweise und eine Inline-Variante des Befehls:
\example{lst:MintedVariants}{code/minted-varianten}{Kurzschreibweise und Inline-Listing.}
\example{lst:MintedVariants}{code/minted-varianten}{Kurzschreibweise und Inline-Listing}
\noindent Außerdem gibt es eine Kurzschreibweise und eine Inline-Variante des Befehls (vgl. \cref{lst:MintedVariants}).
Um Redundanz zu vermeiden, ist es manchmal praktisch, den Quelltext direkt aus der Quelldatei einzulesen.
Hierzu müssen nur die verwendete Programmiersprache und der Dateipfad an den Befehl \mintinline{latex}{\inputminted} übergeben werden:
Hierzu müssen nur die verwendete Programmiersprache und der Dateipfad an den Befehl \mintinline{latex}{\inputminted} übergeben werden (vgl. \cref{lst:MintedExternal}).
\example{lst:MintedExternal}{code/minted-import}{Einbinden aus einer externen Datei.}
\example{lst:MintedExternal}{code/minted-import}{Einbinden aus einer externen Datei}
\subsection{Minted konfigurieren}
Durch optionale Parameter können Zeilennummerierung, Umbrüche und Farben ausgewählt werden.
Außerdem sind zahlreiche Themes verfügbar.
Einen umfänglichen Überblick geben die Einführung von Overleaf und die Dokumentation\footnote{Verfügbar unter \url{https://www.overleaf.com/learn/latex/Code_Highlighting_with_minted} bzw. \url{https://ctan.kako-dev.de/macros/latex/contrib/minted/minted.pdf}.}.
Einen umfänglichen Überblick geben die Einführung von Overleaf und die Dokumentation.\footnote{Verfügbar unter \url{https://www.overleaf.com/learn/latex/Code_Highlighting_with_minted} bzw. \url{https://ctan.kako-dev.de/macros/latex/contrib/minted/minted.pdf}.}
\example{lst:MintedExternalStyled}{code/minted-import-styled}{Themes und weitere Optionen.}
\example{lst:MintedExternalStyled}{code/minted-import-styled}{Themes und weitere Optionen}