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 de se placer dans un dossier pour ZdS, par exemple :

cd C:\dev\zestedesavoir

Attention

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

Cas numéro 1 : Windows 10 et le sous-système Linux

Utilisez le sous-système Linux, et installez Zeste de Savoir comme si vous étiez sur la distribution choisie.

  • 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 : installation sous Windows lui-même

Installation automatique

Commencez par télécharger et installer Python. Installez PowerShell et autorisez l’exécution des scripts powershell en copiant cette ligne de code dans votre console : powershell -Verb RunAs -ArgumentList "Set-ExecutionPolicy RemoteSigned" -WindowStyle Hidden -Wait.

Ensuite, ouvrez la console de Windows et faites :

cd /ton/path/zds-site/
powershell .\scripts\win\install_zds.ps1 +full

Une fois l’installation finie, utilisez la console PowerShell et chargez l’environnement virtuel de votre espace de développement avec :

. .\zdsenv\Scripts\activate.ps1

Vous devriez obtenir :

(zdsenv)PS C:\dev\zestedesavoir\

Vous pouvez finalement lancer ZdS.

  • Démarrer ZMD : pm2 start --name=zmarkdown -f zmd/node_modules/zmarkdown/server/index.js -i 1

  • Démarrer Django : python manage.py runserver

Installation manuelle

  • 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 avec powershell qui ne doit pas être exécuté en tant qu’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 l’environnent virtuel 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, relancez 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.x” que vous avez installé. Cliquez alors sur la roue dentée puis sur “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éveloppement.

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 Typesense :

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