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.