2.2 Installing BookML

BookML has some pre-requisite software, which needs to be installed before usage. To install software on a MWS device without admin permissions, we need to use a tool called Scoop. To install Scoop, open a PowerShell terminal and type:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

Now that Scoop is installed, we can use it to install the software BookML relies on. In the Command Prompt, type the following:

scoop install perl
scoop install imagemagick
scoop install ghostscript
cpanm --build-args=CC=c++ --notest --verbose Image::Magick
cpanm --notest --verbose LaTeXML
scoop update --all

Ensure that your computer has LaTeX software installed. If it does not, then type the following into command prompt:

scoop install miktex

Download the folder "template" from this website. This downloads as a .zip file.

  • On Windows 10: Left click from within the folder and click "Extract All"

  • On Windows 11: Click the "Extract All" button at the top of your screen.

Windows should move you to the newly extracted folder by default. Make sure that you are in a folder (and not a .zip file) by checking the text at the top of the screen.

Now, we want to run the command prompt from this folder. To do this, click on the text at the top of the screen which says which folder you are in, and type "cmd". Press enter.

Now that you are in the command prompt, type the following

gmake detect

2.2.1 Common Issues: Makefile Not Detected

A common issue at this stage is that gmake does not recognise any makefile in your folder. This is a bug caused by MatLab’s instace of gmake. Type into the command prompt the following

Get-Command gmake

If this is in the wrong location (i.e. in the MATLAB file), you will need to edit environment variables from the control panel. You can access this by opening Control Panel and searching "path".

Once in this environment, select the perl version of gmake, and click to "move up". This may require admin permissions.

2.2.2 Common Issues: Missing Software

If there is any software missing, try to reintall it using Scoop. You can search on the Scoop website for specific software you wish to download and install.

2.2.3 Common Issues: Outdated LaTeX

If your version of LaTeX is outdated, you can either:

  • Update your version of LaTeX

  • Uninstall your version of LaTeX and install a new version via Scoop.