Installing AMC with MacPorts on macOS

Version 41 (Joël Brogniart, 03/23/2024 09:13 am)

1 28 Joël Brogniart
h1. Installing AMC on macOS with MacPorts
2 1
3 34 Joël Brogniart
The installation guide requires some knowledge about Unix tools, the use of command lines, the installation of "MacPorts":http://www.macports.org. You must also have administrative rights on the computer. It is therefore not intended for everyone.
4 10 Joël Brogniart
5 9 Joël Brogniart
h2. Prerequisites
6 1
7 40 Joël Brogniart
To work with its interface, AMC requires the Linux Libertine and the MacPorts installation system.
8 20 Joël Brogniart
9 1
h3. Linux Libertine font
10 12 Joël Brogniart
11 1
Linux Libertine font is a free font that covers code pages for Latin languages​​, Greek, Cyrillic languages​​, Hebrew, the International Phonetic Alphabet (and other). You need to download the package "OTF" on "sourceforge":https://sourceforge.net/projects/linuxlibertine/ site.
12 1
13 34 Joël Brogniart
*Caution*: X Window Ssstem does not recognize the fonts installed in the user's folder. You must install the fonts by moving them in the "@/Library/Fonts@" folder.
14 34 Joël Brogniart
15 1
h3. MacPorts
16 1
17 29 Joël Brogniart
MacPorts is a system that compiles, installs and manages open source software. You need to download the installation package for your version of macOS from the "MacPorts":http://www.macports.org and install MacPorts. Follow the instructions carefully and don't forget to install Xcode.
18 28 Joël Brogniart
19 1
h2. Installing AMC
20 28 Joël Brogniart
21 41 Joël Brogniart
It is possible to install one of the two versions of AMC. Either the @stable@ version (currently, version 1.5.2 of 10/31/2022), or the @development@ version (currently, version 1.5.2+git20221108151552 of 11/8/2022). The @stable@ version evolves slowly and version changes are infrequent. Several months or years may pass between two version changes. The @development@ version is subject to more frequent changes. Some of the new features have not been fully tested and may not work as expected but many corrections are incorporated to the development version.
22 1
23 39 Joël Brogniart
It is not possible to install both the @stable@ and the @development@ version. If one of these versions is installed, you must uninstall it before installing the other version.
24 1
25 20 Joël Brogniart
For installation and operation AMC requires a @LaTeX@ environment. The standard installation will use MacPorts to install this environment. If you are using "MacTeX":http://www.tug.org/mactex/ and want AMC to use @MacTeX@ instead of the MacPort environment, the installation process differs from the standard installation. You should follow either the instructions of the standard installation, or those of the installation of a version of AMC using MacTeX. These descriptions assume that you have a fresh and up-to-date MacPorts installation.
26 23 Joël Brogniart
27 34 Joël Brogniart
If needed, update you Macports installation with the following commands.
28 20 Joël Brogniart
<pre>sudo port selfupdate
29 35 Joël Brogniart
sudo port upgrade outdated</pre>
30 35 Joël Brogniart
31 35 Joël Brogniart
h3. Standard installation
32 20 Joël Brogniart
33 19 Joël Brogniart
The standard installation uses MacPorts to install the LaTeX environment needed by AMC. Use the following command to install the @stable@ version of AMC.
34 40 Joël Brogniart
<pre>sudo port install auto-multiple-choice -x11 +no_x11 +quartz</pre>
35 4 Joël Brogniart
36 20 Joël Brogniart
Or use the following command to install the @development@ version of AMC.
37 40 Joël Brogniart
<pre>sudo port install auto-multiple-choice-devel -x11 +no_x11 +quartz</pre>
38 7 Joël Brogniart
39 20 Joël Brogniart
h3. Installing AMC for use with MacTeX
40 1
41 20 Joël Brogniart
MacPorts build tools must be able to access MacTeX tools. For example, with the MacTeX 2018 installation, these tools are available in the @"/Library/TeX/texbin"@ folder. The MacPorts configuration needs to be changed to include this folder in MacPorts @path@.
42 28 Joël Brogniart
43 20 Joël Brogniart
Be careful, as noted in the "MacPorts documentation":https://guide.macports.org/chunked/internals.configuration-files.html, changing MacPorts' @path@ can have unpredictable effects and consequences for others tools. It must be avoided.
44 1
45 11 Joël Brogniart
Edit the @/opt/local/etc/macports/macports.conf@ file to add the following line.
46 20 Joël Brogniart
<pre>binpath               /opt/local/bin:/opt/local/sbin:/bin:/sbin:/usr/bin:/usr/sbin:/Library/TeX/texbin</pre>
47 20 Joël Brogniart
48 1
For the stable version of AMC, you must start the installation with the following command.
49 1
<pre>sudo port install auto-multiple-choice +mactex</pre>
50 20 Joël Brogniart
51 5 Joël Brogniart
And for the development version of AMC it is necessary to use the command which follows.
52 20 Joël Brogniart
<pre>sudo port install auto-multiple-choice-devel +mactex</pre>
53 20 Joël Brogniart
54 5 Joël Brogniart
The installation may take a while. When it is complete and if there is no error, AMC is ready to be used.
55 5 Joël Brogniart
56 7 Joël Brogniart
h2. Using AMC
57 28 Joël Brogniart
58 40 Joël Brogniart
You should start from the terminal.
59 5 Joël Brogniart
60 5 Joël Brogniart
<pre>auto-multiple-choice</pre>
61 5 Joël Brogniart
62 40 Joël Brogniart
This command will launch AMC application.
63 7 Joël Brogniart
64 5 Joël Brogniart
AMC window should appear.
65 5 Joël Brogniart
66 40 Joël Brogniart
!auto-multiple-choice-window-2.png!
67 7 Joël Brogniart
68 5 Joël Brogniart
Auto-multiple-choice is now ready to work.
69 1
70 1
h2. Links
71 25 Joël Brogniart
72 25 Joël Brogniart
* Linux Libertine fonts, "https://sourceforge.net/projects/linuxlibertine/":https://sourceforge.net/projects/linuxlibertine/
73 1
* MacPorts, "http://www.macports.org":http://www.macports.org.
74 22 Joël Brogniart
* MacTeX, "http://www.tug.org/mactex/":http://www.tug.org/mactex/
75 22 Joël Brogniart
* XQuartz, "http://xquartz.macosforge.org":http://xquartz.macosforge.org.