Skip to content

Latest commit

 

History

History
147 lines (93 loc) · 6.42 KB

install-windows.rst

File metadata and controls

147 lines (93 loc) · 6.42 KB
Raw

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

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

Installation automatique

Commencez par téléchargez et installez Python 3.6 ([lien direct](https://www.python.org/ftp/python/3.6.8/python-3.6.8-amd64.exe)).

Ensuite, ouvrez la console de Windows et faites :

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

Une fois l'installation fini, 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 -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 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 :

Error

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.