Installation d'AMC sous macOS avec MacPorts

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

1 21 Joël Brogniart
h1. Installation d'AMC sous macOS avec MacPorts
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 22 Joël Brogniart
Pour fonctionner avec son interface, AMC nécessite les familles de polices de caractères Linux Libertine, DejaVu, IPAexMincho, IPAexGothic, le système d'installation MacPorts et un environnement graphique X Window System ou X11.
8 1
9 1
h3. La police Linux Libertine
10 1
11 1
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 "sourceforge":https://sourceforge.net/projects/linuxlibertine/.
12 3 Joël Brogniart
13 24 Joël Brogniart
*Attention* : le système X Window 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@".
14 15 Joël Brogniart
15 1
h3. La famille de polices DejaVu
16 15 Joël Brogniart
17 24 Joël Brogniart
Ces polices sont utilisées pour la génération des documentations. Il faut télécharger la dernière version sur le site "sourceforge":https://sourceforge.net/projects/dejavu/.
18 1
19 22 Joël Brogniart
*Attention* : le système X Window 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@".
20 15 Joël Brogniart
21 1
h3. Les polices IPAexMincho et IPAexGothic
22 20 Joël Brogniart
23 24 Joël Brogniart
Ces polices sont utilisées pour la génération des documentations. Il faut télécharger la dernière version sur le site "IPA Font":https://ipafont.ipa.go.jp/node26#en.
24 1
25 1
*Attention* : le système X Window 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@".
26 23 Joël Brogniart
27 23 Joël Brogniart
**Attention aussi** Vérifier aussi les droits et utiliser si besoin chmod 755 /Library/Fonts/<NomDeLaPolice> sur les polices concernées
28 1
29 1
h3. MacPorts
30 1
31 1
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.
32 1
33 22 Joël Brogniart
h3.  L'environnement X Window System
34 22 Joël Brogniart
35 22 Joël Brogniart
MacOS ne contient pas en standard le système de fenêtrage X Window. Ce système peut être fourni soit par l'application XQuartz, soit installé à partir de MacPorts.
36 22 Joël Brogniart
37 22 Joël Brogniart
Pour installer le système de fenêtrage X Windows à partir de MacPorts, lancer la commande suivante.
38 22 Joël Brogniart
<pre>sudo port install xorg-server</pre>
39 22 Joël Brogniart
40 22 Joël Brogniart
*Attention* : pour que le système de fenêtrage X Window soit correctement pris en compte, après son installation il faut que vous quittiez votre session et vous connectiez à nouveau.
41 22 Joël Brogniart
42 1
h2. Installation de AMC
43 1
44 24 Joël Brogniart
Il est possible d'installer une des deux versions de AMC. Soit la version @stable@ (actuellement, la version 1.4.0 du 29/12/2018), soit la version @développement@ (actuellement la version du 5/12/2019). 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.
45 1
46 1
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.
47 18 Joël Brogniart
48 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. 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.
49 15 Joël Brogniart
50 1
h3. Installation standard
51 15 Joël Brogniart
	
52 1
L'installation standard utilise MacPorts pour installer l'environnement LaTeX nécessaire à AMC. Utilisez la commande suivante pour installer la version @stable@ de AMC.
53 15 Joël Brogniart
<pre>sudo port install auto-multiple-choice</pre>
54 15 Joël Brogniart
55 15 Joël Brogniart
Ou alors utilisez la commande suivante pour installer la version @dévelopement@ de AMC.
56 15 Joël Brogniart
<pre>sudo port install auto-multiple-choice-devel</pre>
57 15 Joël Brogniart
		
58 18 Joël Brogniart
h3. Installation avec MacTeX
59 15 Joël Brogniart
60 22 Joël Brogniart
Les outils de construction MacPorts doivent pouvoir accéder aux outils MacTeX. Par exemple avec l'installation MacTeX 2018, 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.
61 15 Joël Brogniart
62 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.
63 15 Joël Brogniart
	
64 15 Joël Brogniart
Éditez le fichier @/opt/local/etc/macports/macports.conf@ pour y ajouter la ligne suivante.
65 15 Joël Brogniart
<pre>binpath               /opt/local/bin:/opt/local/sbin:/bin:/sbin:/usr/bin:/usr/sbin:/Library/TeX/texbin</pre>
66 1
	
67 15 Joël Brogniart
Pour la version stable de AMC, il faut lancer l'installation avec la commande suivante.
68 15 Joël Brogniart
<pre>sudo port install auto-multiple-choice +mactex</pre>
69 15 Joël Brogniart
70 15 Joël Brogniart
Et pour la version developpement de AMC il faut utiliser la commande qui suit.
71 15 Joël Brogniart
<pre>sudo port install auto-multiple-choice-devel +mactex</pre>
72 1
73 1
AMC est prêt à être utilisé.
74 4 Joël Brogniart
75 4 Joël Brogniart
h2. Utilisation de AMC
76 1
77 22 Joël Brogniart
Vous pouvez lancer AMC à partir du terminal ou à partir du système X Window.
78 4 Joël Brogniart
79 4 Joël Brogniart
h3. Dans Terminal
80 1
81 4 Joël Brogniart
<pre>auto-multiple-choice</pre>
82 15 Joël Brogniart
Cette commande lancera l'application XQuartz puis AMC.
83 1
84 22 Joël Brogniart
h3. Dans le système X Window
85 1
86 22 Joël Brogniart
Le système X Window peut être fourni par l'application XQuartz (dans le dossier @Applications@) ou l'application X11 (dans le dossier @Applications/MacPorts@). Lancer l'application.
87 6 Joël Brogniart
88 6 Joël Brogniart
!xquartz.png!
89 7 Joël Brogniart
90 22 Joël Brogniart
On peut tout de suite configurer l'application pour faciliter le lancement de AMC. Ouvrir le menu @Applications > Personnaliser…@.
91 7 Joël Brogniart
92 7 Joël Brogniart
!xquartz-menu-applications-personnaliser.png!
93 7 Joël Brogniart
94 15 Joël Brogniart
Dans la fenêtre de personnalisation, cliquer le bouton @Ajouter un élément@.
95 14 Joël Brogniart
96 14 Joël Brogniart
!xquartz-fenetre-personnaliser-menu-applications.png!
97 14 Joël Brogniart
98 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.
99 14 Joël Brogniart
100 14 Joël Brogniart
!xquartz-fenetre-personnaliser-menu-applications-2.png!
101 14 Joël Brogniart
102 15 Joël Brogniart
Fermer la fenêtre de personnalisation puis choisir le menu @Applications > Auto Multiple Choix@.
103 14 Joël Brogniart
104 14 Joël Brogniart
!xquartz-menu-applications-amc.png!
105 14 Joël Brogniart
106 15 Joël Brogniart
La fenêtre de AMC doit apparaître.
107 14 Joël Brogniart
108 14 Joël Brogniart
!auto-multiple-choice-window.png!
109 1
110 15 Joël Brogniart
Auto-multiple-choice est maintenant prêt à l'emploi.
111 17 Joël Brogniart
112 17 Joël Brogniart
h2. Liens
113 17 Joël Brogniart
114 17 Joël Brogniart
* MacPorts, "http://www.macports.org":http://www.macports.org.
115 17 Joël Brogniart
* MacTeX, "http://www.tug.org/mactex/":http://www.tug.org/mactex/
116 1
* Police de caractères DejaVu, "https://sourceforge.net/projects/dejavu/":https://sourceforge.net/projects/dejavu/
117 20 Joël Brogniart
* Polices de caractères IPAexMincho et IPAexGothic, "https://ipafont.ipa.go.jp/node26#en":https://ipafont.ipa.go.jp/node26#en
118 19 Joël Brogniart
* Police de caractères Linux Libertine font, "https://sourceforge.net/projects/linuxlibertine/":https://sourceforge.net/projects/linuxlibertine/
119 17 Joël Brogniart
* XQuartz, "http://xquartz.macosforge.org":http://xquartz.macosforge.org.