2 Set up ML on your laptop

Keep the BookML Leeds guide at hand.

The bare minimum required to start is the following:

  • •
    ​

    on Windows: install Strawberry Perl (use scoop if you do not have admin rights); make sure to follow the directions in the BookML Leeds guide

  • •
    ​

    on macOS: install the Xcode Command Line Tools (running make in a terminal should be enough)

  • •
    ​

    on Linux: install GNU make

Unpack the BookML template somewhere and open a terminal in that folder.

Run make detect (or gmake detect) on Windows. Keep installing the packages you need, until at least the required ones are all green. The BookML Leeds guide will help you install each component.

Warning: the current has some incompatibilities with TeX Live past 2021. Watch out for:

  • •
    ​

    The babel package. You can work around the issue by setting the document language in the class options (or with a judicious use of \iflatexml).

  • •
    ​

    Anything that loads the expl3 package. If you see expl3 with TeX Live 2022 or later, compilation will take ages and most likely fail.