====== MacOS X (via MacPort) ======

//installation testée fonctionnelle de MacOS Yosemite 10.10 (octobre 2014) à MacOS Ventura 13.4.1 (juillet 2023) //
===== 1. Pré-requis et logiciels tiers : =====

==== Xcode ====

  * Installer "Xcode" sur la machine.
    * Suivez la doc disponible ici pour installer Xcode selon la version de votre OS : [[https://www.macports.org/install.php]]
  * Une fois "Xcode" installé, il vous faudra installer les "Command line tools". Pour cela, tapez ceci dans le terminal :

<code bash>xcode-select --install</code>
N.B. : si jamais cette commande ne fonctionnait pas, vous avez la possibilité de le télécharger sur le site Apple ici : https://developer.apple.com/downloads/index.action?name=for%20Xcode%20-# 

==== Java ====

  * Si vous pensez utiliser Java, il faut installer le JDK pour Mac OS X.
  * Pour ce faire, sur les versions récentes d'OS X (High Sierra, à tester sur les autres), tapez simplement "java" sur la ligne de commande, vous aurez une invite qui vous enverra sur la bonne page chez Oracle.

==== Logiciels tiers ====
  * Installer MacPorts : http://www.macports.org/
    * Attention, lorsque vous appliquez une mise à jour majeure de Mac OS, pensez à réinstaller MacPort.

  * Dans un terminal, mettre à jour MacPort :

<code bash>sudo port selfupdate</code>

  * Si MacPort était déjà installé, il peut être utile d'effectuer un petit nettoyage :

<code bash>sudo port
   uninstall inactive
   clean --all all</code>

  * Installer les logiciels tiers via Macport((Macport installe par défaut tous ses paquets dans le dossier /opt/local/)) ((Pour Maxima, attention a ne pas prendre une version entre 5.16 et 5.20 (à cause d'un bug dans Maxima dans ces versions intermédiaires).)):

<code bash>sudo port install latex2html gnuplot octave maxima pari yacas povray wget ImageMagick graphviz p5-uri fortune qrencode</code>

En cas de problème avec Macport, on peut utiliser [[http://www.finkproject.org/index.php?phpLang=fr| fink]]. (Ceci a été nécessaire pour installer Maxima sur un mac ppc avec 10.4.) ou encore [[http://brew.sh/index_fr.html| Homebrew]] (voir l'aide installation dévelopeur. 

  * Importance relative des logiciels tiers :
    * GNU Octave.( 20% importance)
    * Yacas      ( 10% importance)
    * GAP        ( 10% importance) 
    * Povray     (  5% importance)
    * Graphviz   (  5% importance)
    * Macaulay   (~ 0% importance)
    * fortune and strfile

  * Installer certains logiciels tiers non présents dans MacPort //(peut être fait plus tard)//
echniques", voir ci-dessous)
    * Macaulay 2 : http://faculty.math.illinois.edu/Macaulay2/Downloads/MacOSX/index.html 
    * GAP : http://www.gap-system.org (pensez à indiquer son chemin d'installation dans les "questions t
Suite à une incompatibilité avec la colorisation de gap version ≥ 4.12.1, ajouter un fichier gap.ini contenant : SetUserPreference( "UseColorPrompt", false );// à placer dans /usr/local/Cellar/gap/4.12.2/libexec //



==== Librairie "GD" ====
Depuis WIMS v4.07b, la librairie [[http://libgd.bitbucket.org|"GD"]] est nécessaire à la compilation de flydraw, programme inclus à WIMS.
Cette librairie peut être téléchargée via Macport, mais sans les bonnes options de configuration, la compilation ne pourra se faire correctement.

tentez avec la commande suivante : 
<code bash>sudo port install gd2</code>
(et n'hésitez-pas à nous dire si cela fonctionne bien avec votre installation)


=== Modules Perl ===
Installez ensuite quelques modules Perl nécessaires : 
<code bash>sudo cpan install URI::URL</code> (URI::URL est par exemple utilisé par le script adm/urldecode)
<code bash>sudo cpan install WebService::Validator::HTML::W3C</code>

==== Ajout coreutils ====

les outils date, tac & stat sont disponibles via coreutils

<code bash>sudo port install coreutils</code>

il faudra ajouter en tête du PATH (Configuration/questions techniques) : 

  /opt/local/libexec/gnubin/
=====2. Installation de WIMS : =====
Créer un répertoire/utilisateur wims

Télécharger la dernière version de wims sur le site de sourcesup, 
 http://sourcesup.cru.fr/frs/?group_id=379
par exemple dans le répertoire wims (remplacez le lien ci-dessous par celui de la dernière version sur sourcesup)
<code bash>wget https://sourcesup.cru.fr/frs/download.php/latestfile/531/wims-4.XX.tgz</code>
Le décompacter
<code bash>tar xzf wims-4.XX.tgz</code>

Éditer le fichier ./compile pour modifier les options de compilation standard et les adapter à Macports (erreur de compilation de flydraw sinon) : 
<code bash>./configure CFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib  CXXFLAGS=-I/opt/local/include</code>


Lancez la compilation :
  * Lors d'une première installation (assez long) : <code bash>./compile --mathjax --jmol --modules --geogebra --shtooka</code>
  * Lors des mises à jour : <code bash>./compile --mathjax --jmol --geogebra</code>

NB : 
  * l'option ''--mathjax'' permet d'installer la librairie "MathJax", offrant un bonne compatibilité avec Chrome.
  * l'option ''--jmol'' permet l'installation de la librairie javascript Jsmol,
  * l'option ''--modules'' installe tous les modules pédagogiques, ne le faire qu'à la première installation (la mise à jour est ensuite automatique),
  * l'option ''--geogebra'' installe les libraires javascript utiles pour utiliser Geogebra.


Configuration WIMS d'Apache :
<code bash>sudo bin/apache-config</code>

Pour que WIMS fonctionne, vous devez vous assurer que votre serveur apache permet l'exécution de scripts CGI. Pour cela, commencez par repérer le fichier de configuration d'Apache, avec cette commande :
<code bash>httpd -V</code>
Parmi toutes les informations qui apparaissent, repérez la ligne contenant ceci :
  SERVER_CONFIG_FILE=...
Elle vous indique ou se trouve votre fichier de configuration d'Apache. Par défaut, ce devrait être "/private/etc/apache2/httpd.conf"
Éditez alors ce fichier, pour y rechercher la ligne suivante :
  LoadModule cgi_module libexec/apache2/mod_cgi.so
Elle ne doit surtout pas être désactivée. Si elle commence par un dièse (#), retirez-le et enregistrez, tout simplement.

Si vous voulez vérifier que votre configuration d'Apache est correcte, vous pouvez lancer cette commande : 
<code bash>sudo apachectl configtest</code>

Redémarrez votre serveur Apache : 
<code bash>sudo apachectl restart</code>

Vérifier les permissions des fichiers (normalement ceci est fait automatiquement à la fin de l'installation)
<code bash>sudo bin/setwimsd</code>

Si Povray a été installé, rajouter une ligne de permission dans le fichier povray.conf
(il est dans  /opt/local/etc/povray/3.6/povray.conf)
  read+write* = $WIMS/tmp/sessions

en remplaçant $WIMS par l'adresse du répertoire wims.
===== 3. Première configuration de WIMS =====
Suivez la page suivante pour configurer votre installation : [[installation:first_config| Configuration de WIMS]]


Vous aurez quelques éléments spécifique à une installation MacOS à fournir : 

==== Technical topics / Questions techniques : ====
Si vous êtes sur Mac, il vous faut ajoutez des chemins dans la ligne PATH afin que wims trouve les logiciels installés via MacPort
le champ complet des PATH sur Mac est le suivant (vous pouvez remplacer l'existant par celui-ci) 
   /opt/local/libexec/gnubin/:/opt/local/bin:/usr/local/bin:/usr/bin:/bin:/usr/X11/bin/:/Library/TeX/texbin:
Vous rajouterez également les adresses de GAP, Macaulay ou d'autres logiciels si vous les avez installés dans un endroit non atteint. Par exemple (toujours sur Mac) :
   /Applications/Macaulay2-1.21/bin:/Applications/gap
Pour sortit les fichiers télécharger de "quarantaine". Il peut être nécessaire d'utiliser les commandes: 
  xattr -rc /Applications/Macaulay2-1.21
  xattr -rc /Applications/gap
  
===== 4. Versions testées =====

Wims 4.24 - Ventura 13.4.1 (25/07/2023)