Cette page décrit l'installation de Cyloop sur un ordinateur équipé
d'un système d'exploitation dérivé de UNIX, comme GNU/Linux.
L'installation sur un autre système d'exploitation dépendra du
fonctionnement des outils que vous utilisez (désarchiveur de fichiers
et compilateur C).
Installation des applications
Si vous avez récupéré le fichier des sources compressé, commencez
par le décompresser :
Les différents fichiers seront recopiés dans un sous répertoire
cyloop .
Aller dans ce répertoire et lancer :
make
pour compiler les sources.
Si vous avez récupéré un fichier compressé avec les programmes
exécutables, l'installation se fait de manière similaire, mais
sans qu'il soit nécessaire de lancer la commande make
gunzip cyloop-bin.tar.gz ou
bunzip2 cyloop-bin.tar.bz2
Les fichiers fonte sont des fichiers de données qui permettent de
disposer d'un jeu de caractères étendu pour les textes intégrés aux
graphiques générés par la commande cylgraph .
Dans les premières versions de cyloop, pour plus de souplesse dans
l'évolution des fichiers source comme des fichiers fonte, les fichiers
fonte sont fournis séparément.
Récupérer un fichier parmi : fontecyloop.tar fontecyloop.tar.gz
fontecyloop.tar.bz2 ou fontecyloop.zip
ou une mise à jour majfontecyloop.(...)
Décompressez le et désarchivez le comme vous avez fait pour les fichiers
source.
Vous pouvez indifféremment installer les fichiers fonte avant ou
après la compilation des fichiers source.
Installation locale ou dans les répertoires système
Les exécutables de cyloop sont prêts, mais le système d'exploitation
ne sait pas forcément où ils ont été installés.
Si vous souhaitez conserver Cyloop dans un répertoire spécifique,
il sera nécessaire de rajouter l'accès au sous répertoire
cyloop/bin dans la variable d'environnement PATH .
Pour cela, il faut modifier directement un fichier où la variable
PATH est déclarée : soit le fichier /etc/profile si
Cyloop a été installé pour plusieurs utilisateurs, soit le fichier
.bashrc ou .bash_profile de votre compte dans le cas
contraire.
Dans tous les cas, mettre un chemin d'accès absolu au répertoire
d'implantation de Cyloop.
Il vous faudra vous reconnecter (login) pour que le nouveau chemin
d'accès soit pris en compte.
Si au contraire, vous souhaitez que Cyloop soit implanté au même
endroit que les autres commandes de votre système d'exploitation, à
savoir dans /usr/bin, après l'installation initiale (terminée
par la commande make si vous avez
installé Cyloop à partir des fichiers source), il vous faut passer
en mode super utilisateur (root) pour lancer, depuis le répertoire où
cyloop est implanté, la commande :
make install
Cyloop pourra alors être utilisé par tous les utilisateurs de
l'ordinateur sans qu'il soit nécessaire de modifier le variable
d'environnement PATH .
Sélection d'une langue par défaut
Les différents outils de Cyloop analysent la variable d'environnement
$LANG pour choisir la langue de l'interface utilisateur.
En conséquence, si la variable d'environnement $LANG n'est pas initialisée,
ou si elle fait référence à une langue non disponible, Cyloop ne peut
fonctionner que tant qu'aucun message n'est envoyé à l'utilisateur.
C'est le cas pour la plupart des commandes de cyloop tant qu'elles
fonctionnent sans erreur, mais pas de la toute première à utiliser,
à savoir la commande cylcree
Pour pouvoir utiliser Cyloop dans ce cas, il est nécessaire de créer
un fichier de données mess-cyloop pour une langue choisie par
défaut.
Ce fichier devra être implanté dans le même répertoire que les fichiers
correspondant aux différentes langues de cyloop :
dans le répertoire d'installation cyloop/bin si
cyloop a été installé localement,
dans le répertoire /usr/share/cyloop si cyloop a été
installé dans /usr/bin avec les autres commandes du système
d'exploitation.
Le nom de ce fichier s'obtient en supprimant le suffixe linguistique
(un . suivi de 2 lettres) du fichier à partir duquel il est
créé.
Pour un bon fonctionnement de la langue par défaut, on évitera d'utiliser
des fichiers dont le nom se termine par -utf .
Pour créer les fichiers de la langue choisie par défaut, il est conseillé
de faire des liens symboliques plutôt que des copies ou des liens
physiques. Ainsi, si les fichiers linguistiques évoluent, il n'y aura
rien à modifier pour la langue par défaut.
Par exemple pour choisir la langue française comme langue par défaut,
on lancera la commande :
ln -s mess-cyloop.fr mess-cyloop
Si on désire que le fichier de la langue par défaut soit utilisé
systématiquement (donc, sans tenir compte de la variable d'environnement
$LANG), il faut rajouter un fichier de nom deflang-cyloop (il
peut être vide) dans le répertoire contenant les commandes de Cyloop
ou dans /usr/share/cyloop selon la manière dont Cyloop aura
été installé.
Installation de la documentation
Comme pour les fichiers de l'application Cyloop, on commencera par
faire une installation locale. Ensuite, il sera possible de mettre
les pages de man de Cyloop avec les autres pages de man du système
d'exploitation.
Si le fichier contenant la documentation est compressé, commencer
par une décompression :
gunzip doccyloop-fr-utf.tar.gz
ou
bunzip2 doccyloop-fr-utf.tar.bz2
ou
gunzip doccyloop-fr-iso.tar.gz
ou
bunzip2 doccyloop-fr-iso.tar.bz2
ou
gunzip doccyloop-utf.tar.gz
ou
bunzip2 doccyloop-utf.tar.bz2
ou
gunzip doccyloop-iso.tar.gz
ou
bunzip2 doccyloop-iso.tar.bz2 (ou commande similaire avec un autre fichier).
Désarchiver le fichier contenant la documentation :
tar -xvf doccyloop-fr-utf.tar
ou
tar -xvf doccyloop-fr-iso.tar
ou
tar -xvf doccyloop-utf.tar
ou
tar -xvf doccyloop-iso.tar (ou commande similaire avec un autre fichier).
Le sous répertoire cyloop contiendra un ou plusieurs fichiers
presentation (un fichier par langue installée), ainsi que des
pages de man dans des sous répertoires de cyloop/man .
Plus précisément, les pages de man seront installées dans les
répertoires :
cyloop/man/man1
pour la langue anglaise, cyloop/man/man5
cyloop/man/??/man1
pour une autre langue. cyloop/man/??/man5
avec ?? qui est une langue parmi : fr es pt eo .
Pour les langues autres que l'anglais, le nom du fichier documentation
contient -utf ou -iso pour indiquer le jeu de caractères
accentués utilisé (UTF-8 et ISO8859-1).
Si vos pages de man ne s'affichent pas ou s'affichent avec un jeu
de caractères incorrect, il suffit d'utiliser l'autre fichier de
documentation.
Si vous avez choisi d'implanter Cyloop dans /usr/bin avec les
autres commandes du système d'exploitation, il est souhaitable que les
pages de man de Cyloop soient installées dans /usr/share/man
Pour cela, en mode super utilisateur (root), depuis le répertoire
cyloop vous pourrez lancer la commande :
find man | cpio -pdmuv /usr/share
Il est également possible de déplacer les fichiers man grâce à 2
commandes mv plutôt que de faire une copie. Pour les pages
de man en langue française, les commandes seront :
Dans le cas d'une installation locale de Cyloop et de sa documentation,
si la variable PATH a été initialisée pour trouver les fichiers
exécutables de Cyloop dans .../cyloop/bin , les pages de man
implantées dans .../cyloop/man sont accessibles.
Si ce n'est pas le cas, on peut corriger le problème en rajoutant un
chemin d'accès à la variable d'environnement MANPATH .
Si cette variable d'environnement n'a pas été déclarée, (cas fréquent),
il suffira de rajouter dans /etc/profile (il faut être root pour
ça), ou sur son compte dans le fichier .bashrc ou
.bash_profile, 2 lignes de la forme :