Installation¶
Dépendances¶
Patacrep est un projet reposant sur beaucoup de techniques, il a donc un certain nombre de dépendances à installer pour le faire fonctionner. Ces dépendances sont les mêmes pour tous les systèmes d’exploitation, mais la méthode d’installation diffère. Ces dépendances sont les suivantes :
- Python 3.3 ou plus récent. Python 2 n’est pas supporté ;
- LaTeX, et en particulier
lualatex
;
Patacrep a aussi des dépendances optionnelles, qui peuvent ajouter des fonctionnalités, mais ne sont pas obligatoires :
- Lilypond, pour compiler des partitions.
GNU/Linux¶
Il n’existe pas (pour le moment ?) de paquet pour les différentes
distributions. En attendant, patacrep
peut être installé en utilisant pip
(éventuellement dans un virtualenv, pour
garder un environnement d’installation propre). Voir la section suivante pour les instructions.
Voici quelques informations supplémentaires pour certaines distributions.
Debian¶
Il n’existe pas (encore ?) de paquet debian pour patacrep. Les paquets à installer sous Debian (et ses dérivées comme Ubuntu) sont :
Python 3.4
Installer les paquets nécessaires (pour une installation de patacrep sans virtualenv):
apt-get install python3.4 python3-pip
Installer les paquets nécessaires (pour une installation de patacrep avec virtualenv):
apt-get install python3-virtualenv
LaTeX :
- Nécessaires :
texlive texlive-latex-base texlive-latex-recommended texlive-latex-extra
- Optionnel pour patacrep, nécessaire pour patadata :
texlive-lang-english texlive-lang-french texlive-lang-portuguese texlive-lang-spanish texlive-lang-italian texlive-fonts-extra
- Nécessaires :
Lilypond (optionnel) :
lilypond
Il est aussi possible, en utilisant stdeb, de créer un paquet .deb
à la volée:
python setup.py --command-packages=stdeb.command bdist_deb
sudo dpkg -i deb_dist/python3-patacrep_5.0.0-1_all.deb
Ubuntu 16.04¶
En plus des paquets précédent, il est nécessaire pour que LaTeX fonctionne bien d’installer les deux paquets suivants :
apt-get install texlive-luatex texlive-xetex
CentOS 6.5¶
Sur CentOS 6.5, un certain nombre de logiciels par défaut sont trop anciens pour faire fonctionner Patacrep correctement. En particulier, vous devriez utiliser une version récente de TeXLive, et installer ghostscript en version 9.
MacOSX¶
- Vous devrez installer les dépendaces suivantes :
LaTeX. La distribution MacTeX est la plus simple à installer. Une installation personnalisée de TeXLive fonctionnera aussi si vous savez ce que vous faites.
Lilypond peut être utile si vous souhaitez compiler les partitions dans les chansons. Ce n’est toutefois pas une dépendance obligatoire. Vous pouvez le télécharger à cette adresse. Décompressez l’archive, puis placez-la dans
/Applications
. Vous devrez ajouter un lien vers lilypond pour que songbook puisse le trouver en lançant les commandes suivantes dans un Terminal :sudo ln -s /Applications/LilyPond.app/Contents/Resources/bin/lilypond /usr/local/bin/lilypond echo "export PATH=$PATH:\usr\local\bin" >> ~/.bashrc
La première commande va vous demander votre mot de passe administrateur.
Installation depuis PyPi¶
Une fois les dépendances installées, vous pouvez vérifier que tout s’est bien passé en lançant les commandes
python --version
lualatex --version
# Uniquement si vous avez installé lilypond
lilypond --version
Si le numéro de version s’affiche, tout va bien, si vous avez une erreur command not found
, il y a un problème.
Pour la suite, la bibliothèque Patacrep et le programme songbook sont disponibles sur le Python Packages Index, vous pouvez donc les installer avec pip
.
Sans virtualenv¶
pip3 install patacrep
Puis pour tester si tout a bien fonctionné
songbook --version
Avec virtualenv¶
Pour éviter de mélanger les installations système (par apt, yum ou autre) et les installations de pip, il est recommandé d’installer l’application localement dans un virtualenv:
$ virtualenv -p python3 virtualenv
Already using interpreter /usr/bin/python3
Using base prefix '/usr'
New python executable in virtualenv/bin/python3
Also creating executable in virtualenv/bin/python
Installing setuptools, pip...done.
$ . virtualenv/bin/activate
(virtualenv)$ pip install patacrep
...
$ songbook --version
...
Si vous optez pour une installation dans un virtualenv, il faudra lancer la commande
. PATH_TO_VIRTUALENV/bin/activate
avant chaque utilisation de songbook ou de patacrep.
Mac OS X¶
- Si vous avez des erreurs lors de l’installation, deux cas sont possibles :
erreur
permission denied
: vous n’avez pas de droits en écriture dans/usr/bin
. Ajoutezsudo
devant la commande fautive, et relancez-la (sudo pip3 install patacrep
). Un mot de passe administrateur vous sera demandé.songbook: command not found
, c’est que/usr/local/bin
n’est pas dans votrePATH
. Pour l’ajouter, exécutez la commandeecho "export PATH=$PATH:/usr/local/bin" >> ~/.bashrc
Installation de la version de développement¶
Pour obtenir la version de développement, il est possible de télécharger les sources en utilisant git :
git clone https://github.com/patacrep/patacrep.git
cd patacrep
pip3 install -r Requirements.txt
python3 setup.py install
Pour mettre à jour la version de développement, utilisez simplement
git pull
pip3 install -r Requirements.txt
python3 setup.py install
depuis le dossier patacrep
Mise à jour¶
Pour effectuer une mise à jour de Patacrep, vérifiez que les dépendances sont à jour, puis lancez la commande
pip3 install --upgrade patacrep