From 44e094811bb3efcc5401bfd894dc1bec1c24aede Mon Sep 17 00:00:00 2001 From: Florian Knoch Date: Wed, 12 Jan 2022 12:27:42 +0100 Subject: [PATCH] Minor changes to the listingsmode introduction --- content/source-code-listings.tex | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/content/source-code-listings.tex b/content/source-code-listings.tex index 315bb53..75117e8 100644 --- a/content/source-code-listings.tex +++ b/content/source-code-listings.tex @@ -4,20 +4,22 @@ There are many ways in \LaTeX{} to display source code. We have come to appreciate the package \pkg{minted}, which causes some additional installation overhead, but generates very appealing source code renderings. -However, especially on macOS, the installation of minted has caused a lot of headache in the early days of this workshop. -That's why we will also have a look at an alternative called \pkg{lstlistings}. +However, especially on macOS, the installation of \pkg{minted} has caused a lot of headache in the early days of this workshop. +That's why we will also have a look at an alternative called \pkg{listings}. \paragraph{A note on colors.} Both of these packages require you to define colors. We can recommend using the \pkg{xcolor} package. There are very helpful resources\footnote{If you would like to specify your own colors , these pages might help you: \url{https://www.overleaf.com/learn/latex/Using_colours_in_LaTeX} for a list of pre-defined colors in the \pkg{xcolor} package, \url{https://mmoredo.github.io/latex-color-converter/} for defining your own colors} available online such that we will not go into details here. -\input{./content/source-code-listings-minted} -\input{./content/source-code-listings-listings} +\section*{Source code listings within this script} -\section{Source code listings within this script} +This script uses the package \pkg{listings} as default way for displaying source code listings, since, as mentioned above, it causes less headache, especially on macOS. As we introduce \pkg{minted} as an alternative package, naturally, this script can also display source code listings rendered by \pkg{minted}. -This script uses the package \pkg{listings} as default way for displaying source code listings, since, as mentioned above, it causes less installation overhead and headache, especially on macOS. As we introduced \pkg{minted} as an alternative package, naturally, this script can also display source code listings rendered by \pkg{minted}. If you want to experience more appealing source code renderings, you can change the listings mode to \pkg{minted} like so: First of all, follow the respective installation instructions. Afterwards, create a new file, called \file{listings-mode.tex}, in the root directory of this project, and insert the following command into the newly created file: +To switch between the packages, you can change the listings mode to \pkg{minted} like so: First of all, follow the respective installation instructions. Afterwards, create a new file called \file{listings-mode.tex} in the root directory of this project, and insert the following line into the newly created file: \codeblock{latex}{./listings/source-code-listings/change-listings-mode.tex} -After compiling the script, you should see differently rendered source code listings. If you want to return to \pkg{listings} as package for rendering your source code listings, just replace \sh{minted} with \sh{default} in the \file{listings-mode.tex} file. Source code listings within this script are then displayed using the \pkg{listings} package again. \ No newline at end of file +After compiling the script, you should see differently rendered source code listings. If you want to return to \pkg{listings} as package for rendering your source code listings, just replace \sh{minted} with \sh{default} in the \file{listings-mode.tex} file. Source code listings within this script are then displayed using the \pkg{listings} package again. + +\input{./content/source-code-listings-minted} +\input{./content/source-code-listings-listings} \ No newline at end of file