kaobook VS tcolorbox

I would say that it is very close to the kaobook class. Here is the repo. There are docs in the repo, that are written in the kaobook class so take a look and make your own opinion.

I can highly recommend kaobook: https://github.com/fmarotta/kaobook. Currently writing my Master thesis with that.

I really like the kaobook template https://github.com/fmarotta/kaobook

- I find the kaobook class very nice and complete, and the layout seems to open up a lot of options for integrating a lot of visual information, supplementary texts, etc. Has anyone used it, liked it, any other comments or alternatives?

I downloaded kaobook template from https://github.com/fmarotta/kaobook, it used to compile properly with Texlive 2019 and 2020. However when I try to compile using TexLive 2021, sidenote, marginfigure and marginnote insert the text "pt0pt"

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}