Installation sous macOS

Pour installer une version locale de ZdS sur macOS, veuillez suivre les instructions suivantes. Si une commande ne passe pas, essayez de savoir pourquoi avant de continuer.

Pré-requis

  • Installer XCode :
xcode-select --install
  • Installer Homebrew.
  • Installer un nouveau Python par Homebrew :
brew install python --framework
# Il se peut que votre système n'utilise pas la nouvelle version de Python. Si c'est le cas, lancez la commande suivante.
export PATH=/usr/local/bin:/usr/local/sbin:${PATH}
  • Si vous avez décidé de ne pas installer un nouveau python et que vous utilisez celui de base du système, installez pip :
wget https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py
  • Installer toutes les dépendances systèmes nécessaires :
make install-macos

Une fois les pré-requis terminés, vous pouvez vous lancer dans l’installaton de l’environnement de zds.

Configuration de virtualenv

(Si vous n’utilisez pas bash mais un autre shell, par exemple zsh, remplacez ~/.bash_profile par le fichier rc de votre shell, par exemple ~/.zshrc.)

mkdir ~/.virtualenvs
echo "export WORKON_HOME=$HOME/.virtualenvs" >> ~/.bash_profile
echo "source /usr/local/Cellar/python3/3*/Frameworks/Python.framework/Versions/3.*/bin/virtualenvwrapper.sh" >> ~/.bash_profile
source ~/.bash_profile

Usage de virtualenv

Création d’un virtualenv :

mkvirtualenv -p python3 zdsenv

Lancer un virtualenv :

workon zdsenv

Quitter un virtualenv :

deactivate

Installation des des dépendances front et back

On installe les outils du front-end, zmarkdown puis les packages python:

make install-front
make build-front
make zmd-install
make install-back

Lancer ZdS

Une fois dans votre environnement python et toutes les dépendances installées, lançons ZdS. On crée d’abord la base de donnée, puis le jeu de données utile au dévellopement:

make migrate
make fixtures

On peut finalement lancer zmarkdown, puis ZdS:

make zmd-run
make run-back

Aller plus loin

Pour faire fonctionner ZdS dans son ensemble vous devez installer les outils LateX et Elasticsearch:

Vous pouvez également indiquer à Git de ne pas effectuer de commit s’il y a des erreurs de formatage dans le code.