GitLab

The README is very short now and no longer contains bookmarks

Most of this content was duplication anyway

Now found at https://collaborating.tuhh.de/m21/public/wiki/-/wikis/Version-Control#hints

These points now live in issues #9 , #10 , #11 , #12 and #13

See also https://docs.gitlab.com/ee/user/markdown.html#table-of-contents

Put many small READMEs and comments, facilitates exploration and is easier to maintain

No one cares and it's a burden for maintenance

README pdf is now very small!

Fonts are no longer shipped in this repo

This repo is now supposed to focus on LaTeX
and its compilation via Docker etc. alone.
Bringing git into the equation was always confusing.

The git content moved to

https://collaborating.tuhh.de/m21/public/wiki/-/wikis/Version-Control

A leftover of 1e27372b, where this wasn't deleted

So latexmk -C can clean this aux file as well.

Related to e379fa95

MWE file is pretty useless, and build hooks aren't needed anymore without Docker Automated Builds

Context: https://stackoverflow.com/questions/55987337/visual-studio-code-remote-containers-change-shell#comment121528642_65972905

ARG is empty if not renewed for each stage

Function was used before its definition

BetterBibTeX Zotero plugin ran

Essentially sed with:

\SI      -> \qty
\SIlist  -> \qtylist
\SIrange -> \qtyrange
\si      -> \unit

The new commands provide more clarity.

Was removed in major release 3:

https://github.com/josephwright/siunitx/blob/main/CHANGELOG.md#v300

The package gave an automated deprecation warning and suggested
a fix, which was simply adopted here:

Package siunitx Info: Option "detect-all" has been deprecated in this
release.
(siunitx)
(siunitx)             Use "mode = match, propagate-math-font = true,
(siunitx)             reset-math-version = false, reset-text-family =
false,
(siunitx)             reset-text-series = false, text-family-to-math =
true,
(siunitx)             text-series-to-math = true" as a replacement.

Fixes #8

Was removed in major release 3:

https://github.com/josephwright/siunitx/blob/main/CHANGELOG.md#v300

In v3, we no longer need to load this option. Commands like

\SI{1}{\giga\byte}

or

\SI{1}{\mega\bit}

just work.

Fixes #7

The micro-related options were removed in major release 3:

https://github.com/josephwright/siunitx/blob/main/CHANGELOG.md#v300

There are two micro-signs relevant to us in Unicode:

U+00B5: µ (Micro sign)

U+03BC: μ (Greek letter mu)

See also https://tex.stackexchange.com/a/54915/120853 .

It's an annoying differentiation that is sometimes necessary,
*BUT* for now it seems the two important use cases of Mu work:

\si{\micro\gram} for units works (upright mu)

\(\mu\) works (slanted/italics math-mode mu)

Therefore, a user might never run into this issue/distinction.

Fixes #6

Probably introduced by polyglossia, but haven't figured it out fully yet

Many more features, especially a predefined reaction environment

In order for this class file to be useful for other
documents, without having to sort out various files
and their linking, a bunch of stuff that previously lived
in other files was inlined into the class file itself:

- translations
- lua code
- pgf code
- titlepage

Now, all that's needed is the cls file itself.

The big drawback is that the class file is now pretty big, ugly
and unwieldy...

Replace Fontin with a free font that ships with TeXLive.
Just much easier to deal with, and allows us to get rid of
the entire fonts/ directory.

Adjust everything else as well, aka use fonts that ship
with TeXLive.

Too many people got caught offguard by a5 default

All layers can now be cached properly.
This was previously not possible since dynamic (!)
environment variables like BUILD_DATE and VCS_REF
would cause Docker to discard the cache each time.
See also https://stackoverflow.com/a/51243035 .

Caching of the installation layers (texlive and apt)
is especially important. The texlive layer can take
a long while to complete.

The class file was renamed (cookbook -> acp) and now
lives *inside the Docker image*. This allows for easy
sharing of that file: all latex documents compiled
using the Docker image will be able to use that
class file. No need to copy it around, register it
with CTAN, use git submodules or other means of
central management.

Since copying of that acp.cls file happens in one of
the last Dockerfile layers/steps, the file can be
changed frequently without invalidating caches (of
later layers), hence build times are very fast if
only the class file changes.