Add better code support

docs/parts/reference/extras.tex

@@ -9,11 +9,14 @@ To add more sources, simply use bibter's built-in macro \verb|\addbibresource|\t
 You need to use that inside the preamble as well.
 
 
+% ────────────────────────────────────────────────────────────────────
 \subsubsection{Glossary}
 \textit{Included in \texttt{recommended} and up}
 
 Use \verb|\setupGlossary| in the preamble to prepare, then use the normal glossary commands to add entries to the glossary. When you want to print it, use \verb|\printGlossary|.
 
+
+% ────────────────────────────────────────────────────────────────────
 \subsubsection{Minted}
 \textit{Included in \texttt{full}}
 
@@ -24,7 +27,7 @@ When \texttt{minted} is available via these helpers, you will also have access t
 
 \begin{minted}{latex}
 \begin{code}{language}
-    //Code goes here
+    // Code goes here
 \end{code}
 \end{minted}
 
@@ -33,10 +36,32 @@ This is nothing different than a wrapper for a minted environment with a box dra
 Example (in python):
 
 \begin{code}{python}
-    def hello_world():
+def hello_world():
     print("hello world!")
 \end{code}
 
+If instead, you want to have the code in separate source files, you can use (relative to root file)
+\begin{minted}{latex}
+\inputcode{<language>}{path/to/source/file}
+\end{minted}
+
+The helpers also provide a wrapper for this, which also prints the filename:
+
+\begin{minted}{latex}
+\inputcodewithfilename{<language>}{<base dir>}{<file>}
+\end{minted}
+where the base dir is relative to the root file of the latex document and is not displayed (and should end in \texttt{/}), and the file is relative to the base dir and is displayed.
+
+Example (assume file at \texttt{./code/lib/demo.py} and you want the file name to be \texttt{lib/demo.py}):
+\begin{minted}{latex}
+\inputcodewithfilename{python}{code/}{lib/demo.py}
+\end{minted}
+You may of course leave the base dir argument empty as well.
+
+
+\fhlc{Cyan}{Inline Code}
 If you want to print code inline, use \verb|\inlinecode|\textit{\{string\}}, which renders to \inlinecode{code}.
 
 \textit{Caveat: This is not using the \texttt{verbatim} environment due to various limitations of that environment and instead is simply using} \verb|\texttt{}|, so you cannot use this to print \LaTeX-commands
+
+Alternatively, to get code highlighting, you can use \verb|\mint{<language>}|\texttt{|code|}