31 lines
2.0 KiB
TeX
31 lines
2.0 KiB
TeX
\newsection
|
|
\section{Troubleshooting}
|
|
|
|
\subsection{Visual Errors}
|
|
\subsubsection{Missing headers \& footers}
|
|
You have most likely forgotten about \verb|\startDocument| after \verb|\begin{document}|, or you are using \verb|\setupBarebones| or \verb|\setupexams|.
|
|
|
|
You can easily distinguish from simply looking at the PDF. If the title is missing too, it's the first one, if it is there, it is most likely the second.
|
|
|
|
\subsubsection{Right box of guides tcolorbox is a weird title}
|
|
You have most likely forgotten about the second argument. Then, the first letter is removed from the body and used as the title.
|
|
|
|
|
|
\subsection{Minted}
|
|
\texttt{minted} is a syntax highlighting library. It can cause issues when running, as it needs extra configuration for the compiler.
|
|
|
|
\subsubsection{You must invoke LaTeX with the -shell-escape flag}
|
|
You have set the \textit{scope} to \texttt{full}, which loads the \texttt{minted} package for code highlighting. You will need to configure your latex compiler to use \texttt{-shell-escape} if you want to use it. If you do not plan to use it, simply switch to a smaller \textit{scope}.
|
|
|
|
\subsubsection{You must have pygmentize installed}
|
|
Your host system is lacking the \texttt{pygmentize} package or you have not added the \texttt{pip} path to your \$PATH. This is also the reason as to why the \texttt{-shell-escape} flag has to be set, as minted needs to access external libraries (namely \texttt{pygmentize}) to do the syntax highlighting.
|
|
|
|
\subsection{Undefined command equal}
|
|
If you see an error like this, you likely are using either \verb|\translate| or \verb|\tr| in a \verb|\section| or similar command.
|
|
Due to the way \LaTeX\ code is evaluated, you should prefer using \verb|\safetr| instead,
|
|
which uses \texttt{etoolbox}'s \verb|\protecting| command to stop this issue from occurring
|
|
|
|
\subsection{Any other error}
|
|
Ensure that you are not missing any closing brackets or a math environment is still open. If nothing helps, contact support at \url{https://support.janishutz.com}
|
|
|