{"action":"closed","issue":{"url":"https://api.github.com/repos/zestedesavoir/zds-site/issues/2227","labels_url":"https://api.github.com/repos/zestedesavoir/zds-site/issues/2227/labels{/name}","comments_url":"https://api.github.com/repos/zestedesavoir/zds-site/issues/2227/comments","events_url":"https://api.github.com/repos/zestedesavoir/zds-site/issues/2227/events","html_url":"https://github.com/zestedesavoir/zds-site/issues/2227","id":56855110,"number":2227,"title":"Améliorer la documentation \"Installation du backend sous Windows\"","user":{"login":"ghost","id":10137,"avatar_url":"https://avatars.githubusercontent.com/u/10137?v=3","gravatar_id":"","url":"https://api.github.com/users/ghost","html_url":"https://github.com/ghost","followers_url":"https://api.github.com/users/ghost/followers","following_url":"https://api.github.com/users/ghost/following{/other_user}","gists_url":"https://api.github.com/users/ghost/gists{/gist_id}","starred_url":"https://api.github.com/users/ghost/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ghost/subscriptions","organizations_url":"https://api.github.com/users/ghost/orgs","repos_url":"https://api.github.com/users/ghost/repos","events_url":"https://api.github.com/users/ghost/events{/privacy}","received_events_url":"https://api.github.com/users/ghost/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/zestedesavoir/zds-site/labels/Back","name":"Back","color":"207de5"},{"url":"https://api.github.com/repos/zestedesavoir/zds-site/labels/Documentation","name":"Documentation","color":"207de5"}],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":5,"created_at":"2015-02-06T19:18:58Z","updated_at":"2015-04-30T15:21:41Z","closed_at":"2015-04-30T15:21:41Z","body":"Bonjour,\r\n\r\nIl faudrait amélioration [la documentation sous Windows](https://github.com/zestedesavoir/zds-site/blob/dev/doc/sphinx/source/install/backend-windows-install.rst), elle n'est pas assez précise.\r\n\r\n\r\nJe trouves qu'il faudrait ajouter ces mentions :\r\n\r\nIl est conseillé de lancer à chaque fois PowerShell en administrateur pour les étapes suivantes et choisissez un répertoire pour le zds par exemple : \r\n\r\n    cd C:\\dev\\zestedesavoir\r\n\r\n- Téléchargez et installez les outils suivants :\r\n    - [PowerShell 3.0+](http://www.microsoft.com/fr-fr/download/details.aspx?id=40855)\r\n    - [Git](http://git-scm.com/download/win) (Git pour Eclipse ne suffit pas ; associez les .sh)\r\n    - ~~[gettext](https://www.gnu.org/software/gettext/)~~ <-- Expliquer ce qui faut faire avec.\r\n- [Téléchargez et installez Python 2.7](https://www.python.org/download/releases/2.7/)\r\n- Installez setuptools : Démarrez Powershell et lancez la commande suivante : `(Invoke-WebRequest https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py).Content | python -`\r\n- Décompressez l'archive setuptools-*XX.X.X*.zip.\r\n- Avec la commande `cd setuptools-XX.X.X`, ouvrer le répertoire possèdant *easy_install.py*.\r\n- Installez pip et tox : `python easy_install.py pip tox`.\r\n- Vous devriez avoir un nouveau répertoire `C:\\Python27\\Scripts`, rajoutez le dans le PATH (variable d'environnement).\r\n- Réinstallez easyinstall : `python easy_install.py easyinstall`, ça vous permettra de l'utiliser partout, (supprimez l'ancien package).\r\n- Redémarrez Powershell (pour recharger la variable d'environnement PATH).\r\n- Installez Virtualenv avec les commandes suivante : \r\n    - ``pip install virtualenv``\r\n    - ``pip install virtualenvwrapper-powershell``\r\n- Désactivez la sécurité sur les script powershell (mode administrateur obligatoire) : `Set-ExecutionPolicy RemoteSigned`, pour autoriser `Import-Module`.\r\n- Créez votre workspace dédié à ZdS (mode administrateur obligatoire).\r\n    - ``set $env:WORKON_HOME``\r\n    - ~~``mkdir '~\\.virtualenvs'``~~ <== inutile ?\r\n    - ``Import-Module virtualenvwrapper``, (*la console PowerShell pourrait hurler ici, mais normalement ça passe, en cas de deuxième essai vous ne devriez plus avoir d'erreur*).\r\n    - ``New-VirtualEnvironment zdsenv --no-site-packages``\r\n- Clonez le dépot git *via la console git* (et pas via powershell) windows: ``git clone https://github.com/zestedesavoir/zds-site.git``\r\n\r\n(?) Si vous avez `(zdsenv)` à gauche de la zone de saisie, c'est que vous êtes dans l'environnement *zdsenv*.\r\n\r\n    (zdsenv)PS C:\\dev\\zestedesavoir\\\r\n\r\n\r\nInstallation des outils front-end\r\n=======================\r\n\r\nIl vous faut la version 2.5.0 de npm (et non la version 1.4.X), pour connaitre votre version : `npm -v`. Pour mettre à jour npm, vous avez [trois possibilités](https://github.com/npm/npm/wiki/Troubleshooting#upgrading-on-windows), l'une d'elle est de faire `npm install npm` dans le dossier `C:\\Program Files (x86)\\nodejs`.\r\n\r\nVeillez à respecter [ces conditions](https://github.com/TooTallNate/node-gyp#installation), avant de faire  `npm install` (dans l'ordre d'installation) : \r\n\r\n- [Visual C++ 2010 Express](http://go.microsoft.com/?linkid=9709949).\r\n- [Windows 7 64-bit SDK](http://www.microsoft.com/en-us/download/details.aspx?id=8279), si vous êtes en 64bits.  \r\n  **En cas de problème, suivre [ces instructions](http://www.mathworks.com/matlabcentral/answers/95039#answer_104391) :**\r\n    - Désinstallez : **Microsoft Visual C++ 2010 redistributable packages (x86 et x64)**, *dans le panneau de configuration*.\r\n    - Relancez **Windows 7 64-bit SDK**, décochez \"**Visual C++ Compilers**\" et \"**Microsoft Visual C++ 2010**\".\r\n    - Appliquez ce patch : [SDK 7.1](http://www.microsoft.com/en-us/download/details.aspx?id=4422).\r\n    - Réinstallez (ils se sont peut-être déjà résintallés tous seuls) [Microsoft Visual C++ 2010 redistributable x64](http://www.microsoft.com/en-us/download/details.aspx?id=14632) et [Microsoft Visual C++ 2010 redistributable x86](http://www.microsoft.com/en-us/download/details.aspx?id=5555).\r\n- Vous devez posséder [Visual Studio Express 2013 pour Windows Desktop](https://app.vssps.visualstudio.com/profile/review?download=true&family=VisualStudioExpressDesktop), la version 2012 ne suffit pas, forcez l'utilisation de vs 2013 comme ceci : `npm install --msvs_version=2013`, il est même conseillé de faire `npm config set msvs_version 2013`, pour les futurs installation.\r\n\r\n\r\nIl vous faut installer les outils du front-end. Pour cela, rendez-vous sur [la documentation dédiée](frontend-install.html).\r\n\r\nSuite de l'installation\r\n=======================\r\n\r\n- Dans la console PowerShell via l'environnement zdsenv installez les dépendances.\r\n    - ``easy_install lxml``\r\n    - ``pip install -r requirements.txt -r requirements-dev.txt``\r\n    - ``python manage.py syncdb``\r\n    - ``python manage.py migrate``\r\n    - ``python manage.py runserver``\r\n- ~~Pour redémarrer virtualenv les fois suivantes : ``~\\.virtualenvs\\zdsenv\\Scripts\\activate.ps1``~~ Ca ne fonctionne pas comme ça.\r\n\r\nPour faire fonctionner ZdS dans son ensemble vous devez installer les outils LateX et Pandoc.\r\n\r\n- Téléchagez et installez [MikTex](http://miktex.org/download>)\r\n- Téléchargez et installez [Pandoc](https://github.com/jgm/pandoc/releases>)\r\n\r\n\r\nFAQ :\r\n=====\r\n\r\n\r\n#### En cas de problème avec la commande `pip` : \r\n\r\n- Vérifiez d'avoir ajouté correctement le chemin vers `C:\\Python27\\Scripts`. \r\n- Si vous n'avez pas `pip.exe` à l'intérieur, réinstallez pip (avec `easy_install pip`). \r\n- Si ils vous dit que vous l'avez déjà, nettoyez ce dossier : `C:\\Python27\\Lib\\site-packages`. \r\n"}}