History

Obsolete2

Version 1 (Joël Brogniart, 12/07/2017 10:46 am)

1 1 
h1. Installation de la version de développement d'AMC sous macOS avec une installation LaTeX externe à MacPorts
2 1 






    3
    1
    
    
_Cette installation - AMC version 1.3.0, révision 2007:e08294f9c78e du 29/12/2016 - a été testée sous macOS 10.12.2 (Xcode 8.2.1, MacPorts 2.3.5, MacTeX 2016)._






    4
    1
    
    






    5
    1
    
    
Le logiciel Auto Multiple Choice (AMC) est un logiciel de gestion de questionnaires. Il permet, à partir de la définition des questions (question à choix unique/question à choix multiple, bonnes/mauvaises réponses…) de générer des feuilles de questionnaires. Une fois ces questionnaires remplis et numérisés, AMC permet de corriger automatiquement les questionnaires. Ce logiciel fonctionne dans un environnement graphique X Window System sous Linux et macOS.






    6
    1
    
    






    7
    1
    
    
Ce document décrit succinctement l'installation du logiciel Auto Multiple Choice en utilisant une installation LaTeX externe à MacPorts. La version d'AMC installée est une version de développement récente. Les fichiers et la procédure d'installation décrits ici sont différents de l'"installation de la version de développement d'AMC utilisant l'installation LaTeX de MacPorts":http://project.auto-multiple-choice.net/projects/auto-multiple-choice/wiki/Installation_de_la_version_de_développement_d'AMC_sous_OS_X. En dehors de cet aspect, AMC, fonctionne de la même manière. Aussi seule la partie installation est décrite ici.






    8
    1
    
    






    9
    1
    
    
L'installation décrite ici nécessite quelques connaissances sur les outils Unix, l'utilisation de lignes de commandes, une compréhension de l'architecture des ports "MacPorts":http://www.macports.org, une petite compréhension des dépendances entre différents outils (Subversion, MacPorts, PERL, X11, ports…) et de l'architecture macOS. Il faut aussi disposer des droits d'administration sur l'ordinateur.






    10
    1
    
    






    11
    1
    
    
Pour cette installation il va falloir créer un dépot local MacPort. Dans ce dépot, sera mis le fichier de description de port pour AMC et éventuellement les fichiers de ports complémentaires. Une fois ces fichiers de port installés, l'installation d'AMC pourra être lancée.






    12
    1
    
    






    13
    1
    
    
h2. Prérequis






    14
    1
    
    






    15
    1
    
    
Pour fonctionner avec son interface, AMC nécessite un environnement graphique X Window System ou X11, la police de caractères Linux Libertine, la famille de polices de caractères DejaVu et le système d'installation MacPorts. Il faut aussi une installation LaTeX installée comme, par exemple, "MacTeX":http://www.tug.org/mactex/.






    16
    1
    
    






    17
    1
    
    
h3. L'environnement X Window System






    18
    1
    
    






    19
    1
    
    
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'application sur le site "XQuartz":http://xquartz.macosforge.org.






    20
    1
    
    






    21
    1
    
    
h3. La police Linux Libertine






    22
    1
    
    






    23
    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 "LinuxLibertine.org":http://www.linuxlibertine.org.






    24
    1
    
    






    25
    1
    
    
Attention : La version actuelle de XQuartz (2.7.11) 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
    1
    
    






    27
    1
    
    
h3. La famille de polices DejaVu






    28
    1
    
    






    29
    1
    
    
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.






    30
    1
    
    






    31
    1
    
    
Attention : La version actuelle de XQuartz (2.7.11) 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@".






    32
    1
    
    






    33
    1
    
    
h3. MacPorts






    34
    1
    
    






    35
    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 à sa version de macOS sur le site "MacPorts":http://www.macports.org et installer MacPorts.






    36
    1
    
    






    37
    1
    
    
h2. MacPorts et installation LaTeX externe






    38
    1
    
    






    39
    1
    
    
Pour pouvoir contruire AMC avec une installation LaTeX extérieure à MacPorts, il faut plusieurs choses.






    40
    1
    
    






    41
    1
    
    
D'abord, les outils de construction MacPorts doivent pouvoir accéder aux outils LaTeX extérieurs. Par exemple avec l'installation MacTeX 2016, 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.






    42
    1
    
    






    43
    1
    
    
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.






    44
    1
    
    






    45
    1
    
    
Éditez le fichier "@/opt/local/etc/macports/macports.conf@" pour y ajouter la ligne suivante.






    46
    1
    
    






    47
    1
    
    
<pre>binpath               /opt/local/bin:/opt/local/sbin:/bin:/sbin:/usr/bin:/usr/sbin:/Library/TeX/texbin</pre>






    48
    1
    
    






    49
    1
    
    
Si vous utilisez un autre outil que MacTeX, il faut remplacer la dernière partie du @path@ par le dossier contenant les binaires de votre outil LaTeX.






    50
    1
    
    






    51
    1
    
    
Il faut aussi que l'outil @dblatex@ soit construit pour cette installation extérieure.






    52
    1
    
    






    53
    1
    
    
h2. MacPorts et les fichiers de port






    54
    1
    
    






    55
    1
    
    
Un fichier de port MacPorts contient les informations qui permettent d'installer un programme dans le système MacPorts. Il indique quels sont les outils nécessaires à l'installation et au fonctionnement du programme et comment faire pour installer le programme. MacPorts contient de "nombreux ports":http://www.macports.org/ports.php, mais il ne contient pas de port décrivant l'installation d'AMC à partir du code source du programme. Il va donc falloir créer le fichier de port pour la version de développement d'AMC.






    56
    1
    
    






    57
    1
    
    
Pour éviter les conflits avec les ports déjà décrits de MacPorts, les nouveaux fichiers de ports seront installés dans le dossier de l'utilisateur qui fait l'installation, au lieu d'être installés dans les dossiers directements gérés par MacPorts.






    58
    1
    
    






    59
    1
    
    
h3. Dépot local MacPorts






    60
    1
    
    






    61
    1
    
    
Pour que MacPorts puisse utiliser un dossier local, il faut créer ce dossier local.






    62
    1
    
    






    63
    1
    
    
<pre>mkdir -p ~/nix</pre>






    64
    1
    
    






    65
    1
    
    
Il faut ensuite indiquer à MacPorts de prendre en compte le dossier local et ceci, avant la prise en compte de la hiérarchie standard de MacPorts. Pour cela il faut éditer le fichier "@/opt/local/etc/macports/sources.conf@" et ajouter un URL pointant vers le dossier local avant l'URL @rsync@ du dépot MacPorts.






    66
    1
    
    






    67
    1
    
    
<pre>file:///Users/julesvernes/nix/macports






    68
    1
    
    
rsync://rsync.macports.org/release/tarballs/ports.tar [default]</pre>






    69
    1
    
    
  






    70
    1
    
    
h3. Fichiers de ports






    71
    1
    
    






    72
    1
    
    
Deux archives sont disponibles au téléchargement :






    73
    1
    
    
* pour l'installation sous macOS 10.9 et 10.10 attachment:macports-10.10.zip.






    74
    1
    
    
* pour l'installation sous macOS 10.11 et 10.12 attachment:macports-10.12.zip.






    75
    1
    
    






    76
    1
    
    
La première archive contient la description du port @auto-multiple-choice-devel@ et une adaptation du port @dblatex@ fonctionnant avec une installation LaTeX externe à MacPorts. L'archive pour macOS 10.11 et 10.12 comprend en plus une adaptation des ports @gcc5@ et @pdftk@ permettant leur fonctionnement sous ces versions de macOS.






    77
    1
    
    






    78
    1
    
    
Téléchargez et décompressez cette archive puis déplacer le dossier "@macports@" à l'intérieur du dossier créé précédemment.






    79
    1
    
    






    80
    1
    
    
Les ports sont regroupés par catégories et l'organisation des fichiers de port reflète ce groupement. Chaque port fait partie d'une catégorie principale et dispose de son propre dossier. La catégorie principale de AMC dans MacPorts est X11, aussi le dossier du port pour AMC se trouvera à l'intérieur d'un dossier x11.






    81
    1
    
    






    82
    1
    
    
!port-hierarchy.png!






    83
    1
    
    






    84
    1
    
    
Chacun des dossiers de port doit contenir un document nommé @Portfile@. Ce document est un document texte contenant une description permettant l'installation par MacPorts de l'outil.






    85
    1
    
    
  






    86
    1
    
    
h2. Installation de AMC






    87
    1
    
    






    88
    1
    
    
Une fois les fichiers de port mis en place, il faut générer l'index prenant en compte les nouveaux ports.






    89
    1
    
    
<pre>cd ~/nix/macports






    90
    1
    
    
portindex</pre>






    91
    1
    
    






    92
    1
    
    
Ensuite, pour contourner un problème de MacPorts empêchant la construction d'un port ayant un grand nombre de dépendances en une seule passe, il faut augmenter le nombre de fichiers qui peuvent être ouverts par le shell.






    93
    1
    
    
<pre>ulimit -n 1024</pre>






    94
    1
    
    






    95
    1
    
    
Après celà, il faut installer le port @dblatex@ sans ses dépendances à une installation MacPorts de LaTeX.






    96
    1
    
    






    97
    1
    
    
<pre>sudo port install dblatex -latex</pre>






    98
    1
    
    






    99
    1
    
    
Et finalement, il faut lancer de la même manière l'installation de la version de développement d'AMC.






    100
    1
    
    






    101
    1
    
    
<pre>sudo port install auto-multiple-choice-devel -latex</pre>






    102
    1
    
    






    103
    1
    
    
Une fois l'installation terminée, AMC est prêt à être utilisé.






    104
    1
    
    






    105
    1
    
    
h2. Liens






    106
    1
    
    






    107
    1
    
    
* Auto Multiple Choice, "http://home.gna.org/auto-qcm/":http://home.gna.org/auto-qcm/.






    108
    1
    
    
* Auto Multiple Choice, "Installation sous macOS":http://project.auto-multiple-choice.net/projects/auto-multiple-choice/wiki/Installation_d'AMC_sous_OS_X.






    109
    1
    
    
* Auto Multiple Choice, "Installation de la version de développement sous macOS":http://project.auto-multiple-choice.net/projects/auto-multiple-choice/wiki/Installation_de_la_version_de_développement_d'AMC_sous_OS_X .






    110
    1
    
    
* MacPorts, "http://www.macports.org":http://www.macports.org.






    111
    1
    
    
* MacPorts, "Local Portfile Repositories":http://guide.macports.org/#development.local-repositories.






    112
    1
    
    
* XQuartz, http://xquartz.macosforge.org</a>.