toc VS tcolorbox

I agree that on modern hardware recompiling is pretty fast. I have a 445 page book (https://gitlab.com/jim.hefferon/toc) with more than a graphic per page and lots of code inclusion, cross references, etc. The command "time pdflatex book" gives this on my 2016 laptop under Ubuntu.

real 0m18.159s

Yes. I've written a couple of books and having it all in one place just gets to be too much stuff. Here is a sketch of my current layout (exact is at https://gitlab.com/jim.hefferon/toc ), which I've had good luck with.

The fonts are here.

You might want to try tcolorbox, which seems to work quite all right with paracol, and which can produce breakable boxes with custom borders. If you turn off the vertical bar created by paracol and let tcolorbox "take over", you might be able to achieve what you want.

Templates If you have a specific template or a document class, e.g. memoire, you should start using it from the beginning. If you have decided on that, I'd recommend to read a manual on how to set it up correctly. Otherwise, I would just start from a default latex settings. Make sure you don't make too many local adjustments such as negative/positive horizontal/vertical spaces, local font settings, per equation/table, colours etc. They should be sorted globally via latex commands or custom macros; you should think of macros and environments for repeated contents. Tables are particularly important. You could think of any package which gives you a form of template so your tables follow a similar style; if packages such as tabularray are too much, at least use booktabs; anything that can set a theme, which you can repeat and change only in one place, will be huge advantage, should you have to make adjustments. It's similar with TikZ for drawings and tcolorbox for custom frames. In general, think globally and avoid local settings as much as you can.

First, I would recommend filing an issue on the tcolorbox GitHub. The package author(s) can then either fix the issue, explain how it's not an issue, or let you know that they won't be fixing it.

To get something more like the first, I recommend looking in to the tcolorbox package's listingsutf8 and/or minted libraries.

\documentclass[a4paper]{article} \usepackage{amsthm,enumitem,lipsum,hyperref} % the proof environment % ==== Disable default indentation, and set line spacing ==== % \usepackage{parskip} \setlength{\parskip}{16pt} % https://tex.stackexchange.com/questions/375889/adjusting-space-between-paragraphs/375890#375890 % ==== Remark Box ==== % https://tex.stackexchange.com/questions/21227/example-environment/265697#265697 % https://tex.stackexchange.com/questions/36278/box-around-theorem-statement/175032#175032 \usepackage[many]{tcolorbox} % uses PGF underneath for color parameters, https://youtu.be/pcIzeN46ETc?t=256 %\tcbsetforeverylayer{autoparskip} % https://github.com/T-F-S/tcolorbox/issues/115#issuecomment-699821376, https://githubmemory.com/repo/T-F-S/tcolorbox/issues/121 \colorlet{colexam}{red!55!black} % Global example color \newtcolorbox[ auto counter, number within=subsection, number format=\arabic, ]{remarkbox}[1][]{% empty,% Empty previously set parameters title={{\bf Remark\ \thetcbcounter:} }, attach boxed title to top left, minipage boxed title, boxed title style={ empty, size=minimal, toprule=0pt, top=4pt, left=3mm, overlay={} }, coltitle=colexam, before=\par\medskip\noindent,parbox=false,boxsep=0pt,left=3mm,right=0mm,top=2pt,breakable,pad at break=0mm, before upper=\csname @totalleftmargin\endcsname0pt, % Use instead of parbox=true. This ensures parskip is inherited by box. % Handles box when it exists on one page only overlay unbroken={ \draw[colexam,line width=.5pt] ([xshift=-0pt]title.north west) -- ([xshift=-0pt]frame.south west); }, % Handles multipage box: first page overlay first={ \draw[colexam,line width=.5pt] ([xshift=-0pt]title.north west) -- ([xshift=-0pt]frame.south west); }, % Handles multipage box: middle page overlay middle={ \draw[colexam,line width=.5pt] ([xshift=-0pt]frame.north west) -- ([xshift=-0pt]frame.south west); }, % Handles multipage box: last page overlay last={ \draw[colexam,line width=.5pt] ([xshift=-0pt]frame.north west) -- ([xshift=-0pt]frame.south west); },% #1% Bring in the optional params (labels) } \NewDocumentCommand{\remark}{ m +m }{ \begin{remarkbox}[label={#1}] #2 \end{remarkbox} } \begin{document} \section{Examples} \subsection{Mismatching Numbering between Counter and Ref}\label{sec:subsec0} \remark{remark0}{ \lipsum[1][1] } \begin{remarkbox}[label={remark1}] \lipsum[1][1] \end{remarkbox} \subsubsection{Under Subsubsection} \begin{remarkbox}[label={remark2}] \lipsum[1][1] \end{remarkbox} But when reference them using the hyperref package, the labeling of Remarks \ref{remark0}, \ref{remark1}, and \ref{remark2} are different from the remark counter (although when inside a subsubsection, the situation is slightly better). \subsection{Wrong Indentation Inside the Proof Environment} Calling the Remark environment also causes the wrong indentations of enumerate when inside the proof environment of the amsthm package (if there is Remark(s) above): \begin{proof} \lipsum[1][1] \begin{enumerate}[label=Case \arabic*.] \item \lipsum[1][1] \item \lipsum[1][1] \begin{enumerate}[label=Step \arabic*.] \item \lipsum[1][1] \item \lipsum[1][1] \end{enumerate} \lipsum[1][1] \end{enumerate} \lipsum[1][1] \end{proof} \subsection{Outside the Proof environment: } In contrast, when outside the proof environment or if I remove Section \ref{sec:subsec0}, everything is all good again: \lipsum[1][1] \begin{enumerate}[label=Case \arabic*.] \item \lipsum[1][1] \item \lipsum[1][1] \begin{enumerate}[label=Step \arabic*.] \item \lipsum[1][1] \item \lipsum[1][1] \end{enumerate} \lipsum[1][1] \end{enumerate} \lipsum[1][1] \end{document}