Installation sous Windows

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

Il est conseillé de lancer à chaque fois PowerShell en administrateur pour les étapes suivantes et choisissez un répertoire pour le zds par exemple :

cd C:\dev\zestedesavoir

Attention

Il est fortement recommandé (pour des raisons de compatibilité), que tous les programmes à installer soient en 32 bits ou en 64 bits. Il est conseillé de ne pas mélanger les deux.

Cas numéro 1 : windows 10 et sous-système linux

  • Utilisez le sous-système linux<https://docs.microsoft.com/en-us/windows/wsl/install-win10>

  • (exemple pour le sous système ubuntu)
    sudo apt install build-essential git
    git clone https://github.com/<votre-pseudo>/zds-site
    cd zds-site
    ./scripts/install_zds.sh -packages ubuntu
    

Cas numéro 2 : fonctionnement sur windows lui-même

  • Téléchargez zlib (prérequis pour la bibliothèque Pillow)

  • Téléchargez et installez les outils suivants :
    • PowerShell 3.0+. Uniquement pour les PC tournant sous Windows 7 ou antérieur (installé par défaut avec Windows depuis).

    • Git (Git pour Eclipse ne suffit pas ; associez les .sh).

    • gettext.

  • Téléchargez et installez Python 3.6.

  • Installez setuptools : Démarrez Powershell en mode administrateur et lancez la commande suivante : Set-ExecutionPolicy RemoteSigned

  • Installez Virtualenv avec les commandes suivante :
    • pip install virtualenv

  • Clonez le dépot git via la console git* (ou bien powershell qui n’est pas en administrateur): git clone https://github.com/zestedesavoir/zds-site.git

  • Créez votre workspace dédié à ZdS (mode administrateur obligatoire).
    • se placer dans le dossier du dépôt cloné (zds-site)

    • tapez virtualenv zdsenv (il va alors créer l’environnement virtuel zdenv)

    • Activez l’environnement en exécutant le fichier zdsenv/Scripts/activate.ps1

(?) Si vous avez (zdsenv) à gauche de la zone de saisie, c’est que vous êtes dans l’environnement zdsenv.

Pour redémarrer virtualenv les fois suivantes : exécutez à nouveau le fichier zdsenv/Scripts/activate.ps1.

(zdsenv)PS C:\dev\zestedesavoir\

Lancez par la suite pip install --upgrade -r requirements-dev.txt.

Si l’erreur suivante apparaît :

Erreur

Unable to find vcvarsall.bat

Installez le compilateur Visual C++ pour Python disponible ici.

Pour que la modification soit effective, relancer une nouvelle fenêtre powershell.

Les virtualenvs et pycharm

Avec PyCharm (Pour avoir une license Pro contactez le directeur technique (DTC)) vous pouvez gérer les virtualenv de manière bien plus performante qu’avec la commande powershell de base. Bien que le wrapper doive être installé comme dit au dessus, PyCharm vous offre une interface plus maniable. Ouvrez le projet dans PyCharm, puis allez dans Fichier(File)->Settings Dans « Project interpreter » sélectionnez la version « Python 3.4 » que vous avez installée. Cliquez alors sur la roue dentée puis « Create virtualenv ». Vous pourrez alors sélectionner le dossier dans lequel se trouve le virtualenv et son accessibilité par PyCharm. PyCharm vous notifiera alors que vous n’avez pas toutes les dépendances et vous proposera de les installer.

Attention

Par défaut PyCharm ne va pas chercher les dépendances dans requirements-dev.txt. Vous pouvez installer les dépendances depuis PowerShell ou bien aller dans l’onglet Tools des settings puis dans la partie « Python Integration » pour y changer temporairement le chemin vers le fichier de dépendances.

Installation des outils front-end et de zmarkdown

Il vous faut installer les outils du front-end. Pour cela, rendez-vous sur la documentation dédiée. Ensuite, installez zmarkdown

Suite et fin de l’installation

Dans la console PowerShell via l’environnement zdsenv installez les dépendances:

  • pip install --upgrade -r requirements-dev.txt

  • python .\manage.py migrate ;

  • python .\manage.py loaddata (dir .\fixtures\*.yaml), puis python .\manage.py load_factory_data .\fixtures\advanced\aide_tuto_media.yaml, afin de créer le jeu de données utile au dévellopement.

On peut finalement lancer ZdS:

  • cd zmd/node_modules/zmarkdown && npm run server pour zmarkdown ;

  • python manage.py runserver

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.