Installation d'AMC sous macOS avec MacPorts

Version 16 (Joël Brogniart, 03/23/2024 09:14 am)

1 16 Joël Brogniart
h1. Installation d'AMC sous macOS
2 1
3 15 Joël Brogniart
L'installation décrite ici nécessite quelques connaissances sur les outils Unix, l'utilisation de lignes de commandes, l'installation de "MacPorts":http://www.macports.org. Il faut aussi disposer des droits d'administration sur l'ordinateur. Elle n'est donc malheureusement pas destinée à tout le monde.
4 12 Joël Brogniart
5 15 Joël Brogniart
h2. Prérequis
6 1
7 15 Joël Brogniart
Pour fonctionner avec son interface, AMC nécessite un environnement graphique X Window System ou X11, la police de caractères Linux Libertine et le système d'installation MacPorts.
8 1
9 3 Joël Brogniart
h3.  L'environnement X Window System
10 3 Joël Brogniart
11 15 Joël Brogniart
MacOS ne contient pas en standard l'environnement graphique X11. Il est possible de combler cette lacune en installant XQuartz, un environnement X Windows System fonctionnant sous macOS. On peut télécharger l'image de l'application sur le site "XQuartz":http://xquartz.macosforge.org.
12 1
13 1
h3. La police Linux Libertine
14 1
15 15 Joël Brogniart
La police Linux Libertine est une police libre qui couvre les pages de code pour les langues latines, le grec, les langues cyrilliques, l'hébreu, l'alphabet phonétique international (et d'autres). Il faut télécharger le paquet "OTF" sur le site "LinuxLibertine.org":http://www.linuxlibertine.org.
16 3 Joël Brogniart
17 15 Joël Brogniart
Attention : XQuartz ne reconnait pas les polices installées dans le dossier de l'utilisateur. Il faut installer les polices en les déplaçant dans le dossier "@/Library/Fonts@".
18 1
19 15 Joël Brogniart
h3. La famille de polices DejaVu
20 15 Joël Brogniart
21 15 Joël Brogniart
Ces polices sont utilisées pour la génération des documentations en japonais. Il faut télécharger la dernière version sur le site "dejavu-fonts.org":http://dejavu-fonts.org/wiki/Download.
22 15 Joël Brogniart
23 15 Joël Brogniart
Attention : XQuartz ne reconnait pas les polices installées dans le dossier de l'utilisateur. Il faut installer les polices en les déplaçant dans le dossier "@/Library/Fonts@".
24 15 Joël Brogniart
25 1
h3. MacPorts
26 1
27 15 Joël Brogniart
MacPorts est un système qui permet de compiler, installer et gérer des logiciels source libre. Il faut télécharger le paquet d'installation correspondant à votre version de macOS sur le site "MacPorts":http://www.macports.org et installer MacPorts. Suivez bien les instructions et n'oubliez pas d'installer Xcode.
28 1
29 1
h2. Installation de AMC
30 1
31 15 Joël Brogniart
Il est possible d'installer une des deux versions de AMC. Soit la version @stable@ (actuellement, la version 1.3.0.2132 du 20/11/2017), soit la version @développement@. La version @stable@ évolue lentement et les changements de version sont peu fréquents. Plusieurs mois ou années peuvent passer entre deux changements de version. La version @développement@ est sujette à des modifications plus fréquentes. Certaines des nouvelles fonctionnalités n'ont pas été complètement testées et peuvent ne pas fonctionner comme attendu.
32 1
33 15 Joël Brogniart
Il n'est pas possible d'installer à la fois la version @stable@ et la version @developpement@. Si une de ces versions est installée, il faut la désinstaller avant d'installer l'autre version.
34 1
35 15 Joël Brogniart
Pour son installation et son fonctionnement AMC nécessite un environnement @LaTeX@. L'installation standard va utiliser MacPorts pour installer cet environnement. Si vous utilisez "MacTeX":http://www.tug.org/mactex/ et souhaitez que AMC utilise @MacTeX@ au lieu de l'environnement proposé par MacPort, la procédure d'installation diffère de l'installation standard. La première étape sera celle de l'installation du langage de programmation Perl qui est nécessaire au fonctionnement de AMC. Ensuite il faudra soit suivre les indications de l'installation standard, soit celles de l'installation d'une version de AMC utilisant MacTeX. Ces descriptions supposent que vous avez une installation MacPorts toute fraiche et à jour.
36 15 Joël Brogniart
37 15 Joël Brogniart
h3. Installation de Perl version 5.26
38 15 Joël Brogniart
MacPort est en phase de transition du passage de la version 5.24 à la version 5.26 de Perl. Pour éviter les disfonctionnements, il faut forcer l'installation de la version 5.26.
39 15 Joël Brogniart
<pre>sudo port install perl5 +perl5_26</pre>
40 15 Joël Brogniart
	
41 15 Joël Brogniart
h3. Installation standard
42 15 Joël Brogniart
	
43 15 Joël Brogniart
L'installation standard utilise MacPorts pour installer l'environnement LaTeX nécessaire à AMC. Utilisez la commande suivante pour installer la version @stable@ de AMC.
44 15 Joël Brogniart
<pre>sudo port install auto-multiple-choice</pre>
45 15 Joël Brogniart
46 15 Joël Brogniart
Ou alors utilisez la commande suivante pour installer la version @dévelopement@ de AMC.
47 15 Joël Brogniart
<pre>sudo port install auto-multiple-choice-devel</pre>
48 15 Joël Brogniart
		
49 15 Joël Brogniart
h3. Installation avec MacTeX</h3>
50 15 Joël Brogniart
51 15 Joël Brogniart
Les outils de construction MacPorts doivent pouvoir accéder aux outils MacTeX. Par exemple avec l'installation MacTeX 2017, ces outils sont disponibles dans le dossier @"/Library/TeX/texbin"@. Il faut modifier la configuration de MacPorts pour que ce dossier soit inclus dans le @path@ de MacPorts.
52 15 Joël Brogniart
53 15 Joël Brogniart
Attention, comme indiqué dans la "documentation MacPorts":https://guide.macports.org/chunked/internals.configuration-files.html, la modification du @path@ MacPorts peut avoir des effets imprévisibles et des conséquences pour d'autres outils. Il faut éviter d'y recourir.
54 15 Joël Brogniart
	
55 15 Joël Brogniart
Éditez le fichier @/opt/local/etc/macports/macports.conf@ pour y ajouter la ligne suivante.
56 15 Joël Brogniart
<pre>binpath               /opt/local/bin:/opt/local/sbin:/bin:/sbin:/usr/bin:/usr/sbin:/Library/TeX/texbin</pre>
57 15 Joël Brogniart
	
58 15 Joël Brogniart
Pour la version stable de AMC, il faut lancer l'installation avec la commande suivante.
59 15 Joël Brogniart
<pre>sudo port install auto-multiple-choice +mactex</pre>
60 15 Joël Brogniart
61 15 Joël Brogniart
Et pour la version developpement de AMC il faut utiliser la commande qui suit.
62 15 Joël Brogniart
<pre>sudo port install auto-multiple-choice-devel +mactex</pre>
63 15 Joël Brogniart
64 15 Joël Brogniart
AMC est prêt à être utilisé.
65 15 Joël Brogniart
66 4 Joël Brogniart
h2. Utilisation de AMC
67 4 Joël Brogniart
68 15 Joël Brogniart
Vous pouvez lancer AMC à partir du terminal ou à partir de XQuartz.
69 4 Joël Brogniart
70 4 Joël Brogniart
h3. Dans Terminal
71 1
72 4 Joël Brogniart
<pre>auto-multiple-choice</pre>
73 15 Joël Brogniart
Cette commande lancera l'application XQuartz puis AMC.
74 1
75 4 Joël Brogniart
h3. Dans XQuartz
76 1
77 6 Joël Brogniart
Lancer l'application XQuartz.
78 6 Joël Brogniart
79 6 Joël Brogniart
!xquartz.png!
80 7 Joël Brogniart
81 15 Joël Brogniart
On peut tout de suite configurer XQuartz pour faciliter le lancement de AMC. Ouvrir le menu @Applications > Personnaliser…@.
82 7 Joël Brogniart
83 7 Joël Brogniart
!xquartz-menu-applications-personnaliser.png!
84 7 Joël Brogniart
85 15 Joël Brogniart
Dans la fenêtre de personnalisation, cliquer le bouton @Ajouter un élément@.
86 14 Joël Brogniart
87 14 Joël Brogniart
!xquartz-fenetre-personnaliser-menu-applications.png!
88 14 Joël Brogniart
89 14 Joël Brogniart
Mettre "@Auto Multiple Choice@" dans la colonne @Nom@ et "@auto-multiple-choice@" dans la colonne @Commande@ du nouvel item de menu.
90 14 Joël Brogniart
91 14 Joël Brogniart
!xquartz-fenetre-personnaliser-menu-applications-2.png!
92 14 Joël Brogniart
93 15 Joël Brogniart
Fermer la fenêtre de personnalisation puis choisir le menu @Applications > Auto Multiple Choix@.
94 14 Joël Brogniart
95 14 Joël Brogniart
!xquartz-menu-applications-amc.png!
96 14 Joël Brogniart
97 15 Joël Brogniart
La fenêtre de AMC doit apparaître.
98 14 Joël Brogniart
99 14 Joël Brogniart
!auto-multiple-choice-window.png!
100 1
101 15 Joël Brogniart
Auto-multiple-choice est maintenant prêt à l'emploi.