Documentation installation sous windows #3446

josephcab · 2016-03-15T21:43:37Z

Q	R
Correction de bugs ?	non
Nouvelle Fonctionnalité ?	non
Tickets (issues) concernés	Aucun

QA

Aucun

Objet

Correction (partielle) de la documentation pour l'installation de zds sur un ordinateur muni de Windows

Proposition de correction de la procédure d'installation sous Windows, après une installation laborieuse chez moi

Situphen · 2016-03-16T12:43:43Z

doc/source/install/backend-windows-install.rst

+
+.. Attention::
+
+    Il est fortement recommandé (pour des raisons de compatibilité), que tous les programmes à installés le soit en 32 bits.


à installer

Situphen · 2016-03-16T18:21:25Z

À part les quelques points à modifier ça m'a l'air bon ! :)

SpaceFox · 2016-03-19T22:30:57Z

Est-ce que tu saurais faire un squash de tout ça @josephcab ? 5 commits, ça fait un peu beaucoup pour cette modification de doc :)

À noter que si tu ajoutes [ci-skip] dans le nom du commit, Travis ne passera pas (il est inutile ici).

gustavi · 2016-03-20T06:49:39Z

doc/source/install/backend-windows-install.rst

+
+.. Attention::
+
+    Il est fortement recommandé (pour des raisons de compatibilité), que tous les programmes à installer le soit en 32 bits.


Je suis toujours en désaccord avec cette ligne. Puis-je avoir une justification ?

@SpaceFox , je ne sais pas faire, mais je peux essayer si tu m'explique.

@gustavi , en suivant exactement la même procédure avec les programmes en 64bits, j'ai eu des plantage à répétitions et n'ait jamais réussi à finir d'installer le site. Mais si vous pensez qu'il vaut mieux ne pas le mettre, aucun problème, je l'enlève.

Oui enlève-le, on est en 2016.

Je suis d'accord qu'on est en 2016, mais il faut préciser que la Doc fonctionne avec des programmes 32bit et qu'on n'est pas sur pour 64bit.

Personnellement, à l'époque où j'avais testé sous Windows j'étais en 64 bits et ça passait très bien.

J'ai l'impression que vous parlez de 2 choses différentes là… si les programmes doivent être installés en 32 bits même sur un Windows 64 bits, ça doit être précisé. Même si c'est dommage, je préfère avoir une doc qui explique comment faire tourner ZdS en 32 bits sous Windows, que pas de doc du tout.

je fais quoi?

Je pense que Il est fortement recommandé (pour des raisons de compatibilité), que tous les programmes à installer le soient en 32 bits ou en 64 bits. Il est préférable de ne pas mélanger les deux. est bien.

gustavi · 2016-03-29T15:49:20Z

À part les commentaires sur le 32/64 bits et les quelques fautes ça me semble correcte.

coveralls · 2016-03-29T17:11:13Z

Coverage increased (+0.07%) to 87.889% when pulling dff9824 on josephcab:dev into 9a844fb on zestedesavoir:dev.

coveralls · 2016-03-29T17:20:49Z

Coverage increased (+0.07%) to 87.889% when pulling 8de22a3 on josephcab:dev into 9a844fb on zestedesavoir:dev.

josephcab · 2016-03-29T17:47:05Z

j'ai essayé de faire un squash, mais sans succès, si ce n'est deux commit supplémentaires inutiles (les deux derniers)!

coveralls · 2016-03-29T17:57:21Z

Coverage increased (+0.07%) to 87.889% when pulling 2ac0020 on josephcab:dev into 9a844fb on zestedesavoir:dev.

gustavi · 2016-03-30T08:12:02Z

Tu peux essayer ça :

git reset --soft 41a1f5caf79928ad51bb08841d42ddf307099838
git add -A
git commit -m "Mise à jour de la documentation d'installation sous Windows"
git push -f origin dev

josephcab · 2016-04-01T18:38:02Z

Merci beaucoup gustavi.

Juste pour essayer de comprendre :

je réinitialise mes commits avec la première ligne en désignant le plus vieux à reseter.
J'ajoute toutes les modifs encores non commitées (vu que j'ai reseté)
je crée mon commit avec toutes les modifs
j'envoie sur zds

C'est ça?

gustavi · 2016-04-01T18:43:08Z

Pour te répondre :

git reset --soft 41a1f5caf79928ad51bb08841d42ddf307099838 # tu reviens au commit 41... sans annuler les changements sur les fichiers
git add -A # tu ajoutes tous les fichiers modifiés au prochain commit
git commit -m "Mise à jour de la documentation d'installation sous Windows" # tu fais le commit
git push -f origin dev # tu push avec -f car l'historique des commits a été modifié

Il faut néanmoins que tu rebase ta branche car il y a du conflit. Sais-tu faire ça ?

josephcab · 2016-04-01T18:47:35Z

pas du tout (je ne sais en fait pas me servir de git).

Au passage, si tu as un tuto, je suis preneur!

coveralls · 2016-04-01T19:01:27Z

Coverage increased (+16.5%) to 87.401% when pulling 14aa1ec on josephcab:dev into 504cc3c on zestedesavoir:dev.

Situphen · 2016-04-02T08:39:17Z

Un tutoriel très complet et un autre spécialisé dans la gestion de l'historique !

Cariope · 2016-04-04T14:29:21Z

doc/source/install/frontend-install.rst


-Vérifiez de posséder la version 2.5.0 de npm (et non la version 1.4.X que peut installer l'installeur), 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``.
+Vérifiez de posséder la version 2.5.0 de npm (et non la version 1.4.X que peut installer l'installeur), pour connaitre votre version : ``npm -v``.


Il peux être utile d'indiquer que la commande : npm install npm@latest effectuera les mise à jour

Cariope · 2016-04-04T15:03:22Z

doc/source/install/backend-windows-install.rst

@@ -41,6 +49,7 @@ Prérequis
    - ``pip install virtualenvwrapper-powershell``
 - Désactivez la sécurité sur les script powershell (mode administrateur obligatoire) : ``Set-ExecutionPolicy RemoteSigned``, pour autoriser ``Import-Module``.
 - Créez votre workspace dédié à ZdS (mode administrateur obligatoire).
+    - Créez le dossier ``.virtualenvs`` avec la commande ``mkdir .virtualenvs`` dans le dossier où vous souhaitez voir installer votre environnement virtuel.
    - ``set $env:WORKON_HOME``


C'est vraiment évident qu'il faut rentrer dans le dossier .virtualenvs que l'on vient de créer ou c'est moi qui suis bête?

non, ce n'est pas nécessairement évident, m'étant aussi fait avoir!

N'hésitez pas à donner un max d'infos sur vos retours, même si ça semble stupide !

orandin · 2016-04-04T21:52:39Z

Après les commandes pour installer virtualenv, il est possible de procéder autrement :

cloner le dépôt git
Se placer dans le dossier du dépôt cloné zds-site/
Taper virtualenv zdsenv pour créer le dossier zdsenv contenant l'environnement.
Exécuter le fichier zdsenv/bin/activate.ps1 pour activer l'environnement.

Cela me semble davantage plus simple et plus stable que les commandes proposées.

gustavi · 2016-04-19T07:28:43Z

@josephcab il faudrait rebase tout ça ! Tu as des liens avec de la documentation ci dessus, au besoin n'hésite pas ;)

josephcab · 2016-04-19T08:12:09Z

@orandin j'ajoute les commandes à partir du clone du dépot zds, mais faut-il supprimer une ou plusieurs lignes avant?

et je n'ai pas réussi pour le rebase, j'ai encore bien du mal avec git!

orandin · 2016-04-19T17:02:47Z

doc/source/install/backend-windows-install.rst

@@ -41,6 +49,7 @@ Prérequis
    - ``pip install virtualenvwrapper-powershell``
 - Désactivez la sécurité sur les script powershell (mode administrateur obligatoire) : ``Set-ExecutionPolicy RemoteSigned``, pour autoriser ``Import-Module``.
 - Créez votre workspace dédié à ZdS (mode administrateur obligatoire).
+    - Créez le dossier ``.virtualenvs`` avec la commande ``mkdir .virtualenvs`` dans le dossier où vous souhaitez voir installer votre environnement virtuel.
    - ``set $env:WORKON_HOME``
    - ``Import-Module virtualenvwrapper``, *la console PowerShell pourrait hurler à cette commande, mais normalement ça passe, en cas de deuxième essai vous ne devriez plus avoir d'erreur*.
    - ``New-VirtualEnvironment zdsenv --no-site-packages``


Pour moi, les lignes de 52 à 55 rendent l'installation compliquée et vraiment particulière vis-à-vis de Linux par exemple. Alors qu'il est possible d'avoir sensiblement la même chose en une ligne : virtualenv zdsenv

Il faut donc penser à rajouter vers la ligne 57 cette instruction :

Exécuter le fichier zdsenv/bin/activate.ps1 pour activer l'environnement.

( Documentation installation sous windows #3446 (comment) )

D'autant que quand j'étais sous Windows, ça ne fonctionnait pas.

josephcab · 2016-04-20T09:54:56Z

Suite à la catastrophe que devenait mon fork a cause de mes tentatives échouées de rebase, et autres, j'ai recréé mon fork et donc une PR ici.

Cette PR peut donc être supprimée, tous les changements ayant été repris sur l'autre, avec vos dernières remarques.

SpaceFox · 2016-04-20T09:55:46Z

OK, je ferme ici donc.

corrections après un test d'installation

41a1f5c

Proposition de correction de la procédure d'installation sous Windows, après une installation laborieuse chez moi

Situphen reviewed Mar 16, 2016
View reviewed changes

Situphen added the C-Docs Concerne la documentation label Mar 16, 2016

gustavi reviewed Mar 20, 2016
View reviewed changes

Mise à jour de la Documentation sous Windows

14aa1ec

Cariope reviewed Apr 4, 2016
View reviewed changes

orandin reviewed Apr 19, 2016
View reviewed changes

josephcab and others added 4 commits April 20, 2016 10:27

corrections environnement d'exécution

e130c5d

ajout mise à jour de npm

05dd125

Mise à jour de la documentation d'installation sous Windows

8256c43

Merge branch 'dev' of https://github.com/josephcab/zds-site into dev

8174e13

josephcab mentioned this pull request Apr 20, 2016

Mise à jour de la documentation d'installation sous Windows #3550

Merged

SpaceFox closed this Apr 20, 2016

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Documentation installation sous windows #3446

Documentation installation sous windows #3446

josephcab commented Mar 15, 2016

Situphen Mar 16, 2016

Situphen commented Mar 16, 2016

SpaceFox commented Mar 19, 2016

gustavi Mar 20, 2016

josephcab Mar 20, 2016

gustavi Mar 20, 2016

Situphen Mar 20, 2016

gustavi Mar 20, 2016

SpaceFox Mar 20, 2016

Situphen Mar 20, 2016

josephcab Mar 20, 2016

gustavi Mar 29, 2016

gustavi commented Mar 29, 2016

coveralls commented Mar 29, 2016

coveralls commented Mar 29, 2016

josephcab commented Mar 29, 2016

coveralls commented Mar 29, 2016

gustavi commented Mar 30, 2016

josephcab commented Apr 1, 2016

gustavi commented Apr 1, 2016

josephcab commented Apr 1, 2016

coveralls commented Apr 1, 2016

Situphen commented Apr 2, 2016

Cariope Apr 4, 2016

Cariope Apr 4, 2016

josephcab Apr 4, 2016

gustavi Apr 4, 2016

orandin commented Apr 4, 2016

gustavi commented Apr 19, 2016

josephcab commented Apr 19, 2016 •

edited

Loading

orandin Apr 19, 2016 •

edited

Loading

SpaceFox Apr 19, 2016

josephcab commented Apr 20, 2016

SpaceFox commented Apr 20, 2016


		.. Attention::

		Il est fortement recommandé (pour des raisons de compatibilité), que tous les programmes à installés le soit en 32 bits.


		Vérifiez de posséder la version 2.5.0 de npm (et non la version 1.4.X que peut installer l'installeur), 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``.
		Vérifiez de posséder la version 2.5.0 de npm (et non la version 1.4.X que peut installer l'installeur), pour connaitre votre version : ``npm -v``.

Documentation installation sous windows #3446

Documentation installation sous windows #3446

Conversation

josephcab commented Mar 15, 2016

QA

Objet

Choose a reason for hiding this comment

Situphen commented Mar 16, 2016

SpaceFox commented Mar 19, 2016

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

gustavi commented Mar 29, 2016

coveralls commented Mar 29, 2016

coveralls commented Mar 29, 2016

josephcab commented Mar 29, 2016

coveralls commented Mar 29, 2016

gustavi commented Mar 30, 2016

josephcab commented Apr 1, 2016

gustavi commented Apr 1, 2016

josephcab commented Apr 1, 2016

coveralls commented Apr 1, 2016

Situphen commented Apr 2, 2016

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

orandin commented Apr 4, 2016

gustavi commented Apr 19, 2016

josephcab commented Apr 19, 2016 • edited Loading

orandin Apr 19, 2016 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

josephcab commented Apr 20, 2016

SpaceFox commented Apr 20, 2016

josephcab commented Apr 19, 2016 •

edited

Loading

orandin Apr 19, 2016 •

edited

Loading