34 lines
2.1 KiB
TeX
34 lines
2.1 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{pgfkeys: Don't know mainboxstyle}
|
|
You have most likely forgotten about \verb|\usetcolorboxes| after \verb|\startDocument|.
|
|
|
|
|
|
|
|
\subsection{Undefined commands}
|
|
You have most likely loaded a too small \textit{scope}
|
|
|
|
\subsection{Lots of errors and no compile}
|
|
You have most likely selected a non-existant \textit{scope} in the \verb|\load| function. You can verify by searching the \texttt{<document name>.log} file for any mention of \texttt{INVALID CONFIG SPECIFIED, NOTHING LOADED!}
|
|
|
|
\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{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} |